claude-obsidian：给你的 Obsidian 装上「自我进化」的 AI 第二大脑（13k Star）-无双技术网

你有没有过这种体验：收藏了无数网页、笔记散落在各处，等到真正要用的时候，却想不起来它们在哪里、又彼此有什么关联？大多数 AI 笔记工具的流程止步于「把文字存下来」，存完之后就成了一堆孤岛。今天要介绍的这个 GitHub Trending 项目 claude-obsidian，思路完全不同——它把「存」这件事升级成了一个可持续复利的知识循环。

它是什么

claude-obsidian 是一套 本地优先（local-first） 的知识管理系统，为 Claude Code 以及兼容 Agent Skills 标准的宿主编写的。它可以把任意来源的材料转成带链接、带出处引用的 Obsidian 页面，并基于 vault 里已有的证据回答问题。上线短短几个月已经攒下 13,000+ Star，被不少人称为「开源版 Notion 的替代方案」。

最关键的定位：你的 vault 始终是一个普通的 Markdown / JSON / 源文件目录，不会被偷偷塞进插件缓存、锁进云数据库，也不会静默上传给某个大模型。文件的所有权，完完全全在你手里。

核心特色

来源不丢失：笔记会回链到持久的 source 证据，凡是没被支持的、甚至互相矛盾的说法都会保留可见，而不是被「自信地」编造掉。
每条重要主张都有出处：source 与 claim 账本记录权威性、时效性、支持/矛盾程度、置信度和审阅状态。
知识刻意复利：摄取、检索、lint、研究、rollup 共用同一套 provenance（出处）模型，而不是每次对话从零开始。
并行 agent 不会「打架」：worker 只返回草稿，由单个 orchestrator 检查后一次性应用一个可回滚的事务。
能力边界诚实：可选工具会被探测、成熟度会被声明，缺失的适配器会清晰降级，而不是假装支持。

一段可复用的知识循环

项目围绕一个可重复的循环组织：保留源 → 坐实主张 → 连接知识 → 再反哺使用。

带上下文捕获：本地来源先经过一个可见的 inbox，保存不可变的、内容寻址（content-addressed）的副本，再进行综合。
坐实每一条重要主张：靠 source/claim 账本记录。
连接所学：构建带链接的页面、索引、MOC（Map of Content）、方法学感知的结构，以及 Obsidian Canvas 视图。
反复使用 vault：查询、研究、检索、lint、折叠已有知识，而不是张口就问。

15 个技能，一套系统

这些技能既小到可以直接调用，又协调到共享同一套证据、vault 选择和变更规则：

构建与使用 wiki：wiki（初始化/接管 vault）、save（保存一个界定清晰的答案，而非自动转录）、wiki-ingest（把来源变成带链接的页面）、wiki-query（只读、基于 vault 证据回答）、wiki-lint（报告死链、孤儿页面、元数据缺口、过期索引、空 section）。
扩展工作流：autoresearch（受限联网研究）、canvas（Canvas 创建维护）、defuddle（清洗网页正文）、wiki-fold（可追溯的日志 rollup）、wiki-mode（Generic/LYT/PARA/Zettelkasten 归档约定）、wiki-retrieve（上下文前缀 + BM25 + 可选 cosine 重排）、wiki-cli（Obsidian CLI 读写）。
参考技能：obsidian-markdown、obsidian-bases、think（一套结构化的观察-倾听-连接-创造-成长复盘循环）。

快速上手

最安全的第一步是用源码 checkout + 一个独立的用户 vault，所有会改写的命令都会先预览它要做的确切操作。

git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian

初始化一个独立 vault：

export GENERATED_AT="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
export OPERATION_ID="init-reviewed"

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"

审阅生成的 JSON 计划，复制其中的 approved_plan_sha256，再应用这个精确的操作：

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID" \
  --approved-plan-sha256 "<sha256-from-the-plan>" --apply

然后在 Obsidian 里打开这个目录，从该目录启动带本地插件的 Claude Code：

cd "$HOME/Documents/MyKnowledgeVault"
claude --plugin-dir /absolute/path/to/claude-obsidian

接着用 /claude-obsidian:wiki 开始，往 inbox/ 里放一份来源，调用 /claude-obsidian:wiki-ingest 摄入；用 /claude-obsidian:save 显式保存答案，用 /claude-obsidian:wiki-query 询问 vault。