Draggable transparent balance card with a blood-bar of remaining balance vs month-opening, today/month spend (official when the platform token is configured), and session cost.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-deepseek-quota-bar
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:jiangli07/dsh-deepseek-quota-bar
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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 点击切换）
- 📈 官方政策自动跟随：单价由宿主按官方政策时间表（含 2026-08-17 峰谷、08-23 周末低谷、09-10 flash 降价）实时计算，价格调整无需更新插件
- ⚙️ 可调透明度：设置按钮 + 滑块（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）。
Links
More in this category
bowenliang123/dsh-context★ 1556
DSH context insight panel: Context dashboard + /context command + Context browser — one-stop context lifecycle management with categorized composition, content details, evolution trends, compaction/injection events, and stats.
Han-1413141/dsh-cost-meter★ 344
Per-session and daily API cost, budget with usage %, official balance, history dashboard, and one-click official price sync with peak/off-peak pricing.
wssfk12138/dsh-damage-pulse★ 214
Tracks DeepSeek token usage, per-call and session costs, and account balance with cache-aware charge animations in the DSH Web UI.
zh667/TokenLedger★ 202
Sidebar usage panel that attributes tokens to the relay site that served each request, read from your existing provider config: today/month/all-time totals, per-site and per-model breakdowns, a year activity heatmap, and New API / Sub2API / DeepSeek balances.
Ychris12138/dsh-usage-stats★ 168
Multi-provider usage dashboard with provider/model token breakdowns, calendar drill-downs, account balances, and OpenCode Go / Z.ai subscription quota tracking.
PolinniZhong/dsh-personal-center★ 120
Personal center for DeepSeek Harness: cross-session usage statistics, per-model cost estimation, global custom instructions, a global font-size adjuster, a data-driven desktop pet with bitmap & vector skins, and a conversation status overview, all local and offline.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.