
Cassius0924/dsh-usage-dashboard
51最近提交 2026年8月15日
dsh-usage-dashboard DSH 插件
在 DSH 的 Web GUI 中添加一个可拖动的悬浮额度窗和一个专属的「额度」标签页。显示余额还可撑几天、今日/本月花费、各模型和会话的成本、缓存节省情况,以及 2026-08-17 峰谷定价后的账单预估。所有费用均为基于本地会话日志的估算。
如何安装 dsh-usage-dashboard DSH 插件
dsh plugin --profile web add @cassius0924/dsh-usage-dashboard复制不会执行命令。安装 dsh-usage-dashboard DSH 插件前请核对仓库和版本。
dsh-usage-dashboard DSH 插件数据来源
dsh-usage-dashboard DSH 插件快照日期:2026年8月16日
discovered
dsh-usage-dashboard DSH 插件能做什么
- 悬浮额度窗,显示余额和今日消耗,可拖动并自动吸附,状态持久化
- 专属「额度」标签页,包含余额可用天数、今日/本月概览与环比、峰谷成本分布
- 按模型分解成本(输入、输出、缓存命中),带排名和可视化图表
- 按会话排名,快速定位高消耗会话
- 缓存命中率分析和节省金额估算
- 余额预警功能,可自定义阈值,仪表盘和悬浮窗同步警示
- 近30天逐天/逐小时用量柱状图及12周热力图
dsh-usage-dashboard DSH 插件适合哪些场景
- 在 DSH 内实时监控 DeepSeek API 的每日花费和剩余预算
- 识别哪些模型或会话消耗过高,优化使用策略
- 预览即将到来的峰谷定价对账单的影响
- 追踪缓存节省效果,提高 prompt 缓存命中率
- 设置个性化余额预警,避免意外超支
dsh-usage-dashboard DSH 插件适合谁
- 自行管理 DeepSeek API Key 的 DSH 用户,希望透明地了解费用去向
- 使用 DSH 构建 agent 工作流的开发者,需要监控每个会话的成本
dsh-usage-dashboard DSH 插件的限制
- 用量数据仅来自本机 DSH 会话日志,不包含其他机器或账户的用量
- 费用为估算值,未考虑 DeepSeek 侧的折扣、赠金消耗顺序等因素,请以官方账单为准
- 首次加载需重放全部会话日志(本机实测约5秒),期间有5分钟的服务端记忆化,界面显示骨架屏
dsh-usage-dashboard DSH 插件的仓库 README 摘录
以下文字摘自 dsh-usage-dashboard DSH 插件的上游仓库 Cassius0924/dsh-usage-dashboard 的 README,版权归原作者,仅作引用。
在 [DSH](https://github.com/deepseek-ai)(DeepSeek Harness)的 Web GUI 里,随时看得见 DeepSeek 的钱花在哪: **余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少,以及 2026-08-17 峰谷定价之后账单会变成什么样。**  装上之后 GUI 里多两样东西:右下角一个可拖动的**悬浮额度窗**,顶部栏多一个**「额度」tab**。 界面支持中文与 English,直接跟随 DSH 全局的「Settings → Language」设置;切换无需刷新,选择由 DSH 持久化。 --- ## 为什么需要它 用 DSH 跑 agent,钱是一点一点漏掉的,而 DSH 自己不会告诉你: | 你真正想知道的 | 装之前 | |---|---| | 余额还能用几天? | 只有一个余额数字 | | 今天花了多少?这个月呢? | 只有「累计」,没有时间感 | | 钱花在哪个模型上? | 不知道 | | 缓存到底帮我省了多少? | 完全看不到 | | 8-17 涨价后我的账单会变成多少? | 只能自己算 | 这个插件把这些问题逐个翻译成一眼能看懂的数字。**费用全部为估算**,算法与单价公开可查(见[费用是怎么算的](#费用是怎么算的))。 --- ## 悬浮额度窗 <img src="docs/widget.png" width="300" alt="悬浮额度窗"> 常驻右下角,不打断你干活: - 余额 + **今日消耗**,一眼就够。 - 可拖动,松手自动吸附四角;边界避开侧边栏、右侧详情面板、会话顶栏和输入框——**不会挡住发送按钮**。 - 可收起成一行;**显示/隐藏、所在角落、收起状态都会记住**,刷新页面后原样回来。 - 余额跌破预警线时,状态点和余额数字一起转成警示色。 - 60 秒自动刷新余额。今日消耗读共享缓存,点 ↻ 同时刷新两者。 - 插件加载时就把余额和用量预取到缓存里,所以打开「额度」tab 通常是秒开, 不用等那几秒的会话日志重放;预取失败不报错,交给各自挂载时再取。 ## 「额度」仪表盘 ### 余额:还能撑几天 <img src="docs/balance.png" width="720" alt="账户余额与可用天数"> 「还剩多少钱」不解决余额焦虑,「还能用几天」才行。按近 7 个自然日(含没用的日子)的日均消耗折算,hover 能看到估算口径;不足 3 天转红。 ### 今日 / 本月花了多少 —— 以及这个数怎么来的 <img src="docs/overview.png" width="860" alt="消耗概览与计价说明"> 今日
阅读完整 README仓库许可: MIT
dsh-usage-dashboard DSH 插件常见问题
如何安装 dsh-usage-dashboard 插件?
在终端运行命令 `dsh plugin --profile web add @cassius0924/dsh-usage-dashboard`。确保已安装 pnpm,并在 DSH 的“设置→模型”中或 `$DSH_HOME/.credentials.yaml` 文件中配置了 DEEPSEEK_API_KEY。安装完成后,重启 DSH(`dsh --profile web`)即可在 GUI 中看到插件。
为什么显示的费用和 DeepSeek 官方账单不一样?
插件基于本地会话日志和固定的价目表(见 `src/pricing.ts`)进行估算。它未考虑 DeepSeek 的官方折扣、赠金或消耗顺序。显示的数字仅供参考,请以官方账单为准。
能查看多台机器或多个账户的用量数据吗?
不能。插件只读取运行 DSH 的本地机器上的会话日志,不能聚合其他机器或不同账户的用量。每个 DSH 实例是独立的。
如何设置余额预警阈值?
在 DSH GUI 的“设置”标签页中(或插件自带的设置),可以自定义余额预警阈值(默认 ¥10,设为 0 关闭)。当余额低于该值时,悬浮窗和“额度”仪表盘都会显示警示色和提示条。
「峰谷价预览」是什么意思?
DeepSeek 将从 2026-08-17 起实施峰谷定价。插件会计算在当前用量下,按照新价格(高峰时段 09:00–12:00、14:00–18:00 北京时间为闲时两倍)的账单估算。它显示用量在峰谷时段的分布,以及新旧价格的差异。定价生效后,插件会建议将高峰用量转移到闲时能节省多少。