Link Brain

你个人的书签墓地——只不过这里的东西真的会复活。

快速上手

python3 scripts/brain.py quickstart           # 自动导入浏览器书签 + 启动 GUI
python3 scripts/brain.py save "https://example.com" --auto
python3 scripts/brain.py search "那篇关于 sqlite 的文章"

首次运行

首次运行时，请使用 quickstart 而非 setup。它会：

1. 创建数据库
2. 扫描 Chrome、Safari 和 Firefox 中的书签
3. 导入所有找到的内容（自动跳过重复项）
4. 生成可视化 GUI 控制台
5. 以 JSON 格式返回导入统计信息

setup 同样会检测已安装的浏览器并报告发现结果，但不会自动导入。当用户希望以最快速度构建一个可用的知识库时，请使用 quickstart。

功能概览

• 保存 URL 及其标题、摘要、标签与元数据
• 支持自然语言过滤的全文搜索
• 本地自动抓取并摘要网页内容（无需 API 密钥）
• 采用间隔重复机制，防止收藏链接“腐烂”
• 支持“集合（Collections）”功能，用于组织阅读清单
• 提供知识图谱可视化能力
• 提供阅读统计、连续阅读天数（streak）及每周摘要
• 支持从 Chrome、Safari、Firefox、Pocket、YouTube、Reddit 导入
• 全部数据存储于 SQLite；全部文件落盘；无需账户；无遥测（telemetry）。

数据默认存放在 ~/.link-brain/ 目录下。可通过环境变量 LINK_BRAIN_DIR=/your/path 覆盖该路径。

保存链接

手动保存

你清楚标题，也了解页面内容——直接告诉它即可。

python3 scripts/brain.py save "https://docs.python.org" 
  --title "Python docs" 
  --summary "Standard library reference." 
  --tags "python, docs"

自动保存

只需提供一个 URL，程序将自动抓取页面、提取可读文本、生成摘要，并基于你已有的标签库智能推荐标签。全程不依赖 LLM。

python3 scripts/brain.py auto-save "https://example.com"

等价写法：

python3 scripts/brain.py save "https://example.com" --auto

这是唯一发起网络请求的命令；其余所有操作均在本地完成。

查找内容

搜索

底层使用 SQLite FTS5，但查询语法对人友好，可自然表达意图。

python3 scripts/brain.py search "last week unread from github"
python3 scripts/brain.py search "best rated rust"
python3 scripts/brain.py search "unrated videos from youtube"
python3 scripts/brain.py search "oldest unread" --limit 10

标签查询

python3 scripts/brain.py tags                    # 列出全部标签
python3 scripts/brain.py tags python             # 查看标记为 "python" 的链接

关联链接

查找与指定链接共享标签的其他链接。

python3 scripts/brain.py related 42

标签建议

基于你的历史标签模式，为指定 URL 推荐合适标签。

python3 scripts/brain.py suggest-tags "https://example.com"

内容发现

当你不知道接下来该读什么时。

• digest：拉取一批待审阅链接
• recommend：根据你最常使用的标签推荐链接
• gems：展示你评分最高的链接与被遗忘的优质发现
• random：从积压队列中随机抽取一条

python3 scripts/brain.py digest
python3 scripts/brain.py recommend
python3 scripts/brain.py gems
python3 scripts/brain.py random

阅读追踪

python3 scripts/brain.py read 42                # 标记为已读
python3 scripts/brain.py unread                  # 显示未读链接
python3 scripts/brain.py rate 42 5               # 评分（1–5 分）
python3 scripts/brain.py streak                  # 当前连续阅读天数与活动统计
python3 scripts/brain.py insights                # 阅读行为画像与分析数据
python3 scripts/brain.py weekly                  # 周度摘要（格式适配 WhatsApp 等聊天工具）

streak 统计你连续多少天有阅读行为；insights 告诉你诸如最活跃时段、访问最多域名等信息；weekly 是一份排版良好的摘要，可直接发送至聊天窗口。

集合（Collections）

引用你已保存链接的阅读清单。

