AI Token 用量移动监控面板
Token Monitor 是 Token Monitor Hub 的 Android 客户端，让你随时随地在手机上追踪 AI 编程工具的 Token 消耗、费用支出和 API 配额使用情况。通过 Server-Sent Events 实现实时数据同步，支持多设备协同监控。
- 概览 — 今日 / 本月 / 总计三张用量卡片，Hub 版本信息与服务器时间，今日 Top 10 模型排行
- 配额 — 各 AI 提供商预付余额进度条、充值余额消费占比、速率限制窗口可视化，含颜色阈值和重置倒计时
- 设备 — 已连接设备列表，含平台、总用量和最后活跃时间，支持查看详情和删除
- 模型 — 全时段模型用量排名，每个模型展示输出 Token、缓存 Token、费用及可视化占比图
- 工具 — 按 AI 客户端（Claude Code、Cursor、Cline、Copilot 等 30+）分组统计，配有专属图标和品牌色
- 会话 — 每次 AI 对话的完整记录，点击展开输入 / 输出 / 缓存 / 推理 Token 明细及使用的模型和提供商
- 趋势 — GitHub 风格 53 周活跃热力图、30 天日用量和费用柱状图、近 12 个月月度汇总
- API 密钥 — AES-256-GCM 加密存储，支持 16+ AI 平台，一键验证有效性，JSON 批量导入导出
- 其他 — 中英文双语运行时切换、SSE 实时流同步、支持 HTTP 明文连接（内网环境）
| 层级 | 技术选型 | 说明 |
|---|---|---|
| 语言 | Kotlin 2.2 | 全项目 Kotlin |
| UI | Jetpack Compose + Material 3 | 声明式 UI，动态取色 |
| 导航 | HorizontalPager | Compose 原生分页，8 个标签页 |
| 网络 | Ktor Client (OkHttp) | 协程式 HTTP + SSE 流 |
| 序列化 | Kotlinx Serialization | 编译期类型安全 |
| 图片 | Coil + SVG Decoder | 异步加载，支持原始 SVG |
| 持久化 | DataStore Preferences | Hub 连接配置 |
| 加密 | EncryptedSharedPreferences | API 密钥 AES-256-GCM |
| 架构 | MVVM (ViewModel + StateFlow) | 单向数据流 |
| 构建 | Gradle + Version Catalog | 集中式依赖管理 |
| 工具 | 最低版本 |
|---|---|
| Android Studio | 2024+ |
| JDK | 17+ |
| Android SDK | API 36 |
| Gradle | 9.2+ |
| 运行设备 | Android 12 (API 31)+ |
git clone https://github.com/myhMARS/TokenMonitor-Andorid.git
cd TokenMonitor-Andorid
./gradlew assembleDebug
./gradlew installDebug # 直接安装到设备编译产物位于 app/build/outputs/apk/debug/app-debug.apk。
使用前需运行 Token Monitor Hub 实例：
- 桌面端托管：在 Token Monitor 桌面应用中进入
Settings → Multi-device Sync → Host hub on this device - 独立部署：
git clone https://github.com/Javis603/token-monitor && npm run hub
记录 Hub 的 URL 和 Shared Secret，在应用设置页填入即可连接。
- 首次启动进入设置页，输入 Hub 地址和共享密钥，点击连接
- 验证通过后进入仪表盘，左右滑动切换 8 个功能标签页
- 右上角菜单提供刷新、语言切换、API 密钥管理、断开连接
- 应用自动通过 SSE 接收 Hub 推送的实时数据更新
TokenMonitor/
├── app/src/main/
│ ├── AndroidManifest.xml
│ ├── res/
│ │ ├── raw/ # 30+ AI 工具 SVG 图标
│ │ ├── values/strings.xml # 英文字符串
│ │ ├── values-zh/strings.xml # 中文字符串
│ │ └── xml/ # 备份与数据提取规则
│ └── java/com/tokenmonitor/app/
│ ├── MainActivity.kt # 单 Activity 入口
│ ├── data/
│ │ ├── ApiKeyStorage.kt # 密钥加密存储
│ │ ├── HubPreferences.kt # Hub 配置持久化
│ │ ├── LocaleManager.kt # 语言切换管理
│ │ ├── TokenMonitorApi.kt # Ktor HTTP API
│ │ ├── TokenMonitorRepository.kt # 数据仓库
│ │ └── model/
│ │ ├── ApiKeyModels.kt # API 密钥数据模型
│ │ └── HubModels.kt # Hub 响应数据模型
│ └── ui/
│ ├── DashboardViewModel.kt # 视图状态管理
│ ├── theme/ # Material 3 主题
│ └── screen/
│ ├── SetupScreen.kt # 连接设置页
│ ├── DashboardScreen.kt # 仪表盘 (8 标签页)
│ └── ApiKeysTab.kt # API 密钥管理
├── gradle/libs.versions.toml # 版本目录
├── build.gradle.kts
└── settings.gradle.kts
本项目是 Token Monitor 的 Android 客户端实现。感谢 Javis603 设计并开源了 Token Monitor 生态。
MIT License · Copyright (c) 2026 Eternity