DeepSeek Harness 三方 Key 配置 — APIMaster.ai 自定义 Provider

DeepSeek Harness（dsh）是 DeepSeek 开源的本地 Agent 框架，Web UI 默认跑在 http://127.0.0.1:3080。内置 DeepSeek 渠道只能填官方 Key；要用 APIMaster 的 GPT / Claude / DeepSeek 等模型，必须走 Add a custom provider。

开始前请 获取 API Key。Key 只保存在本机 $DSH_HOME/.credentials.yaml（默认 ~/.dsh/），不要发到群聊或截图。

---

前置条件

1. 已安装 Node.js 22.19+ 或 24+。
2. 已能打开 DeepSeek Harness Web UI。最快启动：

npx @deepseek-ai/dsh web

浏览器打开终端打印的地址（通常是 http://127.0.0.1:3080）。
3. 已从 APIMaster 控制台 复制 API Key。
4. 已在 模型广场 选好 model id（如 gpt-5.6-sol、claude-sonnet-4-6、deepseek-v4-pro）。

---

第 1 步：打开 Models 设置

1. 在 Web UI 打开 Settings。
2. 左侧选择 Models。
3. 你会看到内置的 DeepSeek 卡片（绿色圆点表示官方渠道已配置）。不要点这里的 Edit——那是 DeepSeek 官方 Key，不是 APIMaster。

页面底部有两个入口，用途不同：

按钮	用途
+ Add provider	从目录添加 Anthropic、OpenAI 等官方渠道
+ Add a custom provider	添加 APIMaster（选这个）

---

第 2 步：填写自定义 Provider

点击 + Add a custom provider，按表填写：

字段	填写内容
Provider ID	apimaster（小写、字母开头；保存后不可改名，改名需删掉重建）
Display name	apimaster 或 APIMaster.ai（出现在模型列表分组名）
Base URL	https://apimaster.ai/v1（必须带 /v1）
API protocol	openai-completions
API key	粘贴你的 APIMaster Key（写入后界面只显示掩码）

Models 至少加一条。左侧为请求用的 model id，右侧为显示名，建议两边都填广场上的 id，例如：

• gpt-5.6-sol / gpt-5.6-sol
• 或点 Fetch available models，从 GET /v1/models 勾选后再保存

点 Add model 可继续加 claude-sonnet-4-6、deepseek-v4-pro 等。填完点 Create provider。

说明：

• Base URL 漏掉 /v1 时，Fetch available models 和对话都会失败。
• 自定义 Provider 的模型列表是整条路由的白名单：没写进去的 id 会在本地报 UNKNOWN_MODEL，请求不会发出。

---

第 3 步：确认 Provider 已保存

返回 Models 列表后，应同时看到：

• DeepSeek（官方渠道，可保留，互不影响）
• apimaster +灰色 Custom 徽章 + 绿色圆点

之后改 Key / 模型点 Edit；不要再点 + Add a custom provider 重复创建。

---

第 4 步：在对话里选用 apimaster 模型

1. 回到主界面（新会话或首页输入框）。
2. 点击输入框右侧当前模型名，打开选择器。
3. 在 apimaster 分组下选中刚加的模型（如 gpt-5.6-sol）。
   • 选择器里可能同时出现 DeepSeek 官方分组；请选带 apimaster 分组名的那一项，确认走三方 Key。

---

第 5 步：发消息测试

1. 输入短句，例如 hi。
2. 若收到正常回复，且底部状态栏出现 LLM / TTFT / tok 等指标，说明 Key 与 Base URL 已生效。
3. 回复上方可能出现 Context injection · @deepseek-ai/dsh-system-prompt，这是 Harness 自己的系统提示，与 APIMaster 配置无关。

---

常见问题

现象	处理
找不到自定义入口	Settings → Models → + Add a custom provider（不是 + Add provider，也不是 DeepSeek 的 Edit）
401 / MISSING_CREDENTIAL	重新 Edit 粘贴完整 Key；Key 存在 ~/.dsh/.credentials.yaml，界面不会回显明文
404 / 连不上	Base URL 必须是 https://apimaster.ai/v1，不要漏 /v1
UNKNOWN_MODEL	该 model id 没写进自定义 Provider 的 Models 列表；Edit 后 Add model
Fetch available models 失败	先确认 Key 与 /v1；接口不返回模型列表时改为手填 id
选了模型但走官方 DeepSeek	选择器里改选 apimaster 分组下的项
图片被拒绝	手填的模型默认纯文本；需在 ~/.dsh/settings.yaml 给该模型加 input: [text, image]
Provider ID 填错	ID 保存后不能改；新建一个再 Delete 旧的

---

核对清单

• 已启动 npx @deepseek-ai/dsh web 并打开 Web UI
• 使用 + Add a custom provider，不是官方 DeepSeek Edit
• API protocol = openai-completions
• Base URL = https://apimaster.ai/v1
• 模型 id 来自 模型广场，并已出现在 apimaster 分组
• 发送 hi 能收到回复

---

相关链接

• Agent 配置教程总览
• OpenCode · WorkBuddy · MiMo Code
• OpenAI 兼容接入 · 获取 API Key
• DeepSeek Harness 仓库 · 官方 Providers 指南