fix(engine): 信封解包吞掉顶层兄弟键致死循环——op 落在 arguments 外曾被直接丢弃

用户实测:glm-5.3-flash 建定时任务 6 连败,每轮 'Missing Params: op' 且看到错误提示
仍不修复(发送形态里逐轮增长的 user 行是 errAck 改写后的错误教学,反馈通路正常——
主因是模型习惯,但追查揪出代码同谋)。

unwrapToolArgs 第 3 条信封规则原样 inner = cur.arguments:若模型输出
{"op":"create","arguments":{...}}(op 在信封外),解包把顶层兄弟键连坐丢弃——
op 被代码杀死,且报错信息里模型永远看不到自己写过的 op,无限重试。

- 规则重写:arguments 对象/字符串形统一先解成对象;单键纯信封直剥,多键信封把
  兄弟键与参数体浅合并(剥层不吞键);arguments 是解析不了的坏字符串时保持原样不动;
- 影响面:全部 op 型工具(schedule/skill/db/profile/lab)同治;
- checkToolArgs 错误文案面向弱模型增强:点名缺失字段+枚举候选值+'参数必须放顶层'
  现场教学,替代干瘪的 'Missing Params: op';
- unwrapToolArgs/checkToolArgs 纯函数导出(探针复用,与 wechat.findAttachments 同例)。

探针 9 项全过:对象/字符串信封+兄弟键保留、纯信封剥离、无包裹恒等、坏字符串原样保留、
Missing 教学文案、正常放行、skill 同治、无 arguments 键不受影响。
This commit is contained in:
2026-09-29 19:15:38 +08:00
parent 23ede0fe61
commit 2a1453ce9d
+23 -3
View File
@@ -959,7 +959,12 @@ function checkToolArgs(tools, name, raw) {
// 必填串参传空的场景由各工具自己的中文校验兑底(path 空→「路径不能为空」,url 空→「缺少参数 url」…)。
const missing = required && required.length
? required.filter(k => args[k] == null) : [];
if (missing.length) return { args: null, error: 'Error: ToolCall Missing Params: ' + missing.join('、') };
if (missing.length) {
// 错误回显面向弱模型:点名缺失字段 + 枚举候选值 + 指出必须落在参数顶层(信封形错误现场教学)。
const props = (def && def.function.parameters && def.function.parameters.properties) || {};
const hints = missing.map(k => (props[k] && Array.isArray(props[k].enum)) ? k + '(可选值:' + props[k].enum.join('|') + ')' : k);
return { args: null, error: 'Error: ToolCall Missing Params: ' + hints.join('、') + '。必填参数缺失,请补全后重新调用(参数必须直接放在顶层,不要包在 arguments 等外层里)。' };
}
return { args, error: null };
}
@@ -990,8 +995,21 @@ function unwrapToolArgs(tools, name, raw) {
}
// {"function": {...}} 信封
if (!inner && keys.length === 1 && keys[0] === 'function' && cur.function && typeof cur.function === 'object') inner = cur.function;
// {"name": "...", "arguments": {...}} 信封
if (!inner && !hasArgProp && cur.arguments && typeof cur.arguments === 'object') inner = cur.arguments;
// {"name": "...", "arguments": {...}} 信封(arguments 为字符串时先解一层再判):若顶层除信封键外还有
// 兄弟键(如模型把 op 落在包裹外),必须合并保留——只剥层不吞键;
// 曾因吞掉顶层 op 造成「Missing Params: op」无限重试死循环。
if (!inner && !hasArgProp && cur.arguments != null && !Array.isArray(cur.arguments)) {
let a = cur.arguments;
if (typeof a === 'string') { try { a = JSON.parse(a); } catch (_) { a = null; } }
if (a && typeof a === 'object') {
if (Object.keys(cur).length === 1) inner = a;
else {
inner = Object.assign({}, cur);
delete inner.arguments;
Object.assign(inner, a);
}
}
}
if (!inner) break;
cur = inner;
changed = true;
@@ -1467,6 +1485,8 @@ module.exports = {
getRun,
taskDirOf,
loadHistory,
checkToolArgs, // 参数预检/信封解包两个纯函数:导出供探针与回归验证(运行链路由 runLoopInner 内部调用)
unwrapToolArgs,
saveMessage,
recordModelUsage,
modelUsageStats,