unknown tool "" / 会话历史加载失败:流式 tool_calls 空 delta 覆盖了首块 id/name

[WilShi]

DeepSeek 流式返回工具调用时,首块带正常 id/name,后续 delta 里 id/name 若为空字符串,会把首块的值覆盖成空,导致 unknown tool "" 且 callId 为空;该会话下次加载时历史直接读不出来。

最小复现

两个 SSE data 帧,第二帧把 id/name 清成空串:

data: {"choices":[{"delta":{"tool_calls":[{"index":0,"id":"call_1","type":"function","function":{"name":"get_weather","arguments":""}}]}}]}

data: {"choices":[{"delta":{"tool_calls":[{"index":0,"id":"","type":"function","function":{"name":"","arguments":"{\"city\":\"Paris\"}"}}]}}]}

data: [DONE]

装配出来的 tool call:id=""、name="" → ToolNotFoundError("unknown tool \"\""),且 tool/result 的 source.callId 为空字符串。

根因

packages/llm/llm-deepseek/src/translate.ts:

if (call.id !== undefined) block.callId = call.id
if (call.function?.name !== undefined) block.name = call.function.name

!== undefined 对空串为真,后续 delta 的空串 id/name 覆盖首块。closeBlock 里 id: CallId(block.callId ?? '') 在流里没有 id 时直接落空串,没有兜底(通用装配器 packages/llm/llm/src/assembler.ts 有 ?? CallId('call-${index}'))。

空 callId 写进 tool/result 后,会话校验 assertMessageEventShape(packages/core/session/src/index.ts,空 source.callId 被拒)在重新加载时抛 must have tool source → SessionPersistenceCorruptionError → history unavailable,整条会话历史加载失败。模型发一次空 id 工具调用就卡死该会话。

修复(已本地验证)

// 只在非空串时赋值,避免空串 delta 覆盖首块
if (typeof call.id === 'string' && call.id !== '') block.callId = call.id
if (typeof call.function?.name === 'string' && call.function.name !== '') block.name = call.function.name

closeBlock 加兜底:

id: CallId(block.callId && block.callId !== '' ? block.callId : `call-${block.index}`),

加了两个测试(空串 delta 覆盖、流里无 id),并更新了原断言“无 id 输出空 id”的用例;pnpm vitest run packages/llm/llm-deepseek/tests/translate.spec.ts 32/32 通过。

和 #879 #885 #161 #615 #725 #887 #890 同一根因,这条补上具体复现和补丁。

修复已在 fork 上:WilShi/deepseek-harness 分支 fix/llm-deepseek-empty-toolcall-delta(commit 82f3634),含两个回归测试。

[Electricitysheep]

这个根因我们 FAQ 已收录（#725 同族）：SSE 流式分块对 block.name/callId 覆盖赋值，空 delta 把首块值抹空。官方修复前可：降级非流式 / 及时中止重试。

详见：https://github.com/Electricitysheep/dsh-handbook/blob/main/docs/faq.md