DeepSeek Harness(dsh)連線教學
DeepSeek Harness 是 DeepSeek 開源的 Agent 執行框架(命令 dsh),核心理念是「一切皆外掛」:模型、工具、工作階段等能力都由外掛提供。它支援透過「自訂模型 API」連接任何閘道——NextHub 的 GPT-Azure 分組說明中就把 DSH 列為已支援的第三方工具。
連線步驟
1. 安裝並啟動
需要安裝 Node.js(建議使用官方目前長期支援版本)。用 npx 直接啟動 Web UI,或全域安裝後啟動:
npx @deepseek-ai/dsh webnpm install -g @deepseek-ai/dsh
dsh web啟動後瀏覽器會自動開啟本機管理介面。
2. 新增自訂提供方(Claude 通道)
進入 設定 → 模型,點擊 新增提供方,把卡片切換到 自訂模型 API(Custom model API),按下表填寫:
| 欄位 | 填寫內容 | 說明 |
|---|---|---|
| Provider ID | nexthub | 小寫,建立後不可改名 |
| 基礎 URL | https://api.nexthub.cc | Anthropic 協定填裸網域,不帶 /v1 |
| API 協定 | Anthropic Messages | 對應 Anthropic Messages 協定端點 |
| 憑證(API Key) | 你的 NextHub ApiKey | Claude 系分組 |
| 模型 | claude-opus-5-5 等 | 至少一個;可點「取得可用模型」自動取得 |
儲存後在對話視窗的模型清單裡選擇剛剛新增的模型即可使用。
3. 連接 GPT 通道(可選)
一個提供方只能使用一種協定,需要 GPT 就再建一個:Provider ID 填 nexthub-gpt,API 協定選 OpenAI Chat Completions(或 OpenAI Responses),基礎 URL 填 https://api.nexthub.cc/v1(帶 /v1),API Key 使用 GPT-Azure / GPT-Pro 分組金鑰,模型填 gpt-5.6、gpt-6-astra 等。
4. 驗證
在對話視窗選擇 NextHub 的模型並傳送一則訊息,能正常回覆即連線成功。
設定檔方式(可選)
以上設定最終會寫入 $DSH_HOME/profiles/web/cordis.patch.yml(DSH_HOME 預設為 ~/.dsh),也可以直接編輯這個檔案:
- id: llm-pi-ai
config:
providers:
nexthub:
apiKeyEnv: NEXTHUB_API_KEY
api: anthropic-messages
baseURL: https://api.nexthub.cc
models:
- id: claude-opus-5-5
- id: claude-fable-5apiKeyEnv 填環境變數名稱(金鑰本身從該環境變數讀取);在介面裡儲存的金鑰則存放在 $DSH_HOME/.credentials.yaml。修改後無需重新啟動,下一次請求即生效。
視覺模型要宣告輸入類型
手動錄入的模型預設按純文字處理。若要傳送圖片給模型,需在模型的 Model options 裡把 Input types 勾選 Image(對應設定 input: [text, image]),否則圖片會在傳送前被拒絕。