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

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

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

小夜