DSH Balance
一块常驻 DSH Web 侧边栏的 DeepSeek 状态牌:在账户头像上方集中显示余额、当月用量、费用、缓存命中率,以及峰谷状态与切换倒计时。折叠后仍保留最关键的余额、峰谷和倒计时,展开后补充用量构成与账户信息。
设计
- 简约:没有报表式堆叠,只保留会频繁查看的状态数字;折叠态压缩成一块 44px 状态牌。
- 直观:余额是视觉中心,峰时/谷时用颜色区分,倒计时直接回答“什么时候切换”。
- 信息集中:余额、月度 token、费用、缓存命中率、请求数和峰谷状态在同一张卡片内完成阅读,不需要打开设置页。
功能
- 余额优先:展开卡片以当前账户余额为主,月度 token 用量、费用和构成放在次级位置。
- 折叠态可见:侧边栏收起时仍显示 44px 余额块,以及当前峰/谷状态和切换倒计时。
- 真实峰谷规则:按北京时间,周一至周五 09:00–12:00、14:00–18:00 为峰时;其余时间、周末和中国法定节假日为谷时。
- 远程节假日表:优先使用
jiejiariapi,失败时回退到holiday-cn;未来年份暂无官方日历时回退到内置表。 - 权威校时:按设备时区选择区域 NTP 服务器(阿里云、腾讯、NIST、Cloudflare、pool.ntp.org),失败时回退到
timeapi.io。 - 自动刷新:余额和用量每 30 秒轮询,窗口重新聚焦或恢复可见时刷新;展开卡片支持手动刷新。
安装
要求:DSH Web 界面 + 已登录的 DeepSeek 账户。
从 dshmarket 上架后直接安装。上架前可手动安装:
# 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 页面。
数据与隐私
插件复用 DSH 已保存的 DeepSeek 账户授权,不需要额外填写 API Key 或 token。浏览器只访问 DSH 同源的 /dsh-deepseek-usage/* 接口;DeepSeek 授权 token 始终留在 Host,不会返回给浏览器。
外部请求仅用于:
platform.deepseek.com:读取账户余额、用量和费用jiejiariapi.com/ GitHubholiday-cn:读取中国法定节假日- 区域 NTP 服务器 /
timeapi.io:校准当前时间
插件只支持 DeepSeek 账户级数据;OpenAI、Anthropic、OpenRouter 等其他供应商不在支持范围内。DeepSeek 的其他模型会自然聚合到同一账户用量中。
峰谷定价依据
DeepSeek 官方定价规则写明:峰时为 UTC 01:00–04:00 和 06:00–10:00,即北京时间 09:00–12:00、14:00–18:00,周一至周五;其中排除的是中国法定节假日,不参考其他国家节假日。
- 官方文档:https://api-docs.deepseek.com/quick_start/pricing
- 周末即使调休上班也按谷时处理,因为官方规则只按周一至周五 + 中国法定节假日判断。
开发
无需构建步骤,源码即发布产物。修改后至少检查:
node --check index.js
node --check client.js
npm pack --dry-run
主要文件:
index.js:Host 端,读取账户数据、节假日和授时,提供同源 JSON 接口client.js:Web 客户端,渲染侧边栏卡片和折叠余额块cordis.patch.yml:DSH bundle 入口
License
MIT