前言¶
在 DeepSeek Harness（DSH）里来回切换模型时，背后往往是不同的供应商路由和不同的计费方式：有的是额度窗口（5 小时、每周），有的是账户余额，还有的是 Credits。若要到各家的控制台或单独脚本里查，容易和「当前会话正在用哪条路由」脱节。
dsh-usage-hub 是社区维护的 DSH 插件，把查询对象绑在会话的模型选择上：换模型就换供应商，用量数字跟着变。下面介绍它的定位、能力与安装方式。
这是什么¶
- 名称：dsh-usage-hub（npm 包名同插件 id
usage-hub） - 维护者：KevenUnderwood
- 分类：admin-security（SkillHub 目录归类）
- 许可证：MIT（见 GitHub 仓库）
- 版本：资料中 package.json 为 0.1.0
插件面向已有 Web 界面的 DSH 安装，在界面中展示当前对话所用模型背后供应商的额度窗口、账户余额与 token 用量；另有一页独立的供应商清单，不与用量数字混排。官方简介与 README 一致：支持 DSH 中当前主流大模型对应的路由，可在详情页与左下角概览查看。
核心功能¶
跟随会话模型¶
浏览器读取会话 modelSelection 投影的 next ?? lastUsed，带着新的 provider 重新查询。不需要额外配置，也没有「先选账户再查」的下拉框。切换模型即切换查询对象。
用量与额度展示¶
- 额度窗口：以进度条展示剩余比例（≥40% 绿、≥15% 橙、更低为红），并显示已用百分比与重置时间。
- 余额 / Credits：按各供应商 API 返回形态展示（例如 DeepSeek 分币种余额、OpenRouter 已用/总额度等）。
- 当前会话 token：输入、输出、缓存读/写及合计。
- 跨会话累计：按模型聚合请求数与各 token 维度，数据来自会话日志回放。
供应商目录页¶
单独列出内置识别的供应商：展示凭据引用名（如 MINIMAX_CN_API_KEY）与是否解析成功、API 基址，提供「查看」入口；不展示 key 本身。已配置与未配置凭据用不同标记区分，并可「回到当前模型」。
适配器与语言¶
- 逐供应商声明用量接口、鉴权方式与响应解析；README 列出十四家内置路由及一个面向自建 OpenAI 兼容中转站的通用适配器。
- 识别顺序：DSH 供应商路由 id → base URL → 若有
baseURL但无法匹配则走通用中转站适配器。 - 界面中英双语，跟随 harness 语言设置。
- 零运行时依赖：宿主侧使用 Node 内置能力；
schemastery为可选 peer，仅用于配置 schema。
安装与启用¶
前提：已有带 Web 界面的 DeepSeek Harness，且 Node.js ≥ 20；engines 要求 dsh ≥ 0.2.1-rc.1。
推荐从 npm 安装：
dsh plugin --profile web add dsh-usage-hub
也可从 GitHub 或本地目录安装：
dsh plugin --profile web add github:KevenUnderwood/dsh-usage-hub
dsh plugin --profile web add ./dsh-usage-hub
装完后重启 dsh web（或桌面版），再刷新页面。
若从本地目录安装，README 强调：不要安装带自身 node_modules 的链接目录，否则会遮蔽 harness 共享的 @deepseek-ai/cordis，宿主侧注册失败、浏览器请求 404。目录若曾 npm install，应删除 node_modules，或改用 tarball：
npm pack && dsh plugin --profile web add ./dsh-usage-hub-0.1.0.tgz
桌面版使用独立 profile（~/.dsh/profiles/desktop），在桌面窗口使用时需在该 profile 下同样安装一份。
典型用法¶
开箱即用：在 DSH「设置 → 模型」中配置好各路由使用的 API Key（或对应 OAuth token），插件每次查询会重新解析凭据，无需重启。
- 在会话里选择要用的模型，左下角概览或进入用量详情，查看当前供应商的额度窗口或余额及本会话 token。
- 打开「供应商 / Providers」页，核对哪些路由已配置凭据引用、哪些尚未配置，再点「查看」进入对应供应商用量。
- 切换模型后刷新或等待面板跟随
modelSelection更新，确认查询对象已切换到新路由背后的供应商。
凭据多数情况下无需插件内配置：插件向 harness 索取该路由已在用的 key 引用名；用户若在 dsh-llm-pi-ai 的 providers.<route>.apiKeyEnv 中自定义过引用名，同样可识别。README 另列 keyRefs 等可选 bundle 配置，见下一节。
配置（可选）¶
默认可不改动。可信 profile 可在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中按 id 覆盖 bundle 已插入的 usage-hub 行（勿 duplicate 同 id，否则会 duplicate loader entry id 启动失败）：
- id: usage-hub
name: dsh-usage-hub
config:
requestTimeoutMs: 20000
maxSessions: 100
| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
keyRefs |
string[] |
[] |
所有供应商额外尝试的凭据引用名 |
maxSessions |
number |
50 |
跨会话聚合最多回放会话数 |
usageCacheMs |
number |
30000 |
聚合结果缓存时长（毫秒） |
requestTimeoutMs |
number |
15000 |
单次用量查询超时（毫秒） |
diagnostics |
boolean |
false |
是否写本地诊断日志 |
diagnosticsPath |
string |
"" |
诊断日志路径；空则系统临时目录 |
支持的供应商（摘要）¶
完整路由、接口 URL 与展示形态见 GitHub README。资料中包括但不限于：deepseek-official / deepseek、deepseek-account（已登录账户钱包，无需 API Key）、anthropic、openai-codex、kimi-coding、zai-coding-cn / zai、minimax-cn / minimax、opencode-go、github-copilot、openrouter、moonshotai-cn / moonshotai、siliconflow、novita、stepfun，以及带 baseURL 的其它路由（通用中转站适配器依次尝试常见余额路径）。
凭据类型注意¶
以下接口不接受普通 API Key，401 通常表示凭据类型不对，而非插件故障：
- Claude（
anthropic）：/api/oauth/usage需要 OAuth access token，不是ANTHROPIC_API_KEY。 - ChatGPT / Codex（
openai-codex）：需要 ChatGPT 订阅的 OAuth access token。 - GitHub Copilot（
github-copilot）：需要 GitHub OAuth token（Authorization: token …）。
适用场景与注意¶
适合：在 DSH Web（或桌面）中频繁切换多供应商模型、希望在一处对照额度窗口、余额与会话/累计 token 的开发者与运维。
注意：
- 插件以当前 DSH 进程权限运行，会向各供应商官方（或路由配置的）用量/余额接口发起请求；安装前请自行审阅 源码与 MIT 许可证。
- 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」的扩展方式。
- 跨会话汇总与缓存受
maxSessions、usageCacheMs等配置影响；上游 API 变更或凭据错误时，面板会显示上游返回的错误信息。
结尾¶
dsh-usage-hub 把「当前模型 → 供应商 → 额度与 token」连成一条自动跟随的路径，减少切换模型后查错账户的情况。需要安装命令、凭据引用表与适配器细节时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/KevenUnderwood/dsh-usage-hub
- GitHub：https://github.com/KevenUnderwood/dsh-usage-hub
