deepseek-harness 默认附加 dsh_plugin_packages 导致第三方 OpenAI 兼容网关全部报错

[hotcat854]

版本

dsh-v0.1.2-alpha.3 (dd6322d6)

问题描述

从 v0.1.2-alpha.1 引入的 [#2916](https://github.com/)（`feat(deepseek): upload plugin package metadata，commit ea6f61f）开始，llm-deepseek` 适配器默认会在每一条请求中附加以下最外层字段：

{
  "dsh_plugin_packages": []
}

该字段包含当前活跃插件包的 name 和 version 清单。

当 baseURL 不是 DeepSeek 官方端点时，例如：

• OpenCode Zen Go：https://opencode.ai/zen/go/v1
• kimi-k3 等第三方上游或兼容网关

这些服务通常会对请求参数进行严格校验。遇到不认识的最外层字段时，请求会被直接拒绝：

Upstream request failed: Unsupported request parameter(s): dsh_plugin_packages.

因此，从 v0.1.2-alpha.2 开始，所有通过 deepseek-official 路由访问第三方网关的请求，默认都可能失败。

如果用户显式开启了 dsh_session_log，也可能出现相同问题。

复现步骤

在 ~/.dsh/settings.yaml 中配置一个使用第三方网关的 DeepSeek provider：

llm-deepseek:
  baseURL: https://opencode.ai/zen/go/v1
  models:
    - id: kimi-k3

随后发起任意一个通过 deepseek-official 路由的请求。

请求会立即失败，并返回：

Upstream request failed: Unsupported request parameter(s): dsh_plugin_packages.

期望行为

当 baseURL 指向非 DeepSeek 官方端点时，不应默认向请求中添加 DeepSeek 官方专属的诊断字段。

可以考虑以下任一方案：

1. 仅在 baseURL 为 DeepSeek 官方端点时添加 dsh_plugin_packages；
2. 为该字段提供显式配置开关，例如：

dsh_plugin_packages: false

3. 将 plugin-package-inventory-deepseek 插件的默认状态改为禁用，由用户主动开启。

当前 plugin-package-inventory-deepseek 的 enabled 默认值为 true，会导致所有第三方兼容网关默认收到额外字段，影响范围较大。

临时解决方案

可以在 profile 的补丁层中禁用该扩展插件：

# ~/.dsh/profiles/web/cordis.patch.yml

- id: plugin-package-inventory-deepseek
  disabled: true

也可以通过 settings.yaml 禁用：

plugin-package-inventory-deepseek:
  enabled: false

影响

该问题会导致所有使用 llm-deepseek 适配器、通过 deepseek-official 路由访问严格校验请求参数的第三方网关时，请求默认失败。

第三方网关兼容性不应依赖用户手动发现并禁用诊断插件。默认配置应保证基础请求可以正常发送。

[Mide69]

查了一下文档，这个行为是刻意设计的，不是漏掉的边界情况。

docs/deepseek-llm-api-wire-extensions.md 里有一句明确写着：A gateway selected through baseURL receives the same values as the official endpoint. 也就是说，不管 baseURL 指不指向 DeepSeek 官方端点，dsh_plugin_packages 都会一起发过去，这是文档里白纸黑字写明的既定行为，不是 bug。

config-catalog.md 里 plugin-package-inventory-deepseek 的 Config 也确认了 enabled 默认是 true，字段本身没有按 baseURL 做区分的逻辑，这点和你的复现一致。

所以你贴的两个方案里，第二个（提供开关）其实已经存在，就是你自己已经找到的那个临时方案：把 plugin-package-inventory-deepseek 禁用（无论是 patch 里 disabled: true，还是 settings.yaml 里 enabled: false）。这不是绕过去的 workaround，是这个功能唯一支持的正式关闭方式，配置项就是给这个用的。

第一个方案（只在官方端点才加这个字段）目前源码里确实没有实现，前面那句文档原话说明这是有意不做区分。要不要改成按 baseURL 区分，这属于产品设计取舍，不是我能替官方决定的事，但至少可以确认：这不是被忽略的问题，是刻意的选择，只是默认值（true）对严格校验参数的第三方网关不友好。如果你想推动默认值改变，值得把这个具体的失败信息（Unsupported request parameter(s): dsh_plugin_packages）和目前唯一的正式退出路径一起说清楚，而不是当成未知行为去报。

[hotcat854]

感谢大佬极其详尽的排查和文档对照！
原来 A gateway selected through baseURL receives the same values as the official endpoint 是白纸黑字的既定设计，是我此前漏看文档了。
非常认同大佬的观点——这不是未知行为，而是默认值（enabled: true）对严格校验参数的第三方网关不够友好。
非常感谢！