dsh-provider-info

一个 DeepSeek Harness 插件。

它的作用只有一件事：在你选择模型的地方，旁边显示一行小字，告诉你当前选中的模型是哪家服务商（公司）提供的。

把鼠标移动到这行小字上，会弹出一个深色小面板，列出这家服务商和当前模型的详细信息。

这是什么问题

DeepSeek Harness 可以同时配置多家 AI 服务商，每家服务商下面又挂着许多模型。光看模型名称，你很容易搞不清它到底走的是谁的接口、用的是哪家服务。这个插件就是想让你一眼看清楚：我现在选的模型，是哪家提供的。

它能干什么

• 模型旁边多一行小字：显示当前模型所属服务商的名称。如果服务商没有设置名称，就显示它的编号（像 ID 一样的代号）。
• 鼠标悬停弹出小面板，分两部分：
  • 服务商信息：显示名称、编号、用的 API 协议（比如 OpenAI 兼容、Anthropic 等）、API 地址、密钥对应的环境变量名。
  • 当前模型信息：模型编号、显示名、描述、支持哪些推理等级、当前用的推理等级、上下文窗口大小、最大 token、支持哪些输入类型、兼容信息。
• 没有填的信息会显示「未提供」；文字太长会自动换行。
• 切换模型后，旁边那行小字会自动跟着变。
• 悬停即显：鼠标移到提供商标签上立刻显示面板（用本地缓存同步渲染，余量未就绪时先显示「刷新中…」，数据回来后在后台补齐），不会出现“悬停没反应、移开后才弹出”。
• 标签与选择器分离：标签挂在 DSH 官方槽位 conversation.input.right（模型座左侧的官方空槽），由 DSH 布局系统自动排列，不侵入原生模型选择器；旧版 DSH 没有该槽时自动回退到兼容方式。
• 不碰密钥：它只显示密钥对应的环境变量名，绝不会读取或显示密钥的真实内容。
• 余量区块：对支持查询的厂商，悬浮浮层还会展示当前提供商的余量。两类提供商共用同一套呈现规则：
  • 余额型（如 DeepSeek）：一行「余额」，显示账户金额（多币种，如 ¥20.38 / $0.00）。
  • 套餐型（如 OpenCode Go、Command Code）：按窗口逐行显示，行名是窗口周期名 5小时 / 周 / 月，行内容是 已用% · $已用/$总额 · 重置倒计时；浮层里这几行按四列网格对齐（标签 | 比例 | 金额 | 倒计时，金额不带括号、段间用 · 分隔、各列右边缘对齐，比例从 4.00% 到 77.00% 宽度不同也不会错位）；厂商提供订阅计费周期时，最后再加一行「到期」（如 2026-10-08 · 剩 27 天，按普通行渲染，不参与窗口列的对齐）。
    • OpenCode Go：5小时 / 周 / 月 三个滚动窗口。接口只回百分比 + 重置时间，金额按官方套餐价常量折算；接口没有独立的订阅字段，但月窗的重置时间就是计费周期终点（周窗锚在周一 00:00、月窗锚在订阅起算日 + 1 个月），所以它同时作为「到期」显示；「月」行照旧带自己的重置倒计时，三行窗口的呈现方式保持一致（「到期」行单独给日期，开启「显示更多信息」后附「剩 N 天」）。
    • Command Code（GOAT / Pro / Max 等套餐，如 https://api.commandcode.ai/provider/v1）：5小时 / 周 两个窗口 + 月度池（归一到「月」窗口，总额度 = 周窗 × 2 动态推导）+ 订阅「到期」（官方 CLI 同款内部接口，只读）。
    • 窗口时长以厂商为准：常见档位显示为 5小时 / 周 / 月，厂商换成别的时长就按真实时长显示（如 5天），不需要改代码。
  • 不支持查询的提供商（含未识别厂商）浮窗照常显示「当前暂不支持查询当前提供商」；未配置密钥显示「未配置 API Key」；查不到数据时按原因给话：网络不可达 / 查询超时 / 请求过频（429） / 服务端错误 503 / HTTP 状态 4xx，实在归不了类才是「查询失败」。
  • 设置 → 提供商信息 里的「全部提供商余量」表格与浮层是同一份数据、同一套列名：提供商 | 5小时 | 周 | 月 | 余额 | 到期 | 操作，谁有数据填谁，没有的留空；查不了/出错的厂商，状态跟在名称后面，不占数据列。
  • 这些查询都是只读的，不会扣费、不会消耗 token。
  • host 端按 provider 缓存 5 分钟，反复悬浮不会频繁打厂商接口。
  • 瞬时失败会自己好：连接被 reset（ECONNRESET）、429、5xx 自动重试一次（超时的第二次把等待上限压到 8 秒）；失败结果只缓存 20 秒（成功仍是 5 分钟），一次网络抖动不会再让设置页表格把「查询失败」挂满 5 分钟；打开设置页时首轮失败的话，1.8 秒后还会自动再查一次，不用手点刷新。原始错误会打到 host 控制台：[provider-badge] 余量查询失败 { provider, family, error }。
  • 余量区块带「刷新」按钮：点击立即绕开缓存、强制拉取最新余量（仍只读、不扣费）；平时悬停走 5 分钟缓存。
  • 鼠标悬停到浮窗/按钮上时，消息流滚动不会隐藏浮窗，方便查看；移开后才因滚动隐藏。
  • 刷新行为可在「设置 → 提供商信息」调整：开启显示悬浮窗自动刷新（默认开）则浮窗打开时立即重新查询最新余量（绕开缓存）；或开启定时刷新（默认关）并设置间隔（默认 5 分钟，最低 1 分钟），在浮窗打开时定时重新查询。设置持久化于 $DSH_HOME/dsh-provider-info.json（权限 0600）。

