[Bug] All tool calls fail with UNKNOWN_TOOL (unknown tool "") when using Bailian (DashScope) deepseek-v4-flash as provider

[100w2]

[Bug Report] DSH 接入阿里云百炼 deepseek-v4-flash 时所有工具调用失败（UNKNOWN_TOOL / unknown tool ""）

DeepSeek Harness (DSH) tool calls all fail with UNKNOWN_TOOL (unknown tool "")
when the LLM provider is Alibaba Cloud Bailian (DashScope) deepseek-v4-flash.
Works fine with the official DeepSeek API and with Bailian's qwen models.

摘要 / Summary

在 DeepSeek Harness（@deepseek-ai/dsh-base 系）中，将 LLM provider 配置为阿里云百炼 OpenAI 兼容端点（https://dashscope.aliyuncs.com/compatible-mode/v1）、模型选择 deepseek-v4-flash 后：

• 对话正常（模型能正常回复）；
• 所有工具调用均失败，报 UNKNOWN_TOOL，错误信息为 unknown tool ""（工具名是空字符串）；
• 模型流式生成的内容正常，但解析出的工具调用对象只有 arguments、没有 name。

对照实验：同一 DSH 使用 DeepSeek 官方 API（api.deepseek.com）或百炼 qwen 模型（如 qwen3.7-flash）时，工具调用全部正常。问题稳定复现，指向 LLM 端点侧的流式协议差异。

环境 / Environment

项	值
OS	Windows 11（Git Bash / MINGW64）
DSH	DeepSeek Harness，基于 Cordis；核心包 @deepseek-ai/dsh-base、@deepseek-ai/dsh-llm-deepseek 等（安装于 ~/.dsh/profiles/node_modules/@deepseek-ai/）
LLM Provider	阿里云百炼 OpenAI 兼容模式 https://dashscope.aliyuncs.com/compatible-mode/v1
模型	deepseek-v4-flash（全小写 ID；百炼能力表标注支持 Function Calling）

现象 / Symptom

1. 模型正常回复用户消息；
2. 任何工具调用（包括 DSH 内置的 read 工具）都失败：Error: unknown tool ""；
3. DSH 调试面板显示解析后的 Payload 只有 {command, description} 等参数，缺少 name 字段；
4. 模型侧陷入"我以为我写了 name，但结果总是空"的循环重试。

排查过程 / Investigation

1. 排除工具侧与解析器

• pwsh 工具在 DSH 中注册名正确（name: "pwsh"），工具本身健康；
• 官方 API 下同会话内 read/write/edit/glob/grep 全部成功，说明 DSH 解析器与官方协议兼容良好。

2. 模型名验证

百炼对模型 ID 区分大小写：

model: "deepseek-V4-Flash"  →  {"code":"model_not_found", "message":"The model `deepseek-V4-Flash` does not exist or you do not have access to it."}
model: "deepseek-v4-flash"  →  正常响应

DSH 配置（~/.dsh/settings.yaml）中使用的为全小写 ID deepseek-v4-flash，模型名无问题。

3. 百炼接口直测（关键证据）

用 curl 分别以非流式与流式调用百炼 deepseek-v4-flash，请求体相同（含 tools 与 tool_choice: "auto"）：

非流式（stream 缺省）→ 完全正常：

{
  "choices": [{
    "message": {
      "content": "",
      "role": "assistant",
      "tool_calls": [{
        "function": { "arguments": "{\"command\": \"Get-ChildItem\"}", "name": "pwsh" },
        "id": "call_fe0aed254fba43f9a54a89f4",
        "index": 0,
        "type": "function"
      }]
    },
    "finish_reason": "tool_calls"
  }]
}

流式（"stream": true）→ 增量 chunk 中 name/id 为显式空字符串：

chunk1: "tool_calls":[{"index":0,"id":"call_7df9...","type":"function","function":{"name":"pwsh","arguments":""}}]
chunk2: "tool_calls":[{"index":0,"id":"","type":"function","function":{"name":"","arguments":"{"}}]
chunk3: "tool_calls":[{"index":0,"id":"","type":"function","function":{"name":"","arguments":"\"command\": \"G"}}]
...
finish_reason: "tool_calls"

第一个 chunk 携带完整的 name: "pwsh" 与 id，但后续增量 chunk 将 name/id 显式序列化为 ""（而非省略字段）。

4. 源码定位

DSH 的 LLM 适配器 @deepseek-ai/dsh-llm-deepseek 在解析 SSE 增量 chunk 时（lib/index.js 第 321-322 行）：

if (call.id !== void 0) block.callId = call.id;
if (call.function?.name !== void 0) block.name = call.function.name;

适配器用 !== void 0（即非 undefined）判断字段是否存在，这是按 OpenAI / 官方 DeepSeek API 的行为编写的：官方增量 chunk 省略 name/id 字段（undefined），因此首个 chunk 写入的 pwsh 会被保留。

