dsh-balance-guard

One of the most annoying surprises when building on the DeepSeek API is hitting a 402 mid-session because the balance quietly hit zero. dsh-balance-guard solves that by surfacing your account balance right in the browser: a compact pill in the top-right corner of the conversation header keeps the number visible at all times, so you never have to guess whether you can still afford the next request.

The plugin stays deliberately lean. On the host side it registers a same-origin endpoint that reads the same credentials as llm-deepseek, calls the official balance API, and applies a 15-second cache with single-flight deduplication so multiple tabs do not hammer the service. On the client side it polls every 30 seconds by default, refreshes instantly on tap, and re-pulls whenever the tab becomes visible; hovering reveals the full breakdown—total, bonus, top-up amount, and last-updated time. When the balance drops below a configurable threshold (five yuan by default), the pill turns orange with a warning glyph, the page title gains a warning prefix, and a single browser system notification fires; the reminder stays quiet until the balance recovers and dips again, so it will not nag you repeatedly.

It is built for anyone whose workflow depends on DeepSeek API credits: solo developers running long generation jobs who do not want to babysit a tab, small teams sharing a single key who need to spot who drained the quota, or simply anyone who would rather see a gentle heads-up than an abrupt auth error at the worst possible moment. Once installed, the pill appears in the header with zero changes to your existing proxy or routing setup.