dsh-plugin-api-balance
侧栏实时额度小卡：显示 DeepSeek 账户总额度（充值 + 赠送，多币种合计），旁边并排高峰/空闲计价时钟（高峰红色、空闲醒目绿色）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:geitaHer0/dsh-plugin-api-balance#6d5ed148edee0e4097625a4fe9d032ed4fe76f34
Plugin Api Balance 以 dsh-plugin-api-balance 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DSH 侧栏底部放一枚实时账户额度小卡：读取 DeepSeek 账户的充值余额与赠送余额，按币种求和后显示总额度（多币种用 + 连接），悬停展开每个钱包的明细与更新时间，点击刷新。
额度旁边并排一枚计价时段时钟：显示北京时间，并按 DeepSeek 峰谷定价（北京时间工作日 09:00–12:00、14:00–18:00，法定节假日除外）显示「高峰」（醒目红色 + 脉冲圆点）或「空闲」（绿色），悬停可看完整窗口、下次切换时间与倒计时。
数据复用官方 account/getBalance，不新增凭证或网络路径；
默认每 15 秒轮询，页面重新可见和点击时也会刷新；
未登录 / 读取失败 / 无余额分别显示对应状态，不臆造 0；
配置项 refreshIntervalMs（默认 15000，低于 5000 回退默认值）。
Live DeepSeek account credit chip for the DSH Web client sidebar.
The plugin mounts one component into the sidebar's sidebar.footer.action seat
and keeps it current:
account/getBalance
Remote (@deepseek-ai/dsh-api-account-controller) — the same call the
Settings → Account page uses, so no new host code, credentials, or network
path exists;refreshIntervalMs (default 15 s), re-reads whenever the browser
tab becomes visible again, and re-reads on click;+
(¥1.00 + $2.00); amounts use the Platform Web client's currency format
(two decimals, digit grouping, <0.01 for positive sub-cent amounts);HoverCard primitive on hover or keyboard focus: a heading,
the 总额度 / Total credit row, a divider, one label / amount line per
wallet, and a footer with the freshness stamp and the refresh hint. The
primitive owns the card's surface,
portal, placement, viewport clamping, and pointer grace, so the card cannot be
clipped by the layout frame and the pointer may rest on it;未登录 / 不可用 when the account is signed out or the read fails,
instead of inventing a zero balance. The card explains the same state;高峰 / 空闲 tag, the countdown to the next switch in the tooltip,
and a red warning pill with a pulsing dot while DeepSeek's peak price window
is active.| Field | Default | Meaning |
|---|---|---|
refreshIntervalMs | 15000 | Poll interval in milliseconds; values below 5000 fall back to the default. |
DeepSeek publishes a peak/idle tariff in Beijing time (UTC+8): calls are peak Monday to Friday 09:00–12:00 and 14:00–18:00, excluding Chinese statutory holidays; every other period — weekends and holidays included — is idle, at half the peak price.
The clock beside the chip shows the current Beijing time and the active period.
During peak the pill turns warning red (red text, red ring, red 高峰 tag, and
a pulsing dot); the native tooltip carries the full windows and the countdown
to the next switch. In the collapsed rail the clock is hidden, like the chip's
label and amount.
The holiday dates live in lib/client.js as STATUTORY_HOLIDAYS, copied from the
State Council's annual arrangement notice (currently 2026, 国办发明电〔2025〕7号).
When the next year's notice is published, append its holiday dates there; a year
without an entry falls back to the weekday + time rules only.
The package is meant to live in a durable home outside the session workspace
(for example ~/.dsh/plugins/dsh-plugin-api-balance):
dependencies as link:<that path>;dsh-plugin-api-balance to dsh.profile.bundles in the profile's
package.json;node_modules link, then restart DSH.dsh.bundle.patch points at this package's cordis.patch.yml, which inserts the
api-balance row. That is why the row shows up in the sidebar's Plugins page
as a manageable bundle row (per-row enable/disable, whole-bundle enable, uninstall)
instead of being an untracked file:/// row in the user's patch layer.
The row config lives in the bundle layer; a user-patch override with the same id
still wins, so refreshIntervalMs can be tuned per installation without touching
the package.
| Path | Role |
|---|---|
lib/index.js | Node half. Empty apply; the row exists so the Loader mounts the package. |
lib/client.js | Browser half: the hand-written window.__ModuleLoader__.load bundle (dictionaries, snapshot store, chip component, hover-card content, peak-tariff clock, plugin body). |
cordis.patch.yml | Bundle patch inserting the api-balance row. |
The browser half only requests baseline modules (react, react/jsx-runtime,
and @deepseek-ai/dsh-client-ui-primitives for its HoverCard), so it needs no
build step and no dsh.client.external entries. Editing lib/client.js is
picked up live: client-hmr stat-polls every row's bundle and republishes it
through /plugins/events; the browser reloads that row's module graph in
place, so a rewritten bundle shows up without a manual page refresh.