dsh-openrouter-provider-badge：在 DSH 會話統計行顯示 OpenRouter 實際供應商

前言¶

DeepSeek Harness (DSH) 採用插件化架構。在使用 OpenRouter 通道時，雖然 DSH 會話統計行顯示的是配置的路由（例如 openrouter/deepseek-v4-flash-0731），但 OpenRouter 實際會根據負載和策略，將請求分發到不同的上游供應商（如 StreamLake、DeepInfra、Novita 等）。

DSH 原生面板無法展示這一動態選擇的供應商信息。dsh-openrouter-provider-badge 是一個純客戶端插件，通過補丁和配置注入，將 OpenRouter 返回的元數據渲染到每條會話輪次的統計行上方。

核心功能¶

顯示實際供應商：在會話統計行上方顯示 OpenRouter 實際選中的供應商名稱。
純客戶端運行：服務端僅作爲骨架，核心邏輯在客戶端渲染。
靜默降級：如果未配置、補丁未生效或 Key 限額被拒，插件會靜默失敗，不影響會話本身的正常進行。

安裝與配置¶

本插件需要三步配置才能生效：安裝插件、運行補丁腳本、配置請求頭。

1. 安裝插件¶

使用官方安裝命令將插件添加到 web profile：

dsh plugin --profile web add /path/to/dsh-openrouter-provider-badge

2. 運行補丁腳本¶

DSH 默認配置層會丟棄 OpenRouter 的供應商元數據。必須運行 patch.sh 腳本對 node_modules 進行打補丁。該腳本會根據 dsh-llm-pi-ai 的版本自動選擇對應的補丁目錄。

bash patch.sh

注意：補丁僅修改 node_modules 產物，升級 DSH 後補丁會被覆蓋，需重新運行此腳本。

3. 配置請求頭¶

編輯 ~/.dsh/settings.yaml（Windows: C:\Users\<你>\.dsh\settings.yaml），在 openrouter provider 的配置中添加 X-OpenRouter-Metadata: enabled 請求頭。

llm-pi-ai:
  providers:
    openrouter:
      apiKeyEnv: OPENROUTER_API_KEY
      headers:
        X-OpenRouter-Metadata: enabled
      models:
        - id: deepseek/deepseek-v4-flash-0731
          name: "DeepSeek: DeepSeek V4 Flash 0731"
          contextWindow: 1048576
          maxTokens: 384000

4. 重啓服務¶

重啓 DSH 服務後刷新網頁，發送一輪 OpenRouter 請求，即可在統計行上方看到供應商徽標。

與其他插件的差異¶

DSH 生態中存在其他顯示 provider 信息的插件，但側重點不同：

插件	顯示內容	差異說明
dsh-chat-tweaks / dsh-plugin-model-provider-readout	配置的 Provider 顯示名	顯示的是 `settings.yaml` 中配置的靜態 Provider 名
dsh-openrouter-provider-badge	OpenRouter 實際供應商	顯示的是 OpenRouter 動態選中的上游服務商（StreamLake 等）

一句話概括：其他插件告訴你“配置的是誰”，本插件告訴你“這次請求實際是誰在服務”。

維護狀態與兼容性¶

已停止維護：插件於 2026-09-10 停止更新，v0.1.2 爲最終版本。作者因不再使用 OpenRouter 通道（API 降價）而停止維護，後續 DSH 升級若導致不兼容，作者不再適配。
版本兼容：支持 DSH 0.1.1-rc.2 / 0.1.5-rc.1 及以上版本。
適用範圍：僅適用於 OpenRouter 通道。

總結¶

該插件解決了在 DSH 中觀測 OpenRouter 實際路由去向的需求。由於已停止維護，如需長期使用，需自行維護或確認當前 DSH 版本與插件版本的兼容性。