DeepSeek Harness（dsh）接入教程

DeepSeek Harness 是 DeepSeek 开源的 Agent 运行框架（命令 dsh），核心理念是「一切皆插件」：模型、工具、会话等能力都由插件提供。它支持通过「自定义模型 API」接入任何网关——NextHub 的 GPT-Azure 分组说明中就把 DSH 列为适配的第三方工具。

接入步骤

1. 安装并启动

需要安装 Node.js（建议使用官方当前长期支持版本）。用 npx 直接启动 Web UI，或全局安装后启动：

bash

npx @deepseek-ai/dsh web

bash

npm 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），也可以直接编辑这个文件：

yaml

- 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-5

apiKeyEnv 填环境变量名（密钥本身从该环境变量读取）；在界面里保存的密钥则存放在 $DSH_HOME/.credentials.yaml。修改后无需重启，下一次请求即生效。

视觉模型要声明输入类型

手动录入的模型默认按纯文本对待。要给模型发图，需在模型的 Model options 里把 Input types 勾选 Image（对应配置 input: [text, image]），否则发图会在发送前被拒绝。

DeepSeek Harness（dsh）接入教程 ​

接入步骤 ​

1. 安装并启动 ​

2. 添加自定义提供方（Claude 渠道） ​

3. 接入 GPT 渠道（可选） ​

4. 验证 ​

配置文件方式（可选） ​