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 版本与插件版本的兼容性。