在 DeepSeek Harness (DSH) 中使用 OpenRouter 模型时,有时需要指定特定的提供商或限制量化位数。dsh-openrouter-providers 插件通过插件设置页面提供了这一配置入口,允许管理提供商列表并注入路由参数,同时将设置持久化到本地配置文件。
核心功能¶
- 插件配置卡:以折叠卡片形式展示,支持填写提供商 slug 列表、选择路由模式(仅允许或按顺序优先)以及量化位数限制。
- 界面跟随 DSH 语言:使用
openrouter-providerslocale 命名空间,支持中英文切换,与 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,插件即可生效。
典型用法¶
- 确保模型的 provider 路由为
openrouter,在模型选择器中选中 OpenRouter 下的模型。 - 进入「插件 → 插件配置 → OpenRouter 提供商列表」,填写提供商 slug(如
DeepInfra、Together),选择路由模式与量化位数限制,保存。 - 之后的 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 服务持久化,确保配置在不同会话间的一致性。