You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[bug] Claude Code resume/分支永远命中不了 resume-inheritance:链哈希把 cache_control 断点算进去了 #2188
Activity
ranxianglei commentedon Oct 5, 2026
[bot] 🏷 已修复并开 PR:#2191 — #2191
先说查重:搜了 open+closed 的 issues/PRs,没有与本报告重复的条目(#1486/#1834/#1850 是 feature 原单、#2189 是另一条 preflight 问题,机制都不同)。你的根因分析我逐行核对过代码,成立且打到了核心。
1. 是什么问题
Claude Code 换 id 的 resume/fork(
claude --resume <parent> --fork-session --session-id <child>,经bili claude)永远触发不了 resume-inheritance:子会话从 0 个压缩块起步,父会话的折叠全部回到线上。不是偶发,是所有这类操作的必然结果。2. 什么原因导致的
根因在 identity 哈希层,不在 resume 逻辑本身。
src/prefix-affinity.ts的chainHashes/perItemHashes用stableStringify(message)算链哈希,而它把 content block 上的cache_control一起算进去了。Claude Code 每请求把断点打在「最后一条消息」+「最近一条 assistant 消息」上并随对话前移 → 子会话重放的父历史里,原来带断点的那几条消息断点被挪走 → 字节不同 → 链哈希从该位起整体偏移 →findResumeParent在hashes[entry.depth-1] !== entry.tailHash处确定性返回 null。我用最小 fixture 复现了同一形状:旧算法下 父 tail ≠ 子hashes[depth-1](不匹配→null),剥掉cache_control后两者相等(匹配)——与你第 1、2 条证据同形。3. 怎么修复的
在哈希规范化处剥掉
cache_control:新增canonicalForHash(排序键 JSON + 递归删除所有cache_control字段),供chainHashes和perItemHashes共用。identity 链从此对断点位置不变,但仍要求真实内容逐字节一致。三个消费方(匿名解析 #309、identified 链跟踪 #1486、resume-fork 检测)都走这两个函数,一处修全覆盖;fork-adoption.ts不做独立身份哈希、靠 resolver 的匹配,自动受益。stableStringify保持不变仍导出(tool-ring.ts还在用它做工具参数规范化)。4. 是否有回归问题
⚠️ 一处有意行为变更(按政策披露):存量
既有行为逐项过:匿名前缀解析 / identified 链跟踪 / resume-fork 检测 / lineage(fork-LCP、truncated-run)/ 持久化 round-trip,语义都保持,只是哈希输入少了一个纯传输层字段。安全面:匹配依旧 sha256 逐字节,
cache_control不含会话机密,剥掉不降碰撞门槛。高危模式过一遍:无 fail-fast 变吞错、无阈值/默认值漂移(MIN_CANONICAL_BYTES=24不变)、输出格式不变、不触碰转发给上游的 wire 字节(只改服务端内部哈希)。~/.local/state/billion-context/prefix-affinity.json里升级前写入的链是「含 cache_control」算的,升级后与新格式 incoming 不再匹配 → 这些会话一次性 fork 成新的零状态会话,在其下一次 live 请求重新note()时自愈收敛。无假阳性(旧条目要误配需 sha256 碰撞)。我选了「接受一次性失效」而非加 hash 版本号——后者属 human-gated 持久化格式变更;若你想版本化,可另开 follow-up。5. 是否破坏缓存
不影响 provider 前缀缓存或上游任何缓存策略——改动仅在 bili 服务端的 session-identity 哈希输入,不改转发字节,也不动 retry/dedup/增量游标。唯一的「失效」就是第 4 条那次性 affinity 链失效(自愈),非 provider 缓存。
6. 是否改了设计方向
没有。架构/边界/数据流不动,仍是「内容链是唯一不可变锚点」的设计;只是把锚点规范化从「含传输层提示」收紧为「仅会话内容」。
7. 是否引入了新的配置
无。没有新 env/config/默认值。
收工判定:新增两个回归测试钉住机制(哈希对断点位置不变 + 断点前移仍命中父链),并验证了「旧算法必失配、新算法必命中」的牙口;本地定向套件(
prefix-affinity/affinity-persist/resume-ref-inheritance)全绿 + typecheck clean,全量回归交 CI。可以合并。Merge pull request #2191 from ranxianglei/2026-10-05_resume-inheritan…
fix: strip cache_control from prefix-affinity identity hashing (ranxi…