jiangli07/dsh-deepseek-quota-bar ↗★ 0
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).
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:jiangli07/dsh-deepseek-quota-bar说明文档
阅读完整 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后为官方精确数据;未配置时自动降级为余额差值估算 - 💬 当前对话费用:按官方价格表(含峰谷定价)对会话日志计价,含安装前历史
- 🖱️ 可拖动:按住卡片任意位置拖动,位置持久化(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 号首次观测到的余额快照;月中新装时用「当前余额 + 本月官方消耗」反推
- :订阅 实时计价 + 持久化日志全量回放(含重启前历史)