DeepSeek 中轉站思考強度適配插件

前言¶

DeepSeek Harness (DSH) 支持通過中轉站（第三方 OpenAI 兼容網關）接入 DeepSeek 模型。官方適配器 llm-deepseek 在 Web UI 中暴露了 Off / Low / High / Max 四檔推理等級，但中轉站通常使用 llm-pi-ai 且缺少這些選項，且思考參數格式不兼容。dsh-deepseek-relay 通過註冊獨立的 OpenAI 適配器路由解決上述問題，無需改動 harness 本體。

核心功能¶

• 暴露 Off / Low / High / Max 四檔推理等級。
• 自動按中轉站方言序列化思考參數。
• 支持按模型覆蓋 wire 值。
• 支持按模型聲明識圖能力。
• 一個插件實例可掛多條中轉站路由。
• 純插件即可生效。

安裝與啓用¶

插件提供了兩種安裝方式。

1. 從源碼運行
   在 deepseek-harness 倉庫根目錄下執行：

   pnpm dsh web --patch ./dsh-deepseek-relay/cordis.yml

2. 作爲組合包安裝

   dsh plugin --profile demo add ./dsh-deepseek-relay

安裝後，在 Web UI 的模型設置中配置 providers、models 和 supportsVision。API Key 需通過環境變量 RELAY_API_KEY 設置，或在 Web UI 中手動填入。

典型用法¶

在 cordis.yml 中配置中轉站信息：

- insert:
    - id: dsh-deepseek-relay
      name: '/絕對路徑/deepseek-harness/dsh-deepseek-relay/src/index.ts'
      config:
        providers:
          my-relay:
            baseURL: https://your-relay.example.com/v1
            apiKeyEnv: RELAY_API_KEY
            thinkingFormat: auto
            models:
              - id: deepseek-v4-flash
              - id: deepseek-v4-flash-vision-exp
                supportsVision: true

注意事項¶

• 升級須知：舊配置中未顯式聲明 supportsVision: true 的模型默認不支持識圖，升級後需手動補全該字段。
• 輸入類型：插件默認只支持文本輸入，圖片輸入需手動聲明 supportsVision: true 才能避免錯誤。
• 中轉站 URL：若網關要求帶 /v1，需在 baseURL 中寫完整路徑。
• 免責聲明：本插件爲第三方非官方適配層，不保證適配所有網關。

結尾¶

該插件爲 DSH 用戶在通過中轉站使用 DeepSeek 模型時提供了推理等級控制能力。

• 插件目錄
• GitHub 倉庫