Skip to content

[Bug] 消息引用编号与当前顺序不一致时,compress 范围提示会选错消息,导致“内容不足”失败 #887

Closed

Description

@kuviki

问题概述

billion-context 0.1.117 的 formatRanges() 按消息引用编号的数字部分排序、合并范围,而 resolveBoundaries() 按消息在当前上下文数组中的实际位置解析端点。

当当前消息顺序并非引用编号递增顺序时,提示中显示的范围可能附带多个范围的总消息数和总 token 数,但实际执行时只选中其中一小部分消息。模型按照提示调用 compress,就会收到与提示规模明显不符的 Total compressible content too small 错误。

附件提供了独立离线复现:使用合成消息,直接执行实际安装包中的范围格式化与解析函数,不需要模型、API key、代理服务或生产会话数据。

环境

  • billion-context:0.1.117
  • Node.js:v24.15.0
  • 系统:Linux x64
  • 实际使用场景:Kimi Code,经 Anthropic plugin passthrough
  • compress.minCompressRange:5000 字符

复现方法

附件:repro.cjs 和 actual-output.txt。如果附件名为 repro.cjs.txt,先改名为 repro.cjs。

actual-output.txt
repro.cjs.txt

已全局安装 billion-context 0.1.117 时,运行:

node repro.cjs

也可以显式指定安装包中的 bundle:

node repro.cjs /path/to/billion-context/dist/index.js

如需隔离安装受影响版本,不必更改当前运行的全局安装:

mkdir bili-range-repro
cd bili-range-repro
npm install --ignore-scripts --no-save billion-context@0.1.117
# 将附件 repro.cjs 放入当前目录。
node repro.cjs ./node_modules/billion-context/dist/index.js

脚本仅读取指定安装包的源码与版本信息,并在 VM 中执行相关函数;不会导入或启动 CLI、访问会话文件、修改压缩状态,也不会调用上游服务。退出码为 1 表示成功复现覆盖范围不一致的问题。

最小输入

消息的实际顺序与合成正文长度如下:

引用 正文字符数
m07522 4000
m07990 4000
m08040 200
m06185 168
m08089 4000

注意:m06185 在当前消息顺序中位于 m08040 后面。

按实际消息顺序提供两个范围:

  • m07522–m08040:3 条消息,8200 字符。
  • m06185–m08089:2 条消息,4168 字符。

合计覆盖 5 条消息、12368 字符,超过 5000 字符门槛。

实际结果

以下为脚本的实际输出,保留英文以便与附件逐项对照:

Actual formatter output:
Compressible ranges (1, oldest first):
  m06185–m08040  5 msgs  3.1K [tool 0% | text 100%] · 1 user msg

Resolving the displayed ranges selects: m08040, m06185
Expected coverage: 5 messages / 12368 chars
Actual coverage:   2 messages / 368 chars
5000-char compression gate: intended PASS, displayed selection FAIL
BUG REPRODUCED: displayed ranges do not preserve coverage

即:提示显示覆盖 5 条消息、约 3.1K tokens;按提示端点解析后,实际只覆盖 2 条消息、368 字符。

具体过程:

  1. formatRanges() 因为 6185 < 7522,将第二个范围排到第一个范围前面。
  2. 按引用编号判断两个范围重叠并合并,把 last.endRef 更新为后遍历范围的 m08040,最终输出 m06185–m08040。
  3. 消息数与 token 数仍是两个原始范围的合计。
  4. resolveBoundaries() 按实际消息位置定位端点,交换反向端点后,只选中相邻的 m08040 和 m06185。

预期结果

显示出来的每个可压缩范围,必须能解析回用于计算其消息数、大小的同一组消息。

对于这个最小输入,可以保留两个原始范围,也可以按实际消息顺序合并为 m07522–m08089;这两种结果都能保留原始覆盖范围。m06185–m08040 则不能。

除非系统确实保证引用编号与当前消息顺序一致,否则不能用引用编号的数字大小推断当前时间顺序或范围包含关系。范围展示与执行应使用一致的定位依据。

实际会话中的表现(补充证据)

时间均为 2026-09-17,北京时间 UTC+08:

  • 13:47:20、13:48:07、13:49:01:三次独立的 compress 调用提交了相同范围 m06185–m08040 和完全相同的摘要,均返回:
[Compression FAILED: Total compressible content too small (368 chars across 1 range(s), min 5000). Combine more messages into your range(s) to meet the threshold.]
  • 模型在客户端 wire 中记录的思考将该范围描述为约 50.1K/51.0K。历史请求中完整注入的 nudge 未留存,因此这里是客户端 wire 的证据,不是对当时 HTTP 请求正文的直接验证。
  • 13:49:57:模型添加第二个范围后,通过了所有范围合计的字符门槛,创建 b56/b57。持久化的 b56 原始内容只有两条消息,顺序为 m08040、m06185,证实工具实际选择的范围很小。b56 的摘要却有 2471 字符,描述的历史明显超过这两条源消息。
  • 13:50:57:模型改用另外三个范围,才压缩掉主要历史内容。随后 b59/b60 吸收了 b56/b57。

合成复现用于隔离确定性的“范围展示与执行不一致”问题,并不声称完整重建了历史请求,也没有完整追溯较旧引用出现在较后消息位置的全部过程。

相关实现位置

0.1.117 安装包的 dist/index.js:

  • formatRanges(),约 43668 行:按引用编号排序、合并;同时使用 last.endRef = e.endRef 与独立的 last.endNum = Math.max(...)。
  • resolveBoundaries(),约 44332 行:按消息数组位置解析范围,并交换反向端点。
  • applyCompression(),约 46019 行:按实际解析出的消息,对本次请求的范围合计字符数进行门槛检查。

