Repository navigation
Description
问题概述
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 字符。
具体过程:
formatRanges()因为 6185 < 7522,将第二个范围排到第一个范围前面。- 按引用编号判断两个范围重叠并合并,把
last.endRef更新为后遍历范围的m08040,最终输出m06185–m08040。 - 消息数与 token 数仍是两个原始范围的合计。
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
kuviki commentedon Sep 17, 2026
继续,看下 issue #888 是否相关
ranxianglei commentedon Sep 17, 2026
核对了本仓当前 pin 的 acp-kernel 源码(bundled 实现),结论如下。
判定:相关但不同源,不建议把 #888 并入 #887
两个 issue 同处一个场景族——subagent 交错导致「引用编号与当前消息顺序非单调」+ 上下文快速变密。但 #888 里的两条报错都不是 #887 那个 bug,而是各自独立的缺陷。
#887 的根因(代码确认)
formatRanges()(acp-kerneldist/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 无关validateCompressionRange()(index.js:2727,报错在:2743),校验的是单条 range 摘要字符数是否超过compress.maxSummaryLength(默认 20000,index.js:325)。②
no valid ranges parsed (kind=no-valid-ranges, dropped=2)—— 也不是 #887parseCompressArgs→validateEntry()(index.js:4005)。它只做结构校验:条目是不是对象、有没有 start/end 边界、summary 是否非空。不检查引用是否存在、是否有序、在消息数组里的位置。resolveBoundaries+ gate),报 "too small" 而非 "no valid ranges"。两者管道阶段不同、判据不同。bili.log里reasons=[entry 0: …, entry 1: …]那行才能定位具体哪个结构检查挂了(使用Pi subagen时经常出现这个问题 #888 线程已在等这份日志)。建议
formatRanges+resolveBoundaries),按仓库规范属跨仓依赖——需先改 acp-kernel 并单独发版,再回本仓 bump 版本。根因已确认,我接下来走这条路径提 PR。一句话总结:#888 与 #887 只是同属 subagent 交错这一场景,但 #888 的两条报错(单摘要超限、结构解析失败)都不是 #887 的范围解析不一致 bug,属独立缺陷,不该并入 #887;#887 本身要修的是 acp-kernel 的 formatRanges/resolveBoundaries,我会走跨仓发版路径处理。
ranxianglei commentedon Sep 17, 2026
先修本issue
ranxianglei commentedon Sep 17, 2026
已定位并修复 #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 编号。改动文件:
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,需要人工介入):
npm view acp-kernel version确认新版本已上线;acp-kerneldevDependency(当前0.0.69)升到新版本,单独出一个变更/release。npm publish(agent 被系统规则禁止)。第 1 步需要 owner 手动 merge;等 merge + publish 完成、新版本确认上线后告诉我,我再做 billion-context 这边的版本 bump。ranxianglei commentedon Sep 17, 2026
内核已经合并 本issue关闭 后续pin
kernel: normalize reversed ref-pair display to ascending labels (ranx…
fix: client abort miscounted as weak overflow; opencode-local system …