oiupoyt/token-contribution
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
34 commits 1 branch 0 tags 989 KiB
TypeScript 56.6%
JavaScript 43.4%
Find a file
oiupoyt 60643d673c fix: eliminate v3/v4 double-counting, count assistant/message usage only 
- findSessionFiles now picks newest schema version per session dir
  (v3 file is a migrated subset of v4; reading both doubled ~5.9k turns)
- handleLine only counts type=assistant/message with data.usage
  (compaction/summary re-reports summarizer spend separately)
- verified exact match vs independent ground truth: 16/16 days,
  all 13 model rows, grand total 3,725,441,198 tokens
2026-10-14 13:48:03 +05:30
assets docs: move preview under installation, resize to compact width, uncrop model breakdown 2026-10-11 10:16:30 +05:30
lib fix: eliminate v3/v4 double-counting, count assistant/message usage only 2026-10-14 13:48:03 +05:30
scripts chore: rename package and assets to token-contribution 2026-10-11 17:51:39 +05:30
src fix: eliminate v3/v4 double-counting, count assistant/message usage only 2026-10-14 13:48:03 +05:30
.gitignore fix: eliminate v3/v4 double-counting, count assistant/message usage only 2026-10-14 13:48:03 +05:30
cordis.patch.yml chore: rename package and assets to token-contribution 2026-10-11 17:51:39 +05:30
LICENSE feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30
package.json fix: eliminate v3/v4 double-counting, count assistant/message usage only 2026-10-14 13:48:03 +05:30
README.md chore: rename package and assets to token-contribution 2026-10-11 17:51:39 +05:30

README.md

token-contribution

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

Installation

Install with a single command via the official DSH CLI:

dsh plugin --profile web add token-contribution

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

Manual Alternative (pnpm)

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

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

Preview

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.

Usage

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

License

MIT © oiupoyt