什么是内容寻址捕获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-obsidianclaude-obsidian 是一个基于 Obsidian Claude Code 的自我组织 AI 第二大脑把任意来源文件丢进去AI 会自动阅读、建立链接并归档成一张你拥有的纯 Markdown 知识图谱。它的核心设计之一就是内容寻址捕获content-addressed capture——用文件内容的 SHA-256 摘要作为文件名生成一份永不篡改的原始来源副本。本文将带你完整理解这套不可变来源存储的原理与工作流程。什么是内容寻址捕获传统做法里文件靠文件名 路径来识别。而内容寻址换个思路用文件内容的哈希值来定义文件。在 claude-obsidian 中当你把一份资料放进inbox/并执行捕获后系统会读取文件全部字节计算 SHA-256 摘要source_identity将副本存入.raw/captured/目录文件名就是摘要值 原扩展名例如.raw/captured/3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b.md记录格式元数据PDF、图片、EPUB、纯文本等由 sniff_metadata 从文件头识别这样做带来三个直观好处同内容自动去重同一份资料放两次第二次会被识别为content-unchanged直接跳过篡改立刻现形文件名就是内容指纹一旦字节对不上系统报IMMUTABLE_SOURCE_CONFLICT冲突而不会静默覆盖跨设备一致内容相同摘要相同在任何机器上都能互相校验捕获流程先预览后落盘claude-obsidian 对所有写入操作坚持先出计划、人工审核、再执行的两阶段流程见 docs/install-guide.md第一步只读预检不写任何文件python3 scripts/claude-obsidian.py capture plan --vault vaultCLI 入口是 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 里藏着几道防线防线说明禁止符号链接来源和存储路径都是符号链接时直接报错SOURCE_SYMLINK防止被指到库外O_NOFOLLOW 打开文件打开文件描述符时拒绝跟随链接避免竞态中被换掉前后指纹比对哈希前后各取一次文件元数据设备号/inode/大小/mtime若哈希计算期间文件被改动报SOURCE_CHANGED预算限制单文件、总量、条目数都有上限CaptureBudget防止一次拖入巨量文件撑爆磁盘捕获之后从指纹到知识图谱不可变副本只是第一步。接下来wiki-ingest技能会把.raw/captured/里的来源变成带出处的笔记计算 SHA-256 身份、登记来源账本source ledger与主张账本claim ledger、生成互链页面并把每条重要结论回溯到具体证据详见 provenance 契约。最终在 Obsidian 里你的来源和笔记连成一张可视化图谱更宏观的知识地图则可以用 Canvas 呈现把索引、实体、概念、热缓存连成整体新手上手最短路径想亲自体验三步即可初始化一个独立 vaultpython3 scripts/claude-obsidian.py init 路径先预览再--apply把一份资料放进 vault 的inbox/目录依次执行capture plan和capture apply再调用/claude-obsidian:wiki-ingest完成归档完整步骤见 docs/install-guide.md架构细节见 docs/compound-vault-guide.md。关键文件速查模块作用claude_obsidian/capture.py内容寻址捕获核心哈希身份、元数据嗅探、去重与预算claude_obsidian/transaction.py可恢复事务create-only 写入、校验与回滚scripts/claude-obsidian.pyCLI 入口capture plan/capture applyskills/wiki-ingest/SKILL.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 Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 什么是内容寻址捕获？claude-obsidian不可变来源存储深度解析
什么是内容寻址捕获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-obsidianclaude-obsidian 是一个基于 Obsidian Claude Code 的自我组织 AI 第二大脑把任意来源文件丢进去AI 会自动阅读、建立链接并归档成一张你拥有的纯 Markdown 知识图谱。它的核心设计之一就是内容寻址捕获content-addressed capture——用文件内容的 SHA-256 摘要作为文件名生成一份永不篡改的原始来源副本。本文将带你完整理解这套不可变来源存储的原理与工作流程。什么是内容寻址捕获传统做法里文件靠文件名 路径来识别。而内容寻址换个思路用文件内容的哈希值来定义文件。在 claude-obsidian 中当你把一份资料放进inbox/并执行捕获后系统会读取文件全部字节计算 SHA-256 摘要source_identity将副本存入.raw/captured/目录文件名就是摘要值 原扩展名例如.raw/captured/3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b.md记录格式元数据PDF、图片、EPUB、纯文本等由 sniff_metadata 从文件头识别这样做带来三个直观好处同内容自动去重同一份资料放两次第二次会被识别为content-unchanged直接跳过篡改立刻现形文件名就是内容指纹一旦字节对不上系统报IMMUTABLE_SOURCE_CONFLICT冲突而不会静默覆盖跨设备一致内容相同摘要相同在任何机器上都能互相校验捕获流程先预览后落盘claude-obsidian 对所有写入操作坚持先出计划、人工审核、再执行的两阶段流程见 docs/install-guide.md第一步只读预检不写任何文件python3 scripts/claude-obsidian.py capture plan --vault vaultCLI 入口是 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 里藏着几道防线防线说明禁止符号链接来源和存储路径都是符号链接时直接报错SOURCE_SYMLINK防止被指到库外O_NOFOLLOW 打开文件打开文件描述符时拒绝跟随链接避免竞态中被换掉前后指纹比对哈希前后各取一次文件元数据设备号/inode/大小/mtime若哈希计算期间文件被改动报SOURCE_CHANGED预算限制单文件、总量、条目数都有上限CaptureBudget防止一次拖入巨量文件撑爆磁盘捕获之后从指纹到知识图谱不可变副本只是第一步。接下来wiki-ingest技能会把.raw/captured/里的来源变成带出处的笔记计算 SHA-256 身份、登记来源账本source ledger与主张账本claim ledger、生成互链页面并把每条重要结论回溯到具体证据详见 provenance 契约。最终在 Obsidian 里你的来源和笔记连成一张可视化图谱更宏观的知识地图则可以用 Canvas 呈现把索引、实体、概念、热缓存连成整体新手上手最短路径想亲自体验三步即可初始化一个独立 vaultpython3 scripts/claude-obsidian.py init 路径先预览再--apply把一份资料放进 vault 的inbox/目录依次执行capture plan和capture apply再调用/claude-obsidian:wiki-ingest完成归档完整步骤见 docs/install-guide.md架构细节见 docs/compound-vault-guide.md。关键文件速查模块作用claude_obsidian/capture.py内容寻址捕获核心哈希身份、元数据嗅探、去重与预算claude_obsidian/transaction.py可恢复事务create-only 写入、校验与回滚scripts/claude-obsidian.pyCLI 入口capture plan/capture applyskills/wiki-ingest/SKILL.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 Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-obsidian创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考