jiangli07/dsh-deepseek-quota-bar
DeepSeek API quota blood-bar widget for the DSH web GUI: remaining balance vs month-opening, today/month spend, session cost. Draggable & collapsible.
已收录
2
Usage
Bundle 已验证
预览
功能介绍
可拖动透明余额卡片：余额/月初额度血条、今日/本月用量（配置平台 token 后为官方精确数据）、当前对话费用。
适合
- 希望在 DSH Web 界面快速查看 DeepSeek API 余额及月初额度比例的用户。
- 希望同时跟踪当前会话费用与 DeepSeek 今日、本月用量的用户。
- 需要可拖动、可折叠且跟随 Web 界面主题的额度组件的用户。
不适合
- 使用 DeepSeek 以外模型服务商的用户；其余额与定价数据专用于 DeepSeek。
- 无法提供 `DEEPSEEK_API_KEY` 的用户；读取余额需要该凭证。
- 要求今日和本月用量必须是官方精确数据、但不配置 `DEEPSEEK_PLATFORM_TOKEN` 的工作流；否则会退化为余额差值估算。
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 号首次观测到的余额快照；月中新装时用「当前余额 + 本月官方消耗」反推
-
对话费用：订阅
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）。
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:jiangli07/dsh-deepseek-quota-bar。命令会解析公开 package 元数据，并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到，请先保持禁用，并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页，确认目录已经观察到最新版本。