Repository navigation
Description
当模型给出的 proxy 工具参数是无法被裸 JSON.parse 解析的字符串时,src/loop/core.ts:686-692 把整串丢弃并代之以 {},然后照常执行工具。
关键在于:下游本来就有一条完整、宽松、专门为这种输入准备的入口(parse-compress-input.ts:70 parseCompressArgs),
它的函数文档写得很直白:
Accepts a decoded object, a JSON string (possibly fenced, trailing-comma, raw-newline, or double-stringified), or a truncated JSON prefix (salvage mode).
而且它第一件事就是判字符串(:86):
if (typeof input === "string") {
return parseStringInput(input, callId, diag); // ← 直接进容错链
}这个入口是通的,只是没人把字符串递给它。
两个后果:
core.ts的JSON.parse一旦失败,原文就被换成{};{}是对象,于是绕过parseCompressArgs的字符串分支,直接落到parseObjectValue—— 容错阶梯(tryParseLenient/normalizeSingleQuotes/stripFence/salvageContentEntries)一次都不会运行。- 用户可见的回执变成
no valid ranges parsed (kind=missing-content),把"参数语法损坏"和"模型发了个空调用"呈现为同一个错误,无法区分。
修复方向很小:不要提前降级,把原始字符串递给已经接好的字符串入口。
环境
- billion-context 0.1.160(npm latest,逐字比对确认;问题出现于 0.1.152,并已复核 0.1.158 → 0.1.160 该路径均未被修改)
- 客户端 opencode(ACP 模式),Windows
- 上游为 OpenAI-compatible 网关(host 由 bili 日志自行脱敏为
<private-host>)
现象与数据
0.1.152 引入了 #1306 的诊断日志(感谢),它第一次让这类情况可观测。本机至今共命中 2 次:
2026-09-25T21:52:09.937Z [info] [pfa-9625af0fe4193ecc] [acp-loop] proxy tool compress: arguments not parseable JSON (len=28543, head={"content": [{"startId": "m00002", "endId": "m00026", "topic": "…", "summary": "## 环境事实(本机)\n- `cargo` 不在 Bash 默认 PATH:必须 `export PATH=\"<home>/.cargo/bin:$PATH\"` 后用 `) — executing with {}
2026-09-25T21:52:09.938Z [warn] [acp-compress-input] rejected: kind=missing-content invalidItems=0 keys=[]
2026-09-25T21:52:09.938Z [info] [pfa-9625af0fe4193ecc] [acp-proxy: compress call had no valid ranges; nothing compressed.]
2026-09-25T21:52:09.939Z [info] [pfa-9625af0fe4193ecc] [acp-loop] round 1: proxy tool executed; re-requesting so the model sees the result]
2026-09-25T22:58:17.875Z [info] [pfa-370eaca2fa1ab15e] [acp-loop] proxy tool compress: arguments not parseable JSON (len=22029, head={"content": [{"startId": "m00002", "endId": "m00090", "topic": "…", "summary": "## 用户目标与硬约束(延续自上一会话,仍然有效)\n\n控制指令(上一会话,历史引用):\n> 「…遵守 agents.md 和 plan,1) — executing with {}
2026-09-25T22:58:17.875Z [warn] [acp-compress-input] rejected: kind=missing-content invalidItems=0 keys=[]
(原文照录,仅截断 head= 展示长度、并以 … 隐去与本问题无关的业务内容,未改动时间戳与错误文本。)
| 指标 | 值 |
|---|---|
| 命中次数 | 2 |
len |
28543 / 22029(参数完整送达,非截断) |
| 失败类型 | 两次均为 kind=missing-content invalidItems=0 keys=[] |
| 上游 stream error | 0(两次请求均正常结束,非流截断) |
breaking early |
0(模型换参数重试后成功,未触发 #156) |
两次的形态高度一致:参数完整送达、前缀合法、中段出现中文与 Markdown 代码块。
keys=[] 的语义是确定的:parse-compress-input.ts:164-169 的 parseObjectValue 在入口处执行
diag.keys = Object.keys(value),即只要 value 是一个真实对象,keys 就必然包含它的键名,
不可能是空数组。keys=[] ⟺ value 就是 {}。
这恰恰是本 issue 的关键证据:日志显示参数完整送达(len=28543),但下游解析器收到的却是
{} —— 中间那次降级把 28KB 的内容换成了空对象,从而 content === undefined 走
missing-content 分支(第 179-180 行)。"26KB 的坏 JSON"与"模型发了个空调用"在下游
完全同形,这正是本条建议要解决的问题。
代码路径
关键事实:项目里存在两套解析器,而 proxy 工具路径接的是「宽松」那一套 —— 却因为上游一次降级,永远收不到字符串。
| 解析器 | 位置 | 是否接受字符串 |
|---|---|---|
parseCompressArgs(宽松,新) |
acp-kernel/src/parse-compress-input.ts:70 |
接受 —— :86 if (typeof input === "string") return parseStringInput(...) |
parseCompressInput(严格,旧) |
acp-kernel/src/compress-tools.ts:171 |
拒绝 —— :176 if (!input || typeof input !== "object") { onWarn(...); return []; } |
src/loop/core.ts 走的是前者(经代理层包装):
core.ts:12 import { ..., parseCompressInput } from "./compress-tool.js";
core.ts:225 return applyRanges(parseCompressInput(args, callId), ctx);
compress-tool.ts:14 import { parseCompressArgs, ... } from ...acp-kernel
compress-tool.ts:249 export function parseCompressInput(input, callId?) {
const parsed = parseCompressArgs(input, { callId }); ← 宽松解析器
...
parseCompressArgs 的文档注释(parse-compress-input.ts:62-69)明确写着它接受:
a JSON string (possibly fenced, trailing-comma, raw-newline, or double-stringified), or a truncated JSON prefix (salvage mode)
也就是说 —— 修这个 bug 所需的全部容错能力,早已接在 proxy 工具路径上。
调用链与降级点:
| # | 位置(0.1.160) | 行为 |
|---|---|---|
| 1 | src/loop/core.ts:685-693 |
try { parsedArgs = call.arguments.length > 0 ? JSON.parse(call.arguments) : {}; } catch { ...; parsedArgs = {}; } —— 原始字符串在此处被丢弃 |
| 2 | src/loop/core.ts:218 executeProxyTool(...) |
签名收 args: Record<string, unknown> —— 已是对象,拿不到原始字符串 |
| 3 | src/loop/core.ts:225 |
return applyRanges(parseCompressInput(args, callId), ctx); |
| 4 | src/compress-tool.ts:249-250 |
包装层 → parseCompressArgs(input, { callId }) —— 接受字符串的宽松入口 |
| 5 | acp-kernel/src/parse-compress-input.ts:86-88 |
if (typeof input === "string") return parseStringInput(input, callId, diag); |
| 6 | acp-kernel/src/parse-compress-input.ts:98-129 |
parseStringInput → stripFence → parseStringCore → tryParseLenient → normalizeSingleQuotes 重试 |
| 7 | acp-kernel/src/parse-compress-input.ts:159-161 |
前缀不可解析时 salvageContentEntries(cleaned) 逐条抢救 + looksTruncated(cleaned) |
即:第 4-7 步那条完整的 salvage 阶梯一直在链上,只是永远收不到输入 —— 因为第 1 步已经把 28KB 的字符串换成了 {},
parseCompressArgs({}) 于是走 :95 parseObjectValue,diag.keys = [],
content === undefined → missing-content(:171 的 if (content === undefined))。
这与 parseStringInput 里那两套为"模型输出不完美"专门准备的兜底(单引号漂移重试、前缀损坏抢救)的设计意图完全相反:
它们针对的正是本例的输入形态,却因为一次上游降级全部短路。
附注:
acp-kernel/src/compress-tools.ts:171那个严格版parseCompressInput是另一个函数,
被stream.ts/preflight.ts/stream-openai.ts/stream-responses.ts等路径使用(其中stream-openai.ts:25
与stream-responses.ts:39直接传tc.function?.arguments原始字符串 —— 说明"字符串直传"在这些路径上是既有实践)。
本 issue 只涉及loop/core.ts这条走宽松版的路径。
为什么 head= 不足以定位(建议 3 的动机)
#1306 的日志只打印 head(前 200 字符)。这两次的 head 都显示前缀是合法 JSON 开头,所以"坏在哪"无法从现有日志判定。
要区分「字符串被截断」与「内容语法损坏」,尾部才是判别位:
- 截断 ⇒ 末尾不完整(缺少收尾的
}/]/ 引号),且len会是某个中间值 - 语法损坏(未转义控制字符 / raw newline / quote drift)⇒ 相邻字符本身非法
本机这两次均无 stream error,倾向于后者(内容层面的未转义字符 —— 参数中含 Markdown 代码块与中文,属于 \n / \" 最密集的输入),但现有证据不足以定论。
建议
1)fallback 时把原始字符串交给容错链,而不是降级为 {}
这是根因修复的方向:JSON.parse 失败不该等价于"参数为空"。
而且这条修复的成本极低 —— 容错链已经接在链上了,只差把字符串递进去。
src/loop/core.ts:12 导入的 parseCompressInput 是 src/compress-tool.ts:249 的包装函数,
它转手调用 kernel 的宽松解析器 parseCompressArgs:
compress-tool.ts:249 export function parseCompressInput(input, callId?) {
const parsed = parseCompressArgs(input, { callId }); ← 宽松解析器
parseCompressArgs(acp-kernel/src/parse-compress-input.ts:70)第一件事就是判字符串:
parse-compress-input.ts:62-69 文档:"Accepts a decoded object, a JSON string (possibly fenced,
trailing-comma, raw-newline, or double-stringified),
or a truncated JSON prefix (salvage mode)."
86-88 if (typeof input === "string") return parseStringInput(input, callId, diag);
98-106 parseStringInput → stripFence → parseStringCore
142 let value = tryParseLenient(cleaned); ← 宽松 JSON(trailing-comma / raw-newline)
146 tryParseLenient(stripFence(value)) ← 双重字符串化
113 normalizeSingleQuotes(cleaned) ← 单引号漂移重试
160 salvageContentEntries(cleaned) ← 前缀不可解析时按条目抢救
也就是说:修这个 bug 所需的整套容错阶梯,早已接在 proxy 工具路径上,只是永远收不到输入 ——
因为 core.ts:688 的裸 JSON.parse 已经把字符串换成了 {}。
对比之下,acp-kernel/src/compress-tools.ts:171 那个同名但严格的 parseCompressInput(:176 硬拒非对象)
是给别的路径用的;core.ts 这条走的是宽松版。这个错配正是全部问题所在:
| 层(0.1.160 行号) | 是否接受字符串 | 失败时行为 |
|---|---|---|
loop/core.ts:686-692 顶层 |
只接受字符串(JSON.parse(call.arguments)) |
丢弃原文 → {} |
compress-tool.ts:249 包装 → parse-compress-input.ts:86 |
接受(typeof input === "string" → parseStringInput) |
走完整 salvage 阶梯 |
parse-compress-input.ts:142-161 parseStringCore |
接受 | 宽松解析 / 单引号重试 / 逐条抢救 |
坏掉的恰好是唯一没有容错的那一层(最外层 JSON.parse)。 一旦它失败,下游那条能救回来的链就再也拿不到原文。
所以正确做法只是让原始字符串走到 parseStringInput:
- 在
core.ts:689的 catch 里保留call.arguments原文(不要置{}),交给宽松入口; - 或在
executeProxyTool(core.ts:218)签名上增加可选rawArguments?: string,applyRanges优先用原文解析。
由于 parseCompressArgs 已经接受字符串,改动规模仅是"不提前把字符串转成 {}"。
这样 #362 那类 {ranges: …} 形状漂移、quote drift、围栏包裹、行形态、前缀损坏,
都能落回它们本来该走的 salvage 路径 —— 而不是被一个裸 JSON.parse 一刀切掉。
2)区分「参数为空」与「参数语法损坏」
维护者在 #1366/PR #1384 已引入 isEmptyCall 谓词,把"真正空调用"的回执改为「不要重发」。方向正确。但它依赖 rawReasons.length === 0 且不落在 {ranges} 漂移分支 —— 而 JSON.parse 失败后的 {} 恰好满足这个形状,于是"语法损坏的长参数"与"空调用"收到同一份回执。
本 issue 的两次命中正是踩在这里:日志明确记着 len=28543,却给出"carried no content at all"语义的 missing-content。
建议在降级路径上打一个区分标记(例如保留 argumentsLen 与 parseFailed: true),让回执能说「参数送达但无法解析」而非「调用为空」。
先例参考:刚落地的 PR #1454(修 #1453)在 re-request 传输失败路径上做了同类事情 —— 把
const kind = classifyUpstreamFailure(...)的分类结果做成TRANSPORT_FAILURE_LABELS,
只把 kind 级标签写进客户端流(注释:"raw error text can embed endpoint hostnames/IPs, which must never reach the client stream"),
完整链走日志。"给客户端一个安全的结构化标签、给日志完整原文" 这个模式已经被这个仓库接受,代价很小 —— 本建议可以照此办理。
3)诊断日志补 tail=
head= 已很有价值,建议再加一个 tail=(末尾 200 字符)。判"截断 vs 语法坏"时,尾部是决定性位置,成本仅是拼接一个切片。
与 0.1.160(npm latest)的比对结论
已解包 billion-context@0.1.160 并从 dist/index.js.map 还原 TypeScript 源逐一比对,本条路径未被修改:
| 检查项 | 0.1.160 结果 |
|---|---|
core.ts 的 parsedArgs = {} 降级 |
未被修改 —— 0.1.158 位于 592-600、0.1.160 位于 685-693,代码体逐字节一致(仅行号位移) |
core.ts 的 #1306 诊断日志 |
保留(len= / head=,措辞未变) |
新增 salvage / repair 相关符号(repairJson / salvageJson / tryRepair / coerceArguments / parseArgsLenient / parseJsonLoose / lenientJson / recoverArgs / salvageArguments) |
全库搜索均不存在 |
parseStringCore 容错阶梯(tryParseLenient / stripFence / normalizeSingleQuotes / salvageContentEntries) |
仍只存在于 acp-kernel/src/parse-compress-input.ts 内,未被 proxy 工具路径调用 |
parseCompressInput 入口是否接受字符串 |
未变,仍为 typeof input !== "object" 直接拒绝 |
0.1.158 → 0.1.160 之间,loop/core.ts 确有改动(911 → 1028 行),但改动全部集中在传输层,与本 issue 无关:
#1453:re-request传输失败改为 in-band 收尾(ending turn in-band instead of throwing)—— 对应UND_ERR_CONNECT_TIMEOUT重试链路#1455:loop 侧 upstream 响应统一接入 SSE tee;重取(re-fetch)门禁由「转发过任意字节」细化为「转发过有状态帧」,让 ping-only 截断轮次也能重取- 此外
src/compress-loop.ts被合并移除(buildVisibilityMarker内联进core.ts)
这些都不触及 proxy 工具参数的解析与降级路径。 本 issue 描述的静默降级(JSON.parse 失败 → {} → missing-content)在 0.1.160 上原样存在。
0.1.158 同期的相关修复是 #1384(fix: stop empty-compress-call retry loops — targeted no-content receipt),
它处理的是真正空调用({} / "")的回执措辞,让模型不要反复重发空调用 ——
方向正确,但不覆盖本 issue:JSON.parse 失败后的 {} 恰好与"空调用"同形,
反而会被那个针对空调用的新回执归类为"carried no content at all"。
Activity
ranxianglei commentedon Sep 27, 2026
[bot] 🏷 Triage 完成(已本地复现验证),开始实现,PR 出来后再回。
复现验证(当前 master ea40f91,本地 repro):
{"content": [...]}(严格JSON.parse拒绝)走现有路径 → 降级{}后kind=missing-content keys=[],与真空调用完全不可区分;parseCompressArgs→kind=ok,range 正常恢复;kind=truncated/malformed-json(带length),可以区分。Issue 的分析成立:
src/loop/core.ts:704-708的 catch 在 lenient 层之前丢弃原始字符串,整条 salvage 阶梯(stripFence / tryParseLenient / normalizeSingleQuotes / salvageContentEntries)被绕过。层次判断:这是根因级缺陷(用户 payload 在决策点被丢弃),不是表面症状;修复位置(catch 处保留原始字符串、走 lenient 入口)正确,且符合 #1039 wire-fidelity 原则(tool args 是用户意图,不得丢弃)。
附带发现(同根因,同 PR 修):Responses 非流式路径
src/compress-loop-responses.ts:99-104与:163-169有两处相同的 JSON.parse→{}降级。Gemini 非流式(stream-google.ts:28)与 MCP plugin(plugin.ts:926)路径线上本来就是结构化参数、无字符串形态,不属此根因。方案:①
executeProxyTool加可选rawArguments,解析失败时把原始字符串喂给 lenient parser;② receipt 区分「空参数」vs「语法损坏」(安全标签只带 len,沿用 #1454 模式);③ 诊断日志补tail=(#1306)。回归测试:单元级 + loop 级(复用 #1306 的测试框架)。ranxianglei commentedon Sep 27, 2026
[bot] 🏷 ## Triage verdict + fix landed
PR: #1508
审核结论(三步)
① 复现/查证 — 问题真实存在,且比你定位的还多两处同根因站点。 我直接用 acp-kernel 0.0.95 的
parseCompressArgs做了对照实验:你日志里那种len=28543、完整送达、严格 JSON.parse 失败的字符串,喂给宽松解析器是kind=ok keys=[content](可救回),而经loop/core.ts的 catch 降级成{}后变成kind=missing-content keys=[]—— 与你两条现场日志的指纹逐字吻合。另外在src/compress-loop-responses.ts找到了另外两处完全相同的裸JSON.parse+ 失败置{}(Responses API 流式surfaceProxyJson和非流式 re-request 分支;后者连形状日志都没有)。同一根因,按「一个根因一个 issue」原则合并在本 PR 一起修。核过不受影响的:stream-google.ts:28(Gemini 结构化 args,wire 上不存在字符串形态)、plugin.ts:926(MCP JSON-RPC 对象)、以及非流式 OpenAI/Responses/Anthropic 路径(本来就把原始字符串直接交给宽松解析器——你的方案 1 与既有实践一致)。② 层次判断 — 根因是调用点的前置降级,不是 receipt 文案。 表面现象是「missing-content receipt 误导模型」,但病灶是 raw string 在进入 lenient 层之前就被丢弃了。所以主修在三个 discard 点保留原始字符串并路由给宽松入口(你的方案 1,打在源头而非下游过滤);receipt 区分(方案 2)和 head+tail 日志(方案 3)作为配套落地。
③ 方案评估 — 你的三条建议全部成立并已实现,实现细节见 PR。
行为变更披露(旧 → 新)
{}执行 → 什么都没压,receipt 说 "carried no content at all" 且劝模型别再重试no valid ranges parsed (kind=missing-content)+ 空调用劝退语(错误建议:语法修好本可重试)the call's arguments (N chars) were not parseable JSON (+ looks truncated)+ 「以格式良好的 JSON 重发」;#847 守卫桶从parse:missing-content:0:移到parse:malformed-json|truncated:0:(损坏与真空成为不同失败类)…executing with {},只有 head=(Responses 非流式站点无日志){}/无参数)wire 保真度不受影响(#1039:工具参数字节级原样转发,此改动只影响 bili 服务端对自己 proxy-tool 调用的解析);两种压缩模式均已核对(plugin 模式下注入被抑制、agent 自持执行,不经过此路径)。
验证
tests/issue1502-raw-args-salvage.test.ts(7 个测试:单元级四种 salvage 变体、fix: stop empty-compress-call retry loops — targeted no-content receipt (#1366) #1384 空调用 receipt 钉住不变、不平衡/平衡垃圾各自的 corruption receipt + 出现持续压缩失败,无法自动恢复 #847 守卫键区分、两个runCompressLoop端到端测试)src/loop/**自动跑 e2e-codex修复了 proxy 侧三处「JSON.parse 失败即丢原始字符串降级为
{}」的根因(compress 参数改路由到内核宽松 salvage 层,救不回时给出独立的损坏 receipt 而非误判为空调用),已开 PR #1508,可以审查合并。ranxianglei commentedon Sep 27, 2026
[bot] 🏷 补充:PR #1508 的完整审查已完成,结论可以合并——详见 #1508 的审查评论(含既有行为逐项清点、内核契约源码核实、rebase 到当前 master 后的本地全绿验证、CI 13/13 全绿)。审查中新增披露一处跨路径效应:非流式 OpenAI/Responses 路径本就把原始字符串直传宽松解析器,新的「参数损坏」回执在这两条路径同样生效(回执措辞统一,#847 守卫键不变)——属同一设计意图的自然延伸,非回归。合并由人工执行。
Merge pull request #1508 from ranxianglei/wt-1502-ework-daemon
fix: route unparseable compress tool args to the lenient parser inste…