claude-obsidian wiki-fold详解可追溯、幂等的日志折叠如何工作【免费下载链接】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 第二大脑你做的每次摄取、保存、研究都会被追加记录到wiki/log.md操作日志中。当日志越滚越长回顾历史就变得困难。wiki-fold技能正是为此而生它把最近一批日志条目压缩成一个可追溯、结构幂等的折叠页全程只读原日志、绝不改动任何子页面且默认先预览、经你确认后才以单笔事务落盘。为什么要折叠日志而不是删除它 ️日志是这个知识库的操作流水账例如样例库中的 log.md 记录了每次 fixture、ingest、save 动作。直接删旧日志会丢失审计线索而wiki-fold的思路是只新增、不改动extractive抽取式折叠页里的每一句话都必须能指向某条子日志条目不新增任何事实additive增量式子条目及其页面永不被修改、移动或删除幂等同一组输入永远生成同一个折叠页身份重复执行就是 no-op空操作先预览折叠页、目录、日志三处变更打包成一笔事务审阅通过后才应用。这一点在 docs/dragonscale-guide.md 中也被明确强调折叠页是导航辅助不是新证据——如果某次折叠不帮助回忆只需撤销这单个折叠操作即可原日志完好无损。确定性折叠 ID幂等性是如何实现的 幂等性来自一个关键设计折叠页的文件名完全由输入推导与执行时间、随机数无关。有界范围折叠按批次指数 k选取大小为 2^k 的连续日志条目默认 k416 条。可用条目不足时会如实报告缺口并停止绝不折叠不完整的批次结构性 ID由范围确定性地生成例如fold-k4-from-20260701-to-20260716-n16其中包含层级、起止日期和精确条目数存在即跳过若wiki/folds/{FOLD_ID}.md已存在直接返回 no-op。想替换必须显式 force 并单独审阅一份 replace 提案。也就是说你今天跑一次、明天对同一批条目再跑一次得到的折叠页身份完全一致——这就是结构幂等的含义。child_key 双射可追溯性的骨架 折叠页的 frontmatter 中有一个child_keys列表每条子日志条目对应一个确定性child_key日期 顺序号例如log-20260701-001。规则非常严格每个child_key在frontmatter 出现一次、正文 Child Entries 表格出现且仅出现一次形成双射每个结论Key Outcomes必须标注它引用的 child_key文中的每个数字都必须能在源条目中核实跨条目主题Cross-entry Themes必须列出至少两个贡献条目若子页面缺失保留显式的page_missing记录宁可写 source missing 也不臆造。下面是 fold-template.md 中 Child Entries 表格的样子一眼就能看出每条结论从哪来| Child key | Date | Op | Title | Page | Page state | Extractive summary | | log-20260701-001 | 2026-07-01 | ingest | Example source filed | [[Example Source]] | present | Added one source-backed example page. |正因为折叠不引入新证据它不会提升主张的置信度、也不会创建来源记录发现矛盾时只如实报告留待后续人工审阅。默认先预览确认后单笔事务落盘 ✅wiki-fold 的写入路径遵循 operation-transactions.md 定义的claude-obsidian.transaction.v1事务契约默认只预览返回完整草稿、折叠 ID、子条目范围、读取预算和拟变更路径不碰仓库任何文件你说应用/提交时生成一个operation_type: fold的事务包恰好耦合三处写入新建wiki/folds/{FOLD_ID}.mdcreate 模式wiki/index.md中的折叠目录条目wiki/log.md顶部一条新的折叠记录不更新hot.md三处目标都会记录SHA-256 前置条件先用 scripts/claude-obsidian.py 的transaction inspect审阅计划拿到approval_sha256后再transaction apply相同的事务包与操作 ID 是幂等的若 vault 已被其他操作改动退出码 75则重新读取并重建计划中断的应用可用transaction recover恢复或回滚。这套机制的核心是校验失败 一次写入都没发生折叠因此可以放心重试。折叠之后如何在图谱里定位结果 ️折叠页最终存放在wiki/folds/目录由wiki/index.md目录收录、wiki/log.md留痕与其他 wiki 页面一样参与双链。在 Obsidian 中整个 wiki 库包括日志、索引、折叠页都会形成一张可视化网络如果配合 Canvas 画布还可以看到log、index、overview等枢纽节点如何串联起各主题簇折叠页则像一个个章节摘要挂接在这张知识地图上另外Git 提交checkpoint是独立的可选动作不会在折叠时自动执行。如何触发 wiki-fold一句话就够 无需任何网络出口直接用自然语言触发即可常见触发语包括fold the log / run a foldlog rollup / roll up log entriescommit the fold表示审阅后应用触发后你会先看到完整草稿确认无误再让它提交整个过程就是预览 → 审阅 → 单笔事务三步。小结特性wiki-fold 的做法可追溯每个 child_key 双射到表格行每个结论标注来源条目幂等折叠 ID 纯由输入推导同输入同身份重复执行即 no-op安全默认 dry-run 预览SHA-256 前置校验失败零写入可恢复回滚无损子日志与页面永不改动折叠页只是导航辅助如果你想深入实现细节建议按顺序阅读skills/wiki-fold/SKILL.md技能契约→ skills/wiki-fold/references/fold-template.md页面模板→ skills/wiki/references/operation-transactions.md事务机制→ claude_obsidian/transaction.py事务引擎源码。【免费下载链接】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 wiki-fold详解：可追溯、幂等的日志折叠如何工作
claude-obsidian wiki-fold详解可追溯、幂等的日志折叠如何工作【免费下载链接】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 第二大脑你做的每次摄取、保存、研究都会被追加记录到wiki/log.md操作日志中。当日志越滚越长回顾历史就变得困难。wiki-fold技能正是为此而生它把最近一批日志条目压缩成一个可追溯、结构幂等的折叠页全程只读原日志、绝不改动任何子页面且默认先预览、经你确认后才以单笔事务落盘。为什么要折叠日志而不是删除它 ️日志是这个知识库的操作流水账例如样例库中的 log.md 记录了每次 fixture、ingest、save 动作。直接删旧日志会丢失审计线索而wiki-fold的思路是只新增、不改动extractive抽取式折叠页里的每一句话都必须能指向某条子日志条目不新增任何事实additive增量式子条目及其页面永不被修改、移动或删除幂等同一组输入永远生成同一个折叠页身份重复执行就是 no-op空操作先预览折叠页、目录、日志三处变更打包成一笔事务审阅通过后才应用。这一点在 docs/dragonscale-guide.md 中也被明确强调折叠页是导航辅助不是新证据——如果某次折叠不帮助回忆只需撤销这单个折叠操作即可原日志完好无损。确定性折叠 ID幂等性是如何实现的 幂等性来自一个关键设计折叠页的文件名完全由输入推导与执行时间、随机数无关。有界范围折叠按批次指数 k选取大小为 2^k 的连续日志条目默认 k416 条。可用条目不足时会如实报告缺口并停止绝不折叠不完整的批次结构性 ID由范围确定性地生成例如fold-k4-from-20260701-to-20260716-n16其中包含层级、起止日期和精确条目数存在即跳过若wiki/folds/{FOLD_ID}.md已存在直接返回 no-op。想替换必须显式 force 并单独审阅一份 replace 提案。也就是说你今天跑一次、明天对同一批条目再跑一次得到的折叠页身份完全一致——这就是结构幂等的含义。child_key 双射可追溯性的骨架 折叠页的 frontmatter 中有一个child_keys列表每条子日志条目对应一个确定性child_key日期 顺序号例如log-20260701-001。规则非常严格每个child_key在frontmatter 出现一次、正文 Child Entries 表格出现且仅出现一次形成双射每个结论Key Outcomes必须标注它引用的 child_key文中的每个数字都必须能在源条目中核实跨条目主题Cross-entry Themes必须列出至少两个贡献条目若子页面缺失保留显式的page_missing记录宁可写 source missing 也不臆造。下面是 fold-template.md 中 Child Entries 表格的样子一眼就能看出每条结论从哪来| Child key | Date | Op | Title | Page | Page state | Extractive summary | | log-20260701-001 | 2026-07-01 | ingest | Example source filed | [[Example Source]] | present | Added one source-backed example page. |正因为折叠不引入新证据它不会提升主张的置信度、也不会创建来源记录发现矛盾时只如实报告留待后续人工审阅。默认先预览确认后单笔事务落盘 ✅wiki-fold 的写入路径遵循 operation-transactions.md 定义的claude-obsidian.transaction.v1事务契约默认只预览返回完整草稿、折叠 ID、子条目范围、读取预算和拟变更路径不碰仓库任何文件你说应用/提交时生成一个operation_type: fold的事务包恰好耦合三处写入新建wiki/folds/{FOLD_ID}.mdcreate 模式wiki/index.md中的折叠目录条目wiki/log.md顶部一条新的折叠记录不更新hot.md三处目标都会记录SHA-256 前置条件先用 scripts/claude-obsidian.py 的transaction inspect审阅计划拿到approval_sha256后再transaction apply相同的事务包与操作 ID 是幂等的若 vault 已被其他操作改动退出码 75则重新读取并重建计划中断的应用可用transaction recover恢复或回滚。这套机制的核心是校验失败 一次写入都没发生折叠因此可以放心重试。折叠之后如何在图谱里定位结果 ️折叠页最终存放在wiki/folds/目录由wiki/index.md目录收录、wiki/log.md留痕与其他 wiki 页面一样参与双链。在 Obsidian 中整个 wiki 库包括日志、索引、折叠页都会形成一张可视化网络如果配合 Canvas 画布还可以看到log、index、overview等枢纽节点如何串联起各主题簇折叠页则像一个个章节摘要挂接在这张知识地图上另外Git 提交checkpoint是独立的可选动作不会在折叠时自动执行。如何触发 wiki-fold一句话就够 无需任何网络出口直接用自然语言触发即可常见触发语包括fold the log / run a foldlog rollup / roll up log entriescommit the fold表示审阅后应用触发后你会先看到完整草稿确认无误再让它提交整个过程就是预览 → 审阅 → 单笔事务三步。小结特性wiki-fold 的做法可追溯每个 child_key 双射到表格行每个结论标注来源条目幂等折叠 ID 纯由输入推导同输入同身份重复执行即 no-op安全默认 dry-run 预览SHA-256 前置校验失败零写入可恢复回滚无损子日志与页面永不改动折叠页只是导航辅助如果你想深入实现细节建议按顺序阅读skills/wiki-fold/SKILL.md技能契约→ skills/wiki-fold/references/fold-template.md页面模板→ skills/wiki/references/operation-transactions.md事务机制→ claude_obsidian/transaction.py事务引擎源码。【免费下载链接】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），仅供参考