dsh-deepseek-quota-bar
DeepSeek API quota widget for the dsh web GUI: floating bottom-right card with a blood-bar of remaining balance vs month-opening balance, plus today/month spend and current conversation cost (fork of dsh-deepseek-quota).
Who this is for
- people who run long sessions and need session control
Install
dsh plugin --profile web add dsh-deepseek-quota-bar
Sandbox test results
| Stage | Result |
|---|---|
| T0 static check | — |
| T1 install | ✓ |
| T2 list | ✓ |
| T3 mount | ✓ |
| T4 boot | — |
Four stages run in an isolated sandbox: install (network on) → list → mount → boot (last three with no network).
README
dsh-deepseek-quota-bar
DeepSeek API 额度血条插件 for DeepSeek Harness (dsh) web GUI：
右下角悬浮卡片，血条直观显示「余额 / 本月额度」，并展示今日与本月使用量（官方数据优先）。
A floating bottom-right widget for the dsh web GUI: a blood-bar of your remaining
DeepSeek API balance vs the month-opening balance, plus today's and this month's
spend (official platform data when configured).
功能 Features
- 🩸 血条：剩余比例 = 当前余额 / 月初余额快照（≥50% 绿 / ≥20% 橙 / <20% 红）
- 📅 今日/本月使用量：配置
DEEPSEEK_PLATFORM_TOKEN后为官方精确数据；未配置时自动降级为余额差值估算 - 💬 当前对话费用：按官方价格表（含峰谷定价）对会话日志计价，含安装前历史
- 🕐 峰谷时段提醒：北京时间高峰（09:00-12:00 / 14:00-18:00）徽标 + 距下一时段切换倒计时 + 当前模型单价（Flash/Pro 点击切换，V4 官方峰谷价格表，半价低谷）
- ⚙️ 可调透明度：设置按钮 + 滑块（0-100%），背景不透明度可调并持久化
- 🖱️ 可拖动：按住卡片任意位置拖动，位置持久化（localStorage）
- 📉 可折叠：一键折叠为只显示血条的迷你卡，再点展开
- 🌗 跟随浅色/深色主题
- ⏱️ 余额每 60s 自动刷新，支持手动刷新
安装 Install
dsh plugin --profile web add dsh-deepseek-quota-bar # 或从 GitHub 安装： dsh plugin --profile web add github:jiangli07/dsh-deepseek-quota-bar
安装后重启 dsh web，打开页面强刷（Ctrl+Shift+R），右下角出现卡片。
配置 Configuration
凭证 · 必需 · 说明
DEEPSEEK_API_KEY · ✅ · 与 harness 同一个 Key（设置 → 模型 页面填写）
DEEPSEEK_PLATFORM_TOKEN · 可选 · platform.deepseek.com 的 userToken：F12 → Console → 执行 JSON.parse(localStorage.getItem('userToken')).value，把值写入 ~/.dsh/.credentials.yaml
凭证是热读取的：配置后无需重启，下一次刷新即生效。
工作原理 How it works
- 余额：
GET https://api.deepseek.com/user/balance - 今日/本月（官方）：
GET https://platform.deepseek.com/api/v0/usage/cost?month=&year=（与平台控制台同源） - 今日/本月（估算兜底）：月初/当日期初余额快照差值，状态持久化于
~/.dsh/storages/deepseek-quota-bar.json - 血条分母：本月 1 号首次观测到的余额快照；月中新装时用「当前余额 + 本月官方消耗」反推
- 对话费用：订阅
session/event实时计价 + 持久化日志全量回放（含重启前历史）
开发 Development
git clone https://github.com/jiangli07/dsh-deepseek-quota-bar.git cd dsh-deepseek-quota-bar dsh plugin --profile web add .
注意：修改 lib/client.js 后需重启 dsh web（bundle 引导哈希重新生成）再强刷页面。
许可 License
MIT。Fork 自 yingjunnan/dsh-deepseek-quota（MIT）；
定价引擎参考 dsh-web-billing（MIT）。
Rendered from the README published on npm. Formatted only, not edited.
Embed the badge
Two badges, each using its own site's identity: left is the **standard** (published by DSHIO), right is the **testing organization** (deepseekbase, which ran the inspection). Each links to the standard text and the test report.
Markdown（推荐，两个一起）
[](https://dshio.org/10/) [](https://deepseekbase.com/zh/plugins/dsh-deepseek-quota-bar/)
Note: this is not a certification. DSHIO/T 32 is not in effect.
Versions
Published on npm:：3，最后更新 2026-08-21
Links
Frequently asked
dsh plugin --profile web add dsh-deepseek-quota-bar in DSH, or paste the package name into the DSH Desktop plugin page.dsh --version), then look at the first error in the test-results section. If it still fails, open an issue on the repository.dsh plugin --profile web remove dsh-deepseek-quota-bar.