前言¶
在 DSH Web 里跑智能体或对话时，账户余额、当月用量和 DeepSeek 峰谷时段往往要另开页面或翻设置才能看清。DeepSeek 按北京时间区分峰时与谷时，切换点又和法定节假日有关，单靠记忆容易误判当前计价区间。下面介绍 maintainer lamp23333 维护的 dsh-balance-simple：一块常驻侧边栏的状态牌，把余额、用量、费用、缓存命中率与峰谷倒计时放在同一处，折叠侧边栏后仍保留最关键数字。
这是什么¶
dsh-balance-simple（npm 包名 dsh-balance-simple，当前版本 1.0.2，MIT 许可证）是面向 DSH Web 的插件：在账户头像上方渲染 DeepSeek 账户状态卡片，不堆报表，只保留会频繁查看的指标。它只支持 DeepSeek 账户级数据；OpenAI、Anthropic、OpenRouter 等其它供应商不在支持范围内，同一 DeepSeek 账户下其它模型会自然聚合进用量统计。
源码与说明见 GitHub：lamp23333/dsh-balance-simple；社区目录页：skillhub.cn 插件页。DSH 生态强调「一切皆插件」；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
设计与信息布局¶
插件强调三块原则（来自项目 README）：
- 简约：无报表式堆叠；折叠态压缩为约 44px 高的状态块。
- 直观：余额为视觉中心；峰时 / 谷时用颜色区分；倒计时直接回答「何时切换」。
- 信息集中：余额、月度 token、费用、缓存命中率、请求数与峰谷状态在同一张卡片内读完，无需打开设置页。
展开时以当前余额为主，月度 token、费用及构成放在次级位置；侧边栏收起时仍显示折叠余额块、当前峰 / 谷状态与切换倒计时。
核心功能¶
账户数据与刷新¶
- 余额、用量等每 30 秒轮询；窗口重新聚焦或恢复可见时会刷新；展开卡片支持手动刷新。
- 插件复用 DSH 已保存的 DeepSeek 账户授权，不需要额外填写 API Key。浏览器仅访问 DSH 同源的
/dsh-deepseek-usage/*接口；DeepSeek 授权 token 留在 Host，不返回浏览器。Host 侧会访问platform.deepseek.com读取余额、用量与费用。
峰谷规则与校时¶
峰谷规则按 北京时间 与 DeepSeek 官方定价一致（详见 pricing 文档）：
- 峰时：周一至周五 09:00–12:00、14:00–18:00（对应官方 UTC 01:00–04:00 与 06:00–10:00）。
- 谷时：其余时段、周末，以及 中国法定节假日（官方规则只排除中国法定假日，不参考其它国家假日）。
- 周末即使调休上班，插件仍按 谷时 处理，因官方规则仅按「周一至周五 + 中国法定节假日」判断。
节假日数据优先 jiejiariapi，失败回退 GitHub holiday-cn；未来年份暂无官方日历时回退内置表。授时按设备时区选择区域 NTP（阿里云、腾讯、NIST、Cloudflare、pool.ntp.org），失败回退 timeapi.io。
安装与启用¶
前提：已具备 DSH Web 界面，且已登录 DeepSeek 账户。
上架 dshmarket 后可从市场直接安装。上架前可手动安装，命令以 README 为准：
# npm 发布后
dsh plugin --profile web add dsh-balance-simple
# 或直接从 GitHub 安装
dsh plugin --profile web add git+https://github.com/lamp23333/dsh-balance-simple
安装完成后刷新 DSH Web 页面即可看到侧边栏状态牌。
典型用法¶
安装并刷新页面后，无需单独配置文件：卡片自动出现在侧边栏账户头像上方。
- 日常盯盘：侧边栏展开时查看余额、当月 token、费用、缓存命中率与请求数。
- 窄栏模式：折叠侧边栏后仍看 44px 余额块、峰 / 谷标识与切换倒计时。
- 即时更新：需要立刻对齐平台数据时，在展开卡片上使用手动刷新；平时依赖 30 秒轮询与窗口聚焦刷新。
外部网络请求除 DeepSeek 平台外，仅用于节假日 API 与 NTP / 时间 API，用途在 README「数据与隐私」一节有完整列举。
适用场景与注意¶
适合：长期在 DSH Web 中使用 DeepSeek 账户、需要一眼看到余额与峰谷切换时间的开发者或运维式使用者。
注意：
- 插件以当前 DSH 进程权限运行；安装前建议阅读 源码仓库 与 MIT 许可证，确认行为符合你的环境策略。
- 仅 DeepSeek 账户数据；勿期望展示其它 LLM 供应商余额。
- 峰谷与节假日逻辑与官方文档对齐，但远程 API 或 NTP 失败时会走回退路径，极端情况下切换时刻展示可能短暂依赖内置表或备用时间源。
项目无需构建步骤，源码即发布产物；维护者修改后至少执行 node --check index.js、node --check client.js 与 npm pack --dry-run 做基本检查。主要文件为 Host 端 index.js、Web 客户端 client.js 与 DSH bundle 入口 cordis.patch.yml。
结尾¶
dsh-balance-simple 把 DeepSeek 余额、月度用量和峰谷倒计时收进 DSH Web 侧边栏，折叠后仍保留关键状态，适合不想反复打开设置页的使用方式。
