什么是claude-obsidian？开源AI第二大脑完全入门指南

什么是claude-obsidian？开源AI第二大脑完全入门指南

【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian

claude-obsidian 是一个开源的AI 第二大脑项目，专为 Obsidian 和 Claude Code 设计。你只需把任何资料丢进 inbox，AI 就会自动阅读、建立链接，并将其归档到一个由纯 Markdown 文件组成的知识图谱中。它既是 AI 笔记工具，也是个人知识管理（PKM）系统，更是一个你可以完全拥有的开源 Notion 替代方案 🧠

claude-obsidian 解决什么问题？

大多数 AI 笔记工具止步于"把文字存下来"，然后笔记就沉睡了：

• 📥资料散落各处：PDF、网页、聊天记录，收藏了就忘
• 🔗笔记互不联系：知识无法互相引用，越用越乱
• ☁️数据被锁定：云笔记服务把数据放在别人的数据库里
• ⏱️对话即焚：和 AI 聊出来的洞见，关窗即消失

claude-obsidian 的思路完全不同：它围绕一个可重复的知识复利循环运转——保留来源、佐证论断、连接知识、再投入使用。你的知识库不是静态仓库，而是一个每次使用都变得更聪明的"活"系统。

它是如何工作的：从原料到知识图谱

整个工作流可以概括为四步：

1. 带上下文捕获——本地资料通过可见的inbox/目录进入，先保留不可变的内容寻址副本
2. 为每个论断建立出处——来源账本和论断账本记录权威、新旧、支持与矛盾证据
3. 连接所学内容——生成互相链接的页面、索引和内容地图（MOC）
4. 让知识库再次工作——查询、研究、检索、体检（lint），而不是每次都从零开始对话

最终产物依然是普通的 Markdown 文件夹，可以用 Obsidian 打开，也可以用任何编辑器打开——没有插件缓存，没有云端数据库。

在 Obsidian 的图谱视图中，你能直观看到笔记之间如何自动形成一张网状知识图谱，每个节点都是一篇由 AI 组织出来的 Markdown 笔记：

更进一步，它还能在 Obsidian Canvas 中生成可视化的知识地图，把来源、实体、概念和索引画成一张可交互的白板：

快速上手：3 步搭建你的 Obsidian AI 知识库

环境要求很简单：Python 3.11+、Obsidian（想要可视化体验时）、Bash。

第 1 步：获取项目

git clone https://gitcode.com/GitHub_Trending/cl/claude-obsidian cd claude-obsidian

第 2 步：初始化一个独立的知识库（Vault）

产品代码和你的知识库是严格分离的两部分。用内置脚本为知识库生成初始化计划，审阅后确认执行：

python3 scripts/claude-obsidian.py init ~/Documents/MyVault \ --generated-at <时间戳> --operation-id init-reviewed

新 Vault 会自动生成inbox/（资料入口）、wiki/（笔记与索引）、.claude-obsidian.json（身份配置）等目录，结构定义见 skills/wiki/SKILL.md。

第 3 步：打开 Obsidian，启动 Claude Code

在新目录中打开 Obsidian，用 Claude Code 加载本地插件，然后输入/claude-obsidian:wiki即可开始。之后的日常操作：把资料放进inbox/，调用/claude-obsidian:wiki-ingest让它消化入库；用/claude-obsidian:save保存洞见；用/claude-obsidian:wiki-query向知识库提问。

完整的安装细节、已有 Vault 的迁移（adopt）流程，都写在官方文档 docs/install-guide.md 中。

15 个核心技能：一套完整的 AI 笔记工作流

claude-obsidian 的核心是 15 个协同工作的技能（Skills），每个都可以直接调用，且共享同一套证据与写入规则：

每个技能的行为契约都写在各自的SKILL.md中（如skills/wiki-ingest/SKILL.md），想深入了解某个技能的触发词和规则，直接看对应文件即可。

为什么是本地优先：你的数据真正属于你

这是 claude-obsidian 与云笔记最大的区别：

• 🔒Vault 是你的普通目录——Markdown、JSON、来源文件，随时可以备份、迁移、用 Git 管理
• 🛡️一次操作 = 一个可恢复的事务——记录 SHA-256 校验、备份日志、原子替换，写入失败会自动回滚，绝不静默覆盖
• ✅并行 Agent 不会互相抢写——工作线程只产出草稿，由单一编排者审查后应用一次事务
• 📡联网是显式决策——默认不上传任何内容，需要外发数据时必须有明确的同意计划

架构细节可以阅读 docs/compound-vault-guide.md，它清晰定义了产品包、用户 Vault 与运行时状态的边界。

4 种组织方式：按你的思维形状整理知识库

通过wiki-mode技能，你可以选择最适合自己思维方式的知识组织方法论，无需批量搬动已有笔记：

四种模式的完整对比见 docs/methodology-modes-guide.md。切换模式只改变新笔记的路由方式，老内容原封不动。

claude-obsidian 适合谁？

• ✍️PKM 玩家：想摆脱云笔记锁定，把知识主权收回本地
• 📚重度资料收藏者：读过的 PDF、网页、笔记终于能被"消化"而不是囤积
• 💻Claude Code 用户：让 AI 助手拥有持久记忆，而不是每次从零开始
• 🔍Notion 逃离者：想要一个开源、纯 Markdown 的结构化替代方案

需要提醒：它不是自动转录器，不是云同步服务，也不是事实 Oracle——高风险结论需要两个独立来源佐证，找不到证据时它宁可明确拒绝，也不编造引用。

总结：今天就开启你的 AI 第二大脑

claude-obsidian 把"AI 读资料 → 建链接 → 成图谱 → 可查询"做成了一个可靠、本地、可恢复的循环。它基于 Andrej Karpathy 的 LLM Wiki 模式，以 MIT 协议开源，所有文件都是你随时能读、能带走的纯 Markdown。

下一步很简单：clone 仓库、初始化一个 Vault、把第一份资料丢进inbox/，然后看着你的知识图谱长出来 ✨

【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian + Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian