还在手动查 DeepSeek 余额？我开源了一个 Windows 托盘监控工具

问题

用 DeepSeek API 做开发的同学应该都有这个体会：调着调着代码，突然 401 了——余额耗尽。

跑去官网登录、打开账单页面、查余额……这一套操作不仅打断思路，还浪费时间。尤其是 API 高峰期跑批量任务的时候，余额变化快，手动刷新根本来不及。

所以干脆写了一个常驻 Windows 系统托盘的 DeepSeek 余额监控工具，挂后台自动查余额、超阈值弹窗提醒、历史消耗一目了然。代码已开源，MIT 协议，随意折腾。

核心功能

• 托盘常驻实时显示余额 — 打开电脑就能看到，不用打开浏览器
• 自动定时刷新 — 可自定义轮询间隔（默认 5 分钟），余额变化第一时间知道
• 低余额弹窗预警 — 设置阈值，余额不足时 Windows 通知栏弹窗提醒
• 今日消耗统计 — 记录当日 API 调用消耗，日均消耗自动计算
• 历史数据持久化 — 本地 SQLite 存储，按天粒度记录，支持 CSV 导出回看趋势
• 多币种支持 — 自动识别 CNY / USD，按平台显示对应货币符号
• API Key 安全存储 — 使用系统凭据管理 API Key，不落盘明文

技术架构

项目分为三个核心模块：

1. 数据层 — API 请求 + 本地持久化

DeepSeek 官方提供了查询余额的 API：

GET https://api.deepseek.com/user/balance
Authorization: Bearer <api_key>

返回的 JSON 结构很简洁：

{
  "is_available": true,
  "balance_infos": [
    {
      "currency": "CNY",
      "total_balance": "8.66",
      "granted_balance": "0.00",
      "topped_up_balance": "8.66"
    }
  ]
}

本地用 SQLite 做历史记录存储，每次轮询结果追加一条记录，包含时间戳、余额、币种、状态等字段。按天聚合后可以绘制消耗曲线，直观呈现余额变化趋势。

2. 调度层 — 定时轮询引擎

轮询引擎采用独立的后台线程驱动，核心是一个可配置的时间循环：

• 支持自定义刷新间隔（1-60 分钟滑块调节）
• 失败自动重试（最多 3 次，指数退避）
• 网络异常时保留上次余额数据，不覆盖历史
• 首次启动或网络恢复后自动立即刷新

调度器与 UI 线程通过消息队列解耦，余额更新后通过回调通知托盘 UI 刷新显示。

3. 展示层 — Windows 系统托盘

托盘图标的设计有几个细节：

• 图标数字渲染：直接在托盘图标上渲染余额数字，不依赖外部图片资源
• 颜色编码：余额充足显示绿色，低于阈值变黄，耗尽或异常变红
• 右键菜单：立即刷新 / 设置 / 查看历史 / 退出
• 左键点击：弹出悬浮详情面板（总余额、充值余额、赠送余额、今日消耗）

关键技术决策

为什么用 SQLite 存历史？

历史数据的价值在于趋势分析，不需要高并发。SQLite 零配置、单文件、跨平台一致，作为桌面应用的本地存储是最自然的选择。后期如果需要更丰富的可视化，数据可以一键导出 CSV，丢进 Excel 或 Python 做分析。

API Key 安全存储

明文存 Key 是大忌。这里使用 Windows 凭据管理器（Credential Manager）加密存储，读取时由系统解密，代码层面不接触明文 Key。这样即使程序被逆向，Key 也不会泄露。

自定义阈值提醒

支持两个维度的预警：

1. 余额阈值 — 低于设定值时弹窗提醒「DeepSeek 余额不足，请及时充值」
2. 日消耗阈值 — 单日消耗超过设定值时提醒，帮用户感知异常消耗（比如代码里不小心死循环调 API）

两者结合可以有效防止「代码写着写着发现钱没了」的尴尬。

开源与下载

项目完全开源，MIT 协议，欢迎 Star / Fork / Issue。

GitHub：https://github.com/micc99/deepseek-balance-monitor

可直接下载打包好的安装包（Windows 安装程序 / 便携版），也支持从源码构建：

git clone https://github.com/micc99/deepseek-balance-monitor.git
cd deepseek-balance-monitor
# 按项目 README 指引安装依赖并运行

后续计划

• 消耗趋势图表（集成简单可视化）

欢迎提 PR 和 Issue，一起把这个小工具做得更好用。