前言¶
在使用 DeepSeek API 进行对话或开发智能体时，经常需要监控账户余额和消费情况。传统做法要么依赖网页端查看，要么在代码中自行轮询余额接口，容易遗漏实时变化或因网络波动导致误判。DeepSeek Harness（DSH）提供了一体化的插件机制，可以将这类功能集成到客户端界面中。下面介绍一个专门用于可视化 DeepSeek API 余额的插件。
这是什么¶
dsh-plugin-token-bucket 是一个挂在窗口角落的小水桶组件，水位代表你的 DeepSeek API 余额，出水口流出的是正在花的钱。插件由 youchai2016 维护，分类为客户端。它通过读取 DeepSeek 官方余额接口，将余额信息以直观的水位形式展示在 DSH 界面中，帮助你实时掌握消费情况。
核心功能¶
- 水位反映真实余额：插件使用与 DSH 聊天相同的
DEEPSEEK_API_KEY调用GET https://api.deepseek.com/user/balance，水位与你的实际余额同步。 - 双层水位设计：余额分为赠送余额和充值余额两层，赠送余额在上，充值余额在下。DeepSeek 优先消耗赠送余额，水位变化会反映这一顺序。
- 出水口模拟消费：出水口的流水和水滴大小基于过去三分钟的消耗速率，用于观察“vibe coding” sessions 如何快速消耗信用额度。
- 水位高度自适应：水桶高度以历史最高余额为基准，充值后水位上升而非溢出。
- 错误状态处理：如果余额读取失败，水位保持不变，出水口关闭，轮廓变为琥珀色，不会以错误信息清空水位。
- 可交互布局：右键打开设置面板，拖拽调整位置，箭头键微调位置，支持窗口角落隐藏。
安装与启用¶
插件提供两种安装方式。
通过 npm 安装：
dsh-plugin-token-bucket
或锁定到特定版本：
github:youchai2016/dsh-plugin-token-bucket#v0.1.0
插件依赖 DSH 已管理的凭证。如果“Models”页面中存在有效的 DeepSeek API Key，插件即可工作；否则会提示未配置。
典型用法¶
安装后，插件会自动出现在窗口角落。将鼠标悬停在水位上可查看具体数值，或右键打开设置面板查看更详细的数据：
- 余额（当前水位）
- 赠送/充值余额拆分
- 自启动以来的消费总额
- 自启动以来的充值总额
- 消耗速率（三分钟滚动平均）
- 水桶高度（历史最高余额）
- 最后读取时间
调整位置或隐藏后，再次右键即可恢复设置面板。
适用场景与注意¶
适合需要实时监控 DeepSeek API 余额的开发者，特别是在长时间对话、批量请求或自动化脚本运行期间。插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证（MIT）。
结尾¶
余额水桶插件通过水位可视化方式，将 DeepSeek API 余额监控融入 DSH 日常使用流程，减少了对网页端的依赖。如需更多插件或查看源码，可访问插件目录页或 GitHub 仓库。
