余额水桶 youchai2016/dsh-plugin-token-bucket

Balance Bucket · 余额水桶

一只小水桶，DeepSeek API 余额在花，它就跟着漏。

六种水桶状态：满、倒水、低水位、已补充、读不到、深色主题

一只挂在窗口角落的小水桶。水是你的余额，漏出去的是正在花的钱。

版本 0.1.1。

它做什么

- 水位就是你的真实余额。 它用 DSH 聊天时用的同一个 DEEPSEEK_API_KEY 去读 GET https://api.deepseek.com/user/balance，所以桶里显示的就是你实际拥有的钱。
- 水分两层，因为钱也分两种。 赠送余额（赠送）浮在充值余额（充值）上面。DeepSeek 先扣赠送钱包，所以你会看到浅色那层先漏空，深色那层才开始动。
- 钱一动，水龙头就开。 水流和水滴的大小跟最近三分钟的消耗速度成正比——想看着一场 vibe coding 会话吃掉你的额度，就用它。
- 桶的高度等于它见过的最高余额。 一开始是满的，之后充值只会让桶变高，不会溢出来。
- 读取失败绝不说谎。 如果余额读不到，水停在原地，水龙头关上，轮廓变成琥珀色。它绝不会为了显示错误就把桶倒空。

挪动它、缩放它、把它收起来——右键打开设置，拖动改变位置，方向键微调。

怎么看这只桶

| 外观 | 含义 |
| 上面浅色一层 | 赠送余额（先扣） |
| 下面深色一层 | 充值余额 |
| 蓝色水 | 高于见过的最高余额的 30% |
| 琥珀色水 | 在 10% 到 30% 之间 |
| 红色水，轻微晃动 | 低于 10% |
| 琥珀色轮廓，没有水流 | 上次读取失败；水位是最后一次读到的值 |
| 灰色水，— | 没有配置 API key，或者 key 被拒绝 |

把鼠标悬停在桶上可以看到数字，或者打开设置面板查看余额、赠送/充值拆分、启动以来已花费、启动以来已补充、消耗速度、桶的大小和上次读取的时间。

安装

包页面：dsh-plugin-token-bucket on npm。

dsh-plugin-token-bucket

或者锁定这个发布版本：

github:youchai2016/dsh-plugin-token-bucket#v0.1.0

插件需要 DSH 已经为聊天管理好的凭据。如果 Models 页面里有一个能用的 DeepSeek API key，水桶就能工作；如果没有，它会直接说明，而不是瞎猜。

隐私与运行时边界

- API key 每次轮询都通过 DSH 的凭据服务解析，绝不存储、记录日志、在错误里回显，也不会发给客户端那一半。浏览器那一半从不自己跟余额服务通信。
- 只有一个对外请求：对文档里写的余额端点做只读 GET。没有模型调用，没有遥测，没有监听端口，没有第三方服务。
- 你的对话内容一概不读。这个插件不订阅任何会话事件，所以它看不到提示词、回复或工具输出。
偏好和历史记录保存在浏览器的本地存储里。插件绝不会写入你的 DSH 配置档。

诚实的局限

- 消耗速度是根据余额变化估算的，不是根据 token 数量：余额以整分为单位变动（¥0.01），所以读数是一个滚动的三分钟平均值，而不是单次请求的数字。它刻意不作为账单凭证。
- 轮询是自适应的：余额变动后的两分钟内每 5 秒一次，然后 20 秒一次，之后没有动静时每分钟一次。来自其他设备或工具的变动也看得见，因为它们动的是同一个余额。
- 价格、赠送额度，以及赠送余额与充值余额的划分，都按 API 返回的结果显示。这个桶不会根据价目表计算费用。
- 余额只读取一种货币，优先 CNY。

开发

pnpm install --frozen-lockfile
pnpm run build
npm test

preview/index.html 是单个离线文件：在浏览器里打开即可，不需要服务器，也不需要网络。它的按钮会伪造余额样本，所以不用 API key 就能查看每一种状态。

pnpm run build 会把 Host 部分打包到 lib/index.js，把严格的浏览器/Host 契约打包到 lib/remote.js，把浏览器部分打包到 lib/client.js。预构建文件已提交，所以用 Git 安装不需要构建步骤。

许可证

代码采用 MIT。没有捆绑任何第三方美术资源：这个桶用 CSS 和一个内联 SVG 绘制。