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
[行为确认] rebuildMessages pin 住第一条 user message:即使被 active block 覆盖仍原样转发——请确认意图并写入契约文档 #341
tests/state-prune.test.ts "prune preserves first user message even when covered"
tests/orphan-fixes.test.ts "prune: first user message pruned when covered (no duplication)",断言注释直接写明理由:"first user message always survives (even when covered — some providers reject 0-user)"
下游代码已适配它:src/boundaries.ts:313-317 的 blockVisibleInRange 显式处理了这个行为——当 block 覆盖第一条 user message 时,summary 锚在 pinned raw 之前,所以 range 判定必须同时检查 rendered summary 和 earliest surviving raw。若 pin 是无意的,边界解析不会专门为此补偿。
理由
严格 provider 拒绝没有 user message 的会话(Anthropic 要求对话从 user role 开始)。pin 保证只要输入至少有一条 user message,重建后的 wire 就至少保留一条(就是第一条本身;后续被覆盖的 user message 正常剪掉)。因此 issue 中提的另一方案——把 pin 移到 covered 检查之后——会破坏这个保证,不采纳。
Activity
ranxianglei commentedon Sep 22, 2026
结论:有意设计,已确认并写入契约文档。未改代码。
意图证据(三条独立佐证)
9747d18, v0.0.2)起就存在,且 pin 检查先于 covered 检查的顺序从未被改动过——不是某次重构的副产物。tests/state-prune.test.ts"prune preserves first user message even when covered"tests/orphan-fixes.test.ts"prune: first user message pruned when covered (no duplication)",断言注释直接写明理由:"first user message always survives (even when covered — some providers reject 0-user)"src/boundaries.ts:313-317的blockVisibleInRange显式处理了这个行为——当 block 覆盖第一条 user message 时,summary 锚在 pinned raw 之前,所以 range 判定必须同时检查 rendered summary 和 earliest surviving raw。若 pin 是无意的,边界解析不会专门为此补偿。理由
严格 provider 拒绝没有 user message 的会话(Anthropic 要求对话从 user role 开始)。pin 保证只要输入至少有一条 user message,重建后的 wire 就至少保留一条(就是第一条本身;后续被覆盖的 user message 正常剪掉)。因此 issue 中提的另一方案——把 pin 移到 covered 检查之后——会破坏这个保证,不采纳。
文档化(PR: https://github.com/ranxianglei/acp-kernel/pull/342)
src/prune.tspin 处加注释:说明该检查顺序是契约的一部分、交换会怎样,防止未来有人把它当 bug "修掉"。纯注释,无逻辑改动。验证:基于最新 master(
b30723f, v0.0.82)rebase,typecheck ✅、869/869 测试 ✅、build ✅。中文摘要:确认第一条 user message 的 pin 是有意的 provider 兼容性保证(拒绝 0-user 会话),已在 DESIGN.md §8 写入契约并在代码处加防护注释,无逻辑改动,PR #342 可合并。