📌 项目地址：AgriciDaniel/claude-obsidian | ⭐ 11,710 颗星 | 🔧 Python | 📜 未标注
先说痛点
用 AI 记笔记，流程通常是这样的：丢一份材料给模型，它吐回一份摘要，存进笔记软件。三个月后你想核对一个细节，摘要还在，原文呢？没了。来源断了。更糟的是，两次对话生成的笔记互相矛盾，你也发现不了——矛盾藏在流畅的文字里，肉眼看不出来。
claude-obsidian（11,710 星，Python）针对的就是这个。它是一个跑在 Claude Code 或兼容 Agent Skills 宿主上的本地知识系统，把”记笔记”拆成一个可重复的循环：留下源、锚定主张、建立连接、再利用。
四步循环
README 描述的流程是：
- Capture：本地资料先经过一个可见的 inbox，在任何综合处理之前保存不可变的、内容寻址的原始副本。也就是说，AI 拿到的摘要永远指向一份没被动过的原文。
- Ground：维护两套账本——来源账本和主张（claim）账本。每条主张记录权威性、新鲜度、支持/矛盾状态、置信度、审阅状态。
- Connect：生成互相链接的页面、索引、Map of Content，以及 Obsidian Canvas 视图。
- Reuse：对库做查询、检索、研究、lint、汇总，下次对话不从零开始。
我觉得主张账本是整个项目里最值钱的设计。无依据的主张和自相矛盾的主张，在普通 AI 笔记里是隐形的；这里它们被显式标记，一直保持可见。这在读摘要时能救命。
Vault 是普通目录
这是我要强调的一点：产出物就是 Markdown、JSON 和源文件组成的普通目录。README 明确列了三个“不”——不藏在插件缓存里，不锁在云数据库里，不被静默上传到模型。网络出口是一个单独的、显式的决策。
实际后果：哪天你不用 Claude 了，这个库还是一个完整的 Obsidian vault。Graph view 能看，Canvas 能开，文件能迁移。产出物离开 agent 照样有用。
两个少见的工程细节
并发写入。 多 agent 同时写一个 vault，库会被写坏。这个项目在架构上处理了：worker 只产出草稿，由唯一的 orchestrator 检查后，以一个可恢复的事务方式应用。做过并行 agent 工作流的人知道这个坑有多常见，多数项目根本没考虑。
诚实的能力声明。 可选工具会被检测，成熟度会被声明，缺失的 adapter 明确降级，而不是假装功能存在。README 还列了四条“不是什么”：不是自动转录记录器，不是云同步服务，不是事实预言机，不能替代备份和版本控制。你的 vault 该备份还是得备份，该进 git 还是得进 git。
上手
README 快速开始的第一步是：
git clone https://github.com/Agri
（README 原文在此处截断，完整安装步骤见仓库的 Installation guide，Windows 用户有专门的 WSL 指引。）
两条安全实践值得照做：
- 首次运行用源码 checkout 加一个单独的用户 vault，别直接指向你的主力库；
- 所有会修改文件的 setup 命令，在真正执行前都会预览它将要做的确切操作。
技能域覆盖 ingestion、querying、linting、retrieval、research、rollups、visual mapping，全部共享同一个 provenance-aware 模型。
我的判断
有一个取舍要想清楚：处理引擎绑定 Claude 生态。文件格式开放、本地优先，但引擎不是免费的替代品。这点自己权衡。
如果你在用 Obsidian，并且对“AI 总结完原文就没了”这件事忍了很久，这个项目把来源保全、主张追踪、并发写入三件事一起做掉了。11,710 星说明踩中这个痛点的人不少。