企业官网建设流程全解析

什么是内容寻址捕获？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 Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian

claude-obsidian 是一个基于 Obsidian + Claude Code 的自我组织 AI 第二大脑：把任意来源文件丢进去，AI 会自动阅读、建立链接并归档成一张你拥有的纯 Markdown 知识图谱。它的核心设计之一，就是"内容寻址捕获"（content-addressed capture）——用文件内容的 SHA-256 摘要作为文件名，生成一份永不篡改的原始来源副本。本文将带你完整理解这套不可变来源存储的原理与工作流程。

什么是内容寻址捕获？

传统做法里，文件靠"文件名 + 路径"来识别。而内容寻址换个思路：用文件内容的哈希值来定义文件。

在 claude-obsidian 中，当你把一份资料放进inbox/并执行捕获后，系统会：

1. 读取文件全部字节，计算 SHA-256 摘要（source_identity）
2. 将副本存入.raw/captured/目录，文件名就是摘要值 + 原扩展名，例如：

.raw/captured/3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b.md

3. 记录格式元数据（PDF、图片、EPUB、纯文本等由 sniff_metadata 从文件头识别）

这样做带来三个直观好处：

• 📌同内容自动去重：同一份资料放两次，第二次会被识别为content-unchanged直接跳过
• 📌篡改立刻现形：文件名就是内容指纹，一旦字节对不上，系统报IMMUTABLE_SOURCE_CONFLICT冲突而不会静默覆盖
• 📌跨设备一致：内容相同，摘要相同，在任何机器上都能互相校验

捕获流程：先预览，后落盘

claude-obsidian 对所有写入操作坚持"先出计划、人工审核、再执行"的两阶段流程（见 docs/install-guide.md）：

第一步：只读预检（不写任何文件）

python3 scripts/claude-obsidian.py capture plan --vault <vault>

CLI 入口是 scripts/claude-obsidian.py，预检会输出 JSON 计划：每个来源的摘要、目标路径、是否会变更、跳过原因，以及一个approved_plan_sha256指纹。

第二步：确认计划无误后落盘

python3 scripts/claude-obsidian.py capture apply --vault <vault> \ --approved-plan-sha256 <审核过的指纹> --apply

所有新副本通过一个可恢复的事务一次性提交（capture_filesystem_batch），中断也能回滚。而且捕获过程从不删除 inbox 里的原文件——原始材料永远归你所有。

不可变与去重：create-only 语义

来源存储只允许"创建"，不允许"修改"。核心逻辑在 _find_existing_capture：

• 目标摘要文件已存在 → 重新校验字节，一致则复用（skip_reason: content-unchanged）
• 目标摘要文件存在但字节不匹配 → 抛出IMMUTABLE_SOURCE_CONFLICT，拒绝执行

批量计划生成时（plan_filesystem_batch），同一批次内出现重复内容也只写入一次。远程来源更新了？它会获得一个新的不可变副本，而不是覆盖旧的——这正是 skills/wiki-ingest/SKILL.md 中强调的规则："Never replace or edit an existing raw payload"。

安全细节：符号链接、竞态与预算

看似简单的"拷贝文件"，source_identity 里藏着几道防线：

捕获之后：从指纹到知识图谱

不可变副本只是第一步。接下来wiki-ingest技能会把.raw/captured/里的来源变成带出处的笔记：计算 SHA-256 身份、登记来源账本（source ledger）与主张账本（claim ledger）、生成互链页面，并把每条重要结论回溯到具体证据（详见 provenance 契约）。

最终在 Obsidian 里，你的来源和笔记连成一张可视化图谱：

更宏观的知识地图则可以用 Canvas 呈现，把索引、实体、概念、热缓存连成整体：

新手上手最短路径

想亲自体验？三步即可：

1. 初始化一个独立 vault：python3 scripts/claude-obsidian.py init <路径>（先预览再--apply）
2. 把一份资料放进 vault 的inbox/目录
3. 依次执行capture plan和capture apply，再调用/claude-obsidian:wiki-ingest完成归档

完整步骤见 docs/install-guide.md，架构细节见 docs/compound-vault-guide.md。

关键文件速查

一句话总结：内容寻址捕获让每一份来源都拥有"身份证"（SHA-256 指纹），不可变、可去重、可校验——这正是 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 Karpathy's LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian