DeepSeek Harness 是 DeepSeek AI 开发的一套用来构建、运行和扩展智能体的应用框架，采用“一切皆插件”的架构。本文以 Hy3 模型为例演示如何将模型接入到 DeepSeek Harness 中使用。
安装与启动 DeepSeek Harness
1. 在终端执行以下命令，下载 DeepSeek Harness 并启动其 Web UI：
注意：
安装 DeepSeek Harness 前，请确认您已安装 Node.js（建议使用 LTS 版本）。
npx @deepseek-ai/dsh web
2. 在浏览器打开命令输出的访问地址。默认地址为
http://127.0.0.1:3080。获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：
在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 Hy3。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
配置 DeepSeek Harness
1. 在 DeepSeek Harness Web UI 中，单击左下角设置。
2. 在左侧导航栏选择模型，单击添加自定义提供方，按下面信息填写完成提供方的创建。
Provider ID：自定义设置，后续如需重命名则需要添加新的提供方，并删除旧的提供方。
显示名称：自定义设置。
API 地址、API 协议：
站点 | API 协议 | API 地址 |
广州 | openai-completions | https://tokenhub.tencentmaas.com/v1 |
| openai-responses | https://tokenhub.tencentmaas.com/v1 |
| anthropic-messages | https://tokenhub.tencentmaas.com |
新加坡 | openai-completions | https://tokenhub-intl.tencentmaas.com/v1 |
| openai-responses | https://tokenhub-intl.tencentmaas.com/v1 |
| anthropic-messages | https://tokenhub-intl.tencentmaas.com |
API 密钥：填写您从控制台获取的 API Key。
添加模型：按需添加 hy3 或当前站点支持的其他模型，详细模型清单请参见 模型列表。
3. （可选）如果需要让模型支持图片输入，则需要在配置文件中进行更改。
单击 打开配置文件，路径
$DSH_HOME/settings.yaml。
在模型配置部分加上
input: [text, image]，配置示例如下，保存后生效。
使用 DeepSeek Harness
1. 在页面中点击选择一个工作区开始，添加您启动 dsh 时所在的项目目录。选中工作区后，会话输入框才可用。
2. 在输入框右下角，选择要使用的模型。
3. 在输入框输入需求即可开始使用 DeepSeek Harness。
常见问题
1. 可以同时使用多个地域吗？
可以。每个地域对应一个独立提供方 + 独立 API Key，重复“添加自定义提供方”步骤即可。如果需要在同一会话中跨地域切换模型，添加多个提供方后在输入框右下角切换。
2. 调用时报 No free trial quota 或 INSUFFICIENT_BALANCE？
模型无免费试用额度，需在控制台开通按量付费并确保账户余额充足。开通后重试即可。
3. 可以同时配置 Token Plan 套餐和按量付费吗？
可以。两者使用不同的端点和不同的 API Key，分别“添加自定义提供方”互不冲突。注意 Token Plan 套餐端点带
/plan/ 前缀，按量付费不带。
