fix: v0.6.2 修复工具调用不稳定与会话停止 — 纯 tool_calls 轮丢失 assistant 消息导致 API 400
【根因(main.log 实证)】 19:04 / 19:05 / 19:06 三次会话终止均为同一报错: DeepSeek 400 "Messages with role 'tool' must be a response to a preceding message with 'tool_calls'" 缺陷链:engine 主循环仅在 step.thought 存在(该轮有文本或思考内容)时才 将 assistant 消息加入请求历史。当模型发起纯工具调用(零文本零思考 — DeepSeek 高频行为)时: - assistant(tool_calls) 消息不进 messages - 但 tool 结果消息照常 push → 下一轮请求出现孤立 tool 消息 → 协议 400(不可重试)→ 会话 ERROR 终止 "不稳定" = 模型每轮是否附带文本是概率性行为:带文本正常,纯调用必崩。 DB 持久化侧同源缺陷(if (!step.thought) continue)导致这些步骤的 assistant 与 tool 结果全部不落库 — 重启后工具上下文丢失,模型重复调用。 【修复】 - engine.ts: 有 toolCalls 的轮次必 push assistant(content=null,C-6 规范) - agent.ts: 持久化条件同步修复(无 thought 但有 toolCalls 的步骤落库) - 回归测试: 纯 tool_calls 轮后第二次请求中 tool 消息前必须是带 tool_calls 的 assistant(请求契约断言,engine-toolchain.test.ts) 【纵深防御 — 孤立 tool 消息过滤】 - openai-format.ts(DeepSeek/Agnes/MiMo/OpenAI 四家共享): 构建请求时 按 tool_call_id 配对过滤孤立 tool 消息(任何来源的历史污染不再 400 死锁) - anthropic.adapter.ts: tool_use/tool_result 同策略配对过滤 - 单测 ×6: 正常配对保留 / 孤立丢弃 / id 不匹配丢弃 / 多轮配对 / includeImages 原位转换 / 非 vision 静默丢弃 【多模态索引对齐收敛】 4 家 adapter 的 images 处理循环原按未过滤的 nonSystemMsgs[i-1] 对齐索引, 孤立 tool 过滤引入后会错位 — 统一收进 buildOpenAICompatibleMessages (includeImages 参数,基于 sanitized 序列原位转换),4 家 adapter 删除 各自的索引对齐循环(DeepSeek vision 判断 / OpenAI 推理模型拒绝保留在 adapter)。 【终止原因可见化】 MAX_ITERATIONS / TIMEOUT 终止此前无任何提示(用户感知"会话直接停止")— 前端 DONE 事件非 completed 终止原因显示为 system 消息。 【v0.6.1 回归缓解】 web_fetch timeoutMs 120s → 240s:浏览器回退串行化后并发 3 个排队最坏 ~127.5s,旧值让排队末位抓取被工具超时杀掉(表现为抓取不稳定)。 【验证】 lint 0/0;typecheck 双工程 0 错误;test:electron 259/259(+7); electron-vite build 成功
This commit is contained in:
@@ -230,6 +230,37 @@ describe('AgentLoopEngine 工具调用链路(adapter → 引擎 → 真实 Hoo
|
||||
expect(hook.getPendingConfirmations()).toHaveLength(0);
|
||||
});
|
||||
|
||||
it('v0.6.2 回归:纯 tool_calls 轮(零文本零思考)后,下一轮请求的 tool 消息前必须有带 tool_calls 的 assistant', async () => {
|
||||
// 会话停止根因(DeepSeek 400 "Messages with role 'tool' must be a response
|
||||
// to a preceding message with 'tool_calls'"):模型纯工具调用轮不产生
|
||||
// thought → 原实现跳过 assistant 消息 push → 孤立 tool 消息 → 下一轮 400。
|
||||
// 契约断言:第二次 sendStream 收到的 messages 中,tool 消息的前一条
|
||||
// 必须是带 tool_calls 的 assistant。
|
||||
executedTools.length = 0;
|
||||
recordedRequests.length = 0;
|
||||
const hook = new ConfirmationHook(makeMockWindow(), null);
|
||||
|
||||
const engine = makeEngineWithHooks(
|
||||
[toolCallEvent('read_file', { file_path: 'x.ts' }), textDoneEvent('finished')],
|
||||
hook,
|
||||
);
|
||||
|
||||
await engine.runStream(userMessage, 'sess-orphan-tool', [], systemPrompt);
|
||||
|
||||
expect(recordedRequests.length).toBe(2);
|
||||
const second = recordedRequests[1].messages;
|
||||
// 找到 tool 消息
|
||||
const toolIdx = second.findIndex((m) => m.role === 'tool');
|
||||
expect(toolIdx).toBeGreaterThan(0);
|
||||
// 前一条必须是带 tool_calls 的 assistant(修复前这里是 user — 孤立 tool)
|
||||
const prev = second[toolIdx - 1];
|
||||
expect(prev.role).toBe('assistant');
|
||||
expect(prev.toolCalls?.length).toBeGreaterThan(0);
|
||||
// 且该 assistant 的 toolCalls id 与 tool 消息的 toolCallId 配对
|
||||
const toolMsg = second[toolIdx];
|
||||
expect(prev.toolCalls!.some((tc) => tc.id === toolMsg.toolResult!.toolCallId)).toBe(true);
|
||||
});
|
||||
|
||||
it('HIGH 风险工具经用户批准后执行(pending → approve → 工具运行)', async () => {
|
||||
executedTools.length = 0;
|
||||
const hook = new ConfirmationHook(makeMockWindow(), null);
|
||||
|
||||
Reference in New Issue
Block a user