CodeScan 实战(05):save_threat_model 为什么会收到空参数

系列目录 · 第 05 篇

有一类错误很容易误判成“模型不会调用工具”:

1
2
3
save_threat_model {}
Error: invalid tool input:
input: missing required property "expected_revision"

这个回执能确认的是:工具校验层收到的参数没有必填版本号。仅凭它,还不能确定参数在哪一层丢失,也不能确定所有类似错误具有同一个根因。

0x01 一次保存经过了哪些环节

保存威胁模型并不是把一段模型文字直接写入数据库。实际链路至少包含:

1
2
3
4
5
6
7
8
9
10
11
工具定义与 required 字段
↓
模型响应中的 tool call
↓
流式事件、参数分片与 SDK 累积
↓
JSON 解码与输入契约校验
↓
版本比较、源码引用与模型结构校验
↓
事务保存与小型回执

报错发生在哪一层,决定了该查哪里。缺少 expected_revision 属于输入契约错误;证据引用不存在,属于业务校验错误;connect: connection refused 则是在连接模型服务时就失败。这三类故障不应该都显示成一个笼统的“模型错误”。

0x02 为什么不能删掉 expected_revision

这个字段负责并发版本比较。假设 Planner 读到模型版本 7,操作员随后补了一条信任边界,数据库已到版本 8。Planner 再提交基于版本 7 的整份模型,直接覆盖会把人工修改抹掉。

正确行为是拒绝旧版本提交,重新读取上下文后再合并。把必填字段去掉,或者由宿主一律补成当前版本,会掩盖冲突,让一次看似成功的保存变成数据丢失。

调用前应先读取 get_audit_context,使用其实际版本。支持文件提交的版本,可以在任务目录写好完整模型,再提交以下结构的参数:

1
2
3
4
{
"expected_revision": <刚读取的真实版本号>,
"model_path": "<任务目录内的模型 JSON 相对路径>"
}

这里是参数结构说明,尖括号需要替换。具体字段仍以当前部署实例暴露的工具 schema 为准,不能把旧版本样例直接当成接口规范。

0x03 修了什么

当时排查发现,大参数保存还会受到流式参数组装和回执体积的影响。围绕这条链路做了几件事:

位置 改造
参数接收 累积参数分片,处理文本、用量事件与参数事件交错
解码失败 保留参数长度、摘要和截断诊断,拒绝执行保存
工具定义 保留 required、数组结构和版本比较约束
大模型提交 支持任务目录内的 model_path,限制路径边界与 4 MiB 大小
业务校验 把缺失引用、非法状态定位到具体字段
工具返回 返回版本、摘要及有限缺口,避免整份模型再次灌回上下文

小回执解决的是下一轮上下文膨胀,文件提交解决的是超长参数传输。两者都不能替代模型结构和证据校验。

当次历史快照统计过 43 次保存调用,其中 27 次是空对象。这是排查时点的统计,不是永久累计值,也不能据此把每一次空对象都归因于截断。

0x04 后续复查没有支持“已经彻底解决”

复查时,仍观察到字面两字节 {} 到达工具层,并在执行保存前被 schema 拦下。说明早期补丁覆盖了可复现的组装问题,但没有消灭所有空参数来源。

要继续定位,需要关联同一请求的工具定义、原始请求、原始响应、分片事件和最终解码参数。当时缺少能够一一对应的完整原始报文,因此不能断言是模型直接生成了空对象、协议转换丢了内容,还是后续累积过程出错。

并发运行两个任务也只提供了排查线索,不能单凭时间相关性认定“并发把参数串了”。

0x05 这一轮留下的工程规则

保存失败必须保留失败,不伪造成功回执;版本冲突必须重读,不静默覆盖;日志可以帮助定位参数状态,但不应默认复制整份源码、模型正文或凭据。

本轮验收覆盖了针对性的 Go 测试、工具 schema、流式分片和大模型保存路径。它证明这些受控输入按预期处理,没有证明所有供应商、模型模板和代理转换路径都正常。

工具注册与参数解码实现,以及后续空参数排查记录。遇到同类错误,先保存请求关联标识和发生层次,再决定重试或修复哪一段链路。

上一篇:任务生命周期 · 下一篇:目标拆解恢复

http://www.pa55w0rd.online/codescan-05/