No description

Find a file

oiupoyt ea59eba36d docs: add preview screenshots to repository and README		2026-10-11 09:58:01 +05:30
assets	docs: add preview screenshots to repository and README	2026-10-11 09:58:01 +05:30
lib	style: expand settings panel to 1180px via CSS and layoutEffect, fit 880px calendar with zero scrollbar	2026-10-11 09:48:23 +05:30
scripts	chore: rename package to dsh-token-heatmap	2026-10-10 22:21:43 +05:30
src	style: expand settings panel to 1180px via CSS and layoutEffect, fit 880px calendar with zero scrollbar	2026-10-11 09:48:23 +05:30
.gitignore	feat: initial commit of dsh-plugin-token-heatmap	2026-10-09 08:05:13 +05:30
cordis.patch.yml	chore: rename package to dsh-token-heatmap	2026-10-10 22:21:43 +05:30
LICENSE	feat: initial commit of dsh-plugin-token-heatmap	2026-10-09 08:05:13 +05:30
package.json	chore: release 0.1.2	2026-10-11 09:48:23 +05:30
README.md	docs: add preview screenshots to repository and README	2026-10-11 09:58:01 +05:30

dsh-token-heatmap

GitHub-style daily token usage heatmap, model analytics, and timeline trends for DeepSeek Harness.

Token Heatmap & Overview Model Usage Breakdown & Trends

Features

52-Week GitHub Contribution Calendar: 7 rows × 52 columns tracking daily token activity with a smooth monochromatic gradient anchored on DeepSeek's official brand blue (#3964FE).
Interactive Day Inspector: Click on any day to slide open an inspection drawer showing every session active on that date, exact timestamps, and token breakdown.
Top Model Usage Breakdown: Real-time distribution showing tokens, percentages, and request steps for every model used across sessions.
Token Usage Trends Timeline: Stacked bar chart comparing daily Billed Tokens vs. Cache Reads, with 14D / 30D / 90D range filters and hover tooltips.
Global & Per-Session Filtering: Toggle between aggregate global history or inspect token activity for individual sessions.
Auto-Expanding Panel: Smoothly widens the DSH Settings dialog to 1180px so the calendar and charts fit cleanly with zero scrollbars.
Session Token Meter Integration: Injects a clean action button into the in-session token usage dialog to open the heatmap directly from active sessions.
High-Performance Parser: Recursively aggregates local .jsonl.zstd logs with timestamp and mtime caching for instant loading.

Install with a single command via the official DSH CLI:

dsh plugin --profile web add dsh-token-heatmap

(To remove later: dsh plugin --profile web remove dsh-token-heatmap)

cd ~/.dsh/profiles/web
pnpm add dsh-token-heatmap

Then add "dsh-token-heatmap" to bundles in ~/.dsh/profiles/web/package.json.

Open the DeepSeek Harness Web GUI (http://127.0.0.1:3080).
Go to Settings (gear icon at the bottom left) → Token Heatmap.
Or during any session, click on the token stats pill at the bottom of the composer and tap "View Token Usage Heatmap →".