余额与用量挂件 / Balance & Usage Widget for DSH
DSH 侧边栏底部的常驻小挂件：显示 DeepSeek 账户余额、今日 token 用量与估算花费，点开还能看今天每个对话花了多少钱，以及当前处在高峰还是空闲计费时段。
界面
- 侧边栏底部：一行余额数字，后面跟着今日花费；右边一个小标签写着「空闲半价」或「高峰全价」，前面的圆点空闲是绿色、高峰是黄色。
- 点开面板：余额卡与今日花费进度条（相对最近 7 天日均），今日累计 token、请求数，每个对话的花费（子代理并进发起它的对话），以及下一次计费时段切换的时间。
数据从哪来
- 余额：DSH 官方的账户服务
deepseekAccount，读的是充值余额与赠送余额两个钱包，不经过任何第三方。 - 今日用量：宿主侧扫描每个会话日志里带
usage的assistant/message事件，按事件时间归到北京时间的某一天，结果缓存在~/.dsh/storages/balance-widget-cache.json。 - 花费：按 DeepSeek 官方价目从 token 折算，是估算，不是账单。价目取自官方文档，抓取日期 2026-11-03；官方调价后需要改
index.js里的PRICES。 - 计费时段：北京时间周一至周五 9:00-12:00 与 14:00-18:00 是高峰，其余时段半价。法定节假日这里仍按工作日算，所以估算只会偏高。
安装
从插件市场安装，或者：
dsh plugin --profile add @b9p79rgh6f-sudo/dsh-balance-widget
也可以直接从 GitHub 装：
dsh plugin --profile add github:b9p79rgh6f-sudo/dsh-balance-widget
装完刷新页面（宿主页有改动时重启 DSH）。
依赖
- DSH Web 0.2.x 及以上（用到
sidebar.footer.action与shell.overlay槽位、deepseekAccount服务）。 - 读用量需要会话日志和官方账户服务都可用；登录状态下才能显示余额。
开发
tools/ 下是开发时用的自查脚本，其中 test-client-render.mjs 用假的 React 桩渲染界面，不需要启动 DSH；verify-usage.py 会直接读本机会话日志重算一遍用量和花费，用来和面板数字对账。这些脚本依赖本机的会话日志，换台机器不一定能直接跑。
Balance & Usage Widget for DSH
A persistent widget at the DSH sidebar foot: account balance, today's token usage and estimated spend, a panel with per-conversation cost for the day, and the current peak/idle pricing window.
Balance comes from DSH's official deepseekAccount service (no third party). Usage is folded host-side from assistant/message usage events into Beijing-time days and cached under ~/.dsh/storages/balance-widget-cache.json. Cost is estimated from DeepSeek's official price table (captured 2026-11-03) — an estimate, not a bill. Peak hours are Monday–Friday 09:00–12:00 and 14:00–18:00 Beijing time; everything else is half price.
The sidebar dot is green during idle (half-price) hours and yellow during peak hours.
Install from the plugin market, or:
dsh plugin --profile add @b9p79rgh6f-sudo/dsh-balance-widget
dsh plugin --profile add github:b9p79rgh6f-sudo/dsh-balance-widget
MIT licensed.
