一、安装与启动 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/ 前缀，按量付费不带。