DeepSeek Harness 三方金鑰設定 — APIMaster.ai 自訂 Provider

DeepSeek Harness（dsh）是 DeepSeek 開源的本機 Agent 框架，Web UI 預設為 http://127.0.0.1:3080。內建 DeepSeek 渠道只能填官方金鑰；要使用 APIMaster 的 GPT / Claude / DeepSeek 等模型，必須走 Add a custom provider。

開始前請先取得 API 金鑰。金鑰只保存在本機 $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 官方金鑰，不是 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。或點 Fetch available models。填完點 Create provider。

未寫進列表的 id 會在本機報 UNKNOWN_MODEL，請求不會送出。漏掉 /v1 會導致擷取模型與對話失敗。

---

第 3 步：確認已儲存

返回 Models 後應同時看到 DeepSeek 與帶灰色 Custom 徽章的 apimaster。

之後改金鑰或模型請點 Edit。

---

第 4 步：在對話中選用 apimaster 模型

點輸入框右側的模型名稱，在 apimaster 分組下選中模型（如 gpt-5.6-sol）。請選帶 apimaster 分組名的那一項，不要選 DeepSeek 官方分組。

---

第 5 步：發送測試訊息

輸入 hi。若收到正常回覆，且底部出現 LLM / TTFT / tok 指標，表示設定成功。

---

常見問題

現象	處理
找不到自訂入口	Settings → Models → + Add a custom provider
401 / MISSING_CREDENTIAL	重新 Edit 並貼上完整 Key
連不上	Base URL 必須是 https://apimaster.ai/v1
UNKNOWN_MODEL	在自訂 Provider 的 Models 列表新增該 id
仍走官方 DeepSeek	改選 apimaster 分組下的項目
Provider ID 填錯	ID 無法更名；新建後 Delete 舊的

---

核對清單

• 已啟動 npx @deepseek-ai/dsh web
• 使用 + Add a custom provider
• API protocol = openai-completions
• Base URL = https://apimaster.ai/v1
• 模型出現在 apimaster 分組且能回覆

---

相關連結

• 代理設定總覽
• OpenCode · WorkBuddy · MiMo Code
• OpenAI 相容接入 · 取得 API 金鑰
• DeepSeek Harness 倉庫