dsh-provider-auto：DeepSeek Harness 推理模型自动配置插件

在 DeepSeek Harness（DSH）的智能体开发场景中，模型能力的选择通常由 @deepseek-ai/dsh-llm-pi-ai 组件控制，它仅在模型声明了 reasoningEfforts 时显示推理选择器。许多自定义的 OpenAI 兼容网关只返回模型 ID，不返回元数据。dsh-provider-auto 插件的作用是在此场景下，为识别出的推理模型补充缺失的声明。

这是 icekale 维护的一个 DSH 插件，核心价值是自动为兼容的自定义提供商模型添加推理努力控制。

核心功能¶

该插件主要处理以下事实：

协议支持：支持 openai-completions 和 openai-responses 协议。
模型匹配：支持对以下命名模式的模型进行识别：gpt-5*、o1*、o3*、o4*、o<number>* 以及 codex*。
控制等级：提供 off、low、medium、high 四种推理努力等级。
排除项：自动排除图像、音频、嵌入、审核和重排序模型。
声明保留：插件会保留模型中已存在的 reasoningEfforts 声明，绝不会覆盖它们。

安装与启用¶

通过官方 CLI 安装到 Web 配置文件：

dsh plugin --profile web add github:icekale/dsh-provider-auto

安装完成后，需要重启 dsh web 进程。后续的提供商或模型变更将通过设置服务实时处理。

Provider 配置¶

在 DSH 的模型页面添加提供商，或者直接编辑 ~/.dsh/settings.yaml。插件会监听 llm-pi-ai 设置部分，并为符合条件的模型注入配置。

例如，配置一个名为 one2api 的提供商：

llm-pi-ai:
  providers:
    one2api:
      baseURL: https://one2api.top/v1
      api: openai-completions
      apiKeyEnv: ONE2API_API_KEY
      models:
        - id: gpt-5.6-sol
          name: gpt-5.6-sol
        - id: gpt-image-2
          name: gpt-image-2

插件只会为 gpt-5.6-sol 自动添加以下内容：

reasoningEfforts:
  off: null
  low: low
  medium: medium
  high: high

插件配置覆盖¶

如果网关使用的模型名称或内部映射值与默认规则不同，可以通过编辑 ~/.dsh/profiles/web/cordis.patch.yml 来覆盖插件配置。

- id: provider-auto
  config:
    api:
      - openai-completions
      - openai-responses
    modelPattern: '^(gpt-5|o[0-9]|codex|my-reasoner)'
    nonTextPattern: '(image|audio|embedding|rerank)'
    efforts:
      off: null
      low: low
      medium: medium
      high: high

对于使用不同内部值的提供商，可以显式映射：

- id: provider-auto
  config:
    efforts:
      off: null
      low: lite
      medium: standard
      high: max

注意事项¶

协议与认证：该插件不实现提供商协议或认证逻辑。DSH 仍仅支持其已安装适配器支持的协议。
能力发现机制：由于大多数 OpenAI 兼容的 /models 端点不报告推理级别，该插件依赖模型名称进行能力发现。
手动声明：对于特殊模型，建议手动声明 reasoningEfforts，插件会尊重并保留这些声明。
环境要求：插件依赖 Node.js 22 或更高版本。

总结¶

dsh-provider-auto 解决了自定义网关无法在 DSH 前端正确显示推理控制的问题。它通过名称匹配和配置注入，将推理努力控制集成到工作流中，同时保持了 DSH 原生模型选择器的权威性。

更多细节可查看 SkillHub 目录或 GitHub 仓库。