dsh-usage-plugin

When running DeepSeek Harness Web, one question is easy to overlook: how much official balance is left, and how many tokens have I actually burned over the past few days? The usual answer used to mean spinning up another terminal, firing a curl, or grepping through log files. dsh-usage-plugin moves that answer directly into the browser sidebar. A trigger icon sits just above Settings; one click unfolds a panel showing your live api.deepseek.com balance alongside today and the last 7 days of input, output, and cache token usage with a daily trend. Everything is aggregated from your local $DSH_HOME/sessions logs, with no extra daemons, no database, no cross-origin calls, and the API key never leaves the server.

Under the hood, the plugin scans zstd-compressed session logs frame by frame and de-duplicates by turn and step so usage numbers are never double-counted. Balance queries take the same server-side path the DSH DeepSeek provider already uses, and the browser sees only numbers, never secrets. The panel UI follows DSH design tokens with full light and dark theme support, requiring zero configuration.

Who is this for? Developers who push batches, debug prompts, or share a DSH instance with a team. No extra tooling is required: restart dsh web once, and a compact balance-and-usage panel appears in the sidebar, right where you would expect it.