MeteorNOX/DeepSeek-Balance-Whale-Widget

DeepSeek Balance Whale Widget 的功能

此仓库包含一个 DeepSeek Web/桌面客户端 (DSH) 的插件。它添加一个小型、常驻屏幕的“鲸鱼”小部件，显示：

• 您的 DeepSeek API 余额（每 60 秒自动刷新，并有平滑的滚动数字）。
• 今日支出 – 根据余额变化和每次回合的 token 使用量计算。
• 当前回合的成本 – 每次模型响应后弹出气泡，显示该回合的花费金额。
• 可自定义的气泡 – 您可以编辑文本、添加随机句子、图片、GIF，或显示余额/价格信息。
• 高峰/非高峰定价 – 小部件知道 DeepSeek 的“高峰”时段，并可显示相应的价格。
• 预算/低余额警报 – 当余额低于阈值或今日支出超过限制时弹出。
• 音频反馈 – 按下/释放音效、回合结束音效，以及问题/授权的可选提示。
• 拖放定位 – 鲸鱼可以贴齐屏幕边缘、镜像，或自由放置。

工作原理

1. 数据源 – 插件首先尝试从 DSH 凭据存储读取 DEEPSEEK_API_KEY。如果该密钥丢失，则回退到 DSH 可内部查询的已登录 DeepSeek 账户。
2. 会计核心 – lib/accounting.mjs 监视余额端点，记录每次增减，并保留分类账（90 天汇总，最多 20,000 条）。它还会使用 DeepSeek 内置的价格表（或您可为每个模型设置的自定义价格），将 token 使用量（input、cache、output、reasoning）转换为货币成本。
3. UI – assets/whale-widget.js 在 DSH UI 的右下角绘制鲸鱼和气泡。所有视觉设置（大小、颜色、字体、镜像等）都存储在 $DSH_HOME/.dshw-size.json 中。
4. 可扩展性 – 小部件附带一个“模块库”，可让您从文本、链接、随机句子、图片/GIF 或内置占位符（如 {balance}、{cost}、{quota}）组合气泡行。模块可以保存并重复使用。
5. 多供应商支持 – 通过“自定义 API”面板，您可以添加其他供应商（OpenRouter、Kimi、OpenAI 兼容网关等）。每个供应商都有自己的余额/配额模块，小部件可以与 DeepSeek 并排显示。

安装路径

目标	分支	安装命令
DSH Web UI（右下角小部件）	main	dsh plugin --profile web add dsh-whale-widget (npm) 或 … add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
DSH Desktop (Electron) 客户端	main	让桌面客户端自行安装：在 DSH 会话中输入 “把 dsh-whale-widget 装上”，或使用内置的插件管理器。
Codex 桌面应用（不同的代码路径）	For-Codex	解压到 %USERPROFILE%\plugins\api-balance-whale，并按照分支特定文档操作。

一次只能使用两条产品线之一 – 它们完全独立。

配置文件（存储在 $DSH_HOME 下）

文件	用途
.dshw-size.json	UI 大小、吸附点、音频组选择、高峰价格样式
.dshw-usage.json	余额观察分类账、每次回合成本、警报阈值、音频设置
.dshw-bubble.json	自定义气泡序列和模块库
.dshw-api.json	您添加的额外供应商列表，包含端点 URL、JSON 路径和可选的每 token 定价
.dshw-usage-archive.json	旧分类账数据（逐回合 90 天，每日汇总 365 天）
.dshw-codex.json	Codex 模式分支的本地 Codex 会话日志缓存

使用时机

• 您执行大量 DeepSeek 调用，并想要快速视觉提示花费金额。
• 您需要一个 预算守卫，在余额耗尽前警告您。
• 您喜欢有趣的“鲸鱼”UI，并想要自定义气泡消息（例如随机励志语录、GIF 或每日预算提醒）。
• 您使用多个 LLM 供应商，并想要一个小部件显示每个供应商的剩余配额。

---

总结： 此仓库是一个功能完整、可安装的 DSH 插件，将 DeepSeek 客户端变成一个小型会计仪表板，并带有可爱且高度可自定义的鲸鱼小部件。