DeepSeek Harness

DeepSeek Harness（指令名稱 dsh）是 DeepSeek 開源的程式設計 Agent Harness，提供工作區、終端機、檔案編輯、Skills、計畫和 Web UI。它可透過 OpenAI Chat Completions 相容介面連接 AIHubMix。

本文以 DeepSeek Harness 0.2.0-rc.2 為準，該版本為截至 2026 年 10 月 18 日的最新版本。與 0.1.0-rc.6 相比，版本變化較大，設定位置與介面均已更新。Harness 仍處於開發者預覽階段，後續版本的欄位或介面可能變更。

快速結論

接入需要四項設定：

設定	值
Provider ID	`aihubmix`
Base URL	`https://aihubmix.com/v1`
API protocol	`openai-completions`
API key environment variable	`AIHUBMIX_API_KEY`

DeepSeek Harness Models 頁面顯示 AIHubMix 已設定

需要準備什麼？

可用的 AIHubMix API Key
Node.js 22（22.19.0 或更新版本）或 Node.js 24 以上
可存取 npm Registry 與 https://aihubmix.com 的網路環境

node --version
npm --version

如何安裝 DeepSeek Harness？

直接安裝 npm 發布版，無需複製原始碼倉庫：

npm install -g @deepseek-ai/dsh
dsh --version

若顯示 dsh: command not found，執行 npm config get prefix，並確認該目錄下的 bin 已加入 PATH。

如何啟動 Web UI？

在要作為工作區的專案目錄中執行。官方建議使用 npx 啟動：

npx @deepseek-ai/dsh web --port 3080

若已全域安裝，也可以執行：

dsh web --port 3080

開啟 http://127.0.0.1:3080，首次使用時選擇或加入工作區。

如何設定 AIHubMix 提供方？

開啟 Settings → Models → Add model provider，將卡片切換為 Custom model API，然後填寫以下內容：

欄位	建議值	說明
Provider ID	`aihubmix`	小寫識別碼；若已使用可填 `aihubmix-gateway`
Display name	`AIHubMix`	模型選擇器顯示名稱
Base URL	`https://aihubmix.com/v1`	必須包含 `/v1`
API protocol	`openai-completions`	OpenAI Chat Completions 相容協定
API key	你的 AIHubMix API Key	Harness 會保存為憑證，不會再次顯示明文

最終請求端點為 https://aihubmix.com/v1/chat/completions。

Base URL 欄位不要填入完整的 /chat/completions 路徑。

加入 auto 或其他模型

填入 Base URL 與 API Key 後，在 Model catalog 中選擇 Fetch available models。Harness 會請求 GET https://aihubmix.com/v1/models 並顯示目前可用的模型 ID。

首次連線測試可只加入 auto，顯示名稱填寫 Auto。若要使用指定模型，請在取得的清單中勾選該模型，然後選擇 Add selected。圖形介面的模型選擇器只會顯示已註冊在目前 Provider 目錄中的模型。

auto 與指定模型比較

選擇	適用情況
`auto`	首次連線測試，或由 AIHubMix 自動選擇模型
指定模型 ID	需要固定模型能力、版本或可重現結果

兩種方式使用相同的 Provider、Base URL 和 API Key。切換模型不需要重新建立提供方。

使用環境變數保存 API Key

開發機與 CI 環境可以讓 Harness 透過 profile 檔案讀取環境變數中的 API Key。Web UI 使用 web profile，headless 測試使用 headless profile，檔案路徑分別為：

$DSH_HOME/profiles/web/cordis.patch.yml
$DSH_HOME/profiles/headless/cordis.patch.yml

兩個檔案都寫入以下內容：

- id: llm-pi-ai
  config:
    providers:
      aihubmix:
        apiKeyEnv: AIHUBMIX_API_KEY
        api: openai-completions
        baseURL: https://aihubmix.com/v1
        models:
          - id: auto
- id: agent-default-model
  config:
    provider: aihubmix
    model: auto

兩個條目缺一不可。只寫 llm-pi-ai 而沒有寫 agent-default-model 時，headless 仍會使用預設的 deepseek-official，並顯示 MISSING_CREDENTIAL。

舊版使用 $HOME/.dsh/settings.yaml 保存設定，0.2.0 已不再使用該檔案。DSH 0.2.0 首次啟動時會把它遷移為 profile 設定，並將原檔案改名為 settings.yaml.imported。遷移當次執行可能顯示 MISSING_CREDENTIAL，再執行一次即可。啟動 Harness 前設定密鑰：