百炼返回的是 ""（空字符串），而 "" !== void 0 为 true，于是 block.name 被覆盖为空字符串 → 最终工具调用对象 name: "" → 分发时报 UNKNOWN_TOOL。

另：DSH 适配器强制流式输出（README："只支持流式输出（stream_options.include_usage 始终开启）"），因此无法通过关闭流式规避；且适配器不发送 tool_choice（README："未映射 tool_choice"）。

根因 / Root Cause

百炼 deepseek-v4-flash 直供模型在流式工具调用时，增量 chunk 将 name/id 序列化为显式空字符串 ""；而 OpenAI 兼容规范（及官方 DeepSeek API）在增量 chunk 中省略这些字段（undefined）。

DSH 适配器按 !== void 0 判断字段存在，把空字符串当作有效新值采纳，覆盖了首个 chunk 中的有效 name/id，最终工具调用对象 name 为空 → UNKNOWN_TOOL。

百炼 qwen 系列不受影响：其对 qwen 的流式增量 chunk 行为与官方一致（省略字段）。

修复 / Fix

在 dsh-llm-deepseek/lib/index.js 第 321-322 行忽略空字符串（与"字段缺失保留旧值"语义一致）：

-				if (call.id !== void 0) block.callId = call.id;
-				if (call.function?.name !== void 0) block.name = call.function.name;
+				if (call.id !== void 0 && call.id !== "") block.callId = call.id;
+				if (call.function?.name !== void 0 && call.function.name !== "") block.name = call.function.name;

验证：重启 DSH 后，deepseek-v4-flash 模型工具调用恢复正常。

复现 / Reproduction

curl -s -N -X POST "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "用工具列出当前目录"}],
    "tools": [{"type": "function", "function": {"name": "pwsh", "description": "执行PowerShell命令", "parameters": {"type": "object", "properties": {"command": {"type": "string"}}, "required": ["command"]}}}],
    "tool_choice": "auto",
    "stream": true
  }'

观察 SSE chunk：首个 chunk 带 name:"pwsh"，后续增量 chunk name:""/id:""。

建议 / Suggestion

1. 解析器应区分"字段缺失"与"字段为空"，将空字符串与 undefined 同等对待（按字段有无而非值是否为 undefined 判断），以兼容更多 OpenAI 兼容提供商；
2. 百炼侧如能修复直供模型流式增量 chunk 的序列化（空字符串 → 省略字段），同样可解决。

附注 / Notes

• 本补丁直接修改 node_modules 内文件，DSH 升级（重新安装依赖）后需重新应用；原文件备份为 index.js.bak；
• 相关排查上下文另见本仓库 fix_pwsh_bug.md（其早期"模型漏写 name"的结论已被本报告推翻，以本文为准）。

[denial123789]

I verified the reported chain against rc.8 (141eb6f) and updated the operator runbook here: https://sandbaseai.github.io/deepseek-harness-handbook/streamed-tool-call-identity.html

Two source-level details make the diagnosis especially strong:

1. llm-deepseek/src/translate.ts still assigns both fields whenever they are not undefined, so Bailian continuation values id: "" and name: "" overwrite the valid first-delta identity.
2. BlockAssembler ignores a falsy name on intermediate deltas, but the translator later emits an authoritative block-end containing the overwritten empty identity. That completed block reaches policy, which correctly refuses an unidentified effect.

The published guide now includes the reported control matrix (non-streaming Bailian, official DeepSeek, and Bailian Qwen), the empty-string fixture plus the earlier null-continuation fixture, safe route fallback, and acceptance gates. One important operator boundary: do not allow an empty tool name or weaken policy, and avoid patching generated global node_modules; preserve the SSE evidence and route through an already authorized omission-style backend until a source fix ships.

[weijiafu14]

这个百炼故障现在可以直接绕开，不需要改 llm-deepseek 源码：

dsh plugin --profile web add pi2dsh
dsh plugin --profile web add pi-provider-alibaba-bailian

export ALIBABA_API_KEY='<your Bailian key>'
dsh web

然后选择 Alibaba Bailian / deepseek-v4-flash。这条路由使用 pi-ai 的 OpenAI Chat SSE 解析；它保留首个非空 id/name，百炼续片里的 id:""、name:"" 或 null 不会覆盖已经组装好的工具身份。

我们已经完成两层验证：

• 按百炼抓包形态同时回放空字符串和 null 续片，真实 DSH loop 正确执行工具、配对 tool/result 并继续下一轮；
• 使用普通百炼 Key 对真实 DashScope 公网 deepseek-v4-flash 端点调用，工具名和 callId 保留，工具结果成功回传，最终回复正常完成。

请直接按上面步骤试；如果你的地域、模型或账号返回不同错误，把所选模型和错误贴出来，我们继续按真实场景修。

项目：https://github.com/weijiafu14/pi2dsh