DeepSeek Harness 接入第三方中转 API 教程

中转站地址：https://xh.v1api.cc（OpenAI 兼容接口，实际 baseURL 一般为 https://xh.v1api.cc/v1）

前置准备

Node.js ^22.19.0 或 >=24.0.0

在 xh.v1api.cc 后台申请的 API Key（形如 sk-xxxx）

启动 Harness：

npx @deepseek-ai/dsh web

浏览器打开 http://127.0.0.1:3080。

打开 Settings → Models。

点击 Add a custom provider（添加自定义提供方）。

按下表填写：

字段	填写内容
Provider ID	`v1api`（小写，永久不可改，仅可删除重建）
Display name	`xh.v1api 中转`（可随意）
Base URL	`https://xh.v1api.cc/v1`
API protocol	`openai-completions`（OpenAI 兼容）
API key	你的中转站 Key `sk-xxxx`

在 Model catalog 区域点击 Fetch available models，它会调用中转站的 GET /v1/models 拉取可用模型列表，勾选你要用的（如 deepseek-chat、deepseek-reasoner 等）。

若拉取报 401，检查 Key；若中转站不支持 /models，就手动填模型 ID。

点击 Save。

回到对话页，在模型选择器里选中刚配置的模型即可。

Key 是只写的，保存后存于 $DSH_HOME/.credentials.yaml，界面只保留引用，不回显明文。

编辑 $DSH_HOME/settings.yaml（$DSH_HOME 默认在用户目录下的 harness home），在 llm-pi-ai 段落里加入：

然后设置环境变量后再启动：

export V1API_API_KEY=sk-你的key
npx @deepseek-ai/dsh web

apiKeyEnv 指定的是「环境变量名」，Key 本身放在环境变量里；也可以改用 Web UI 保存凭证。手动填写的模型默认按纯文本处理，多模态模型需显式加 input: [text, image]。

内置 deepseek-official 路由的 baseURL 会回退到 $DEEPSEEK_BASE_URL，所以可直接指向中转站：

export DEEPSEEK_API_KEY=sk-你的key
export DEEPSEEK_BASE_URL=https://xh.v1api.cc/v1
npx @deepseek-ai/dsh web

请求时 model 字段会原样透传给中转站，因此模型 ID 必须是中转站认识的名字。若中转站的模型名和 DeepSeek 官方不一致，建议用方式一/二自定义模型列表，避免报 UNKNOWN_MODEL。

报错	原因与处理
`MISSING_CREDENTIAL`	没配 Key。通过 Models 页保存，或设置对应环境变量
`UNKNOWN_MODEL`	选了未配置的模型，去自定义 provider 里补上该模型 ID
Fetch models 返回 401	Key 错误，或中转站不提供 `/models`，改为手动填模型
图片被拒绝发送	该模型未声明图像能力，给它加 `input: [text, image]`