上游项目： DeepSeek-Balance-Whale-Widget， 作者 MeteorNOX，MIT 许可。
界面、角色立绘、气泡、音效全部来自该上游项目，前端一行未改。 本项目重写了宿主端，让它能脱离 DSH 独立在桌面运行，并接入各类中转站与 Agent。
源码与许可全文见 上游仓库；
安装目录下的 LICENSE.txt 也保留了原始许可声明。
它是怎么工作的
余额取自中转站的真实接口——用你已有的 API Key 调用，不需要登录网页版。 接口是自动识别的：挂件内置一组「接口指纹」，启动时逐个试，命中哪个就套用哪套字段映射。 识别不出来的也可以在设置里手填。
每轮花费来自 Agent 自己的用量日志（ZCode 的 SQLite、Codex / Claude Code 的 JSONL）， 按 token 数估算后，再用中转站返回的当日真实花费做校准。 所以每轮金额是被真实账单校正过的，而不是纯估算。
使用注意
首次启动会弹出设置窗口，里面已经列好了自动发现的结果，通常直接点「完成」就能用。
挂件平时是点击穿透的：只有鼠标移到角色和菜单上时才接管点击，桌面其它地方照常操作。 开机自启默认关闭，需要的话在托盘菜单里勾选。
如果界面卡住无法关闭，用命令退出：
"%LOCALAPPDATA%\BalanceWhale\balance-whale.exe" --quit安装包未做代码签名，首次运行会有 Windows SmartScreen 提示。