夜雨聆风你有没有这种感觉：笔记越记越多，找起来却越来越费劲。收藏了上百篇文章，真到用的时候，脑子里只剩个模糊印象，根本想不起来放在哪。更烦的是，每次跟AI聊天，都得把前因后果重新交代一遍，它就像个金鱼，聊完就忘。
这事儿挺折磨人的。直到我碰见了 claude-obsidian，才觉得知识管理终于对味儿了。
这个项目在GitHub上已经攒了七千多颗星星，不是什么花架子，它是真的能让你的笔记"活"起来。作者 Daniel Agrici 把它定位成一个知识引擎，不是那种只会跟你聊天的AI插件，而是能自己读、自己连、自己整理的第二大脑。
它的底子来自 Andrej Karpathy 去年提出的 LLM Wiki 模式。核心思路就一句话：别让AI每次都从原始文档里重新检索，而是让它逐步构建并维护一张持久的知识网。你丢进去的资料，AI负责把碎片串成一张互联的图谱，问问题的时候它从这张网里抽答案，而不是从训练数据里瞎编。
听起来有点抽象？我换个说法。以前用RAG，就像每次考试都临时翻书，翻完就扔。claude-obsidian 呢，是请了一个私人文书，你每给他一份材料，他就读完、写卡片、贴标签、归档进你的专属图书馆。下次你再问，他直接去书架上拿，还能告诉你这段话出自哪本书的第几页。
这个"图书馆"完全长在你本地。所有文件都是纯 Markdown，没有数据库，没有云端，没有订阅费。Obsidian 负责存和看，Claude Code 负责读和写，数据主权完全在你手里。
它能干啥？我列几个我觉得特别香的。
自动整理笔记。你扔进去一篇论文、一个PDF、一段聊天记录，Claude 会自动抽取出实体页（比如人名、公司、项目）和概念页（比如理论、模式、方法），然后建立双向链接。不用你手动打标签，不用你操心分类。
矛盾检测。笔记里前后冲突的观点，它会标出来，还附上来源。这对做研究的人来说太友好了，省得自己被自己绕进去。
会话记忆。每次聊完，它会自动更新 hot.md，下次打开不用从头交代背景。就像跟一个跟了你很久的助理说话，他记得你上周在忙啥、上个月定了什么决策。
八类健康检查。孤儿笔记、死链、过期声明、缺失引用，全给你列出来。你的 wiki 会自己保持整洁，不用周末专门花半天手动清理。
还有自主研究、批量导入、多模型支持（Claude、Gemini、Codex、Cursor、Windsurf 都能用）、多作者安全锁（v1.7+）等等。功能堆得挺满，但用起来并不复杂。
装起来其实挺简单的，三种方式，挑一个顺手的就行。
方式一：克隆仓库（推荐，最省心）
先确保你电脑上装了 Git、Obsidian，还有 Claude Code。然后打开终端，敲这几行：
git clone https://github.com/AgriciDaniel/claude-obsidiancd claude-obsidianbash bin/setup-vault.shsetup-vault.sh 这个脚本会帮你把颜色方案、过滤规则、CSS 片段全配好，基本属于开箱即用。跑完之后，用 Obsidian 打开这个文件夹，再在同一个目录下启动 Claude Code，输入 /wiki，Claude 就会一步一步带你搭起来。
它会问你这个知识库是用来做什么的，然后根据你的回答自动创建 index.md、hot.md、log.md、dashboard 这些骨架文件。整个过程大概两分钟，比泡杯咖啡还快。
方式二：装成 Claude Code 插件
如果你已经有一个 Claude Code 的工作流，不想另起炉灶，可以用插件方式。也是两步：
claude plugin marketplace add AgriciDaniel/claude-obsidianclaude plugin install claude-obsidian@agricidaniel-claude-obsidian装完以后，随便在哪个 Claude Code 会话里输入 /wiki，它就能帮你搭 vault。想确认装没装上，可以跑 claude plugin list 看一眼。
方式三：塞进现有仓库
如果你已经有一个 Obsidian 仓库在跑，不想搬家，那就把项目里的 WIKI.md 复制到你仓库根目录，然后贴下面这段给 Claude：
Read WIKI.md in this project. Then:1. Check if Obsidian is installed. If not, install it.2. Check if the Local REST API plugin is running on port 27124.3. Configure the MCP server.4. Ask me ONE question: "What is this vault for?"Then scaffold the full wiki structure.这种方式适合老用户，但配置稍微多几步，新手建议直接用方式一。
装好之后怎么用？这才是好玩的地方。
第一次运行 /wiki，Claude 会检查环境、问你的 vault 用途，然后搭好结构。这时候你的仓库里会出现 wiki/ 文件夹，里面有 sources/（来源）、entities/（实体）、concepts/（概念）、meta/（元数据）这些目录，清清楚楚。
接下来就可以开始"喂"材料了。比如你在网上看到一篇好文章，存成 markdown 丢进 .raw/ 文件夹，然后在 Claude Code 里输入：
ingest 文件名.mdClaude 就会开始读，提取关键信息，创建对应的实体页和概念页，更新索引和日志。整个过程全自动，你看着它一条条生成笔记、建立链接，有点像看蚂蚁搬家，特别解压。
如果想批量处理，直接说：
ingest all of these它会并行处理多个来源，然后做交叉引用。效率挺高的。
问问题也很简单。比如：
what do you know about X?Claude 会先读 hot.md（最近的上下文缓存），再扫 index.md（总目录），然后钻进相关页面里找答案。最后给你的回复会带上具体引用，告诉你这段话出自哪篇笔记。不是瞎猜，是正经有据的。
用久了之后，wiki 会自己"长胖"。每加一份材料，知识网络就更密一点。作者管这叫 compounding knowledge，知识复利。越用越聪明，越问越准，这跟普通AI笔记工具完全不在一个频道。
还有一些进阶玩法。/autoresearch 可以跑自主研究循环，Claude 自己上网搜、自己填空白、自己写综述。/canvas 能打开视觉画布，把笔记、图片、PDF 排成一张图。/think 是十原则思考框架，适合处理复杂决策。
定期跑一下 lint the wiki，让它检查健康度。 orphans（孤儿笔记）、dead links（死链）、stale claims（过期声明），全给你揪出来。你的知识库会自己保持干净，不用你当保洁员。
数据安全这块也做得挺到位。
所有东西都是本地纯文本，你可以用 Obsidian Git 自动同步到私有仓库，也可以用 Obsidian Sync、Syncthing、iCloud、Dropbox 随便跨设备。v1.7 以后还加了文件级建议锁，多人协作的时候不会互相覆盖。MIT 协议开源，个人商用都免费。
这个项目让我最感动的一点是，它不是在卖一个工具，而是在给一种知识管理的理念做落地。你的笔记不该是堆在角落的灰尘，而应该是一张越织越密的网。每当你需要某个知识点，它就在那儿，连带着上下文、来源、相关概念，一起跳出来。
如果你也在用 Obsidian，或者一直想搭一个属于自己的第二大脑，claude-obsidian 真的值得试试。安装不麻烦，上手有 Claude 带着，基本不会卡壳。
guthub地址：https://github.com/AgriciDaniel/claude-obsidian