在 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 服務持久化,確保配置在不同會話間的一致性。