效果图

模型选择按钮旁边的那行小字（这里显示提供商是 opencode-go）：

鼠标移上去弹出的详细信息面板：

怎么安装

这个插件需要通过 DSH 的 profile 机制加载（比如 web profile）。

方式一：用命令安装

dsh plugin --profile web add dsh-provider-info

方式二：手动配置

在 profile 的依赖里加上它：

// profile 的 package.json
"dependencies": { "dsh-provider-info": "^0.1.0" }

再在 profile 配置里声明加载它：

# profile 配置
dsh:
  profile:
    bundles:
      - dsh-provider-info

装好后重启一次 dsh web，然后刷新页面。

设置

打开 设置 → 提供商信息 配置余量刷新行为：

• 显示悬浮窗自动刷新（默认勾选）：鼠标移到徽章上、浮窗打开时就立即重新查询最新余量，绕开 5 分钟缓存。
• 定时刷新（默认不勾选）+ 定时刷新间隔(分钟)（默认 5，最低 1）：浮窗打开时按设定间隔定时重新查询余量（未开启定时刷新时，下方的间隔输入框禁用变灰）。
• 显示更多信息（默认勾选）：勾选时窗口额外显示 （已用/总额） 金额、浮层显示重置倒计时、到期显示剩余天数；不勾选时余量只显示比例数字与到期日期（界面更干净），此时比例作为右对齐的值直接贴着面板右边缘，与「到期」以及上方「提供商 / 当前模型」各行的值对齐。浮层与设置页表格同时生效。
• 界面语言（默认「跟随系统(dsh)」）：设置悬浮面板与设置页的语言——「跟随系统(dsh)」跟随 DSH 界面语言（中文界面→中文，英文界面→英文）；「中文」强制中文；「English」强制英文。强制语言只影响本插件，不会改动 DSH 自身的语言设置。

改动会保存到 $DSH_HOME/dsh-provider-info.json 并立即生效。

怎么用

不需要任何操作。打开对话界面，模型选择按钮旁边就会自动出现那行小字。鼠标移上去就能看到详细信息。

隐私说明

这个插件只是读取你本机正在运行的 DSH 实例里的服务商配置，用来显示信息。所有数据都只在你自己的浏览器里展示，不会发送到任何地方。密钥值从头到尾都不会被读取或显示，只显示密钥对应的环境变量名。

许可证

MIT