Skip to content

proxy 工具参数 JSON 解析失败被降级为空对象执行,原始字符串被丢弃、lenient 容错层被绕过 #1502

Closed

Description

@tjp72

当模型给出的 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);   // ← 直接进容错链
}

这个入口是通的,只是没人把字符串递给它。

两个后果:

  1. core.ts 的 JSON.parse 一旦失败,原文就被换成 {};{} 是对象,于是绕过 parseCompressArgs 的字符串分支,直接落到 parseObjectValue —— 容错阶梯(tryParseLenient / normalizeSingleQuotes / stripFence / salvageContentEntries)一次都不会运行。
  2. 用户可见的回执变成 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

  1. ranxianglei commented on Sep 27, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 Triage 完成(已本地复现验证),开始实现,PR 出来后再回。

    复现验证(当前 master ea40f91,本地 repro):

    • 带尾逗号的 {"content": [...]}(严格 JSON.parse 拒绝)走现有路径 → 降级 {} 后 kind=missing-content keys=[],与真空调用完全不可区分;
    • 同一原始字符串直接喂 kernel 宽松版 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 的测试框架)。

  2. ranxianglei commented on Sep 27, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    [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。

    行为变更披露(旧 → 新)

    场景 旧 新
    可救回但严格解析失败的 compress 参数(尾逗号/单引号/fence/含完整条目的截断前缀) 按 {} 执行 → 什么都没压,receipt 说 "carried no content at all" 且劝模型别再重试 走内核 salvage ladder → 压缩成功
    真正不可解析的参数 receipt no valid ranges parsed (kind=missing-content) + 空调用劝退语(错误建议:语法修好本可重试) receipt 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 非流式站点无日志) compress 显示 "routing the raw string to the lenient parser";全部站点加 tail=(后 200 字符,截断 vs 中段损坏的决定性判据)
    真空调用({}/无参数) #1384 定向空调用 receipt 不变(有测试钉住)

    wire 保真度不受影响(#1039:工具参数字节级原样转发,此改动只影响 bili 服务端对自己 proxy-tool 调用的解析);两种压缩模式均已核对(plugin 模式下注入被抑制、agent 自持执行,不经过此路径)。

    验证

    修复了 proxy 侧三处「JSON.parse 失败即丢原始字符串降级为 {}」的根因(compress 参数改路由到内核宽松 salvage 层,救不回时给出独立的损坏 receipt 而非误判为空调用),已开 PR #1508,可以审查合并。

  3. ranxianglei commented on Sep 27, 2026

    @ranxianglei
    Owner

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 补充:PR #1508 的完整审查已完成,结论可以合并——详见 #1508 的审查评论(含既有行为逐项清点、内核契约源码核实、rebase 到当前 master 后的本地全绿验证、CI 13/13 全绿)。审查中新增披露一处跨路径效应:非流式 OpenAI/Responses 路径本就把原始字符串直传宽松解析器,新的「参数损坏」回执在这两条路径同样生效(回执措辞统一,#847 守卫键不变)——属同一设计意图的自然延伸,非回归。合并由人工执行。

  4. added a commit that references this issue on Sep 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingp1

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions