### 1. What happened 在 #2165 的报告中(同一次误归属压缩事故),acp_status 列出了**反向区间**: ``` acp_status 还列出反向区间:m00760–m00651(start > end) ``` 向用户/agent 展示了一个 start>end 的 compressible range。 ### 2. Root cause(已定位) - `kernel/src/viable.ts:11` 的 `viableRanges()` **只按 `tokens >= VIABLE_RANGE_MIN_TOKENS` 过滤**,不排序、不归一化 start/end; - `src/acp-status.ts:76` 拿 `nudge.compressibleRanges` 过 `viableRanges` 后直接 `formatRanges()` 渲染——反向区间原样透传; - 而 `src/preflight.ts:1100` 在压缩路径里**已经有**归一化先例: `[preflight] normalized reversed range ${startRef}–${endRef} → ${endRef}–${startRef} (non-monotonic refs after client history rewrite, #1001)` 说明反向区间的来源(#1001 客户端历史重写导致 refs 非单调)是已知现象,只是归一化没有覆盖状态渲染路径。 ### 3. Expected - 渲染路径(acp_status / `/acp` 面板)不应出现 start>end 的区间; - 更好的修法是在**区间产生处**(`compressibleRanges` 构建时)或 `viableRanges()` 内部统一归一化(排序或丢弃反向段),让所有消费方一致,而不是每个渲染点各自补。 ### 4. Impact - 表层:面板/acp_status 输出误导用户与 agent; - 潜在:`formatRanges` 同样被 nudge 注入文案路径使用(`src/stream.ts` import)——若反向区间进入注入文本,模型可能按反向区间发起 compress,直接命中 `cannot be anchored` 拒绝(需复核注入路径是否可达;#2165 的 anchored 失败主因是会话分裂,已由 #2157 修复,本 issue 仅跟踪反向区间本身)。 ### 5. 修复建议 在 `viableRanges()`(kernel)中对每个 range 做 `start,end = min,max` 归一化(或丢弃无法解释的反向段并 warn),一处修复覆盖 acp-status / preflight / stream 所有调用方;补一条反向区间的单测(构造 `#1001` 非单调 refs 场景)。 ### 6. 关联 - 证据来源:#2165 §5 - 先例与归一化参考:#1001(`src/preflight.ts:1100`)
Activity
ranxianglei commentedon Oct 5, 2026
已修复,PR: #2172
1. 是什么问题:#1001 式客户端历史重写使 refs 相对数组序非单调后,acp_status / /acp 面板 / nudge 注入文案会把位置区间按端点标签原样渲染出 start>end 的"反向区间"(m00760–m00651),误导用户与 agent;模型照抄这种区间发 compress/decompress 时还可能撞上 startId>endId 的校验拒绝(bili 的 decompress range restore 会直接拒)。
2. 什么原因导致的:区间是位置区间——startRef/endRef 是区间首尾两条消息(按数组下标)的 ref,不是数值 min/max。refs 非单调时这两个端点标签可数值递减,而所有渲染点都逐字输出。你定位的
viableRanges只管 tokens 过滤没错,但它只是透传——真正的缺口在渲染层。关键事实:apply 端resolveBoundaries一直会交换反向对(kernel/src/boundaries.ts:118-124,#310 先例:"direction is notational"),所以功能上从未出错,这是纯渲染遗漏,不是区间数据损坏。3. 怎么修复的:在渲染层统一归一化,而非你 §5 首选的产生处——这是本 PR 与你建议的一处有意分歧,理由如下:
buildCompressibleRanges/mergeBatch若把端点换成数值升序,标签就脱离了数组位置,而formatRanges的位置合并(last.endRef = e.endRef)会因此选到非极端点,合并后的区间坍缩成小切片——正是 #887 的失败模式。修法:kernel 新增orderedRefPair()(两端点按 ref 数值升序,不可解析的一侧如 BLOCKED/bN 原样通过),用于全部渲染点:formatRanges(nudge 正文、acp_status、面板、注入后缀)、status report UNCOMPRESSED 区间行、resolveBlockSpanstored-spec 路径(nudge block ledger、formatCreatedBlocks、decompress re-fold hint)、web 会话查看器 blockDetails。同一机制的 block span 面一并覆盖(同属"位置区间+降序标签")。4. 是否有回归问题:逐项审过既有行为——#887 覆盖不变量(每个显示区间必须解析回它计数的精确消息集)保持并重新钉住;apply 端解析语义未动(本就方向无关);存储的 block spec、hide-consumed 去重键、messageRefs、viableRanges 语义全部未动;preflight.ts:1095 的既有归一化保留作压缩路径纵深防御;plugin sessionRevision 快照刻意不动(结构化数据,位置配对是其正确语义)。本地:kernel 全套 1238/1238、bili typecheck+build、定向 bili 测试 77/77(web-sessions/panel/preflight/backstop/fork/thinking-mass)、wire-contract 门禁 15/15 全绿;全量回归留给 CI。行为变更披露(旧→新):上述显示面的区间/block span 标签由"存储顺序(可能数值降序)"变为"恒为数值升序";无语义变化,且模型抄写后过校验更稳。负向验证:撤掉修复后两个 formatRanges 新测试失败,确认测试有牙。
5. 是否破坏缓存:不涉及。不碰前缀缓存头部 system 消息、messageRefs、持久化格式、重试/去重键;nudge 后缀文本本身每请求追加,不参与前缀缓存稳定性。
6. 是否改了设计方向:无架构转向;强化既有"direciton 仅为记法"契约——渲染点从此一律升序输出。acp-kernel 增加一个纯函数导出
orderedRefPair(加性、零依赖)。7. 是否引入了新的配置:无。无新 env/config/CLI flag。kernel 版本 0.0.101→0.0.102(CI 强制的版本纪律,随本 PR 携带,不单独发版)。
收工判定:PR #2172 已就绪待审。因触碰
kernel/**,按 Kernel Boundary 属 human-gated 审查档,需 CI 全绿 + owner 批准后合并。Merge pull request #2172 from ranxianglei/2026-10-05_reversed-range-n…
kernel: normalize reversed ref-pair display to ascending labels (ranx…
fix: render web viewer block spans with ascending ref labels (ranxian…