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