前言¶
用 DSH 调用 DeepSeek 模型时，余额、累计消耗和具体用量之间，往往缺少一张能直接看成本的视图。dsh-usage-dashboard 是 Cassius0924 维护的 DSH Web 插件，MIT 许可，用来展示账户余额、今日/本月/累计消耗及环比、模型与会话成本、缓存节省，以及 2026-08-17 峰谷定价后的账单预估。
DSH 的扩展方式可以理解为“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面介绍这个插件的能力、安装方式和注意事项。
这是什么¶
dsh-usage-dashboard 在 DSH Web GUI 中增加悬浮额度窗和顶部「额度」tab，把额度与用量视图放进现有 Web 会话界面里。
能看什么¶
- 账户余额，以及今日、本月、累计消耗和环比。
- 按近 7 个自然日的日均消耗估算余额还能撑几天；不足 3 天时转红。
- 2026-08-17 峰谷定价下的高峰/闲时用量分布与账单预估。
- 前缀缓存命中带来的节省金额。
- 按费用降序的模型成本排行，并拆分输入、输出和缓存。
- 会话成本排行，用于定位最贵的会话。
- 近 30 天逐天、0–23 点逐小时用量分布，以及近 12 周热力图。
界面与提醒¶
界面支持中文与 English，并跟随 DSH Settings → Language 设置。悬浮额度窗常驻右下角，可拖动、吸附四角、可收起，状态会记住。样式使用 DSH 的 --dsw-alias-* CSS 变量，跟随宿主主题。
插件支持余额预警线设置。跌破预警线时，仪表盘和悬浮额度窗都会显示警示。
费用估算¶
插件展示的费用是估算，不是账单。费用估算规则与单价表公开，未识别模型按 deepseek-v4-pro 计价。估算不含 DeepSeek 侧折扣、赠金消耗顺序等因素，最终应以官方账单为准。
安装与启用¶
先确认两个前提：
- 已配置
DEEPSEEK_API_KEY，余额接口会使用该凭据。 - 本机有
pnpm，因为dsh plugin是pnpm的转发器。
从 npm 安装：
dsh plugin --profile web add @cassius0924/dsh-usage-dashboard
或从 GitHub 安装：
dsh plugin --profile web add github:Cassius0924/dsh-usage-dashboard
安装后重启 dsh：
dsh --profile web
典型用法¶
1、打开 GUI 并进入任意一个会话。「额度」 tab 挂在 conversation.view 上，New Session 首页没有 tab 栏，所以需要先进入会话。
2、在顶部查看 Chat / Trajectory / 额度。
3、在设置中配置余额预警线，默认 ¥10，填 0 关闭。
4、在「额度」tab 中查看计价说明、峰谷定价预估、缓存节省、模型/会话排行和用量分布图表。
5、右下角的悬浮额度窗支持拖动、收起和 ↻ 手动刷新，用于常驻查看额度信息。
数据范围与性能¶
用量数据来自本机 DSH 会话日志，不含其它机器或账户的用量。首次加载用量需要重放全部会话日志，本机实测约 5 秒，并启用 5 分钟服务端记忆化。
适用场景与注意¶
适合需要在本机 DSH 中查看 DeepSeek 额度、用量和成本分布的用户，尤其是想对比模型、会话、峰谷时段和缓存节省的人。
需要注意：插件会读取本机 DSH 会话日志，并以当前 dsh 进程权限运行。安装前应检查源码与许可证；许可证为 MIT。
