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 仓库