【claude-obsidian】打造越用越聪明的本地 AI 知识库，让每一次笔记都有迹可循
这是一个专为 AI 助手设计的本地优先知识管理系统。它解决了传统 AI 笔记工具“只存不连、缺乏溯源”的痛点，通过将零散资料转化为有链接、有来源引用的结构化知识库，让你的个人知识资产越用越有价值。
主要功能与特性
- 本地优先与数据掌控：知识库以普通的 Markdown 和 JSON 文件形式存在于本地目录，不依赖云端数据库，确保你对文件拥有绝对的所有权。
- 带上下文的来源捕获：在合成知识前，系统会保留原始资料的不可变副本，确保信息来源清晰可查。
- 基于证据的知识接地：为重要观点建立来源和声明台账，记录权威性、新鲜度及矛盾状态，有效避免 AI 产生无根据的幻觉。
- 丰富的内置技能（Skills）：提供 15 个协调工作的技能，涵盖知识库初始化、内容摄入、只读查询、死链与元数据检查（Lint）以及网页研究等完整工作流。
- 兼容主流笔记方法论：支持通用、LYT、PARA 和 Zettelkasten（卡片盒）等多种笔记组织模式，且切换模式只会影响新笔记路由，不会破坏原有笔记结构。
- 安全的事务架构：采用严格的并发控制和可恢复事务机制，防止多进程同时写入导致的数据冲突或静默覆盖。
安装与使用示例
项目提供了清晰的命令行工具来管理知识库。以下是核心的安装与启动步骤：
- 获取项目代码：
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 哈希值，并再次运行命令加上 --approved-plan-sha256 <HASH> --apply 参数以真正应用更改。
- 在 Obsidian 中打开该目录，并通过命令行启动 AI 助手加载本地插件：
cd "$HOME/Documents/MyKnowledgeVault"
claude --plugin-dir /absolute/path/to/claude-obsidian
- 基础使用示例：
在助手中输入/claude-obsidian:wiki初始化路由；将资料放入inbox/文件夹后，调用/claude-obsidian:wiki-ingest进行知识摄入；或使用/claude-obsidian:wiki-query基于已有证据进行提问。
适用场景与目标用户
- 适用场景：适合需要长期积累、高度结构化且要求严格来源引用的知识管理场景。例如学术研究、技术文档沉淀、复杂项目调研，以及需要结合 Obsidian 进行可视化知识图谱探索的工作流。
- 目标用户：主要面向 Obsidian 重度用户、注重数据隐私与本地文件所有权的知识工作者，以及使用 Claude Code 等 AI 助手并希望将其与个人知识库深度打通的开发者。
总结
总体而言，这是一个架构严谨、注重数据安全和来源追溯的知识管理工具。它没有盲目追求 AI 的自动生成，而是强调“证据、连接与复用”，通过规范化的工作流让知识库保持健康和高可用性，非常适合希望构建高质量、可信赖个人知识库的用户。
