dsh-usage-dashboard DSH plugin

Adds a draggable floating balance widget and a dedicated 'Usage' tab to DSH's Web GUI. Shows estimated remaining days, today's/monthly spend, cost by model and session, cache savings, and a projection of the 2026-08-17 peak/off-peak pricing impact. All calculations are estimates based on local session logs.

ui-productivity developer-tools

How to install the dsh-usage-dashboard DSH plugin

dsh plugin --profile web add @cassius0924/dsh-usage-dashboard

Copying does not run this command. Review the repository and version before installing the dsh-usage-dashboard DSH plugin.

dsh-usage-dashboard DSH plugin data source

dsh-usage-dashboard DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-usage-dashboard DSH plugin can do

Floating balance widget showing balance and today's spend, draggable with auto-snap and persistent state
Dedicated 'Usage' tab with balance runway, daily/monthly overview with comparisons, peak/off-peak cost breakdown
Cost breakdown by model (input, output, cache) with ranking and visual charts
Session-level cost ranking to identify expensive conversations
Cache hit rate analysis and estimated savings
Balance alert with customizable threshold, warning on dashboard and widget
30-day daily/hourly usage charts and 12-week heatmap

Where the dsh-usage-dashboard DSH plugin fits

Monitor daily DeepSeek API spending and remaining budget from within DSH
Identify which models or sessions are driving high costs and optimize usage
Preview the financial impact of upcoming peak/off-peak pricing changes
Track cache savings and improve prompt caching efficiency
Set personalized balance alerts to avoid unexpected overruns

Who the dsh-usage-dashboard DSH plugin is for

DSH users who manage their own DeepSeek API key and want transparent cost tracking
Developers building agent workflows with DSH and need to monitor per-session expenses

dsh-usage-dashboard DSH plugin limitations

Usage data comes only from the local DSH session logs; usage from other machines or accounts is not included
Costs are estimates and do not account for DeepSeek discounts, grant consumption order, etc.; official billing is authoritative
First load requires replaying all session logs (approx. 5 seconds on local machine), with a 5-minute server-side memoization; skeleton screen shown during loading

dsh-usage-dashboard DSH plugin: from the repository README

Quoted from the Cassius0924/dsh-usage-dashboard README, the upstream source of the dsh-usage-dashboard DSH plugin. Copyright remains with the original authors.

在 [DSH](https://github.com/deepseek-ai)（DeepSeek Harness）的 Web GUI 里，随时看得见 DeepSeek 的钱花在哪： **余额还能撑几天、今天花了多少、哪个模型最贵、缓存替你省了多少，以及 2026-08-17 峰谷定价之后账单会变成什么样。** ![dsh-usage-dashboard](docs/hero.png) 装上之后 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="消耗概览与计价说明"> 今日

Read the full READMERepository license: MIT

dsh-usage-dashboard DSH plugin questions

How do I install the dsh-usage-dashboard plugin?

Run the command `dsh plugin --profile web add @cassius0924/dsh-usage-dashboard` in your terminal. Make sure you have pnpm installed and your DEEPSEEK_API_KEY configured in Settings → Model or in `$DSH_HOME/.credentials.yaml`. After installation, restart DSH with `dsh --profile web` to see the plugin in the GUI.

Why is the cost shown different from my DeepSeek billing?

The plugin estimates costs based on local session logs and a fixed pricing table (see `src/pricing.ts`). It does not account for DeepSeek's official discounts, promotional credits, or consumption order. The displayed numbers are for reference only; always verify with your official DeepSeek invoice for accurate billing.

Can I see usage data from multiple machines or accounts?

No, the plugin only reads session logs from the local machine where DSH runs. It cannot aggregate usage from other machines or different accounts. Each DSH instance is isolated.

How do I set a balance alert threshold?

Go to the 'Settings' tab in the DSH GUI (or the plugin's settings if available). You can set a balance alert threshold (default ¥10, set to 0 to disable). When your balance drops below this value, both the floating widget and the 'Usage' dashboard will show a warning color and a notification bar.

What does the 'peak/off-peak' preview mean?

DeepSeek is introducing peak/off-peak pricing starting August 17, 2026. The plugin calculates how your current usage would be billed under the new pricing (peak hours: 09:00–12:00 and 14:00–18:00 Beijing time, cost 2x off-peak). It shows the proportion of your usage in peak vs off-peak and the estimated bill difference. After the pricing change, it will suggest how much you can save by shifting usage to off-peak.