DeepSeek Harness 设置
将 SimiRouter 添加为 DeepSeek Harness 的自定义 OpenAI 兼容供应商,并在 Web UI 或 settings.yaml 中配置模型。
DeepSeek Harness(dsh)是 DeepSeek AI 开源的智能体框架。将 SimiRouter 配置为自定义供应商后,可以在 Harness 的 Web UI 和 headless 任务中使用 SimiRouter 模型。
前置条件
开始之前,请准备好:
- SimiRouter 账户和 API Key
- Node.js 与
npx - macOS、Linux 或 Windows 终端
- 一个准备交给智能体操作的项目目录
安装并启动
进入希望智能体操作的项目目录,然后运行:
npx @deepseek-ai/dsh webWeb UI 默认地址为 http://127.0.0.1:3080,当前目录会成为工作区根目录。
如需更换端口:
npx @deepseek-ai/dsh web --port 8080在 Web UI 中配置 SimiRouter(推荐)
1. 打开模型设置
在 DeepSeek Harness Web UI 中进入 Settings → Models。

2. 添加自定义供应商
选择 Add a custom provider,填写以下内容:
| 字段 | 填写内容 |
|---|---|
| Provider ID | simirouter |
| Display name | SimiRouter |
| Base URL | https://api.dwchainless.com/v1 |
| API protocol | openai-completions |
| API key | 你的 SimiRouter API Key |

Provider ID 会被会话、默认模型和凭据引用,保存后不能直接改名。请保持小写并使用 simirouter。
3. 获取模型
在 Model catalog 中选择 Fetch available models。Harness 会使用当前 Base URL 和 API Key 请求模型列表。
勾选需要的模型后保存。如果自动获取失败,也可以手动填写模型 ID,例如 gpt-6-astra。模型名称必须与当前 API Key 分组实际可用的名称一致。

4. 选择模型
保存后,在输入框附近的模型选择器中找到 SimiRouter,选择准备使用的模型。该模型会成为新会话的默认模型;已经发送过请求的旧会话会继续使用其原有模型。

使用 settings.yaml 配置
也可以编辑 $DSH_HOME/settings.yaml,默认路径通常是 ~/.dsh/settings.yaml:
llm-pi-ai:
providers:
simirouter:
displayName: SimiRouter
apiKeyEnv: SIMIROUTER_API_KEY
api: openai-completions
baseURL: https://api.dwchainless.com/v1
models:
- id: gpt-6-astra
agent-default-model:
provider: simirouter
model: gpt-6-astra不要把 API Key 直接写进 settings.yaml。可以通过启动环境传入:
SIMIROUTER_API_KEY="sk-..." npx @deepseek-ai/dsh web也可以写入 $DSH_HOME/.credentials.yaml:
SIMIROUTER_API_KEY: sk-...macOS 和 Linux 用户可以限制凭据文件权限:
chmod 600 ~/.dsh/.credentials.yaml自定义供应商必须设置 api、baseURL 和至少一个模型。models 列表中需要包含所有希望在选择器里显示的模型。
验证配置
- 打开
http://127.0.0.1:3080。 - 确认模型选择器中出现 SimiRouter 和已保存的模型。
- 新建会话并发送一条简短测试消息。
- 如果可以正常返回结果,说明配置已经生效。
Headless 模式
Web UI 和 headless 模式共用 $DSH_HOME 中的模型与凭据配置。完成一次配置后,可以运行:
npx @deepseek-ai/dsh --profile headless "列出当前目录中的文件"常见问题
MISSING_CREDENTIAL
Harness 找不到 SIMIROUTER_API_KEY。请在 Settings → Models 重新保存 API Key,或在启动进程的终端中设置同名环境变量。
UNKNOWN_MODEL
当前模型不在 simirouter 的 models 列表中。请重新获取模型,或把正确的模型 ID 手动加入列表。
获取模型或对话时出现 401
- 检查 API Key 是否完整、有效且没有多余空格。
- 确认 Base URL 为
https://api.dwchainless.com/v1。 - 确认当前 API Key 分组可以使用所选模型。
请求没有经过 SimiRouter
确认添加的是 custom provider,Provider ID 为 simirouter。内置的 DeepSeek、OpenAI 或 Anthropic 供应商仍会使用各自的官方端点。
修改默认模型后没有生效
新建一个会话再测试。已经发送过请求的会话会保留自身记录的模型。
官方参考
这篇文档对您有帮助吗?
最后更新于