claude-obsidian Compound Vault架构深潜4个角色与4层知识分层【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidianclaude-obsidian 是一个开源的 AI 第二大脑项目它把 Claude Code 与 Obsidian 结合成一套Compound Vault复利知识库架构你丢进任何资料AI 负责阅读、建链、归档最终沉淀成一张由纯 Markdown 构成的、完全属于你的知识图谱。本文面向新手带你快速看懂 Compound Vault 的4个角色分工与4层知识分层搞懂这套个人知识管理PKM系统为什么越用越好用。为什么需要 Compound Vault 架构普通 AI 笔记工具的问题聊天记录一关就丢知识散落在各个对话里无法复利。claude-obsidian 的思路相反——知识库是本地普通文件夹不是云数据库也不是插件缓存 你的库就是一堆 Markdown 和 JSON 文件随时可用 Git 备份 每条重要结论都能回溯到原始来源source-cited 摄入、查询、体检、检索共享同一套证据模型知识持续复利完整架构文档见 docs/compound-vault-guide.md人类可读的库结构规范在 WIKI.md。4个角色产品代码和你的知识库严格分离Compound Vault 的第一步就是划清界限。架构里定义了 4 个角色各管各的互不污染角色装什么谁可以改产品包Product package技能、Python 核心、脚本、钩子、模板仅产品开发流程用户库User vault笔记、来源、账本、Obsidian 设置经审阅的库操作派生运行时Derived runtime锁、日志、检索索引、采集队列库内本地可恢复/可再生公共发行物Public artifact白名单产品文件 合成示例从干净 Git 快照重建对新手最关键的一点你 clone 下来的产品仓库不是你的知识库。安装插件缓存永远只是产品代码绝不会变成你的库。库的选位必须显式通过--vault参数或配置文件选位不明时命令直接退出、拒绝写入——这是防误写的第一道保险。4层知识分层从 inbox 到 .vault-meta打开任何 Compound Vault目录都是同一套 4 层结构每层职责单一vault/ ├── inbox/ # ① 可见的来源收件箱绝不自动删除 ├── .raw/ # ② 不可变的来源字节内容寻址 ├── wiki/ # ③ 生成的知识页面index、log、hot、账本 │ ├── sources/ ├── concepts/ │ ├── entities/ ├── questions/ │ └── meta/ledgers/ # 来源账本 结论账本 ├── .obsidian/ # Obsidian 设置你控制 └── .vault-meta/ # ④ 运行时锁、日志、索引、队列①inbox/— 收件箱可见、你控制的入口。资料丢进来系统绝不会自动删掉它删除权永远在你手里。②.raw/— 不可变原始层按 SHA-256 内容寻址存储原始字节已存在的原始数据永不被替换。摘要可以随时重算但证据原件不会变。③wiki/— 知识层AI 生成的可导航知识核心有 4 个页面index.md目录与导航每条链接必须可解析log.md已完成操作的流水账最新在前hot.md有界的热上下文缓存为下一次会话准备不是聊天记录overview.md低频变更的高层综合④.vault-meta/— 运行时层锁、事务日志、检索索引、队列。新建库会自动生成.gitignore把它整体排除因为日志里可能含笔记文本和本地路径不该进版本库。 记住这个心智模型来源只进不改.raw知识可生长wiki运行时可丢弃.vault-meta。一次操作一笔事务写入安全机制Compound Vault 最硬核的设计是任何一次逻辑修改保存、摄入、折叠、画布更新、研究合并 一笔可恢复的事务。并行 AI 工作者只产出草稿最终由一个编排者检查并应用唯一的事务包流程是读取所有目标文件记录当前 SHA-256并行工作者各自返回草稿与证据不做共享写入合并为单一操作包schemaclaude-obsidian.transaction.v1先inspect无变更检查再凭批准哈希apply一次报告操作 ID 与精确变更路径引擎会记录原始备份、校验内容哈希、原子替换文件失败或中断后可用transaction recover恢复原状并发改动会返回冲突码 75绝不静默覆盖。事务契约详见 skills/wiki/references/operation-transactions.md核心实现在 claude_obsidian/transaction.pyCLI 入口是 scripts/claude-obsidian.py。证据账本让每条知识可溯源Compound Vault 的知识分层不止于目录还延伸到证据本身。wiki/meta/ledgers/下有两本账来源账本source-ledger.json记录每个来源的身份哈希、权威性官方/一手/二手/社区、独立性、新鲜度、审阅状态结论账本claim-ledger.json记录可证伪的结论及其支撑、矛盾来源、置信度与风险等级规则很严格被接受的结论必须有活跃、新鲜、非合成的支撑高风险结论需要两个独立来源矛盾证据永远保持可见无支撑是合法状态编造引用则不是。溯源契约见 skills/wiki/references/provenance.md。在 Obsidian 中查看你的 Compound Vault架构的终点是可视化。在 Obsidian 中打开你的库Compound Vault 立刻呈现为两种视图Graph 视图让你一眼看到哪些笔记是枢纽、哪些页面孤悬——配合wiki-lint技能可以定期体检出死链与孤儿页。Canvas 画布则把 index、overview、hot、log 等核心页面组织成一张可编辑的知识地图canvas技能会自动维护它。上手路径与参考文档你想做的事入口初始化或接管一个库skills/wiki/SKILL.md把来源变成带引用的页面skills/wiki-ingest/SKILL.md只读查询知识库skills/wiki-query/SKILL.md体检死链、孤儿页、过期索引skills/wiki-lint/SKILL.md看一套完整示例库examples/sample-vault/wiki/index.md新库模板templates/vault/一句话总结Compound Vault 用 4 个角色保证产品不碰你的数据用 4 层目录保证证据、知识、运行时互不污染再用一笔一操作的可恢复事务保证写入安全——这就是 claude-obsidian 让知识库真正产生复利的架构底座。【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 claude-obsidian Compound Vault架构深潜：4个角色与4层知识分层
claude-obsidian Compound Vault架构深潜4个角色与4层知识分层【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidianclaude-obsidian 是一个开源的 AI 第二大脑项目它把 Claude Code 与 Obsidian 结合成一套Compound Vault复利知识库架构你丢进任何资料AI 负责阅读、建链、归档最终沉淀成一张由纯 Markdown 构成的、完全属于你的知识图谱。本文面向新手带你快速看懂 Compound Vault 的4个角色分工与4层知识分层搞懂这套个人知识管理PKM系统为什么越用越好用。为什么需要 Compound Vault 架构普通 AI 笔记工具的问题聊天记录一关就丢知识散落在各个对话里无法复利。claude-obsidian 的思路相反——知识库是本地普通文件夹不是云数据库也不是插件缓存 你的库就是一堆 Markdown 和 JSON 文件随时可用 Git 备份 每条重要结论都能回溯到原始来源source-cited 摄入、查询、体检、检索共享同一套证据模型知识持续复利完整架构文档见 docs/compound-vault-guide.md人类可读的库结构规范在 WIKI.md。4个角色产品代码和你的知识库严格分离Compound Vault 的第一步就是划清界限。架构里定义了 4 个角色各管各的互不污染角色装什么谁可以改产品包Product package技能、Python 核心、脚本、钩子、模板仅产品开发流程用户库User vault笔记、来源、账本、Obsidian 设置经审阅的库操作派生运行时Derived runtime锁、日志、检索索引、采集队列库内本地可恢复/可再生公共发行物Public artifact白名单产品文件 合成示例从干净 Git 快照重建对新手最关键的一点你 clone 下来的产品仓库不是你的知识库。安装插件缓存永远只是产品代码绝不会变成你的库。库的选位必须显式通过--vault参数或配置文件选位不明时命令直接退出、拒绝写入——这是防误写的第一道保险。4层知识分层从 inbox 到 .vault-meta打开任何 Compound Vault目录都是同一套 4 层结构每层职责单一vault/ ├── inbox/ # ① 可见的来源收件箱绝不自动删除 ├── .raw/ # ② 不可变的来源字节内容寻址 ├── wiki/ # ③ 生成的知识页面index、log、hot、账本 │ ├── sources/ ├── concepts/ │ ├── entities/ ├── questions/ │ └── meta/ledgers/ # 来源账本 结论账本 ├── .obsidian/ # Obsidian 设置你控制 └── .vault-meta/ # ④ 运行时锁、日志、索引、队列①inbox/— 收件箱可见、你控制的入口。资料丢进来系统绝不会自动删掉它删除权永远在你手里。②.raw/— 不可变原始层按 SHA-256 内容寻址存储原始字节已存在的原始数据永不被替换。摘要可以随时重算但证据原件不会变。③wiki/— 知识层AI 生成的可导航知识核心有 4 个页面index.md目录与导航每条链接必须可解析log.md已完成操作的流水账最新在前hot.md有界的热上下文缓存为下一次会话准备不是聊天记录overview.md低频变更的高层综合④.vault-meta/— 运行时层锁、事务日志、检索索引、队列。新建库会自动生成.gitignore把它整体排除因为日志里可能含笔记文本和本地路径不该进版本库。 记住这个心智模型来源只进不改.raw知识可生长wiki运行时可丢弃.vault-meta。一次操作一笔事务写入安全机制Compound Vault 最硬核的设计是任何一次逻辑修改保存、摄入、折叠、画布更新、研究合并 一笔可恢复的事务。并行 AI 工作者只产出草稿最终由一个编排者检查并应用唯一的事务包流程是读取所有目标文件记录当前 SHA-256并行工作者各自返回草稿与证据不做共享写入合并为单一操作包schemaclaude-obsidian.transaction.v1先inspect无变更检查再凭批准哈希apply一次报告操作 ID 与精确变更路径引擎会记录原始备份、校验内容哈希、原子替换文件失败或中断后可用transaction recover恢复原状并发改动会返回冲突码 75绝不静默覆盖。事务契约详见 skills/wiki/references/operation-transactions.md核心实现在 claude_obsidian/transaction.pyCLI 入口是 scripts/claude-obsidian.py。证据账本让每条知识可溯源Compound Vault 的知识分层不止于目录还延伸到证据本身。wiki/meta/ledgers/下有两本账来源账本source-ledger.json记录每个来源的身份哈希、权威性官方/一手/二手/社区、独立性、新鲜度、审阅状态结论账本claim-ledger.json记录可证伪的结论及其支撑、矛盾来源、置信度与风险等级规则很严格被接受的结论必须有活跃、新鲜、非合成的支撑高风险结论需要两个独立来源矛盾证据永远保持可见无支撑是合法状态编造引用则不是。溯源契约见 skills/wiki/references/provenance.md。在 Obsidian 中查看你的 Compound Vault架构的终点是可视化。在 Obsidian 中打开你的库Compound Vault 立刻呈现为两种视图Graph 视图让你一眼看到哪些笔记是枢纽、哪些页面孤悬——配合wiki-lint技能可以定期体检出死链与孤儿页。Canvas 画布则把 index、overview、hot、log 等核心页面组织成一张可编辑的知识地图canvas技能会自动维护它。上手路径与参考文档你想做的事入口初始化或接管一个库skills/wiki/SKILL.md把来源变成带引用的页面skills/wiki-ingest/SKILL.md只读查询知识库skills/wiki-query/SKILL.md体检死链、孤儿页、过期索引skills/wiki-lint/SKILL.md看一套完整示例库examples/sample-vault/wiki/index.md新库模板templates/vault/一句话总结Compound Vault 用 4 个角色保证产品不碰你的数据用 4 层目录保证证据、知识、运行时互不污染再用一笔一操作的可恢复事务保证写入安全——这就是 claude-obsidian 让知识库真正产生复利的架构底座。【免费下载链接】claude-obsidianSelf-organizing AI second brain for Obsidian Claude Code. Drop any source and Claude reads, links, and files it into one connected knowledge graph of plain Markdown you own. AI note-taking, personal knowledge management (PKM), and an open-source Notion alternative. Based on Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考