v0.1.0

dsh-deepseek-usage 0.1.0

A DSH web plugin that shows the DeepSeek account balance in the sidebar footer (above the
Settings row) with a refresh button, and opens a popover with the balance card, daily
token / estimated-cost charts over a 7/30-day window, a per-model cost table, and a link to
the platform usage page.

Install

dsh plugin add github:The-five-stooges/dsh-deepseek-usage

Then restart the host process once (the host half is composed at startup) and reload the page.

Or install this release's prebuilt tarball — it includes the generated lib/ artifacts, and
the package declares no prepare script, so no allowBuilds approval is needed either way:

dsh plugin add https://github.com/The-five-stooges/dsh-deepseek-usage/releases/latest/download/dsh-deepseek-usage.tgz

Requires a DEEPSEEK_API_KEY in the harness credential store (or the launch environment).

What the numbers are

• Balance — read server-side from the official GET https://api.deepseek.com/user/balance
  endpoint, cached 60 s. This side is authoritative.
• Usage and cost — aggregated from this machine's DSH session logs and priced with the
  published peak/off-peak rate card in CNY. It is a local estimate, labelled as such on the
  panel, and it states its own scope: usage billed to the same account from another machine,
  the web UI, or any other tool is not included. DeepSeek publishes no usage API, which is why
  this side is local — see docs/usage-data-sources.md for the
  measurements.

The API key never reaches the browser: it is resolved per operation through the host's
credential store and used only in an Authorization header to api.deepseek.com.

Verification

222 tests (node --test), including a contract suite for the two HTTP routes and a
real-browser layout probe that measures the sidebar row's geometry in an actual engine.