用 Obsidian + Claude 整了个 AI 记忆外挂：claude-obsidian 深度测评

GitHub: https://github.com/AgriciDaniel/claude-obsidian
⭐ 8.5K Stars | MIT 协议 | 纯本地笔记，数据不锁死

一、项目定位：Self-organizing AI Second Brain

claude-obsidian 的定位很清晰：Self-organizing AI second brain，翻译成人话就是"会自己整理自己的 AI 第二大脑"。

它的核心思路是：扔进去各种资料，让 Claude 自己读完、抽概念、建链接、归档进一个完整的 Markdown 知识图谱。后续所有提问都基于你自己扔进去的笔记资料，而不是泛泛的网络知识。

二、核心功能深度解析

1. 自动归档与知识图谱

最打动人的功能。丢一个 PDF 进去，Claude 自动生成 8 到 15 个 wiki 页面，更新 index 和 log。所有内容用 Markdown 存，数据是纯文本，不会被哪个平台锁死。

Obsidian 原生的 Graph view 把页面之间的链接可视化出来：

Transformer ←引用→ Attention Mechanism
Transformer ←引用→ KV Cache
Attention Mechanism ←引用→ KV Cache

2. 热缓存与会话记忆（hot.md）

hot.md 这个设计很巧妙：每次和 Claude 聊完，它把近期上下文、关键结论、待办事项写进这个文件。下次敲 /wiki，Claude 先读 hot.md，接着上次的话题继续聊。

以前：每次新开聊天窗口都是陌生人
现在：Claude 记得我上周在调研哪个模型，记得我卡在哪一步

3. 自动研究循环（/autoresearch）

/autoresearch 让 Claude 变成一台自主研究机器：

给它一个主题
Claude 自己分解角度、搜索资料、抓取内容、综合写作、归档进 vault
默认跑三轮：第一轮大范围搜 → 第二轮找漏掉的 → 第三轮互相印证

实测效果：试了一个"对比 2026 年主流向量数据库"的题目，Claude 跑了三轮搜索，最后给了一份带引用来源的综合报告，还自动建了 "Pinecone"、"Milvus"、"Weaviate" 这几个实体页面，全程没动过手。

4. 画布可视化（Canvas）

可以把图片、 PDF 、 wiki 页面、文字卡片丢到画布上，Claude 自动排版（不重叠），甚至能从最近生成的图片里抓素材直接上画布。

5. 多方法论支持（v1.8+）

支持四种知识组织方式，通过 bash bin/setup-mode.sh 选择：

方法论	适用场景
PARA	项目多，按项目归类
LYT	按卡片盒思路组织
Zettelkasten	原子化笔记
自定义	灵活配置

三、三种部署方式

方式一：克隆完整 vault（推荐，两分钟搞定）

git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh

setup-vault.sh 自动帮你配好：

graph.json — 图谱过滤和颜色
app.json — 排除插件目录
appearance.json — 启用 CSS

跑完后，打开 Obsidian → Manage Vaults → Open folder as vault，选中 claude-obsidian 文件夹。在同一个文件夹里打开 Claude Code，敲 /wiki 即可。

方式二：装成 Claude Code 插件

claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@agricidaniel-claude-obsidian

方式三：塞进现有 vault

如果已经有熟悉的 Obsidian vault，把项目里的 WIKI.md 复制到 vault 根目录，然后在 Claude Code 里贴：

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.

四、与同类产品对比

能力	claude-obsidian	Smart Connections	Copilot	SystemSculpt
自动整理笔记	✅ 创建实体/概念/交叉引用	❌	❌	❌
矛盾标记	✅ 自动标注矛盾并附来源	❌	❌	❌
会话记忆 hot cache	✅ 持久化	❌	❌	❌
vault 维护（lint）	✅ 8类检查	❌	❌	❌
自主研究循环	✅ 3轮搜索+归档	❌	❌	❌
方法论模式	✅ LYT/PARA/Zettelkasten	❌	❌	❌
思考框架	✅ 10原则循环	❌	❌	❌
多模型支持	✅ Claude/Gemini/Codex/Cursor/Windsurf	仅 Claude	多模型	多模型
画布可视化	✅	❌	❌	❌
多写作者安全	✅ 文件锁(v1.7+)	❌	❌	❌
引用来源	✅ 引用具体 wiki 页	引用相似笔记	引用笔记	引用笔记
批量摄入	✅ 并行 agent 处理	❌	❌	❌
开源协议	✅ MIT	MIT	免费增值	免费增值

claude-obsidian 是知识引擎，它每次交互都在扩建 vault，知识越积越厚。Smart Connections 是检索工具，Copilot 是聊天界面，干的不是一回事。

五、我的看法

适合谁

想搭一套能自己越积越厚的知识库，claude-obsidian 是比较好的选择。如果你只想在 Obsidian 里装个聊天机器人，偶尔问两句，Copilot 或者 Smart Chat 更合适——装完就能用，不用折腾 Claude Code。

几个不爽的地方

对 Claude Code 有依赖：换用 Cursor 或 Windsurf 的话得额外装一套 Claude Code，skill 体系是围绕 Claude Code 建的，其他工具链用起来没那么顺。
上手门槛比 Copilot 高：要懂 git、要配 Local REST API、要理解 vault 结构，纯小白可能卡在第一步。
自动研究循环有时过度搜索：窄技术问题跑了三轮，抓回来五十多页资料，归档了二十多个页面，有用的信息混在垃圾里，得自己挑一遍。

六、项目信息

项目	信息
GitHub	https://github.com/AgriciDaniel/claude-obsidian
Stars	⭐ 8.5K+（开源俩月）
协议	MIT
语言	TypeScript / Bash
依赖	Claude Code + Obsidian + Local REST API 插件