dsh-openrouter-providers:DeepSeek Harness OpenRouter 路由配置插件

在 DeepSeek Harness (DSH) 中使用 OpenRouter 模型时,有时需要指定特定的提供商或限制量化位数。dsh-openrouter-providers 插件通过插件设置页面提供了这一配置入口,允许管理提供商列表并注入路由参数,同时将设置持久化到本地配置文件。

核心功能

  • 插件配置卡:以折叠卡片形式展示,支持填写提供商 slug 列表、选择路由模式(仅允许或按顺序优先)以及量化位数限制。
  • 界面跟随 DSH 语言:使用 openrouter-providers locale 命名空间,支持中英文切换,与 DSH 界面语言保持一致。
  • 请求注入:监听 llm/stream 事件,当模型路由为 openrouter 时,重路由至 adapter 并注入 provider.only、provider.order 或 provider.quantizations 参数。
  • 凭据复用:复用环境变量 OPENROUTER_API_KEY,无需额外配置。
  • 应用归属:自动注入 HTTP-Referer、X-OpenRouter-Title 等头,使 OpenRouter 界面/排行榜显示为 DeepSeek Harness OpenRouter。
  • 状态持久化:配置写入 DSH 设置文档(~/.dsh/settings.yaml),重启后自动恢复。

安装与启用

插件以 bundle 包形式挂载,通过 cordis.patch.yml 的 insert 行自动合并进 profile composition。

在 profile 目录执行以下命令安装:

pnpm add dsh-openrouter-providers@latest

在 profile 的 package.json 中将插件名加入 dsh.profile.bundles 列表:

{
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-openrouter-providers"
      ]
    }
  }
}

完成上述步骤后,重启 dsh web,插件即可生效。

典型用法

  1. 确保模型的 provider 路由为 openrouter,在模型选择器中选中 OpenRouter 下的模型。
  2. 进入「插件 → 插件配置 → OpenRouter 提供商列表」,填写提供商 slug(如 DeepInfra、Together),选择路由模式与量化位数限制,保存。
  3. 之后的 OpenRouter 请求都会自动携带注入的 provider 路由参数。

适用场景与注意

  • 适配版本:本插件适配 DeepSeek Harness 0.1.5-rc.1,需要 @deepseek-ai/dsh-settings@^0.1.5-rc.1 作为 peerDependency。
  • 功能限制:
    • 图像输入暂不支持(返回 UNSUPPORTED_CONTENT)。
    • 在 only 模式下,allow_fallbacks 被强制为 false,列表中全部提供商不可用时请求会失败。
  • 生态背景:DSH 理念为「一切皆插件」,本插件为社区项目,源码与文档位于 GitHub。

短结尾

该插件将 OpenRouter 的复杂路由配置封装在 DSH 设置面板中,便于管理和维护。所有配置均通过 DSH settings 服务持久化,确保配置在不同会话间的一致性。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