oiupoyt/token-contribution
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
2 commits 1 branch 0 tags 989 KiB
TypeScript 56.6%
JavaScript 43.4%
Find a file
oiupoyt d152526119 style: remove emojis and keep UI minimal
2026-10-09 11:13:45 +05:30
lib style: remove emojis and keep UI minimal 2026-10-09 11:13:45 +05:30
scripts style: remove emojis and keep UI minimal 2026-10-09 11:13:45 +05:30
src style: remove emojis and keep UI minimal 2026-10-09 11:13:45 +05:30
.gitignore feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30
cordis.patch.yml feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30
LICENSE feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30
package.json feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30
README.md feat: initial commit of dsh-plugin-token-heatmap 2026-10-09 08:05:13 +05:30

README.md

dsh-plugin-token-heatmap

GitHub-style token usage contribution heatmap and analytics for DeepSeek Harness.

Visualizes your daily token consumption, prompt intensity, cache hit efficiency, and streaks across all sessions in a 52-week contribution calendar.

Features

  • 52-Week GitHub Contribution Calendar: 7 rows × 52 columns tracking daily token activity with 4-level color intensity.
  • Detailed Summary Cards:
    • Total Tokens: Complete volume of input, output, and cached tokens.
    • Cache Hit Ratio: Percentage of tokens served from KV cache reads.
    • Daily Average & Active Days: Real workload metrics.
    • Streak Tracker: Current and longest active day streaks.
    • Peak Day Callout: Date and token count for your heaviest day.
  • Dual Color Palette: Switch between GitHub Emerald and DeepSeek Indigo.
  • Interactive Tooltips: Hover over any day to see token breakdown (billed input/output vs. cache reads and step counts).
  • Session Token Meter Integration: Integrates into session stats pills with a "View 12-Month Activity Heatmap" button that opens the interactive modal dialog anywhere.
  • High-Performance Parser: Aggregates zstandard (.jsonl.zstd) session logs with timestamp and mtime caching for near-instant rendering.
  • DeepSeek Native Theme: Automatically adapts to DSH dark and light themes using --dsw-alias-* design tokens.

Installation

Method 1: Using pnpm in your DSH Web profile

Inside your DSH profile directory:

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

Then add "dsh-plugin-token-heatmap" to ~/.dsh/profiles/web/package.json under dsh.profile.bundles:

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-plugin-token-heatmap"
      ]
    }
  }
}

Method 2: Local Development Link

Clone the repository locally:

git clone https://github.com/oiupoyt/dsh-plugin-token-heatmap.git ~/projects/dsh-plugin-token-heatmap
cd ~/projects/dsh-plugin-token-heatmap
npm run build

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

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 to view token details and tap "View 12-Month Activity Heatmap →".

License

MIT © oiupoyt