AI Token 余额查看器：多平台 API 额度监控工具，支持 Android 桌面小组件
AI Token 余额查看器：多平台 API 额度监控工具，支持 Android 桌面小组件
还在一个个打开网页查 DeepSeek、OpenAI、MiniMax 的余额？一个开源的安卓 App + 桌面小组件，瞄一眼就搞定。
目录
- 为什么要做这个工具
- 功能简介
- 多平台支持
- Android 桌面小组件
- 如何使用
- 技术架构
- 下载与安装
- 常见问题
- 总结
一、为什么要做这个工具
同时使用多个 AI 平台的开发者，应该都遇到过这个场景：
你正在跑一个批处理任务，突然收到报错——「额度不足」。然后你不得不停下工作，打开 DeepSeek 官网 → 登录 → 找余额页面 → 看看还剩多少钱。如果是 MiniMax，还要看日限额、周限额、窗口时间……
如果同时用 3 个平台，这个操作就要重复 3 遍。
市面上有一些余额查询工具，但基本都是PC 端或浏览器插件，手机上能用的几乎没有。作为一个 Android 开发者，我决定自己动手做一个。
项目特点：
- 本地运行：API Key 只存在手机本地，不上传任何服务器
- 开箱即用：内置 DeepSeek 和 MiniMax 模板
- 灵活扩展：任何有余额 API 的平台都能添加
- 桌面小组件：手机桌面瞄一眼就知道余额
开源项目地址：https://gitee.com/neil-boy/token-balance-view
二、功能简介
2.1 多平台统一管理
所有 AI 平台的余额、额度在一个 App 里统一展示。每个平台独立配置 API Key，互不干扰。网络错误或认证失败只影响单张卡片，其他平台正常显示。
2.2 灵活的平台配置
用户添加平台时，配置好 API 地址、请求方式、JSONPath 字段映射即可：
fields:-label:"余额"path:"$.balance"unit:"¥"type:"number"-label:"到期时间"path:"$.expire_at"type:"datetime"支持的 JSONPath 语法：
$.field— 根字段取值$.field.subfield— 嵌套取值$.array[0].field— 数组索引取值
2.3 一键刷新 + 定时自动刷新
- 下拉刷新所有平台余额
- 支持后台定时自动刷新（可设置间隔）
- 每个平台独立缓存，网络异常时显示上次数据
2.4 数据安全
- API Key 仅通过 Android SharedPreferences 本地存储
- 不经过任何第三方服务器
- App 直接向各 AI 平台官方 API 发起请求
- 导出配置时可选择是否包含 API Key
三、多平台支持
当前已验证的平台：
| 平台 | 类型 | 可查询内容 |
|---|---|---|
| DeepSeek | Balance | 账户余额（¥） |
| MiniMax | TokenPlan | 日限额剩余、周限额剩余、窗口剩余时间 |
| OpenAI | Balance | 账户余额（$） |
| Claude | Balance | API 剩余额度 |
| 硅基流动 | Balance | 账户余额 |
其他有余额查询 API 的平台均可通过自定义配置添加。
TokenPlan 和 Balance 的区别
- Balance 类型：直接显示余额数字，适用于 DeepSeek、OpenAI 等按余额计费的平台
- TokenPlan 类型：显示日限额剩余、周限额剩余、窗口倒计时，适用于 MiniMax 等按周期额度计费的平台
四、Android 桌面小组件
这是最实用的功能。把小组件添加到手机桌面后：
- 不开 App 一眼看余额，不用每次打开 App 刷新
- Balance 类型：显示所有余额字段
- TokenPlan 类型：显示日剩余、周剩余、窗口倒计时
- 右上角刷新按钮：点击直接后台拉取数据
- 定时自动刷新：设置间隔后在后台更新
- 深色主题适配
对于经常调用 API 的开发者来说，桌面小组件比打开 App 快得多。
五、如何使用
添加平台
- 点击首页右下角「添加平台」
- 选择平台类型（Balance 或 TokenPlan）
- 填写平台名称、API 地址、API Key
- 配置字段映射（JSONPath 取值路径）
- 保存后自动查询余额
添加桌面小组件
- 长按手机桌面空白处 → 选择「小组件」
- 找到「Token Balance」小组件
- 选择放置位置
- 配置绑定平台
六、技术架构
Flutter (跨平台 UI) ├── Provider (状态管理) ├── home_widget (小组件数据桥接) └── http (API 请求) Android (原生) ├── RemoteViews (小组件渲染) ├── AppWidgetProvider (小组件提供者) └── SharedPreferences (数据存储)核心模块
| 模块 | 职责 |
|---|---|
platforms_provider.dart | 平台配置管理、API 查询、Widget 数据更新 |
api_service.dart | HTTP 请求封装，统一处理 API 响应 |
balance_card.dart | Balance 类型平台卡片 UI |
tokenplan_card.dart | TokenPlan 类型平台卡片 UI |
TokenBalanceWidget.kt | Android 小组件渲染器 |
字段取值类型
| type | 显示方式 | 示例 |
|---|---|---|
number | 千分位格式化 | 1,234,567 |
string | 原样显示 | "2026-07-12" |
datetime | 格式化日期 | 2026-07-12 08:00 |
七、下载与安装
环境要求
- Android 设备（arm64）
- 或者从源码构建
下载 APK
从 Gitee Releases 下载：token-balance-view-v1.0.0-arm64.apk
注意：APK 约 23MB，仅支持 arm64 架构（主流 Android 手机均支持）。
从源码构建
gitclone https://gitee.com/neil-boy/token-balance-view.gitcdtoken-balance-view flutter pub get flutter build apk--release--target-platform=android-arm64八、常见问题
Q1：API Key 会上传服务器吗？
不会。API Key 仅存储在手机本地，App 直接向 AI 平台官方 API 发起请求，不经过任何第三方服务器。
Q2：支持哪些平台？
内置 DeepSeek 和 MiniMax 模板，其他有余额查询 API 的平台都可以通过自定义配置添加。
Q3：桌面小组件不刷新怎么办？
先在 App 内添加平台并成功查询一次。如果仍不刷新，尝试重启手机或重新添加小组件。部分华为/小米桌面可能存在 RemoteViews 兼容性限制。
Q4：支持 iOS 吗？
目前仅支持 Android。Flutter 本身跨平台，后续可以考虑扩展。
Q5：如何添加自定义平台？
点击「添加平台」→ 选择「自定义」→ 填写 API 地址、请求方法、字段映射即可。
九、总结
Token Balance Viewer解决了一个很小的痛点——看 AI 平台余额。但就是这种日常操作，重复多了就很烦。
一个桌面小组件省掉「打开 App → 看余额」这个步骤，直接瞄一眼就知道。如果你也在用多个 AI 平台、经常被额度问题打断工作流，不妨试试这个工具。
开源地址：https://gitee.com/neil-boy/token-balance-view
欢迎 Star、Fork、提 Issue。