前言¶
DSH 支持通过插件扩展界面和数据展示。使用 DeepSeek 时，除了当前对话本身，还需要看到账户余额、当前会话预估消耗、历史对话成本，以及不同模型按历史平均消耗还能使用多少次。
@gongshiyun/dsh-usage-dashboard 是 gongshiyun 维护的 DSH 插件，用于展示 DeepSeek 账户余额、当前会话预估消耗、历史对话明细，并根据历史会话的平均消耗估算各模型剩余对话次数。
插件定位¶
- 包名：
@gongshiyun/dsh-usage-dashboard - 维护者：
gongshiyun - 许可证：
MIT - 适用 profile：
desktop或web - Node.js 要求：
^22.19.0 || >=24.0.0
注意：npm 上不带 scope 的 dsh-usage-dashboard 是另一个同名但无关插件。安装时应使用：
@gongshiyun/dsh-usage-dashboard
核心能力¶
余额展示¶
调用 DeepSeek 官方接口：
GET /user/balance
展示总余额、充值余额、赠送余额，货币可为 CNY 或 USD。
当前会话预估¶
在输入框下方实时显示：
- 当前会话预估金额
- 当前余额
- 预估还能对话几轮
该信息随对话每 4 秒自动刷新。
全局看板¶
在「设置 → 用量与余额」中展示：
- 余额卡片
- 历史对话明细
- 各模型剩余对话次数
历史对话明细¶
历史对话明细按创建时间倒序展示：
- 创建时间
- 输入 token
- 输出 token
- 折算金额
空会话会被自动跳过。
模型聚合¶
插件会按模型聚合历史会话，估算剩余对话次数，并展示：
- 会话数
- 平均消耗
- 累计消耗
- token 明细
价目核算¶
支持通过 pricing 价目历史按生效时间、模型和峰谷时段核算成本。
安装与启用¶
插件必须能被 Cordis Loader 从 profile 目录按名称解析。下面以 desktop profile 为例；Web 版把命令中的 desktop 换成 web 即可。
推荐安装命令：
dsh plugin --profile desktop add @gongshiyun/dsh-usage-dashboard
安装后重启或刷新 DSH Desktop。可以用下面命令确认 usage-dashboard 条目已生效：
dsh --profile desktop --dump-config
手动安装¶
如果需要使用手动安装方式，先将包安装进 profile 的 node_modules，再编辑 cordis.patch.yml 并重启。
1、进入 profile 目录并安装依赖：
cd "$DSH_HOME/profiles/desktop"
pnpm add <本包路径或包名>
2、编辑：
$DSH_HOME/profiles/desktop/cordis.patch.yml
插入 usage-dashboard 配置。最小配置示例：
- insert:
- id: usage-dashboard
name: '@gongshiyun/dsh-usage-dashboard'
config:
currency: CNY
3、重启 DSH Desktop。
配置¶
插件可配置项包括：
| 键 | 说明 |
|---|---|
apiKeyEnv |
API Key 凭证引用名，默认为 DEEPSEEK_API_KEY |
currency |
计价与余额展示货币，可为 CNY 或 USD，必须与 pricing 单位一致 |
baseURL |
DeepSeek API 根地址 |
balanceCacheMs |
余额缓存时长 |
pricing |
价目历史，按生效时间、模型和峰谷时段核算成本 |
默认价目历史为内置，不会自动跟随 DeepSeek 官方后续调价。
限制与注意¶
- 余额接口为按需轮询：侧边栏胶囊
60s、仪表盘4s，不是实时推送。 - 无网络或未配置 API Key 时，余额会显示错误提示；成本统计仍可用，取决于本地会话数据。
- 跨会话的历史平均依赖
dsh-session-query服务，DSH 默认组合已包含。 - 插件以当前 DSH 进程权限运行。安装前应检查源码、配置和许可证，并确认包名为
@gongshiyun/dsh-usage-dashboard。
结尾¶
@gongshiyun/dsh-usage-dashboard 适合在 DSH 中查看 DeepSeek 余额、当前会话消耗、历史对话成本和各模型剩余对话次数。
项目地址：