export AIHUBMIX_API_KEY='sk-***'
dsh web --port 3080

密鑰來自啟動環境時，設定頁會顯示唯讀提示，不會展示真實值。

變更環境變數後需要重新啟動 Harness。

選擇模型並驗證對話

關閉設定視窗，開啟輸入框右下角的模型選擇器，選擇 Auto 或已加入的指定模型。

Reply with exactly: AIHubMix connection successful

收到預期回覆代表 Harness、OpenAI Chat Completions 相容端點與 AIHubMix 之間的連線正常。

執行 headless 測試

無需 Web UI 時，可執行以下指令。此指令使用 headless profile，因此 $DSH_HOME/profiles/headless/cordis.patch.yml 中需已寫入上述兩個條目。

export AIHUBMIX_API_KEY='sk-***'
dsh --profile headless \
  'Reply with exactly DSH_AIHUBMIX_OK and do not use tools.'

成功時會輸出 DSH_AIHUBMIX_OK。

常見問題

為什麼顯示 MISSING_CREDENTIAL？

Harness 未能讀取到可用的設定。請確認 profile 中兩個條目都已寫入，並確認環境變數 AIHUBMIX_API_KEY 已設定，然後從同一個終端機啟動 Harness：

test -n "$AIHUBMIX_API_KEY" && echo configured

為什麼取得模型時回傳 401？

檢查 API Key 是否有效，以及是否包含多餘的空格或換行。模型探索請求使用 Bearer 驗證。

為什麼模型選擇器只有 Auto？

選擇器只顯示目前 Provider 目錄中已註冊的模型。前往 Settings → Models → AIHubMix → Edit，在 Model catalog 中選擇 Fetch available models，勾選所需模型後選擇 Add selected。

為什麼顯示 UNKNOWN_MODEL？

目前 Provider 目錄中沒有該模型 ID。模型 ID 會區分大小寫，請使用模型探索回傳的正確值。

為什麼連線逾時？

檢查 DNS、組織網路與本機 Proxy。DSH 會自動讀取 HTTP_PROXY 與 HTTPS_PROXY 環境變數；若要讓特定位址不經過 Proxy，可設定 NO_PROXY。若瀏覽器使用系統 Proxy 而終端機沒有使用，請在啟動 dsh 的終端機設定 HTTP_PROXY 與 HTTPS_PROXY。

安全建議

不要將 API Key 提交到 Git，或放入截圖與共用指令碼
優先使用 Harness 憑證儲存或 AIHUBMIX_API_KEY
疑難排解時不要列印完整 API Key
在 CI 中使用 Secret 管理功能注入環境變數

最後更新：2026-10-18

程式設計助理

IDE 整合

Agent / Workflow

SDK 與框架

快速結論

需要準備什麼？

如何安裝 DeepSeek Harness？

如何啟動 Web UI？

如何設定 AIHubMix 提供方？

加入 auto 或其他模型

auto 與指定模型比較

使用環境變數保存 API Key

選擇模型並驗證對話

執行 headless 測試

常見問題

為什麼顯示 MISSING_CREDENTIAL？

為什麼取得模型時回傳 401？

為什麼模型選擇器只有 Auto？

為什麼顯示 UNKNOWN_MODEL？

為什麼連線逾時？

安全建議

​快速結論

​需要準備什麼？

​如何安裝 DeepSeek Harness？

​如何啟動 Web UI？

​如何設定 AIHubMix 提供方？

​加入 auto 或其他模型

​auto 與指定模型比較

​使用環境變數保存 API Key

​選擇模型並驗證對話

​執行 headless 測試

​常見問題

​為什麼顯示 MISSING_CREDENTIAL？

​為什麼取得模型時回傳 401？

​為什麼模型選擇器只有 Auto？

​為什麼顯示 UNKNOWN_MODEL？

​為什麼連線逾時？

​安全建議

快速結論

需要準備什麼？

如何安裝 DeepSeek Harness？

如何啟動 Web UI？

如何設定 AIHubMix 提供方？

加入 auto 或其他模型

auto 與指定模型比較

使用環境變數保存 API Key

選擇模型並驗證對話

執行 headless 測試

常見問題

為什麼顯示 MISSING_CREDENTIAL？

為什麼取得模型時回傳 401？

為什麼模型選擇器只有 Auto？

為什麼顯示 UNKNOWN_MODEL？

為什麼連線逾時？

安全建議