dsh-plugin-token-usage

dsh-plugin-token-usage

Read-only daily and per-model Token statistics for DeepSeek Harness. The plugin reconstructs provider-reported usage from durable session events, including existing sessions, and contributes a Token usage page to Web Settings.

Accounting

• Includes top-level and subagent sessions.
• Excludes inherited seed events in forks and subagents to avoid double counting.
• Total Tokens are the sum of uncached input, output, cache-read, and cache-write buckets; all four remain visible in the UI.
• Groups events by the browser's IANA time zone and supports trailing 30, 90, and 365-day summaries plus independently selectable calendar-year heatmaps.
• Does not calculate chat duration, active-day counts, or streaks.

Build

The Harness packages used by this plugin are not currently available from the public npm registry. Point the standalone build at a local built Harness checkout:

pnpm install
pnpm run configure -- --harness "D:\anywhere\deepseek-harness"
pnpm build
pnpm test

Install into a web profile

cd "$env:USERPROFILE\.dsh\profiles\web"
pnpm add "D:\anywhere\dsh-plugin-token-usage"

cd "D:\anywhere\deepseek-harness"
pnpm dsh plugin --profile web install

Run pnpm pack to create a portable package archive.