DeepSeek Harness
DeepSeek Harness是 DeepSeek 开源的 agent harness（智能体框架），提供 Web UI 与 CLI 两种使用方式，本教程以 Web UI 为例。通过添加自定义提供方，可接入云知声 MaaS 平台上的 AI 模型，支持按量付费/模型资源包、Token Plan 两种接入方式。
一、安装 DeepSeek Harness
- 安装或更新 Node.js。
- 在终端中执行下列命令，启动 Web UI。
Bash
npx @deepseek-ai/dsh web启动 Web UI，本机启动时会自动用浏览器打开页面；传入 --no-open 可仅运行服务器不打开浏览器。
二、配置目标模型
- 右下角设置 → 模型，选择 添加自定义提供方，按下表填写。
| 字段 | 填写内容 |
|---|---|
| Provider ID | unisound（自定义，需为小写；创建后不可修改） |
| API地址 | https://maas-api.unisound.com/v1 |
| API 协议 | openai-completions |
| API 密钥 | UNISOUND_API_KEY |
请注意：平台支持按量付费/模型资源包、Token Plan 两种计费方式，对应的凭证获取方式不同：
| 使用方式 | 说明 | 获取方式（以下 API Key 均为示例） |
|---|---|---|
| 按量付费 API 调用 | 按实际使用量计费，适合轻度使用 | API Key 格式：sk-xxxxx 前往 API Key 管理 创建 API Key |
| Token Plan | 固定订阅费，按套餐限量调用 | API Key 格式：tp-xxxxx 成功订阅后，前往 订阅管理 获取专属 API Key |
- 点击“获取可用模型”按钮，即可获取该API Key下所有可用模型列表：
按需选择想要调用的模型，点击“添加所选”，再点击“添加提供方”，即可保存成功。
在模型选择器中选择 unisound 下的目标模型即可开始对话；选择模型会同时将其设为新会话的默认值。
三、快速接入能力模型
我们预置 U2-ASR、U2-TTS、U2-TTS-Clone、U1-OCR 模型能力，只需在 DeepSeek Harness 中添加对应模型 Skill，即可快速调用相关模型服务，无需单独对接各类模型 API 接口。
点击下方链接跳转至对应 Skill 页面，可通过对话或命令行安装 Skill，安装完成后 Skill 将会引导您进行相关模型的配置。