dsh-token-heatmap-cccchens

English | 中文

A draggable floating window that shows your DeepSeek Harness token usage as a GitHub-style contribution heatmap: today's total on top, the last 30 days below, and a full year in a panel that grows above it when you hover.

Install

Needs DeepSeek Harness with the Plugin Manager. Open the sidebar's Plugins page and install this spec:

github:cccchensy/dsh-token-heatmap

Or just ask the agent in any session: install the plugin github:cccchensy/dsh-token-heatmap. If you cloned the repo, install its directory path instead.

The window then appears in the lower-left of the conversation area. Uninstall from the same Plugins page.

• Plugins are per profile and survive a restart.
• Restart DSH after updating the plugin — replacing an installed package needs a restart to load new code.
• Nothing leaves your machine. It reads your own session logs and serves the aggregate in-process: no network calls, no telemetry.

Use

• Drag anywhere to move it. The position is remembered.
• Hover to grow the year panel above it: totals, active days, average, current and longest streak, best day, a colour legend, and each day's input / cache / output split.
• Double-click to collapse it to the header row.
• The window blinks slowly while any session is running, and stops when the last one finishes. Nothing inside it is animated, so the numbers never flicker.

Limits

• Today's figure is accurate to the last committed step, not the last generated token.
• Counts line up with the official usage page. Checked against 2026-10-01: the site reported 529,217,300, this plugin reports 527,911,277 — 0.25% low.
• That 0.25% is failed, retried requests: the site bills the prompt the server had already processed, while the Harness never writes a failed attempt's usage to the log. No log-based count can include it.
• A session history copied into several logs (a subagent snapshot, a fork) is counted once, deduplicated by a fingerprint of time, turn/step and all five token buckets.
• A compaction summary is itself a billed call, and is counted.
• The blink means "a session is running", not "tokens are being spent right now".

Development

node verify.mjs          # token rules + a scan of the real session logs
node verify-client.mjs   # the browser bundle
node verify-host.mjs     # the HTTP route, end to end

Knobs — window length, subagent inclusion, scan concurrency, freshness window — live in lib/config.js. The Host half is plain ESM with no dependencies and no build step.

MIT licensed.