一眼看清你的 AI 订阅还剩多少：用量、剩余额度、重置时间，全都在手机上。
--- 同时用着 ChatGPT、Copilot、OpenRouter、Kimi……每家的额度规则都不一样：5 小时窗口、每周上限、按月重置、预付余额。AI Usage 把它们放在同一个地方，告诉你**哪个快用完了、什么时候恢复**，免得在关键时刻被限流。 ## 功能 - **中转站一键接入**：New API、Sub2API、One API 等中转站只需地址和 Key，自动识别站点和余额。 - **所有订阅一屏看完**：每个账号的每个额度窗口（5 小时、每周、每月、余额）用横条显示已用与剩余，附重置倒计时；最需要注意的账号排在最前面。 - **用完预测**：按你当前的消耗速度，估算什么时候会用完——如果早于重置就提前告诉你。 - **订阅与花费**：显示服务商返回的套餐到期 / 续费日；为每个账号填上月费，首页汇总你每月在 AI 订阅上花了多少。 - **及时提醒**：用量超过你设的阈值、窗口重置额度恢复、套餐快到期、登录失效时，发本地通知提醒你。 - **小组件**（iOS）：主屏和锁屏小组件，不打开应用也能看余量。 - **新版本提示**：有新版时在首页标题旁提示，点一下前往下载；关闭后同一版本不再提示。 - **好用的细节**：中文 / English（可跟随系统）、浅色 / 深色、7 种主题色、流畅的动画与触觉反馈，并尊重系统的「减弱动态效果」。 ## 下载与安装 前往 [Releases](https://github.com/nextroad-dev/aiusage/releases/latest) 下载最新版本。 ### Android 下载 `AIUsage-*.apk`，在手机上打开安装（首次需要允许「安装未知来源应用」）。 ### iOS 下载 `AIUsage-*-unsigned.ipa`。这是**未签名**的安装包，需要用 [Sideloadly](https://sideloadly.io/) 或 [AltStore](https://altstore.io/) 配合你的 Apple ID 签名后安装： 1. 在电脑上安装 Sideloadly（Windows 还需要安装官网版 iTunes），用数据线连接 iPhone。 2. 把 IPA 拖进 Sideloadly，填入 Apple ID，点击 Start。 3. 在 iPhone「设置 → 通用 → VPN 与设备管理」中信任该开发者。 4. iOS 16 及以上需打开「设置 → 隐私与安全性 → 开发者模式」。 > 使用免费 Apple ID 签名时：应用 7 天后需要重新签名（数据会保留）；免费账号不支持 App Group，主屏小组件不会显示数据，其他功能正常。 ## 支持的服务 | 服务 | 连接方式 | 显示内容 | |---|---|---| | ChatGPT / Codex | 浏览器登录 | 5 小时窗口、每周窗口、额度余额、套餐有效期 | | GitHub Copilot | 个人访问令牌（Token） | Premium 请求、Chat、代码补全用量 | | OpenRouter | 浏览器登录 / API Key | 额度余额、Key 限额、今日 / 本周 / 本月花费 | | Cline / ClinePass | API Key | ClinePass 的 5 小时 / 每周 / 每月用量与套餐到期日；额度余额（含组织余额） | | **中转站**（New API、Sub2API、One API 等） | 站点地址 + API Key | Key 额度、已用、剩余余额（按站点设置的货币显示） | | OpenAI 开放平台 | Admin API Key | 组织本月与今日花费 | | Anthropic 开放平台 | Admin API Key | 组织本月与今日花费 | | Kimi Code | API Key | 5 小时窗口、每月额度 | | Kimi 开放平台 | API Key | 可用余额 | | MiniMax Token Plan | API Key | 5 小时窗口 | | GLM Coding Plan（z.ai） | API Key | Token 用量 | | DeepSeek 开放平台 | API Key | 可用余额 | | Poe | API Key | 积分余额 | | Runway 开放平台 | API Key | API 积分余额（不含网页订阅积分） | | Command Code | API Key | 5 小时 / 每周窗口与各类积分（实验性接口） | | OpenCode Go | API Key | Go 订阅额度 | - **浏览器登录**：在系统浏览器里完成授权，自动回到应用，无需复制任何验证码。 - **OpenRouter** 浏览器授权会生成一个属于你的 API Key；查看整个账户余额需要 Management Key。 - **中转站**：只需填写站点地址和 Key，点「智能识别」后自动判断程序类型（New API / Sub2API / One API / OpenAI 兼容）、读取站点名称和余额；之后刷新直接使用识别出的方式查询，失效时才重新识别。 - **OpenAI / Anthropic 开放平台**需要组织的 Admin API Key（普通项目 Key 无权读取费用）；两家都不提供余额接口，因此显示花费。 - **暂不支持**：Claude / Claude Code 订阅（Anthropic 条款不允许第三方读取用量）、Cursor、OpenCode Zen、MiniMax 与智谱 GLM 的开放平台按量余额（暂无公开的余额接口）、Google Antigravity（只能借用 Google 官方客户端的 OAuth 凭据登录）。 > 部分服务的用量接口并非官方公开 API，服务商调整后可能暂时失效；遇到问题欢迎提 [Issue](https://github.com/nextroad-dev/aiusage/issues)。 ## 隐私 - **没有服务器**：应用直接向各服务商请求你的用量，数据不经过任何第三方。 - **凭据只存在本机**：API Key 和登录令牌保存在系统钥匙串（iOS Keychain / Android Keystore）中，不会上传。 - **用量历史只存在本机**：保存在应用的本地数据库里，可在「设置 → 数据」一键全部删除。 - **无广告、无统计**：不收集任何使用数据。 - **版本检查**：应用每隔几小时读取一次本仓库在 GitHub 上的最新 Release，用来提示新版本；请求不携带任何账号或用量信息。 - 浏览器登录使用本机 `127.0.0.1` 临时回调，只在登录过程中短暂开启，授权完成后立即关闭。 ## 常见问题 **为什么数据不是实时的？** 打开应用时会自动刷新，也可以点右上角的刷新按钮。后台刷新由系统调度，频率取决于你使用应用的习惯。 **「按当前速度约 X 后用完」准吗？** 它按本周期内的平均消耗速度线性估算，适合判断「今天会不会被限流」，不代表精确时间。 ## 参与开发 基于 React Native + Expo，Windows 上即可开发： ```bash npm install npm run check # 类型检查 + lint + 测试 npx expo start # 启动开发服务器 ``` - Expo Go 可以运行本应用，但浏览器登录回调、主屏小组件和后台刷新需要原生构建。 - `tools/probe` 可用真实账号验证服务商接口（`node tools/probe/probe.mjs list`）。 - 推送 `v*` 标签（如 `v1.0.3`）会通过 GitHub Actions 自动构建 Android APK 与未签名 iOS IPA，并发布到 Releases。发布前先在 `.github/changes/<标签>.md` 写好该版本的更新日志，并同步修改 `app.json` 中的 `version`；Release 说明会自动拼接更新日志与安装指南。 ## 赞助 AI Usage 免费且没有广告。如果它对你有帮助，欢迎在 [爱发电](https://afdian.com/a/nextroad) 支持开发 ❤️