claude-obsidian：让 Obsidian 知识库有来源、能检索、会持续生长
一分钟看懂
claude-obsidian 是面向 Claude Code 与兼容 Agent Skills 主机的本地优先知识系统。它把原始资料保留、证据标注、概念连接、旧知识检索和知识库维护组成可重复流程。最终资产仍是你拥有的 Markdown、JSON、Canvas 与源文件，可脱离插件使用。
你可以用它做什么
- 从 inbox 采集本地资料，保留内容寻址的原始副本并生成带引用笔记。
- 只依据库中证据回答，保留支持、冲突、置信度与复核状态。
- 建立 MOC、Canvas，并采用 LYT、PARA、Zettelkasten 等整理方式。
- 检查死链、孤立笔记、元数据缺口和陈旧索引。
主要能力
15 个 Skills 覆盖初始化、保存、采集、查询、lint、研究、Canvas、网页清洗和检索。写入采用“预览计划—核对哈希—显式应用”的事务模型，支持锁、原子替换与中断恢复，检测到文件漂移就拒绝覆盖。网络访问、Git 检查点和破坏性修复都需明确动作。
适合哪些人
适合把 Obsidian 当长期研究库、希望 AI 答案可追溯的研究者、写作者和知识工作者，也适合重视本地文件所有权和多 Agent 写入安全的开发者。
怎么开始使用
克隆仓库，用 Python 3.11+ 运行 scripts/claude-obsidian.py init <目录> 生成计划，审阅 SHA-256 后携带该哈希与 --apply 写入。在 Obsidian 打开新目录，从该目录加载 Claude Code 插件并调用 /claude-obsidian:wiki。现有库应使用文档中的非破坏性 adopt 流程。
使用前需要知道
它不是自动转写、云同步、事实裁判或备份服务。PDF/EPUB 目前主要记录元数据；URL、YouTube、OCR 需要额外 runner 与授权。Windows 原生只保证只读检查和 dry-run，写入要求 WSL。接入旧库前务必备份或启用版本控制。