dsh-billing-badge
DeepSeek Harness 网页 GUI composer 的计费周期与账户余额状态标签：在缓存命中统计信息后显示一个原生风格的胶囊标签，点击后打开面板。DeepSeek Harness 计费时段与余额插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-billing-badge@0.1.3Billing Badge 以 dsh-billing-badge 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Billing season and account balance for the DeepSeek Harness web GUI. A pill in the composer's statistics row, immediately after the native Cache hit reading, that opens a small panel with the full picture.
2288M tok · Cache hit 99.8% · ● Off-peak · 2h13m
The pill in the composer statistics row and the panel it opens
| Where | What |
|---|---|
| The pill | a coloured dot (amber for peak, green for off-peak), the season, and the time until it flips |
| The panel (click) | billing season, next switch with the Beijing wall clock, current Beijing time, account balance with its currency, the granted and topped-up split when the account has one, and a refresh button |
The season rule is the published one: peak is Beijing time, Monday to Friday, 09:00-12:00 and 14:00-18:00. Everything else, including all of Saturday and Sunday, is off-peak at half price.
The numbers come from the official GET /user/balance endpoint, and the three of them
mean different things:
total_balance = granted_balance + topped_up_balance
total_balance, shown as Account balance, is everything you can spend.granted_balance, shown as Granted, is credit DeepSeek gave you. The endpoint
reports only the part that has not expired, so a lapsed grant disappears from this
row on its own.topped_up_balance, shown as Topped up, is money you paid in.The panel names the two parts only when the account is actually split. With no grant the topped-up amount is the whole balance, so the split would repeat the account balance row above it, and that account shows one row instead. Granted appears as soon as the endpoint reports one.
is_available is a top-level field of the response and answers one question: is the
balance enough for API calls. The panel adds a warning row when the answer is no, and
stays quiet otherwise, because the flag is true for every funded account.
The currency is taken from the response, never assumed: an account reporting USD is not labelled with a CNY sign.
Two community plugins cover parts of this, and both taught something:
This plugin deliberately does not do cost or token accounting.
From npm:
dsh plugin --profile web add dsh-billing-badge
or straight from the repository:
dsh plugin --profile web add github:devacc8/dsh-billing-badge
then restart dsh web. The package declares dsh.bundle.patch, so the host half is
reconciled into the profile's bundle list automatically.
Works on DeepSeek Harness 0.1.5 and 0.1.6. Older builds render the composer statistics as one labelled row and the chip joins it; 0.1.6 moved those readings into the composer dock as pill buttons, and the chip follows the cache-hit pill into that row.
Working on the plugin itself, install the checkout by path instead:
dsh plugin --profile web add link:/absolute/path/to/dsh-billing-badge
A balance is a small surface, so it stays small:
ctx.credentials.resolve('DEEPSEEK_API_KEY'), environment fallback) and never
reaches the browser;x-dsh-billing-badge: 1 header and rejects a
cross-origin Origin, so a cross-site page cannot reach it;api.deepseek.com is
contacted;The season logic lives in lib/season.js as a plain ESM module so it can be tested
directly. A browser bundle cannot import a sibling file (the loader resolves only
platform seeds, materialized packages and registered factories, and a self-subpath
require throws "missed the module table"), so scripts/inline-season.mjs copies the
module into lib/client.js between two markers with export stripped, and
test/client-sync.test.mjs fails if the copy drifts.
npm test # 30 tests: season rule, countdown invariant, host route, bundle
npm run sync # re-inline season.js into the bundle
npm run check # sync check plus a syntax check of both halves
The countdown has an invariant test rather than fixtures: every 13 minutes across nine days, the reported target must be in the future, must change the season, and the season must not change before it.
lib/season.js season rule, countdown, formatting (source of truth, tested)
lib/index.js host half: the balance route
lib/client.js browser half: the pill and its panel, with season.js inlined
cordis.patch.yml mounts the host half into the profile
scripts/ the inliner
test/ season, sync, host and bundle tests
GitHub Actions runs npm test and npm run check on Node 20 and 22.
MIT.