OpenCode Go中DeepSeek因Thinking模式不支持tool_choice导致工具调用报错

背景

在开源终端 AI 编程工具 OpenCode 的 Go 语言版本中，部分用户遇到了集成 DeepSeek 模型时无法正常使用工具调用（Tool Use）功能的问题。该问题不仅影响了 DeepSeek 模型本身，甚至连带导致 Claude 等其他模型在特定配置下也无法正常调用工具。

这一现象源于 OpenCode 在尝试通过 openai-compatible（OpenAI 兼容）接口对接 DeepSeek 时，传递了模型当前版本不支持的参数组合，从而触发了后端服务的 400 Bad Request 错误。

核心内容

用户在使用 OpenCode Go 版本时，试图通过自定义 Provider 配置来调用 DeepSeek 模型，并强制要求模型使用特定工具。具体的请求配置如下：

1. 接口类型：设置为 openai-compatible，表明使用类 OpenAI 的 API 格式。
2. 基础 URL：指向 https://opencode.ai/zen/go。
3. 模型 ID：指定为 deepseek-v4-flash。
4. 工具定义：定义了一个名为 verify_tool 的工具，描述为“返回时间戳字符串”，输入参数为空对象。
5. 关键参数冲突：
   • 设置了 toolChoice: "required"，强制模型必须调用工具。
   • 同时，DeepSeek 的某些模型版本（特别是启用了 Thinking Mode/思考模式时）对 tool_choice 参数的支持存在限制。

错误反馈： 后端返回了明确的错误信息：Error from provider (DeepSeek): Thinking mode does not support this tool_choice。 这表明 DeepSeek 的推理引擎在启用“思考模式”（Thinking Mode）时，不支持用户指定的 tool_choice 参数格式或值。最终，OpenCode 接收到的 HTTP 状态码为 400，导致工具调用失败。

此外，该问题具有连锁反应，导致原本正常的 Claude 模型在相同配置或依赖环境下也出现了工具调用失效的情况，暗示 OpenCode 内部可能存在全局的工具调用状态管理或 Provider 配置冲突。

关键要点

• 参数兼容性陷阱：DeepSeek 的 deepseek-v4-flash 模型在启用 Thinking Mode 时，不支持标准的 tool_choice 参数传递方式，尤其是当强制要求工具调用（required）时，会直接报错。
• 错误类型明确：错误并非网络超时或认证失败，而是语义层面的 400 Bad Request，明确指出是“Thinking mode does not support this tool_choice”。
• 连锁故障：问题不仅限于 DeepSeek，还波及了 Claude 模型，说明 OpenCode 的工具调用框架可能存在共享状态或配置污染问题。
• 配置示例：用户尝试的配置中，toolChoice 被设置为 "required"，这是触发错误的直接参数之一。
• 工具定义无误：工具本身的 JSON Schema 定义（verify_tool）是正确的，问题出在模型对工具调用指令的解析和支持上。

意义与影响

1. 对 OpenCode 用户的启示：

   • 在使用 OpenCode 等新兴 AI 编程工具时，需密切关注各模型版本对 tool_choice 等高级参数的支持差异。
   • 对于 DeepSeek 等支持 Thinking Mode 的模型，可能需要关闭思考模式或调整 tool_choice 参数（如改为 auto 或特定格式）才能正常使用工具调用。
   • 遇到工具调用失败时，应优先检查模型版本与 API 参数的兼容性，而非仅仅重试。

2. 对 AI 工具链开发的警示：

   • Provider 隔离性：OpenCode 中 Claude 受 DeepSeek 配置影响的问题，提示开发者需加强不同 AI Provider 之间的配置隔离，避免全局状态污染。
   • 错误处理优化：当前的错误信息虽然明确，但前端或工具层应提供更友好的提示，帮助用户快速定位是“模型不支持”还是“配置错误”。

3. 对模型 API 设计的反馈：

   • DeepSeek 在推出 Thinking Mode 等新特性时，需确保其与标准 OpenAI 兼容接口的参数兼容性，或在文档中明确标注不支持的参数组合，以减少下游开发者的调试成本。

4. 社区协作价值：

   • 此类问题在 LINUX DO 等开发者社区中的快速发现和分享，有助于其他用户避免踩坑，也推动了 OpenCode 和 DeepSeek 官方对兼容性的改进。