BAIZE AI RESOURCE

本地优先的 AI 知识库

Claude-obsidian

claude-obsidian 是本地优先的 Obsidian 知识库系统，可将资料转为带引用的关联笔记，并支持检索、研究与维护 Markdown 知识库。

获取资源
Claude-obsidian

资源介绍

claude-obsidian 是一套本地优先的知识系统，以 Claude Code 插件与 Agent Skills 形式提供，把原始资料转化为相互链接、带来源引用的 Obsidian 页面，并让后续问答基于知识库中已有的证据作答。它围绕“保留来源—标注依据—连接知识—再次使用”的循环组织工作：资料先进入可见的 inbox 并保留不可变的内容寻址副本，再通过来源与论断台账记录权威性、时效、支持与矛盾状态，最后生成链接页面、索引、MOC 与 Canvas 视图。所有写入都通过可恢复的事务先预览再应用，并行 Agent 只产出草稿，由单一编排者提交，避免并发写坏知识库。知识库本身是普通的 Markdown、JSON 与源文件目录，不藏在插件缓存或云端数据库中。它适合希望长期积累个人或团队知识、又要求文件自主可控的 Obsidian 与 Claude Code 用户。

Skill 能力

来源可追溯的知识沉淀

在知识沉淀过程中保留来源证据：笔记会指回持久化的源材料，来源与主张账本记录权威性、时效性、支持与矛盾关系及置信度，使不受支持或相互矛盾的主张保持可见，避免摘要后丢失原始出处。

事务化的安全写入

将 vault 写入操作封装为可恢复的事务：并行 worker 只返回草稿，由单一 orchestrator 检查并以一个事务应用变更，避免多个 agent 同时写入造成冲突；每次应用前需先 inspect 事务并凭审批哈希执行。

多技能协同工作流

将采集、检索、研究、维护与可视化映射等多项技能组织为同一套可重复的知识循环：先保留来源并建立可追溯的证据账本，再生成相互链接的 Obsidian 页面，随后通过查询、研究与检索复用已有知识，并用 Canvas 画布进行可视化映射；各技能共享同一套来源与声明溯源模型，并行代理只返回草稿，由单一编排器检查并以可恢复事务的方式统一写入仓库。

本地优先与显式网络边界

该能力让知识库默认以本地普通 Markdown、JSON 和源文件形式保存在用户自有目录中，不隐藏于插件缓存、云数据库或静默上传给模型；网络访问作为独立且需明确同意的决策，例如 autoresearch 技能在未获出站许可时只检索所选 vault 与用户提供的来源，canvas 的链接节点仅接受 HTTPS 且不因创建 JSON 而发起请求。

并行 Agent 与单一编排者

在 autoresearch 研究循环中，并行 Agent 负责搜索并返回来源记录、证据与页面草稿，但不会修改 vault、预留地址或合并规范页面；由单一编排者去重证据、解决草稿冲突，并统一执行可恢复的事务。

资源配置

适用平台

Claude CodeCodexCursorGemini CLI通用 Agent

支持模型

Claude模型无关

调用方式

自动触发手动调用命令调用

安装与调用

  1. 在本地 Obsidian 仓库中安装 claude-obsidian，并配置 Agent 可访问的知识库目录。

  2. 导入要整理的 Markdown、网页摘录或研究资料，先建立来源和笔记之间的关联。

  3. 在对话中提出检索、摘要、主题研究或知识库维护任务，让技能生成带引用的笔记。

  4. 检查引用是否能回到原始资料，并在批量改动前备份知识库，避免覆盖已有人工笔记。

使用案例

资料采集与建库

使用场景把本地文档或网页资料整理进 Obsidian 知识库

将来源放入 inbox/ 后调用 wiki-ingest，系统保留不可变副本、生成带引用的来源页与概念页，并在同一事务中更新索引与日志。

基于知识库问答

使用场景需要从已有笔记中获得有依据的回答

使用 wiki-query 或 wiki-retrieve 检索知识库中已有证据作答，而不是每次对话从零开始。

有边界的研究任务

使用场景围绕某主题做深度调研并归档

autoresearch 在用户确认主题、出口授权与预算后执行有限轮次研究，产出带引用的草稿档案，合并进正式知识库需另行审核。

可视化知识地图

使用场景用 Obsidian Canvas 组织笔记与主题

canvas 技能创建和更新 .canvas 看板，添加文本、文件、链接与分组节点，并通过事务预览后应用。

包含内容

claude-obsidian-source.zip
LICENSE-MIT.txt
README-中文安装说明.md
SHA256.txt

常见问题

claude-obsidian 会把我的笔记上传到云端吗？
默认不会。知识库是本地普通文件目录，网络出口是单独的显式决定；涉及外部抓取或研究时需要用户明确授权，并受域名与预算限制。
它和普通 AI 笔记工具有什么区别？
它围绕可追溯性组织：来源与论断台账保留权威性、时效与矛盾状态，笔记中的关键论断可回溯到持久化证据，而不是只保存一段摘要文本。
支持哪些使用环境？
以 Claude Code 插件形式提供，同时兼容 Agent Skills 主机；仓库还提供 Codex、OpenCode、Gemini、ZCode 的便携技能链接脚本，Cursor 与 Windsurf 使用工作区级技能发现。
写入知识库时如何避免误改文件？
所有变更先构建事务包并 inspect 预览，核对 SHA-256 前置条件后再 apply；冲突会报错，中断可用 transaction recover 恢复，不会绕过失败直接写入。