dsh-usage-plugin

For users who frequently call models inside DeepSeek Harness, token consumption and cost are scattered across many requests, and it is especially hard to calculate the true expense when cache hits and peak/off-peak pricing are involved. dsh-usage-plugin solves this pain point by automatically recording input/output tokens, cache hits, reasoning tokens, and finish reasons after every model call, then computing cost based on DeepSeek's official prices and Beijing-time weekday peak/off-peak periods (weekends are charged at off-peak rates). Every credit and token becomes visible and auditable.

The plugin is much more than a simple ledger. It adds two tabs to the Web UI: "Usage & Cost" and "Balance Query". The Usage & Cost panel contains four subtabs: Overview, Usage Calendar, Cache Hit List, and Price Table. The Overview drills down by model and by API provider, with date filtering and peak/off-peak splits; the calendar shows a daily heatmap by cost or call count, and clicking a day reveals its details; the price table is editable and persisted; Balance Query uses your configured DeepSeek API Key. You can export reports as CSV, JSON, or a long PNG image, and import historical data with automatic deduplication by time.

For data reliability, records are written to a dedicated directory that is unaffected by workspace switching, and legacy data is merged automatically. The UI scales with the app's display size, supports instant Chinese/English switching, and runs on Windows, macOS, and Linux. Whether you want to control your API budget, analyze usage patterns, or account for costs by project or date range, this plugin offers an intuitive, low-friction solution.