SimiRouter

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 web

Web UI 默认地址为 http://127.0.0.1:3080,当前目录会成为工作区根目录。

如需更换端口:

npx @deepseek-ai/dsh web --port 8080

在 Web UI 中配置 SimiRouter(推荐)

1. 打开模型设置

在 DeepSeek Harness Web UI 中进入 Settings → Models。

打开 DeepSeek Harness 模型设置

2. 添加自定义供应商

选择 Add a custom provider,填写以下内容:

字段填写内容
Provider IDsimirouter
Display nameSimiRouter
Base URLhttps://api.dwchainless.com/v1
API protocolopenai-completions
API key你的 SimiRouter API Key

填写 SimiRouter 自定义供应商配置

Provider ID 会被会话、默认模型和凭据引用,保存后不能直接改名。请保持小写并使用 simirouter。

3. 获取模型

在 Model catalog 中选择 Fetch available models。Harness 会使用当前 Base URL 和 API Key 请求模型列表。

勾选需要的模型后保存。如果自动获取失败,也可以手动填写模型 ID,例如 gpt-6-astra。模型名称必须与当前 API Key 分组实际可用的名称一致。

选择要添加到 SimiRouter 供应商的模型

4. 选择模型

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

在 DeepSeek Harness 中选择 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 列表中需要包含所有希望在选择器里显示的模型。

验证配置

  1. 打开 http://127.0.0.1:3080。
  2. 确认模型选择器中出现 SimiRouter 和已保存的模型。
  3. 新建会话并发送一条简短测试消息。
  4. 如果可以正常返回结果,说明配置已经生效。

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 供应商仍会使用各自的官方端点。

修改默认模型后没有生效

新建一个会话再测试。已经发送过请求的会话会保留自身记录的模型。

官方参考

这篇文档对您有帮助吗?

最后更新于

QQWhatsAppTelegramSimiTalk