dsh-token-usage

Token invoices rarely answer the questions you actually care about: how many tokens were cache hits, how much went into pure inference, and whether a silent peak-rate multiplier inflated the bill. dsh-token-usage puts those answers in plain sight. It registers a per-session "Token Usage" tab in the dsh-better-sidebar right panel, breaking down every conversation's token consumption and cost in real time, so you see exactly where the money went.

The tab splits each round's tokens into cache hits, non-cache hits, cache writes, output, and reasoning, each tracked in its own column. A gradient progress bar at the top shifts from deep red to teal as your cache hit rate improves, nudging you toward further savings. Pricing is not flat: the plugin uses Beijing time (UTC+8) to classify each recorded usage into peak windows (09:00-12:00, 14:00-18:00) or off-peak, and price accordingly. The host-side half scrapes DeepSeek's official pricing page every six hours, pulling both peak and off-peak tiers in USD and CNY; if a sync fails it falls back to built-in rates and surfaces a warning badge, so cost display is always trustworthy. After a context compaction or a full week without new records the meter resets and the card notes the reason, keeping each window clean and unambiguous.

If you push a high daily volume of prompts, or someone on your team is accountable for token spend, this card answers the three questions you actually care about in under a minute: how much did this session cost, what was the cache hit rate, and did it land in a peak window. Every session gets its own isolated meter window, so switching back and forth never mixes data. The single prerequisite is dsh-better-sidebar (>= 0.12.0) to provide the right-panel container; the install script detects its absence, offers to install it for you, and aborts cleanly if you decline.