dsh-account-glance

English | 中文

_{The live card: probed balance, Beijing peak / off-peak clock, and today's ledger.}

A three-line glance card for the DSH Web GUI, seated directly above the sidebar's bottom-left account / Settings row:

Line	Content
1	DeepSeek account balance — probed from /user/balance with the host-held API key; hover names the source
2	Peak / off-peak billing period, with a live countdown to the next flip and the discount in effect
3	Today's spend / tokens / calls, plus a manual refresh button that forces one fresh probe

Peak / off-peak follows DeepSeek's official schedule (Beijing time, UTC+8 all year): peak is Monday–Friday 09:00–12:00 and 14:00–18:00 at full price, every other hour (nights and weekends included) is billed at 50% off. The countdown switches to seconds for the final minute.

Install

Needs DSH 0.2.0-rc.1 or newer. No other plugin, no dependencies, no build step.

git clone https://github.com/faith372/dsh-account-glance.git
dsh plugin --profile desktop add link:./dsh-account-glance

The Plugins page also accepts the repository URL in its Add plugin dialog. Installing by hand: put the source at <profile>\plugins\dsh-account-glance\, add the package to both dependencies and dsh.profile.bundles, then link it into node_modules (or run pnpm install). Do **not** add account-glance to cordis.patch.yml yourself — the package ships that row.

Upgrading from 1.3.x: the host half is new, so restart DSH (or toggle this row off and on in the Plugins page) and refresh the page once.

Turning it on and off

Sidebar Plugins icon → Installed → dsh-account-glance: the card switch toggles the whole bundle, the row switch toggles this card. Instant — no restart, no refresh — and turning it off brings dsh-usage's own glance card back.

Where the numbers come from

Both data sources live in this plugin's own host half and are served over loopback-only routes (api/dsh-account-glance/overview, .../refresh); the API key never reaches the browser.

• Balance — GET https://api.deepseek.com/user/balance, with the key resolved from the DSH credential store (pi-ai record → configured env reference → ambient env). No probe value falls back to the account Remote (Settings → Account & balance). A route pointed at a reseller is reported as unsupported rather than probed with the official endpoint; a failure keeps the last good number and flags the row.
• Today's usage — folded from the session event stream into a small per-day ledger at <DSH_HOME>/account-glance/ledger.json (atomic write, 180-day retention), keyed by Beijing date.
• Cost is priced for DeepSeek official routes only (the published CNY peak / off-peak table). Other routes — a DashScope-compatible provider, for example — still count tokens and calls, at cost 0, so a mixed ledger never sums two currencies.
• @linxin666/dsh-usage is optional: install it and nothing breaks — this card still reads its own route first, its glance card stays hidden, and its settings and usage pages keep working.

Probing is a read-only account query: no prompt, no tokens, no credit.

Verify

npm test    # node test/verify.mjs && node test/host-verify.mjs

Both suites run offline. The client suite boots the shipped lib/client.js against React / DOM stand-ins: seat and cadence, the probe outranking the account wallet, the fallback identity, the peak clock's boundary cases, the 15-second deadline, the refresh button, the degradation paths, and the dsh-usage fallback. The host suite covers the clock and price book, the ledger, credential resolution and probe shapes, the origin guard, session folding, the route fence, persistence across a restart, and the entry point.

Known limitations

• Hiding dsh-usage's glance card relies on its data-dsh-plugin="usage" / data-dsh-part="foot-card" attributes; if it renames them, both cards appear (nothing breaks).
• The balance belongs to the DeepSeek account the configured key belongs to — swap the key, swap the number.
• Cost appears for DeepSeek official routes only; other routes show tokens and calls without an amount.
• With dsh-usage installed too, both plugins keep their own ledger (this one buckets days by Beijing date, dsh-usage by host-local date), so the two totals can differ slightly.
• The card hides while the sidebar is collapsed to its 56 px rail, matching the shell's own foot area.

License

MIT — except lib/host/* and lib/index.js, adapted from @linxin666/dsh-usage v0.4.4 (Apache-2.0). See THIRD-PARTY-NOTICES.md and LICENSE-APACHE.