python3 scripts/brain.py collection create "Rust" --description "Systems stuff"
python3 scripts/brain.py collection add "Rust" 42
python3 scripts/brain.py collection show "Rust"
python3 scripts/brain.py collection list
python3 scripts/brain.py collection remove "Rust" 42
python3 scripts/brain.py collection export "Rust"            # 导出为 Markdown
python3 scripts/brain.py collection export "Rust" --html     # 导出为独立 HTML 文件

复习队列（Review Queue）

针对书签的间隔重复系统。每个已保存链接都会进入该队列，复习间隔随成功回顾次数递增：1 天 → 3 天 → 7 天 → ……

python3 scripts/brain.py review                  # 获取下一个到期项目
python3 scripts/brain.py review done 42          # 标记为已复习，延长下次间隔
python3 scripts/brain.py review skip 42          # 暂不处理
python3 scripts/brain.py review reset 42         # 重置为 1 天间隔
python3 scripts/brain.py review stats            # 队列整体概况

自动保存（Auto-Save）

save 命令的 --auto 参数（或快捷命令 auto-save）可在单次操作中完成页面抓取、内容摘要与标签推荐。它使用 urllib 获取网页，提取可读正文，并依据你已有的标签词表匹配推荐标签。全程不调用任何外部服务。

知识图谱（Knowledge Graph）

python3 scripts/brain.py graph --open

在 ~/.link-brain/graph.html 生成一个独立 HTML 文件，内含交互式画布。每个链接为一个节点，共用标签构成边。不依赖任何外部 JS 库——直接用浏览器打开即可。

GUI 控制台

python3 scripts/brain.py gui

在浏览器中打开 ~/.link-brain/console.html。这是一个完全自包含的单 HTML 文件，无外部依赖。内置搜索、标签云、知识图谱、集合管理、复习队列、阅读时间线，以及深色/浅色主题切换功能。

添加 --no-open 参数可仅生成文件而不自动打开。

导入数据

浏览器书签

直接读取浏览器本地书签存储：

python3 scripts/brain.py scan chrome
python3 scripts/brain.py scan safari
python3 scripts/brain.py scan firefox

无需导出步骤，直接解析浏览器本地存储。

平台导出数据

从导出的文件中批量导入：

python3 scripts/brain.py import pocket_export.html
python3 scripts/brain.py import youtube_history.json
python3 scripts/brain.py import reddit_saved.csv

如何获取各平台导出文件：

• Pocket：访问 getpocket.com/export，将获得一个 HTML 文件。
• YouTube：使用 Google Takeout。选择 YouTube，再勾选“观看历史记录”，最终获得 JSON 文件。
• Reddit：访问 reddit.com/prefs/data-request 或 old.reddit.com，导出已保存帖子。

同步（Syncing）

检查浏览器来源中已被删除的书签：

python3 scripts/brain.py sync chrome
python3 scripts/brain.py sources              # 查看已连接的数据源及其同步状态

反馈

python3 scripts/brain.py feedback "your message"
python3 scripts/brain.py feedback --bug "something broke"
python3 scripts/brain.py feedback --idea "wouldn't it be cool if..."
python3 scripts/brain.py debug                # 输出系统信息（便于提交 Bug 报告）

配置

所有数据均存于 ~/.link-brain/ 目录下：

• brain.db（SQLite 数据库）
• graph.html（知识图谱输出文件）
• console.html（GUI 控制台文件）
• collection-*.md 与 collection-*.html（导出的集合文件）

覆盖默认目录：

LINK_BRAIN_DIR=/tmp/test-brain python3 scripts/brain.py setup

使用技巧

• search 支持时间过滤器（如 “last week”）和阅读状态（如 “unread”、“best rated”）
• 除非你已有明确的摘要内容，否则每次保存都建议使用 --auto —— 它既快又出人意料地准确。
• review stats 显示当前有多少链接已逾期。建议每周检查一次。
• gems 是重新发现那些你曾喜爱却早已遗忘的老链接的绝佳方式
• 将集合导出为 HTML，可轻松与他人共享阅读清单
• 知识图谱在积累约 50 条链接后才真正开始展现价值；在此之前，它可能略显冷清。
• random 就是那个写着 “我无聊了” 的按钮
• 组合使用 scan 与 sync，可有效保持浏览器书签与本地知识库的一致性