jiangli07 / dsh-deepseek-quota-bar

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）。