🧠 Claude Obsidian：5k Stars，让 Claude Code 当你的 Obsidian 知识管家
> 项目地址：[GitHub](https://github.com/AgriciDaniel/claude-obsidian) | ⭐ 5k Stars | 🛠 Python | 作者 AgriciDaniel
---
老实说，Obsidian 用户圈子里有个心照不宣的痛：笔记越记越多，但知识没涨。你每天剪藏、打标签、建双向链接，结果库还是那堆躺在文件夹里的 Markdown 文件。它们不会自己长出新东西。
claude-obsidian 干的事很简单——**让 Claude Code 当你 Obsidian 的私人知识管家**。你扔源材料，它自动提取实体、建概念页、维护交叉引用。每次问问题，它先读热缓存，再扫索引，最后钻具体页面，给你带引用的答案。
## 🛠 快速上手
最直接的方式是克隆 vault 然后开箱即用：
```bash
git clone https://github.com/AgriciDaniel/claude-obsidian
cd claude-obsidian
bash bin/setup-vault.sh
```
然后用 Obsidian 打开 `claude-obsidian/` 文件夹，在终端里 `claude` 进入同目录，输入 `/wiki`。它会自动帮你完成 vault 初始化。
如果想装成 Claude Code 插件，两步搞定：
```bash
claude plugin marketplace add AgriciDaniel/claude-obsidian
claude plugin install claude-obsidian@claude-obsidian-marketplace
```
## ⚡ 核心玩法
这玩意儿最骚的是那一套命令体系：
| 你说 | Claude 干 |
|------|-----------|
| `/wiki` | 初始化或继续上次进度 |
| `ingest [file]` | 读源文件，自动创建 8-15 个 wiki 页面 |
| `what do you know about X?` | 扫索引 → 钻页面 → 合成带引用的回答 |
| `/autoresearch [topic]` | 自主研究循环：搜索→抓取→总结→归档 |
| `lint the wiki` | 健康检查：孤立页、死链、缺失交叉引用 |
每个 session 结束时，它自动更新 `wiki/hot.md` 热缓存。下个 session 不用重复交代上下文。
## 🔧 MCP 集成（可选）
想让 Claude 直接读写 Obsidian 笔记而不需要手动复制粘贴，配 MCP 就行。**REST API 方式**（需要安装 Obsidian Local REST API 插件）：
```bash
claude mcp add-json obsidian-vault '{
"type": "stdio",
"command": "uvx",
"args": ["mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "your-key",
"OBSIDIAN_HOST": "127.0.0.1",
"OBSIDIAN_PORT": "27124",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}' --scope user
```
不想装插件？**文件系统方式**，直接用：
```bash
claude mcp add-json obsidian-vault '{
"type": "stdio",
"command": "npx",
"args": ["-y", "@bitbonsai/mcpvault@latest", "/path/to/your/vault"]
}' --scope user
```
## 🎯 跟其他 AI Obsidian 插件比
| 能力 | claude-obsidian | Smart Connections | Copilot |
|------|----------------|-------------------|---------|
| 自动组织笔记 | 创建实体、概念、交叉引用 | ❌ | ❌ |
| 矛盾标记 | `[!contradiction]` 引用来源 | ❌ | ❌ |
| Session 记忆 | 热缓存跨 session 持久化 | ❌ | ❌ |
| Vault 健康检查 | 8 类 lint（孤立页、死链、缺口） | ❌ | ❌ |
| 自主研究 | 3 轮 web 搜索 + 填补缺口 | ❌ | ❌ |
| 多模型支持 | Claude/Gemini/Codex/Cursor/Windsurf | Claude only | Multiple |
别问我怎么知道的——我试了市面上大部分方案，claude-obsidian 是唯一一个**真正帮你管理知识**而不是帮你搜笔记的。
- `/wiki` 一键初始化，读 `WIKI.md` 就能上手
- 每篇笔记自动带所属概念、实体、来源的交叉引用
- 跨 session 热缓存，不用重复交代上下文
- 8 类 lint 保证 vault 质量不滑坡
- MIT 协议，插件市场直接装 & 代码全开源
