前言¶
用 DSH Web GUI 做开发时，额度这件事通常是另开一个页面看：登录 Fireworks Nexus 桌面应用、找到 Overview 卡片、确认本月用了多少、5 小时会话窗口还剩下多少、重置时间是几点。再想看细一点，比如每个模型花了多少钱、缓存命中率多少，网页端没有对应的入口。
下面介绍的插件就是把这张用量卡片搬进 DSH Web GUI。它不开放新的计费能力，只是用 Nexus 客户端自己用过的那个私有 REST API，把已经存在的用量数据读到面板里，并附带按模型的花费拆解。
这是什么¶
dsh-nexus-usage-panel（目录页分类：联网工具）由 bradywatkinson 维护，是一个 DeepSeek Harness Web GUI 的面板插件。
它做的事情一句话：在 DSH 的 Settings → Nexus Usage 页面复刻 Fireworks Nexus 桌面应用 Overview 卡片上的内容，包括套餐档位、本月已用百分比与重置日期、当前会话已用百分比与重置时间，并额外提供按模型的花费拆解和估算节省、缓存命中行（README 中标注为 Milestone 2）。
它不改计费，也不修改用量数据；面板只读，数据来自 Nexus 桌面应用在登录时签发的那把机器级密钥。
核心功能¶
面板读的是 nexus.fireworks.ai 和 Nexus 桌面应用在读的同一套私有 REST API。README 里给出的端点对应关系如下：
| 端点 | 用途 |
|---|---|
GET /v1/accounts/{account}/nexusPlans |
当前套餐档位与计费周期 |
GET /v1/accounts/{account}/users/{user}/nexusPlanUsage |
monthly 与 5 小时 rollingWindow 的用量百分比和重置时间 |
POST /v1/accounts/{account}/usageCosts:query |
按天、按模型的花费（Milestone 2），归属滞后于仪表 |
POST /v1/accounts/{account}/usageSavings:query |
实时按天花费、估算节省与缓存命中率 |
认证用的是 Nexus 桌面应用登录时签发的机器密钥，存放在 macOS 登录钥匙串里（服务名 FireworksAI，账号 fireworks-api-key）。密钥不会离开本机进程，浏览器侧只会拿到脱敏后的百分比。覆盖方式有两种：环境变量 FIREWORKS_NEXUS_KEY 或插件配置里的 apiKey；网关地址可用 NEXUS_GATEWAY_URL 或配置项 gatewayBase 覆盖。
需要注意一点：nexusPlanUsage 只暴露套餐额度的百分比，不返回金额；而 savings 端点对成员密钥会返回美元花费（见 README 指向的 Milestone 2 文档）。按模型的花费只能通过 usageCosts:query 拿到，其归属进度落后于仪表（月初会处于 INCOMPLETE、没有行），在归属完成前面板会显示一条归属等待提示，并附带一条从 savings 管道读取的实时每日花费趋势，同时把模型查询窗口放宽到最近 30 天，让上一周期的行在归属后立即出现。
每日花费趋势默认渲染成 GitHub 风格的贡献网格（周对齐到周日、月标签、Nexus 粉色热力、Less→More 图例），每一格有品牌悬浮提示（Tue, Nov 3 · $4.25，无花费留空）；区块头部的 ▦/☰ 选择器可切换成按天表格。这个选择是宿主端设置，持久化在 ~/.dsh/nexus-usage-panel.json，由 GET/POST /api/dsh-nexus-usage/config 提供，取值形如 {"spendStyle": "grid" | "table"}，其他值回落到 grid。
另外，DSH 会话本身走 Nexus Auto（api.fireworks.ai/inference/v1，model 为 auto），Fireworks 在服务端路由，不会把命中的模型 id 回传给客户端。
安装与启用¶
在 DSH profile 里，或者通过 Web GUI 的 Plugins 页安装。README 给出的命令是：
# In a DSH profile (or via the Plugins page):
pnpm add dsh-nexus-usage-panel
也可以在 DSH Web GUI 里直接装：Plugins → Install，spec 填 dsh-nexus-usage-panel。装完刷新，打开 Settings → Nexus Usage。
不走 npm、直接从 GitHub 安装：同样在 Plugins → Install，spec 填：
github:bradywatkinson/dsh-nexus-usage-panel
用实验性的 Discover 标签（自定义插件市场）时，添加 index 源：
https://raw.githubusercontent.com/bradywatkinson/dsh-nexus-usage-panel/main/market/index.json
然后从卡片上安装 Nexus Usage。该 index 是 format-1，用 @deepseek-ai/dsh-plugin-market-index 校验过。
README 给了两条运行时前提：密钥读取只支持 macOS（且 Nexus 桌面应用必须登录过一次）；网关读取每分钟一次并带缓存，plan 与 seat 各自独立失败，与 Nexus 应用行为一致。
典型用法¶
装好之后不用再关心命令行参数。在 macOS 上确保 Nexus 桌面应用已登录过，然后打开 DSH Web GUI，进入 Settings → Nexus Usage，页面会渲染以下内容：套餐档位徽标、”This month — N% used · Resets
如果归属数据还在 INCOMPLETE 状态，页面上会显示归属等待说明，同时用一条每日花费趋势图替代按模型行。想切表格视图，用区块头部 ▦/☰ 选择器；切完刷新后仍然保持，因为宿主会把选择写进 ~/.dsh/nexus-usage-panel.json。
验证改动是否生效可以用仓库自带的测试：
npm test # host shaping + client smoke
仓库结构上，lib/index.js 是宿主侧 cordis 插件，提供 /api/dsh-nexus-usage/usage；lib/client.js 是浏览器侧模块，在 settings.section 槽位渲染仪表卡片；cordis.patch.yml 是打包用的补丁行。
适用场景与注意¶
适合手上有 Fireworks Nexus 额度、同时在 DSH Web GUI 里干活的开发者，想在一个界面里确认本月与 5 小时窗口还剩多少、以及每个模型大概花掉多少。
几个必须知道的前提：
- 目前只有 macOS 可用，因为要读登录钥匙串；Nexus 桌面应用需先登录一次以签发密钥。
- 面板以当前 DSH 进程的权限运行，也就是它会以你的账号身份访问这些只读端点。安装前建议先读一遍
lib/下的源码与LICENSE（MIT），确认它访问的端点范围符合你的预期。 - 按模型花费存在归属滞后，月初可能没有数据；此时面板自动回退到实时每日花费趋势，不是功能坏了。
- Token 级别的明细没有任何已验证端点会暴露，打算做 token 级追踪的可以先跳过。
- 仓库目前星标数为 0，属于早期项目，接口或配置字段在后续版本中可能调整。
需要修问题或跟踪进展，README 指向 Issues 页：https://github.com/bradywatkinson/dsh-nexus-usage-panel/issues 。Milestone 2（#3）的规划是继续推进 usageCosts:query 的按模型/token 拆解。
结尾¶
这个插件没有引入新的计费口径，它的价值在于把分散在 Nexus 桌面应用里的计划档位、月份用量、会话窗口和重置时间集中到 DSH Web GUI 的同一页，并补上按模型花费与节省估算这条线。对已经在用 Nexus 的 DSH 开发者来说，属于可以直接替代「另开一个页面看额度」这一步的工具。
目录页：https://www.skillhub.cn/plugins/bradywatkinson/dsh-nexus-usage-panel
源码：https://github.com/bradywatkinson/dsh-nexus-usage-panel
