链接大脑

你的个人书签坟场，只不过东西真的会回来。

快速开始

bash
python3 scripts/brain.py quickstart # 自动导入浏览器书签 + 打开图形界面
python3 scripts/brain.py save https://example.com --auto
python3 scripts/brain.py search 那篇关于sqlite的文章

首次运行

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

1. 1. 创建数据库
2. 扫描 Chrome、Safari 和 Firefox 的书签
3. 导入找到的所有内容（跳过重复项）
4. 生成可视化图形界面控制台
5. 返回包含导入统计信息的 JSON

setup 也会检测浏览器并报告找到的内容，但不会自动导入。当用户希望以最快路径获得可用的知识库时，请使用 quickstart。

功能说明

• - 保存带有标题、摘要、标签和元数据的 URL
• 支持自然语言过滤器的全文搜索
• 自动获取并本地总结页面（无需 API 密钥）
• 间隔重复，让你的保存链接不会腐烂
• 用于组织阅读列表的集合
• 知识图谱可视化
• 阅读统计、连续记录和每周摘要
• 从 Chrome、Safari、Firefox、Pocket、YouTube、Reddit 导入
• 所有数据存储在 SQLite 中。所有数据在本地磁盘上。无需账户。无遥测。

数据存储在 ~/.link-brain/ 中。可通过 LINKBRAINDIR=/your/path 覆盖。

保存链接

手动保存

你知道标题。你知道内容。直接告诉它。

bash
python3 scripts/brain.py save https://docs.python.org \
--title Python 文档 \
--summary 标准库参考。 \
--tags python, 文档

自动保存

指向一个 URL。它会获取页面，提取可读文本，生成摘要，并根据你现有的收藏建议标签。无需 LLM。

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

或者等效地：

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

这是唯一会发起网络请求的命令。其他所有操作都是本地的。

查找内容

搜索

底层使用 SQLite FTS5，但你可以像普通人一样编写查询。

bash
python3 scripts/brain.py search 上周来自github的未读内容
python3 scripts/brain.py search 评分最高的rust
python3 scripts/brain.py search 来自youtube的未评分视频
python3 scripts/brain.py search 最早的未读内容 --limit 10

标签

bash
python3 scripts/brain.py tags # 列出所有标签
python3 scripts/brain.py tags python # 标记为python的链接

相关链接

查找与特定链接共享标签的链接。

bash
python3 scripts/brain.py related 42

标签建议

根据你的模式为 URL 获取标签建议。

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

发现

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

• - digest 拉取一批链接供审查
• recommend 根据你最常用的标签推荐链接
• gems 显示你评分最高的链接和隐藏的发现
• random 从积压中抓取一些内容

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

阅读追踪

bash
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 是格式化的摘要，可以直接发送到聊天中。

集合

引用你保存的链接的阅读列表。

bash
python3 scripts/brain.py collection create Rust --description 系统相关
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

复习队列

书签的间隔重复。每个保存的链接都会进入队列。随着你的复习，间隔会增长：1天、3天、7天，以此类推。

bash
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 # 队列概览

自动保存

save 命令的 --auto 标志（或 auto-save 快捷方式）一次性完成获取、总结和标签化。它使用 urllib 抓取页面，提取可读内容，并选择与你现有词汇匹配的标签。不涉及外部服务。

知识图谱

bash
python3 scripts/brain.py graph --open

在 ~/.link-brain/graph.html 生成一个带有交互式画布的独立 HTML 文件。链接是节点。共享标签是边。无需外部 JS 库。直接在浏览器中打开即可。

图形界面控制台

bash
python3 scripts/brain.py gui

在浏览器中打开 ~/.link-brain/console.html。单个自包含的 HTML 文件，无需外部依赖。包括搜索、标签云、知识图谱、集合、复习队列、阅读时间线以及暗色/亮色模式。

添加 --no-open 可仅生成而不启动浏览器。

导入

浏览器

直接拉取书签：

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

从浏览器的本地书签存储中读取。无需导出步骤。

平台

从导出的文件导入：

bash
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 并导出已保存的帖子。

同步

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

bash
python3 scripts/brain.py sync chrome
python3 scripts/brain.py sources # 查看已连接的源和同步状态

反馈

bash
python3 scripts/brain.py feedback 你的消息
python3 scripts/brain.py feedback --bug 有些东西坏了
python3 scripts/brain.py feedback --idea 如果...会不会很酷
python3 scripts/brain.py debug # 用于错误报告的系统信息

配置

所有数据存储在 ~/.link-brain/ 中：

• - brain.db（SQLite 数据库）
• graph.html（知识图谱输出）
• console.html（图形界面控制台）
• collection-.md 和 collection-.html（导出的集合）

覆盖目录：

bash
LINKBRAINDIR=/tmp/test-brain python3 scripts/brain.py setup

提示

• - search 理解时间过滤器如上周和阅读状态如未读或评分最高
• 除非你有特定的摘要想法，否则每次保存都使用 --auto。它速度快且出奇地好
• review stats 告诉你有多少链接已过期。每周检查一次
• gems 非常适合重新发现你忘记曾经喜爱的旧链接
• 将集合导出为 HTML 以与他人分享阅读列表
• 知识图谱在大约 50 个链接后变得更有趣。在此之前，它有点孤单
• random 是我无聊了按钮
• 结合使用 scan 和 sync 来保持浏览器书签的同步