前言¶
在 DeepSeek Harness（dsh）的插件化思路下，web GUI 可以通过插件扩展页面能力。使用 dsh web 时，DeepSeek API 的剩余额度、今日与本月用量、当前会话费用通常不在同一视图里。
jiangli07/dsh-deepseek-quota-bar 是一个 web 插件，把这类信息做成右下角悬浮卡片，用血条显示剩余余额与月初余额比例，并展示今日与本月使用量、当前会话费用和峰谷时段提醒。
下面介绍它的定位、功能、安装、配置和使用注意点。
这是什么¶
dsh-deepseek-quota-bar 是 DeepSeek API 额度血条插件，面向 DeepSeek Harness (dsh) web GUI。维护者为 jiangli07，许可证为 MIT。
它解决的是在 dsh web 页面内查看 DeepSeek API 额度与使用量的问题：右下角显示余额比例、今日/本月使用量、当前会话费用，并提供峰谷时段与界面显示相关控制。
核心功能¶
额度血条¶
- 以血条显示 DeepSeek API 剩余余额与月初余额比例。
- 血条颜色阈值：
≥50%显示绿色≥20%显示橙色<20%显示红色
今日与本月使用量¶
- 配置
DEEPSEEK_PLATFORM_TOKEN后，使用官方精确数据。 - 未配置时，使用余额差值估算。
- 估算与月初余额快照等状态持久化在：
~/.dsh/storages/deepseek-quota-bar.json
当前会话费用¶
- 按官方价格表对当前会话日志计价。
- 包含安装前历史。
峰谷时段提醒¶
- 显示高峰徽标。
- 显示距下一时段切换的倒计时。
- 显示当前模型单价。
- 支持
Flash/Pro点击切换。
界面控制¶
- 卡片可拖动，位置持久化到
localStorage。 - 可折叠为只显示血条的迷你卡。
- 可调透明度范围为
0-100%，并持久化。 - 跟随浅色/深色主题。
- 余额每
60秒自动刷新，也支持手动刷新。
安装与启用¶
包名安装¶
执行：
dsh plugin --profile web add dsh-deepseek-quota-bar
安装后重启 dsh web：
dsh web
打开页面后强刷：
Ctrl+Shift+R
右下角出现卡片。
本地开发安装¶
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 引导哈希重新生成后再强刷页面。
典型用法¶
配置凭证¶
必需凭证：
DEEPSEEK_API_KEY
可选凭证，用于官方精确用量：
DEEPSEEK_PLATFORM_TOKEN
将凭证配置到：
~/.dsh/.credentials.yaml
配置后无需重启，下一次刷新即生效。
查看额度与用量¶
安装并配置后，打开 dsh web 页面，卡片会显示：
- 剩余余额与月初余额比例对应的血条。
- 今日与本月使用量。
- 当前会话费用。
- 峰谷时段提醒。
- 透明度、拖动、折叠等界面控制。
适用场景与注意¶
- 适合在 dsh web GUI 中使用 DeepSeek API，并希望在页面内查看额度、用量和会话费用的开发者。
- 如果只需要大致用量，可以不配置
DEEPSEEK_PLATFORM_TOKEN；此时今日/本月使用量会使用余额差值估算。 - 该仓库位于 GitHub，许可证为 MIT；不要把它理解为 DeepSeek 官方应用商店。
- 插件以当前 dsh 进程权限运行。安装前建议检查源码、依赖与许可证。
- 许可证信息：MIT。Fork 自
yingjunnan/dsh-deepseek-quota（MIT）；定价引擎参考dsh-web-billing（MIT）。
结尾¶
dsh-deepseek-quota-bar 将 DeepSeek API 额度、用量与当前会话费用集中到 dsh web 页面中，适合作为开发过程中的轻量监控组件。
仓库地址：
https://github.com/jiangli07/dsh-deepseek-quota-bar