建议增加回归测试:当引用编号在当前消息序列中非单调时,resolve(format(ranges)) 仍应保留原始消息覆盖范围;展示的消息数和大小必须对应实际可选中的同一组消息。

Activity

  1. kuviki commented on Sep 17, 2026

    @kuviki
    ContributorAuthor

    继续,看下 issue #888 是否相关

  2. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    核对了本仓当前 pin 的 acp-kernel 源码(bundled 实现),结论如下。

    判定:相关但不同源,不建议把 #888 并入 #887

    两个 issue 同处一个场景族——subagent 交错导致「引用编号与当前消息顺序非单调」+ 上下文快速变密。但 #888 里的两条报错都不是 #887 那个 bug,而是各自独立的缺陷。

    #887 的根因(代码确认)

    • formatRanges()(acp-kernel dist/chunk-37CVFHFQ.js:270)按引用编号数字排序:entries.sort((a,b)=>a.startNum-b.startNum);编号空间重叠就合并(:274),合并时只更新 last.endRef/last.endNum、累加 count/tokens,不重算真实消息集合(:275-276)。
    • resolveBoundaries()(dist/index.js:425)按当前消息数组位置解析端点;端点倒序时直接交换:if (startIndex>endIndex) [startIndex,endIndex]=[endIndex,startIndex]。
    • 编号非单调时,显示范围的端点在消息数组里倒序 → 交换 → 只选中相邻小片 → 门槛检查失败 → Total compressible content too small(index.js:2225-2236)。这正是你复现到的现象。

    #888 的两条报错逐条对照

    ① Summary too long (27417 chars, max 20000) —— 与 #887 无关

    ② no valid ranges parsed (kind=no-valid-ranges, dropped=2) —— 也不是 #887

    • 触发点在解析阶段 parseCompressArgs→validateEntry()(index.js:4005)。它只做结构校验:条目是不是对象、有没有 start/end 边界、summary 是否非空。不检查引用是否存在、是否有序、在消息数组里的位置。
    • 因此「编号非单调」在结构上不可能触发 no-valid-ranges——它只能由缺字段 / 空 summary / JSON 无法 salvage 引起。
    • [Bug] 消息引用编号与当前顺序不一致时,compress 范围提示会选错消息,导致“内容不足”失败 #887 的 bug 在其后的解析/门槛阶段(resolveBoundaries + gate),报 "too small" 而非 "no valid ranges"。两者管道阶段不同、判据不同。
    • 这条要拿到 bili.log 里 reasons=[entry 0: …, entry 1: …] 那行才能定位具体哪个结构检查挂了(使用Pi subagen时经常出现这个问题 #888 线程已在等这份日志)。

    建议

    一句话总结:#888 与 #887 只是同属 subagent 交错这一场景,但 #888 的两条报错(单摘要超限、结构解析失败)都不是 #887 的范围解析不一致 bug,属独立缺陷,不该并入 #887;#887 本身要修的是 acp-kernel 的 formatRanges/resolveBoundaries,我会走跨仓发版路径处理。

  3. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    先修本issue

  4. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    已定位并修复 #887 的根因。修复在 acp-kernel(跨仓库),因为出问题的 formatRanges 合并逻辑在 kernel 里,billion-context 只是把它 inline bundle 进来。

    根因:formatRanges() 按引用编号(ref number)排序 + 合并候选区间,但 resolveBoundaries() 按当前消息数组里的位置解析端点。当 ref 编号与数组顺序不一致时(子 agent 交错 / 中间插入 summary 节点),合并后的端点对会被 resolveBoundaries 折叠成极小切片 → 显示的大小 ≠ 实际可选内容 → minCompressRange 闸门报 Total compressible content too small。

    修法:让每个区间携带首尾消息的数组下标(startIndex / endIndex),在 buildCompressibleRanges → mergeBatch → formatRanges 全程按位置(gap ≤ 1 slot)排序合并,而不是按 ref 编号。

    • 对密集单调 ref(常见情况)输出逐字节不变;
    • 无下标的手工构造区间回退到旧的 ref 编号行为(不破坏兼容);
    • 顺带消除 ref 空洞导致的过度碎片化(符合代码库 "array adjacency, never ref arithmetic" 的既有原则)。

    改动文件:src/types.ts、src/recommend.ts、src/nudge-text.ts,新增回归测试 tests/range-coverage.test.ts。

    回归测试:复现 #887 的最小场景(5 条消息、非单调 ref、低 ref 的 user 消息排在更高 ref 之后),断言 resolve(format(ranges)) 覆盖所有原始消息。已在旧代码上验证为 not ok 1(失败)、新代码通过。tsc --noEmit / 全量测试(807 pass, 0 fail)/ npm run build 全部通过。

    PR:ranxianglei/acp-kernel#324 (acp-kernel)

    后续顺序(跨仓库依赖,按 AGENTS.md §5,需要人工介入):

    1. 人工合并 acp-kernel PR feat: clamp effective window to codex's model perception for codex clients (#321 PR-E1) #324 → CI 自动发布新版 acp-kernel 到 npm;
    2. npm view acp-kernel version 确认新版本已上线;
    3. 再在 billion-context 里把固定 pin 的 acp-kernel devDependency(当前 0.0.69)升到新版本,单独出一个变更/release。

    ⚠️ 我不会自己合并 PR 或跑 npm publish(agent 被系统规则禁止)。第 1 步需要 owner 手动 merge;等 merge + publish 完成、新版本确认上线后告诉我,我再做 billion-context 这边的版本 bump。

  5. ranxianglei commented on Sep 17, 2026

    @ranxianglei
    Owner

    内核已经合并 本issue关闭 后续pin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions