核心用法
Link Brain 是一款基于 Python 的本地命令行书签管理工具，专为隐私敏感用户设计。核心工作流包含三步：保存（手动输入或自动抓取网页内容）、检索（SQLite FTS5 全文搜索 + 自然语言过滤器）、复习（内置间隔重复队列）。数据完全存储于本地 ~/.link-brain/ 目录，包括 SQLite 数据库、可选的交互式 HTML 图谱视图以及 Markdown/HTML 格式的收藏集导出。
自动保存功能通过 urllib 抓取目标页面，本地完成可读文本提取、摘要生成与标签推荐，无需调用外部 API。搜索支持时间范围（last week）、来源域名（from github）、评分状态（best rated/unrated）等自然语言过滤器。收藏集（Collection）功能允许用户构建主题阅读清单并导出分享。图谱命令生成零依赖的独立 HTML 文件，可视化链接关系。
显著优点
1. 隐私优先架构：无账号体系、无 API 密钥、无遥测，数据永不离开本地磁盘，适合机密工作流。
2. 离线可用：除自动保存时的单次网络请求外，所有功能完全离线运行，不依赖云服务。
3. 开放数据格式：SQLite + Markdown/HTML 导出，便于长期存档与迁移，无供应商锁定。
4. 轻量零依赖：图谱功能不依赖外部 JS 库，Python 标准库即可运行核心功能。
5. 渐进式复习：内置类 Anki 的间隔重复队列，将书签管理转化为知识巩固工具。
潜在缺点与局限性
1. 功能边界清晰但有限：不支持跨设备同步（需用户自行解决，如 Syncthing）、无浏览器扩展、无移动端应用。
2. 自动摘要质量依赖启发式算法：本地 extractive summarization 效果逊于云端大模型，复杂页面可能出现摘要偏差。
3. 搜索语法非标准 SQL：自然语言过滤器需学习特定句式，高级查询灵活性不如原生 SQL。
4. 单用户设计：无多用户或权限管理，不适合团队协作场景。
5. Python 运行时依赖：目标用户需具备 Python 环境管理能力，非技术用户门槛较高。
适合人群
- 注重数据主权的开发者、研究员、隐私倡导者
- 需要构建个人知识库但拒绝 SaaS 服务的用户
- 熟悉命令行操作、愿意用本地脚本替代 Notion/Pocket 的重度阅读者
- 希望将书签阅读与间隔重复记忆结合的学习者
常规风险
1. 数据丢失风险：纯本地存储无自动备份，用户需自行配置备份策略（如 rsync 或 Git）。
2. URL 抓取合规性：自动保存向目标站点发起请求，需遵守目标网站的 robots.txt 与访问频率限制，避免 IP 被封。
3. HTML 解析健壮性：非标准网页可能导致可读文本提取失败，建议关键链接采用手动保存。
4. 无加密存储：SQLite 文件以明文存储，敏感内容需配合磁盘加密（如 LUKS/FileVault）。