DeepSeek Harness
在 Web UI 中添加 TokenPlan 供应商、模型和兼容配置。
本文介绍如何在 DeepSeek Harness 中，通过 OpenAI Chat Completions 兼容接口接入有道 TokenPlan。
准备工作
- 安装 Node.js （v22.19 或更高版本）。
- 已开通有道 TokenPlan 并创建 API Key。还没有 Key？请先前往 控制台创建 API Key 。
安装并启动
在终端中执行以下命令启动 DeepSeek Harness：
npx @deepseek-ai/dsh web 命令会自动下载依赖，在 http://127.0.0.1:3080 启动 Web UI 并打开浏览器。 Windows 可在 PowerShell 或 CMD 中执行，macOS 可在终端中执行。
配置接入凭证
- 1打开 Web UI，进入 Settings → Models。
- 2点击 Add a custom provider，按下表填写。
| 配置项 | 填写内容 |
|---|---|
| Provider ID | youdao-zhiyun-token-plan（小写，创建后不可修改） |
| Display Name | Youdao Zhiyun TokenPlan |
| Base URL | https://openapi.youdao.com/llmgateway/api/v1 |
| API Protocol | openai-completions |
| API Key | 有道 TokenPlan API Key。还没有 Key？请先前往 控制台创建 API Key 。 |
在 Model catalog 中添加模型 ID。Auto 模式填 auto， 其他模型根据配置选择，例如 qwen3.8-flash，然后点击保存。
验证配置
保存后无需重启服务。在模型选择器中选择刚添加的模型即可开始对话。
常见问题
密钥保存在 ~/.dsh/.credentials.yaml，其余配置在 ~/.dsh/settings.yaml（Windows 为 C:\Users\<用户名>\.dsh\）。
若模型全部报错、请求被拒绝，编辑 ~/.dsh/settings.yaml， 在该供应商下补上兼容开关：
llm-pi-ai:
providers:
youdao-zhiyun-token-plan:
compat:
supportsDeveloperRole: false
maxTokensField: max_tokens保存后下一次请求自动生效，不用重启。