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 倉庫。