[Kernel Initiative] Transactional folding boundaries + wire byte fidelity (unified prefix cache fix #3938, kernel side) | [kernel 专项] 折叠边界事务化 + wire 字节保真(前缀缓存统一修复 #3938 内核侧)

(ai: zhipuai-lb/glm-5.3)

总跟踪:#3938(前缀缓存统一修复)。本 issue 按 Kernel Boundary 落 kernel 侧改动的正式批准与验收口径,范围 = PR-B 折叠边界事务化 + PR-C wire 字节保真。owner 已在 2026-10-20 分诊中批准方向并给出前置条件(打桩先行、语义不变);请在本 issue 回复确认后开工。

为什么宿主侧解决不了

四个现行肇事写者里三个物理住在 kernel 里(hide-consumed.ts / refs.ts / truncate-tools.ts),加上 wire 编解码归一化(kernel/src/wire/*)。宿主只能在出口「看见」字节变了,管不了它们的触发时机——像能在收银台发现丢了货,管不住仓库里谁动了货。

改动面

hide-consumed 折叠门控:轮换删除/rewriteCompressText 剥改/摘要打桩的字节变化,排队到下一折叠/refold/用户动作边界才生效(吸收 [PR] fix: gate failed-compress record cleanup on real folds + attribute its cache breaks (#3769) #3784 的门控模式,覆盖其范围)。
ref 迁移渲染推迟:BLOCKED 解除时只铸号不渲染,旧载体文本前标签出现推迟到折叠边界(治 [cache][kernel] Ref migration during durable carrier replacement rewrites sent history, causing a prefix cache seam | [cache][kernel] durable 载体替换时 ref 迁移改写已发送历史，导致前缀缓存接缝 #3805)。
截断 latch:水位触发 clip 后保持 clip,直到折叠事件重置(治 [cache] Emergency truncation oscillates full↔clipped history at 95% usage, causing 15% hits without folds #3691 振荡)。
多 range 全有或全无:提交前预检所有 range 可折叠性,任一致命则整批拒绝(吸收 [PR] kernel: all-or-nothing summary-length pre-check for multi-range compress (#3003) #3670,治 [design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003)。
opt-in 面同规:absorb 提示/crush/ccr/filter keepLastOnly 开启时同样受折叠门(结构性,非逐个特判)。
wire 保真:anthropic 未知顶层 block(document/PDF 等)default 透传 + 丢弃告警对齐 openai 线(吸收 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547,治 anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410);openai leading-opaque 重排、google 排序归一:同一形状每请求必须同一字节(首见冻结或明示 canonical)。

预计 kernel/src/ 内 6-8 个文件 + kernel/package.json 版本 bump;commit 带 kernel: 前缀,PR body 带 kernel-change: 折叠边界事务化+wire保真(#3938) 声明。

打桩计划(前置,先行单独合入,纯测试零行为变更)

hide-consumed 现状 pin:KEEP_LAST_ORPHANED=2 窗口滑动(第 3 个失败挤最老)、剥改、SUMMARY_STUB_CHARS=200 打桩——各一组 characterization 测试钉死当前字节输出;
ref 迁移现状 pin:BLOCKED 解除→铸新号→下一轮旧载体前出现标签(当前行为,含触发器=protectedLatestTools 滑窗);
截断现状 pin:0.95 触发、贪心到 0.9、marker 跳过、每请求独立重算;
多 range 现状 pin:后段抛错前段已落地([design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003 形状);
wire 四线 unknown-part 处理现状 pin:anthropic 整丢 / openai sidecar / google 兜底 / responses preamble。

之后 PR-B/C 的每个语义变化都能对上「哪条 pin 被有意移动,其余全绿」。

语义不变承诺

只动「何时」,不动「改什么」:隐藏内容集合、截断内容、ref 分配规则、摘要文本全部不变;
金 pin(tests/golden/wire-contract/kernel.json:defaultConfig、四个 prompt 规则、tool-name 表、wire markers)不动;
kernel 自有 suite(npm --prefix kernel test)+ bili 全量两层绿才算完。

可见行为变化(交底)

失败 compress 记录消失时机:第 3 个失败出现时 → 下一折叠轮(历史多留几条失败记录,token 略增);
紧急截断还原:水位回落即还原全文 → clip 保持到折叠(安全侧:宁多截不多变);
旧 durable 载体标签出现:保护解除当轮 → 折叠轮;
anthropic 请求里未知 block 从静默消失 → 原样透传(上游可能开始收到它以前没见过的块——这是恢复保真,非破坏)。

回滚

每个子改动独立 commit,任一行为退化可单独 revert;打桩测试保留作为回滚判据。

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重:不重复。 本 issue 是 #3938(总跟踪)的内核侧专项,与总伞是父子关系而非平行立项。在途 PR 与本专项的关系:

[PR] fix: gate failed-compress record cleanup on real folds + attribute its cache breaks (#3769) #3784(failed-compress 记录清理按真实折叠门控,[Bug] MCP failed compression record rotation prematurely rewrites the history prefix, triggering expensive cache recompu | [Bug] MCP 失败压缩记录轮换提前改写历史前缀，触发大额缓存重算 #3769)、[PR] kernel: all-or-nothing summary-length pre-check for multi-range compress (#3003) #3670(多 range 全有或全无预检,[design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003)、[PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547(anthropic 未知顶层 block 透传,anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410)——与本专项同机制同症状,PR-B/C 按「吸收在途 PR」策略在 kernel 侧实现同一修复;kernel 落地后这三个 PR 按结果处置(被 supersede 则关闭并注明,有残余差异则保留);
anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410 [cache] Emergency truncation oscillates full↔clipped history at 95% usage, causing 15% hits without folds #3691 [cache][kernel] Ref migration during durable carrier replacement rewrites sent history, causing a prefix cache seam | [cache][kernel] durable 载体替换时 ref 迁移改写已发送历史，导致前缀缓存接缝 #3805 [design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003 [Bug] MCP failed compression record rotation prematurely rewrites the history prefix, triggering expensive cache recompu | [Bug] MCP 失败压缩记录轮换提前改写历史前缀，触发大额缓存重算 #3769 是被治缺陷清单,保持打开直到验收逐项关闭;
与 [PR] feat: invariant judge GA — default-on L1 advisory, egress chokepoint, loop continuity, bounded exemptions (#3938 PR-A) #3944(PR-A,宿主侧判官)正交:一个管出口裁决,一个管 kernel 内写者时机,无重叠改动面。

标签: bug + scope/kernel + p1 —— 前缀缓存接缝属成本爆炸级缓存类缺陷(owner 2026-10-19 修订:缓存类一律 p1);kernel 专项无特定客户端,不打客户端标。

确认开工。 按 Kernel Boundary 与 owner 2026-10-20 前置条件(打桩先行、语义不变)执行,顺序:

打桩 PR(先行,单独合入):characterization 测试钉死现状字节输出——①hide-consumed(KEEP_LAST_ORPHANED=2 窗口滑动/剥改/SUMMARY_STUB_CHARS=200 打桩)②ref 迁移(BLOCKED 解除→铸新号→旧载体标签下一轮出现,含 protectedLatestTools 滑窗触发器)③截断(0.95 触发、贪心到 0.9、marker 跳过、每请求独立重算)④多 range 部分落地([design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003 形状)⑤wire 四线 unknown-part 处理(anthropic 整丢/openai sidecar/google 兜底/responses preamble)。纯测试零行为变更,不动 kernel/package.json 版本、不动金 pin。
PR-B 折叠边界事务化:hide-consumed 门控(吸收 [PR] fix: gate failed-compress record cleanup on real folds + attribute its cache breaks (#3769) #3784)+ ref 迁移渲染推迟(治 [cache][kernel] Ref migration during durable carrier replacement rewrites sent history, causing a prefix cache seam | [cache][kernel] durable 载体替换时 ref 迁移改写已发送历史，导致前缀缓存接缝 #3805)+ 截断 latch(治 [cache] Emergency truncation oscillates full↔clipped history at 95% usage, causing 15% hits without folds #3691)+ 多 range 全有或全无(吸收 [PR] kernel: all-or-nothing summary-length pre-check for multi-range compress (#3003) #3670 治 [design] Parallel compression saves cache; both failure and success strategies account for PARTIAL fold double-seam cost | [design] 并行压缩节省缓存,失败和成功策略都考虑 PARTIAL fold double-seam cost — per-range commit makes rejected-range retry pay twice (#2997 §5) #3003)+ opt-in 面(absorb/crush/ccr/filter keepLastOnly)结构同规。只动「何时」不动「改什么」,每个语义变化对得上「哪条 pin 被有意移动,其余全绿」。
PR-C wire 字节保真:anthropic 未知 block default 透传+丢弃告警对齐 openai(吸收 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 治 anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410);openai leading-opaque / google 排序归一:同一形状每请求同一字节。

纪律:kernel: commit 前缀 + PR body kernel-change: 折叠边界事务化+wire保真(#3938) 声明 + kernel/package.json bump;两层测试(kernel suite + bili suite)绿才算完;子改动独立 commit 可单独 revert;可见行为变化按本 issue「交底」节逐条对账。先交打桩 PR,CI 绿后再开 B/C。

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

接单后现状核对(重要,更新上一条开工回复的范围): 我确认开工时,#3939 的 ①–⑤ 已有在途实现——打桩 PR #3941(今日 09:06Z 开,12 条 characterization pins,纯测试零 src 改动,已审可合、等人工合并)与 PR-B #3956(今日 10:51Z 开,五类中途重写全部收敛到折叠边界事务,吸收 #3784+#3670,kernel 0.0.137→0.0.141,lock-sync CI 红已转 ci-worker 处理)。两者均按本 issue 批准的计划执行、方向与打桩先行纪律一致。我不重做 ①–⑤,避免双 worker 撞车;我的车道收窄为 ⑥ PR-C:wire 字节保真(检索 open+closed 确认无 PR-C 在途)。

PR-C 计划(本 issue 第 6 项 + 吸收 #3547 kernel 侧):

anthropic 未知顶层 block 透传:kernel/src/wire/anthropic.ts block switch 补 default——未知类型(document/PDF 等)骑既有 rawAnthropicBlock sidecar 逐字透传(round-trip 字节精确,与 image/redacted_thinking 同构);kernel/src/protected.ts 把未知 block 判为 media+unrecoverable(载荷只在 sidecar、不可归档,折叠即永久丢失,故永不折叠)。治 anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410 静默丢数据。
openai leading-opaque 字节稳定:同一形状每请求必须同一字节——审计 [opaque,text,opaque] 形状下 leading-opaque PREPEND 与 loop 累积的交互,用首见冻结(original part order 记录在侧车、重建按原序发出)或明示 canonical 序钉死,characterization 证据先行。
google 排序归一:固定 reasoning→text→tool 排序从「靠约定稳定」升级为「明示 canonical」——排序规则具名+注释+双向测试钉(同形状跨请求字节恒等),任何未来改动要么保持该序要么显式改 canonical。
丢弃告警对齐 openai 线:[PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 的 host 侧 notice/billing 面若仍在其分支上保留,则 PR-C 只收 kernel 侧,[PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 收窄为 host-only 处置;若已被吸收则直接关闭并注明。此点我在动手前会逐行比对 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 当前分支后在 PR body 里写清处置。

纪律不变: kernel: commit 前缀 + PR body kernel-change: wire保真(#3938/#3939⑥) 声明 + kernel/package.json bump;金 pin 不动;两层测试绿才算完;子改动独立 commit 可单独 revert。基线策略:先基于当前 master 开发,待 #3941/#3956 合入后 rebase(版本行机械冲突按 #3670 先例解),保证「先 #3941 再 #3956 再 PR-C」的合并顺序成立。

可见行为变化交底(PR-C 部分):anthropic 请求里未知 block 从静默整块丢弃变为原样透传上游(上游开始收到它以前没见过的块——恢复保真,非破坏;#3547 已审过的行为变更口径沿用);openai/google 已知形状零字节变化(稳定性证明对象是「跨请求恒等」,不是改输出)。

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

PR-C 已开:#3961(分支 2026-10-20_3939-prc-wire-fidelity,2 个独立 commit,kernel 0.0.137→0.0.139,body 带 kernel-change: 声明)。本 issue 第 ⑥ 项完成交付,①–⑤ 由 #3956 承接。八问结论:

是什么问题:anthropic 线把未知顶层块(document/PDF 等)在 parse 时静默丢掉——payload 从第一次重建起就从后续所有请求里消失,fold 碰到即永久丢失(anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410);openai leading-opaque 重排与 google 固定排序的字节稳定性只靠约定、无证明无钉——两者都属于「前缀缓存被看不见的字节漂移撕碎」这一根因。
什么原因导致的:anthropic.ts 逐块 switch 没有 default 分支(其余三线都有 sidecar/兜底);openai/google 的归一化虽是纯函数,但「同一形状每请求同一字节」从未被合同化、测试化,未来任何改动都可能悄悄把它变成形状依赖的重写而不报警。
影响范围与严重程度:所有携带未知块的 anthropic 会话(现主要 document/PDF)从首轮重建起丢 payload——数据丢失+缓存破坏,p1 级(缓存/保真类)。openai/google 现状经探针验证已稳定,本次是把隐式稳定升级为显式钉住,防未来回归。
怎么修复的:①未知 anthropic 块走既有 rawAnthropicBlock sidecar 原样透传(复用 image/redacted_thinking 通道,coreToAnthropic 本就逐字重发),protected.ts 将其计为 media+unrecoverable(吸收 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 kernel hunk,适配 master 现行 deriveCanonicalMessageId);②coreToOpenai/coreToGoogle JSDoc 写明字节稳定性合同 + 20 条 golden/跨请求前缀字节一致性钉;commit 2 零运行时变更。
是否回归:逐项审过既有行为——anthropic 已知六类块路径不变;未知块谓词 parity(image base64/url、redacted_thinking、纯文本)按旧判决钉死;Image errors accumulating in the conversation | 对话中图片错误堆积 #3398 计费 pin、wire-contract 金门、redacted-thinking/roundtrip/保护谓词×3/image-restore 直接消费方套件全绿。一处跨 PR 注意已在 PR body 标红:[PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 的 document 计费 hunk 落地后,tests/issue3398-opaque-media-reserve.test.ts:87-106 的断言需更新(该文件早于 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 基线,目前无人属主)。
是否破坏缓存:本修复本身就是修缓存——anthropic 未知块不再会话中途消失;openai/google 同形同字节被钉住,未来回归会在 CI 直接变红而不是生产暴露。
是否改设计方向:未转向。按 Unified Prefix Cache Fix: Transactional Folding Boundaries + Single Exit Arbiter (Global Tracking) | 前缀缓存统一修复:折叠边界事务化 + 出口单一判官(总跟踪) #3938 统一修复方向执行:kernel 侧保证「出去的就是进来的」+「同形同字节」,出口裁决归宿主侧(PR-A [PR] feat: invariant judge GA — default-on L1 advisory, egress chokepoint, loop continuity, bounded exemptions (#3938 PR-A) #3944)。
新配置:无。

语义不变承诺对账:隐藏内容集合/截断/ref 分配/摘要文本全部未动(那是 ①–⑤);金 pin 未动;可见行为变化仅 PR body 披露表两行。建议合并顺序 #3941 → #3956 → #3961;#3547 收窄为 host-only 后 rebase。#3961 CI 绿后,#3410 随 Closes 自动关闭,其余验收项等 #3956/#3941 各自收口。

kernel: pass unknown anthropic top-level blocks through verbatim (#3410)

kernel: pin wire byte-stability contract for openai/google normalizat…

kernel: CCR rides the view-latch config digest — disarm releases latc…

Merge pull request #3941 from ranxianglei/2026-10-20_3939-behavior-pins

kernel: pass unknown anthropic top-level blocks through verbatim (#3410)

kernel: pin wire byte-stability contract for openai/google normalizat…

kernel: keep the fold-gate files inside the verifiable subset; re-bas…

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

来源: #3956 (#3956) 分析 #3787 回归时发现。查重: 无(检索 rebuild prepare/tokenCount/truncate latch/水位误触发无命中;#3691 修的是截断无 latch 来回翻,#3787 修的是 numberless 救场窗口,均不覆盖本项)。

补记第 ⑥ 号子缺陷(与 ①–⑤ 同一失败域:写者不认折叠边界契约),先入账,修复时机待排:

⑥ preflight 折叠后的 rebuild prepare 给紧急截断水位喂了折叠前的幻影体量

机制(代码路径 + 实测值,均已在 PR-B 分支实证):

src/server.ts:3462 — result.compressedRanges > 0 时 preflight 调 runPrepare() 组装折叠后的转发体;
该 prepare 走 effectiveTokenCount(src/server.ts ~2303):此刻 post-rebuild usage estimate inflates ~3.4x after a big fold, firing an EMERGENCY T1 nudge into an over-budget context #1820 anchor 尚未写入(setPostRebuildAnchor 在 src/server.ts:3504,晚于 runPrepare 返回)、首请求又无 usage 基线 → 落末支 min(localInputEstimate, estimateCoreMessagesUpper(raw msgs)),两项都是入站未折叠历史的体量;
kernel 管线内 prune 先剥掉块覆盖消息(io.messages 12→4),随后 emergencyTruncateNode 用 ctx.tokenCount(= 第 2 步幻影值)对 modelContextLimit 算水位;
实测(Context Overflow | 上下文溢出 #3787 旧场景:declared 10K、入站 ~51.9K tok、折后 ~5.9K):rebuild prepare 传 tok=51934/limit=10000 → usage=5.19 ≥ 0.95 → 把实际只占窗口 59% 的折叠体裁掉一条消息(~1072 tok)并写 state.emergencyTruncateLatch。

影响:

PR-B 下(③ latch 生效):clip 固化到下次成功折叠(compress.ts blocksCreated>0 清 latch);期间同消息在视图内则每请求重放裁剪字节——稳定本身没问题,但 latch 随折叠释放后同一消息字节「恢复全文」而未经折叠边界 = 折叠窗口外的中部改写,直接违反本专项的核心契约;
master(PR-B 前):同样的幻影触发存在,clip 是瞬态(view 级、state 保全文、次请求自愈)——即 master 已有此接缝,PR-B 把它持久化了;
Context Overflow | 上下文溢出 #3787 旧场景(declared < 入站)中此幻影 clip 还会叠加进 refold 重放(refold 重放同一 clip → body 不变 → 使用pi 压缩后就提示prompt is too long #1195 不变体门跳过重试)。该叠加路径已被 a61a1f9 的场景改写绕开(commit 内已交底),但 ⑥ 本身仍在。

修法建议(二选一,推荐 A):

A(host 侧小改):src/server.ts:3462 前用 preflight 最后一轮测量(折后实际体量)预置临时 anchor,让 rebuild prepare 命中 anchor 分支;:3504 既有调用随后以精确值覆盖。修在产错值的决策点,零 kernel 变更;
B(kernel 侧,KDD refactor: reapOrphanBlocks should live in acp-kernel, not the proxy #12 纪律):prune 节点的 stash(effects.originalMessages)证明发生过裁剪时,emergencyTruncateNode 按当前 io.messages 重算判定体量——判定与执行共用同一数组类。更彻底(覆盖一切喂跨类计数的路径),需 kernel bump + pin。

test: kernel behavior pins for ranxianglei#3939 (fold boundary + wire…

kernel: all-or-nothing batch when a range dies during application (ra…

kernel: latch emergency truncation bytes until the next fold (ranxian…

kernel: defer BLOCKED→numeric migration carrier tags to the fold boun…

kernel: fold-gate the opt-in view rewriters via a structural view lat…

kernel: pass unknown anthropic top-level blocks through verbatim (#3410)

kernel: pin wire byte-stability contract for openai/google normalizat…

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

#3939 第 ⑥ 项(PR-C wire 字节保真)交付完毕:PR #3961,CI 全绿,待人工审核合并(kernel 变更按 Kernel Boundary 属 human-only review)。

结构化八问

是什么问题:kernel 的 wire 编解码不保证「同一形状每请求同一字节」——anthropic 线在解析时把未知顶层 block(document/PDF 等)静默丢弃(四线中唯一整丢的),openai/google 的归一化(leading-opaque 重排、固定 part 排序)只是「按约定稳定」,没有任何契约或测试钉住。
什么原因导致的:kernel/src/wire/anthropic.ts 的 per-block switch 只有 6 个已知类型、没有 default 分支——未知 block 在解析阶段就消失,coreToAnthropic 重建时自然发不出来;openai/google 两条线的重建顺序是纯函数但从未被显式声明和钉死,属于 Unified Prefix Cache Fix: Transactional Folding Boundaries + Single Exit Arbiter (Global Tracking) | 前缀缓存统一修复:折叠边界事务化 + 出口单一判官(总跟踪) #3938 根因表里「convention-stable」未证明的那两行。
影响范围与严重程度:所有走 anthropic 线且消息含未知顶层 block 的会话(典型:带 document/PDF 的计费类 agent)——payload 从每个后续请求和任何触及该消息的折叠中永久丢失(anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410)。属前缀缓存统一修复总伞 Unified Prefix Cache Fix: Transactional Folding Boundaries + Single Exit Arbiter (Global Tracking) | 前缀缓存统一修复:折叠边界事务化 + 出口单一判官(总跟踪) #3938 的保真面,按 owner 修订归 p1 家族。openai/google 面当前无实际漂移(探针实测全部稳定),风险是「未来某个改动悄悄破坏而生产才发现」。
怎么修复的:①anthropic 加 default 分支——未知 block 走既有 rawAnthropicBlock sidecar(image/redacted_thinking 同机制),coreToAnthropic 原样重发(含块内 cache_control),解析∘重建成为不动点;protected.ts 谓词吸收自 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547:未知 sidecar block 计为 media + unrecoverable(折叠即永久丢失,必须保护)。②openai/google 把「同一形状同一字节」写成显式契约(JSDoc)+ 20 条测试钉死:逐线 golden 重建形状、跨请求前缀字节恒等、id 确定性。只动 wire 层,不动任何压缩决策。
是否有回归问题:无。既有行为逐项过:image( base64/url)、redacted_thinking、plain text 的保护判定用 parity 测试钉死不变;openai/google 零运行时改动(仅注释+测试);bili 侧 Image errors accumulating in the conversation | 对话中图片错误堆积 #3398 计费 pin 保持绿(计费 walker 走原始 body,不受影响);真实客户端 e2e(codex/dsh/pi/opencode/registry/image-billing)CI 全绿。
是否破坏缓存:不破坏,方向相反——本 PR 让字节更忠实且把稳定性从「约定」升级为「CI 可判定的契约」,未来任何破坏前缀稳定的改动会直接红在 CI 而不是在生产暴露。不涉及重试/去重/游标失效策略。
是否改了设计方向:无架构转向。扩展既有 sidecar 机制到新的 block 类别;分工调整:[PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 收窄为 host-only(计费 + 一次性告警),kernel hunk 由本 PR 吸收(已适配 master 现行 deriveCanonicalMessageId 身份方案)。
是否引入新配置:无。无新 env/config/CLI。

过程要点

打桩先行:前置 characterization pin 已在 [PR] kernel/tests: Stub PR — fold boundary + pin down wire unknown-part behavior (#3939 prerequisite, no src changes) | kernel/tests: 打桩 PR — 折叠边界 + wire 未知 part 行为钉死(#3939 前置, 无 src 改动) #3941 合入;本 PR 有意移动其中一条(anthropic silent-drop pin → verbatim-passthrough pin,该文件头部本就计划「同一 PR 内更新」),其余 pin 全绿。
红风暴处置:推送后一度遇到全仓 docs-sync 红灯([PR] fix(storage): per-runtime SQLite engine artifacts + refuse-before-load Node floor (#3894, rebase of #3896) #3963 引入 config seed 未重新生成文档产物所致,master 自身亦红)——已由 [PR] docs: regenerate config reference after the engine-tiering seeds (#3963) #3969 在 master 修复;本分支随后 rebase 到含 [PR] docs: regenerate config reference after the engine-tiering seeds (#3963) #3969 的 master(无冲突),per-commit lockfile 同步(lock-sync 绿),最终 head cfc3b96 全 lane 通过(45 check-runs:31 success / 14 skipped / 0 failure)。
版本:kernel 0.0.137→0.0.139(两个子改动各一次 bump,独立 commit 可单独 revert)。金 pin tests/golden/wire-contract/kernel.json 未动。
遗留交接口:Image errors accumulating in the conversation | 对话中图片错误堆积 #3398 断言在 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 的计费 hunk 落地后需更新(预期 cost 2048/count 1)——已在 PR 描述与 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 线程标注,归属 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 rebase 时处理;anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410 在 [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547 合入后关闭。
合并顺序建议:[PR] kernel: wire byte fidelity — anthropic unknown-block passthrough + openai/google stability pins (#3410) #3961(本 PR)→ [PR] fix: preserve unknown anthropic top-level blocks verbatim in the anthropic wire codec #3547(host-only);与 [PR] kernel: consolidate all mid-flight rewrites into fold-boundary transactions (#3939 ①–⑤, fixes #3003/#3691/#3769/#3805) | kernel: 中途重写全部收敛到折叠边界事务(#3939 ①–⑤, 修 #3003/#3691/#3769/#3805) #3956(PR-B)无文件重叠,先后不限,若其先合仅需机械解 version 行冲突。

判定:PR-C 收工,等人工审核;#3939 内核侧六项中 ①–⑤ 由 #3956 承载、⑥ 由 #3961 承载,两者合入即满足 #3938 验收的内核侧条件。

(ai: zhipuai-lb/glm-5.3)

#3939 全部六项已落地,可关闭:

①失败轮换折叠门控 + ②ref 迁移渲染推迟 + ③截断 latch + ④多 range 全有或全无 + ⑤opt-in 面同规 → PR [PR] kernel: consolidate all mid-flight rewrites into fold-boundary transactions (#3939 ①–⑤, fixes #3003/#3691/#3769/#3805) | kernel: 中途重写全部收敛到折叠边界事务(#3939 ①–⑤, 修 #3003/#3691/#3769/#3805) #3956(含 [PR] fix: gate failed-compress record cleanup on real folds + attribute its cache breaks (#3769) #3784/[PR] kernel: all-or-nothing summary-length pre-check for multi-range compress (#3003) #3670 吸收)
⑥wire 保真 → PR [PR] kernel: wire byte fidelity — anthropic unknown-block passthrough + openai/google stability pins (#3410) #3961(kernel anthropic wire silently drops unknown top-level blocks (incl. PDF document) when rebuilding history #3410 透传) + PR [PR] feat: host lane for unknown anthropic blocks — session notice + billing parity (#3410) #3981(host 计费+NOTICE 车道) + PR [PR] fix(verif): emit str.substr so cvc5 can parse slice queries — 3691 harness was silently solver-dead #3980(verif 求解器发射名)
打桩先行 [PR] kernel/tests: Stub PR — fold boundary + pin down wire unknown-part behavior (#3939 prerequisite, no src changes) | kernel/tests: 打桩 PR — 折叠边界 + wire 未知 part 行为钉死(#3939 前置, 无 src 改动) #3941(12 pins),补修 The "shortened" result of emergency truncation is longer than the original: a 4001-character tool output became 4064 cha | 紧急截断的"缩短"结果比原文还长:4001 字符的工具输出截断后变 4064 字符 #3935/Messages with duplicate IDs overwrite the rendered bytes of already-sent messages: protected messages are re-tagged by l | 重复 id 的消息会改写已发送消息的渲染字节:受保护消息被后来的同名 id 消息重新打标 #3945 → [PR] kernel: Fix two byte-stability defects uncovered by verif — truncation must actually shorten + BLOCKED binding collision | kernel: 修 verif 挖出的两个字节稳定性缺陷 — 截断必须真变短 + BLOCKED 绑定撞车保护 (#3935, #3945) #3972
verif 套件 15/15 在最终 kernel 上全绿

verif: google rebuild-stability harness + break-flag loop-exit fix

test(verif): return before t.skip so solver-less CI skips instead of …

Navigation Menu

Repository navigation

[Kernel Initiative] Transactional folding boundaries + wire byte fidelity (unified prefix cache fix #3938, kernel side) | [kernel 专项] 折叠边界事务化 + wire 字节保真(前缀缓存统一修复 #3938 内核侧) #3939

为什么宿主侧解决不了

改动面

打桩计划(前置,先行单独合入,纯测试零行为变更)

语义不变承诺

可见行为变化(交底)

回滚

4 remaining items

结构化八问

过程要点

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

[Kernel Initiative] Transactional folding boundaries + wire byte fidelity (unified prefix cache fix #3938, kernel side) | [kernel 专项] 折叠边界事务化 + wire 字节保真(前缀缓存统一修复 #3938 内核侧) #3939

Description

为什么宿主侧解决不了

改动面

打桩计划(前置,先行单独合入,纯测试零行为变更)

语义不变承诺

可见行为变化(交底)

回滚

Activity

ranxianglei commented on Oct 20, 2026

ranxianglei commented on Oct 20, 2026

ranxianglei commented on Oct 20, 2026

4 remaining items

ranxianglei commented on Oct 20, 2026

ranxianglei commented on Oct 20, 2026

结构化八问

过程要点

ranxianglei commented on Oct 20, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions