claude-obsidian

claude-obsidian 是一款让 Claude Code 与 Obsidian 联动、实现自我组织的 AI 知识管理插件。用户只需向文件夹放入任意来源（PDF、网页、笔记、文档），Claude 就会自动读取、提炼实体与概念、建立双向链接，并将整理好的内容写入 Obsidian 的纯 Markdown 笔记库。整个过程无需手动分类，笔记库会随使用不断积累、越来越"懂"你。

与传统 AI 笔记插件（仅做问答）不同，claude-obsidian 是一个知识引擎——它主动创建、组织、维护和演化笔记，而不是被动回答关于已有笔记的问题。其核心特点包括：自动建立实体间关联，形成知识图谱；内置热缓存机制（hot.md）在会话间保持上下文记忆；提供 8 类别维护检查（孤儿页面、死链、空白段等）；支持 3 轮自主网络研究循环（/autoresearch）；兼容 LYT、PARA、Zettelkasten、Generic 四种知识整理方法论；多写者安全（v1.7+ 引入每文件 advisory 锁）。

检索层面采用混合策略：上下文前缀 + BM25 关键词 + 余弦重排，基于 Anthropic 2024 年 9 月的上下文检索研究，v1.9 评测中 top-1 准确率相比 v1.6 基准提升 32 个百分点。输出为纯本地 Markdown 文件，不依赖任何数据库或云服务，笔记完全自主可控，五年后换工具也能无缝迁移。

安装方式：在 Claude Code 中执行 claude plugin marketplace add AgriciDaniel/claude-obsidian 然后 claude plugin install claude-obsidian@agricidaniel-claude-obsidian；或 git clone 后 bash bin/setup-vault.sh 用 Obsidian 打开生成的文件夹即可。MIT 许可证，完全免费（仅需自备 Claude API 额度）。