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 接入文档;注册控制台即可自助建密钥开跑。