DeepSeek Harness

DeepSeek Harness 用内置 llm-pi-ai 插件把网关配成一个 provider：api 选 openai-completions 或 openai-responses，Base URL 填对应协议入口，密钥填网关令牌。

最后更新：2026-11-14

DeepSeek Harness（dsh）通过内置的 llm-pi-ai 插件接多个兼容端点：把网关配成一个 provider 即可。

支持的模型和协议

api 决定用哪种协议，模型详情页的「模型能力」里要包含你选的协议：

API 协议（界面）	配置 `api`	模型要求
OpenAI Chat Completions	`openai-completions`	模型支持 `/chat/completions`
OpenAI Responses	`openai-responses`	模型支持 `/responses`
Anthropic Messages	`anthropic-messages`	模型支持 `/messages`

界面配置

启动 dsh web（桌面端同理）→ 设置 → 模型 → 自定义模型 API。

DeepSeek Harness 设置 → 模型 → 自定义模型 API

按下表填写：

字段	填什么
Provider ID	唯一标识（小写字母开头），如 `sagelib-local`；请求里用它标识该供应商
显示名称	任意，便于识别（如「SageLib-线上体验」）
API 地址	站点根 `https://api.sagelib.com`（`OpenAI Chat Completions` 会自动补 `/chat/completions`）
API 协议	选 `OpenAI Chat Completions`（也可按上表换成 Responses / Anthropic）
API 密钥	「令牌管理」创建的 `sk-...` 网关令牌
模型目录	点「获取可用模型」自动拉取，或手动加：左填模型标识，右填显示名

配置文件

配置写在当前 profile 的 patch 文件里：~/.dsh/profiles/<profile>/cordis.patch.yml（profile 如 desktop、web）。它是一个顶层 YAML 数组，与模型相关的是 llm-pi-ai 与 agent-default-model 两项：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      sagelib-local:
        displayName: SageLib-线上体验
        apiKeyEnv: SAGELIB_LOCAL_API_KEY
        api: openai-completions
        baseURL: "https://api.sagelib.com"
        models:
          - id: claude-fable-5
          - id: deepseek-v4.1-flash
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config:
    provider: sagelib-local
    model: claude-fable-5

providers 下的键（如 sagelib-local）就是界面上的 Provider ID；displayName 是显示名称；
api 决定协议，baseURL 是API 地址；models 里 id 是模型标识、name 可省略（省略时显示 id）；
apiKeyEnv 是凭据引用（环境变量名）：对应的值可以放在进程环境变量、~/.dsh/.credentials.yaml（界面里填的密钥存在这里）或 ~/.dsh/.env；
agent-default-model 指定默认的 provider 与模型。

启动并验证

重启 dsh，在对话的模型选择器里选中配置的模型，新开对话发一句话；能收到回复即接通，再到控制台「用量日志」确认这次调用。