DeepSeek Harness(dsh)接入指南:網關配置與協議對照(2026)| HopBase

DeepSeek Harness(下稱 dsh)是 DeepSeek 官方開源的 agent 執行時,2026 年 8 月 13 日隨 V4-Pro 一起開源,兩天內 GitHub 星數破 10 萬。它的設計哲學只有一句話:一切皆外掛——連 agent 迴圈本身也是外掛。這讓 dsh 更像一個可自由組裝的編碼 agent 執行時,而不是一個固定形態的程式設計助手。

為什麼給 dsh 配一個網關

dsh 是模型無關的:自定義 provider 只要 Base URL、協議和模型 ID 三樣。但直連各家官方意味著多把金鑰、多份帳單、多個網路出口;經 HopBase 一個網關接入,同一個 dsh 裡可以同時掛 DeepSeek、GLM、Kimi、Grok、GPT 與 Claude,額度、呼叫審計和成本歸集都在一個控制檯完成,國內鏈路直連穩定。

三分鐘配置

在 $DSH_HOME/settings.yaml 中新增一個 provider:

providers:
  hopbase:
    api: openai-completions
    baseURL: https://api.hop-base.com/v1
    apiKeyEnv: HOPBASE_API_KEY
    models:
      - id: deepseek-v4-flash-202605
      - id: glm-5.3
      - id: grok-4.6

啟動前 export HOPBASE_API_KEY=sk-你的密钥 即可。偏好圖形介面的話,在 dsh Web UI 走 Settings → Models → Add a custom provider,填同樣三項;模型 ID 用你這把金鑰調 GET /v1/models 的返回。

協議對照:什麼模型選什麼協議

你要跑的模型	api 欄位	baseURL
DeepSeek / GLM / Kimi / Grok / GPT 對話	`openai-completions`	`https://api.hop-base.com/v1`
grok-4.20-multi-agent(僅 Responses)	`openai-responses`	`https://api.hop-base.com/v1`
Claude 系列	`anthropic-messages`	`https://api.hop-base.com`(不帶 /v1)

我們實測過什麼

agent 最依賴的兩件事已在 HopBase 生產網關端到端驗證:函數調用(dsh 形態的 tools 請求正確返回 tool_calls 與引數)和流式 usage 回傳(最後一幀帶完整用量,計費與上游逐筆對帳一致)。

常見報錯速查

報錯	原因	解決
404「當前平臺不支援該 API 路徑」	Claude 模型誤配了 OpenAI 協議	Claude 用 `anthropic-messages`,baseURL 不帶 /v1
model not found / 503	模型不在你這把金鑰的套餐分組	調 `GET /v1/models` 用返回的完整 ID
401 invalid api key	金鑰複製不完整或帶空格	控制檯重新完整複製

完整引數與更多客戶端接法見DeepSeek Harness 接入文件;註冊控制檯即可自助建金鑰開跑。