DSH (DeepSeek Harness)

DeepSeek Harness 自定义供应商接入 51token

DeepSeek Harness（dsh）支持通过 YAML 配置添加任意 OpenAI 兼容的自定义供应商。下面以 51token 为例，演示如何把 51token 作为自定义供应商接入。

1. 配置文件位置

DSH 的主配置为 $DSH_HOME/settings.yaml。自定义供应商写在 llm-pi-ai.providers 下。也可在 Web UI「设置 → 模型」中选择「添加自定义提供方」填写（表单不含 input / compat 等高级字段，需要时请手改 YAML）。

2. 基础自定义供应商

在 settings.yaml 中加入：

yaml

llm-pi-ai:
  providers:
    fiftyone-token:
      apiKeyEnv: FIFTYONE_TOKEN_API_KEY
      api: openai-completions
      baseURL: https://51token.one/v1
      models:
        - id: gpt-5.6-sol
        - id: gpt-5.4-mini

字段	说明
`providers.<id>`	自定义供应商标识（小写，永久不可变），如 `fiftyone-token`
`apiKeyEnv`	存储 API Key 的环境变量名（也可在 UI 填写，存于 `.credentials.yaml`）
`api`	API 协议，`openai-completions` 表示 OpenAI Chat Completions 兼容
`baseURL`	51token 的 OpenAI 兼容端点 `https://51token.one/v1`
`models`	模型列表，`id` 为 51token 支持的模型名

把 API Key 写入环境变量再启动 dsh：

bash

export FIFTYONE_TOKEN_API_KEY=<你的 51token API Key>

Key 在 51token.one/keys 获取。模型变更在下次请求时生效，无需重启。

3. 图片输入（多模态）

若供应商支持图片输入，可在模型级用 input 声明：

yaml

llm-pi-ai:
  providers:
    fiftyone-token:
      apiKeyEnv: FIFTYONE_TOKEN_API_KEY
      api: openai-completions
      baseURL: https://51token.one/v1
      models:
        - id: gpt-5.6-sol
          input: [text, image]

input 接受 text 与 image，仅作用于该模型；省略或空列表 [] 等价于路由级 defaultInput（默认 [text]）。

4. 请求兼容性（compat）

路由级与模型级均可设置 compat，用于描述对端点的兼容性：

yaml

llm-pi-ai:
  providers:
    fiftyone-token:
      apiKeyEnv: FIFTYONE_TOKEN_API_KEY
      api: openai-completions
      baseURL: https://51token.one/v1
      compat:
        supportsDeveloperRole: false
        maxTokensField: max_tokens
      models:
        - id: gpt-5.6-sol
        - id: gpt-5-4-reasoner
          compat:
            thinkingFormat: deepseek

compat 字段需给值（空值会被拒绝）；模型自身字段逐字段胜出路由默认值。