运行一次对应工具任务 → 在 无限蹬蹬 面板中刷新 → 如仍无数据,在“连接 AI 工具”中重新选择该工具的本地数据源。
Run one task in the source tool → refresh TokenBell → if no data appears, reselect that tool's local source under Connect AI Tools.
首次使用Getting started
如何连接 Antigravity CLI?
启用本机状态栏采集器后,运行一次 agy,在“连接 AI 工具 → Antigravity CLI”中选择包含 antigravity-status.json 的 ration 统计文件夹。应用只读取这个统计快照,无需授权对话目录或登录凭证
显示官方返回的模型额度、重置时间与当前会话输入、输出 Token;不是历史累计用量。快照超过 15 分钟后,旧额度会隐藏,请运行 agy 更新。此来源可用于小组件,并在你开启同步后进入 iCloud 摘要
需要什么系统版本?Which macOS version is required?
无限蹬蹬 为 macOS 14 Sonoma 及以上版本设计,同时支持 Apple 芯片和 Intel Mac。
TokenBell is designed for macOS 14 Sonoma or later and supports both Apple silicon and Intel Macs.
为什么首次启动要选择 .codex 文件夹?Why do I need to select the .codex folder?
macOS 沙盒默认阻止应用读取其他文件。你通过系统选择器授权后,无限蹬蹬 才能以只读方式提取额度和 Token 统计。应用不会修改该文件夹。
The macOS sandbox blocks access to other files by default. Selecting the folder grants read-only access so TokenBell can extract quota and token statistics. The app does not modify the folder.
如何连接 Gemini CLI?How do I connect Gemini CLI?
先在 Gemini CLI 设置中启用 OpenTelemetry,将目标设为本地文件、指定 outfile,并建议把 logPrompts 设为 false。运行一次 Gemini CLI 后,在 无限蹬蹬 的“连接 AI 工具”选择生成的 telemetry.log。无限蹬蹬 不会修改 Gemini CLI 配置。
Enable OpenTelemetry in Gemini CLI, target a local outfile, and set logPrompts to false. After one Gemini CLI run, choose the generated telemetry.log under TokenBell Connect AI Tools. TokenBell does not modify Gemini CLI settings.
如何连接 OpenCode 或 Grok Build?How do I connect OpenCode or Grok Build?
OpenCode 请先通过官方 opencode export 导出(支持时使用 --sanitize),再选择导出的 JSON 文件或文件夹。Grok Build 请先运行任务,再授权.grok 目录,应用提取 updates.jsonl 的任务完成统计字段,并兼容 usage.json;不需要提供登录信息或会话正文。两种接入都只汇总时间、模型与 Token 字段。
For OpenCode, use the official opencode export command (with --sanitize where supported) and choose the exported JSON file or folder. For Grok Build, run a task and authorize your .grok folder. The app extracts completed-task metadata from updates.jsonl, with usage.json compatibility. No login details or conversation text are needed. Both integrations aggregate only timestamps, models, and token counters.
如何设置登录时启动?How do I launch TokenBell at login?
打开“设置 → 通用”,启用“登录 macOS 时自动启动”。如果系统要求批准,请前往“系统设置 → 通用 → 登录项与扩展”允许 无限蹬蹬。
Open Settings → General and enable launch at login. If macOS requests approval, allow TokenBell under System Settings → General → Login Items & Extensions.
数据与授权Data and access
面板显示“没有数据”怎么办?What if the panel says “No data”?
- 先在对应工具运行至少一次任务,让本地产生用量记录。
- 打开菜单栏面板并点击刷新。
- 前往“连接 AI 工具”,确认对应来源已授权。
- 仍无数据时重新选择来源;Gemini CLI 需先开启本地遥测,OpenCode 需先导出,Grok Build 需至少完成一次任务并产生用量事件。
- Run at least one task in the source tool so local usage records exist.
- Open the menu bar panel and refresh.
- Confirm the matching source is authorized under Connect AI Tools.
- If needed, reselect it; Gemini CLI needs local telemetry, OpenCode needs an export, and Grok Build needs a completed task with recorded usage.
应用会读取对话或项目吗?Does the app read conversations or projects?
无限蹬蹬 只提取额度窗口、时间、Token 计数、模型名称与相关统计字段,不提取、展示、保存或上传六种已支持工具的对话正文、项目内容、账户令牌或密码。详情请阅读隐私政策。
TokenBell extracts only quota windows, timestamps, token counts, model names, and related statistical fields. It does not extract, display, save, or upload conversation text, project contents, account tokens, or passwords from the six supported tools. See the Privacy Policy.
如何清除本地统计或撤销访问?How do I clear local statistics or revoke access?
前往“设置 → 数据与隐私”,展开数据维护选项。清除统计只删除 无限蹬蹬 生成的历史和周期基线;六种来源都可分别撤销。这些操作不会删除来源工具的会话、项目、导出或遥测文件。
Go to Settings → Data & Privacy and expand data maintenance. Clearing statistics removes only history and cycle baselines created by TokenBell; each of the six sources can be revoked separately. These actions do not delete source sessions, projects, exports, or telemetry files.
为什么 Token 不等于余额,费用不等于账单?Why are tokens not quota and estimates not bills?
Codex 与 Antigravity CLI 可展示来源实际返回的额度和重置时间;其他来源只展示可获得的用量字段。总 Token 为输入加输出,缓存属于输入,推理属于输出,不能再次相加。费用按公开模型费率估算,不是实际扣款;记录不完整或不足时可能显示部分统计或等待数据。
Codex and Antigravity CLI display source-reported quotas and reset times. Other sources show available usage fields. Total tokens are input plus output; cached tokens are part of input and reasoning tokens are part of output, not additional totals. Costs use public model rates, not actual charges. Incomplete or insufficient records may show partial statistics or a waiting state.
iCloud 会同步什么?断开会删除数据吗?What does iCloud sync, and does disconnecting delete data?
Pro 用户可在“设置 → 通用”主动开启同步。无限蹬蹬只把额度、Token、模型及更新时间摘要存入你的 CloudKit 私有数据库,不同步源文件或凭证。请在需要同步的设备上登录同一 Apple 账户并为无限蹬蹬打开 iCloud。未及时更新时可检查网络与同步状态,再使用“立即同步”。断开只停止后续同步,保留本地与已有云端记录。
Pro users can opt in under Settings → General. TokenBell stores only quota, token, model, and update-time summaries in your private CloudKit database, never source files or credentials. Sign in to the same Apple Account and enable iCloud for TokenBell on each device you want to sync. If data is not current, check the network and sync status, then use Sync Now. Disconnecting stops future sync while preserving local and existing cloud records.
如何切换应用语言?How do I change the app language?
前往“设置 → 通用 → 语言”,选择跟随系统、简体中文、English、日本語或 한국어,切换立即生效。官网右上角的语言按钮仅切换网页,不会更改应用设置。
Go to Settings → General → Language and choose System, Simplified Chinese, English, Japanese, or Korean. Changes apply immediately. The website language selector changes only the webpage, not the app setting.
如何导出数据?How do I export data?
Pro 用户可从数据相关页面选择 CSV 或 JSON 导出,并通过系统保存面板决定文件位置。导出在本机生成。
Pro users can export CSV or JSON and choose the destination through the system save panel. Exports are generated on-device.
通知与菜单栏Notifications and menu bar
如何添加小组件或使用悬浮窗?How do I use widgets or the floating panel?
在 macOS 桌面右键选择“编辑小组件”,搜索 无限蹬蹬。可选小、中、大尺寸;右键编辑单个小组件可选工具,默认工具在“设置 → 小组件”中指定。内容来自最近一次本机摘要,更新由 macOS 调度,不保证实时刷新。悬浮窗在“设置 → 显示”中选择关闭、仅在 Codex 中或始终显示;默认关闭,自动识别当前仅适配 Codex。
Right-click the macOS desktop, choose Edit Widgets, and search for TokenBell. Small, medium, and large sizes are available. Edit each widget to choose a tool, or set the default in Settings → Widgets. Content uses the latest local summary; macOS schedules updates, so refresh is not guaranteed to be real time. Settings → Display offers Off, Codex-only, or Always for the floating panel. It defaults to Off, and automatic app matching currently supports Codex.
为什么收不到额度提醒?Why am I not receiving quota alerts?
- 确认无限蹬蹬设置中的通知开关已启用。
- 在“系统设置 → 通知 → 无限蹬蹬”中允许通知。
- 确认对应阈值、重置或消耗速度提醒已开启。
- 检查应用是否仍有
.codex读取权限。
- Confirm notifications are enabled in TokenBell settings.
- Allow notifications under System Settings → Notifications → TokenBell.
- Check the relevant threshold, reset, or pace alert.
- Confirm the app still has access to
.codex.
如何更改菜单栏内容和自行车?How do I change the menu bar display and bicycle?
打开“设置 → 显示”。Pro 用户可以选择菜单栏显示方式、自行车样式、显示开关和强调色;在低电量模式或“减少动态效果”开启时,系统可能减少动画。
Open Settings → Display. Pro users can choose the menu bar format, bicycle style, visibility, and accent color. macOS may reduce animation in Low Power Mode or when Reduce Motion is enabled.
阶段路线表示什么,可以隐藏吗?What do ride stages mean, and can I hide them?
阶段路线按当前周期的 0、100K、1M、10M、100M、1B Tokens 阈值展示进度,不代表额度、排名或账单。打开主面板的分享入口,在成绩单编辑器中关闭“显示蹬行阶段”即可隐藏;统计数据不会删除。
Ride stages use thresholds of 0, 100K, 1M, 10M, 100M, and 1B tokens for the current cycle. They are not quota, rankings, or billing. Open sharing from the dashboard and disable the ride-stage option in the report-card editor. No statistics are deleted.
Pro、试用与购买Pro, trials, and purchases
月度 Pro 和终身版有什么区别?What is the difference between monthly Pro and lifetime?
两者解锁相同的当前 Pro 功能。月度方案按月自动续订,符合资格的新用户可获得 7 天免费试用;终身版是一次购买。价格、币种和试用资格以 App Store 购买页面为准。
Both unlock the same current Pro features. Monthly Pro renews automatically and eligible new users may receive a 7-day trial; Lifetime is a one-time purchase. Prices, currencies, and trial eligibility are shown by the App Store.
购买后没有解锁怎么办?What if Pro does not unlock after purchase?
- 确认 Mac 登录的是购买时使用的 Apple 账户。
- 打开订购页面并点击“恢复购买”。
- 保持网络连接并等待 StoreKit 完成同步。
- 若仍未恢复,请联系支持并提供应用版本、macOS 版本和错误提示,不要发送 Apple ID 密码或付款资料。
- Confirm the Mac uses the Apple account that made the purchase.
- Open the purchase screen and choose Restore Purchases.
- Stay online while StoreKit synchronizes.
- If it still fails, contact support with the app version, macOS version, and error message. Never send an Apple ID password or payment details.
如何取消或管理订阅?How do I manage or cancel a subscription?
你可以从 无限蹬蹬 的 Pro 状态入口打开 Apple 的订阅管理,也可以前往“系统设置 → Apple 账户 → 媒体与购买项目 → 订阅”。取消后,Pro 通常会持续到当前计费周期结束。
Open Apple's subscription management from the Pro status entry, or go to System Settings → Apple Account → Media & Purchases → Subscriptions. After cancellation, Pro generally remains active until the end of the current billing period.
退款由谁处理?Who handles refunds?
所有购买由 Apple 处理。退款申请与结果由 Apple 根据其政策决定;开发者无法直接查看你的完整付款信息或代替 Apple 完成退款。
All purchases are processed by Apple. Refund requests and outcomes are determined by Apple under its policies; the developer cannot see complete payment details or issue an Apple refund directly.
仍然需要帮助?Still need help?
发送邮件时请附上应用版本、macOS 版本、问题发生的位置和可复现步骤。截图可以帮助定位界面问题,但请先遮挡任何私人信息。
Include the app version, macOS version, where the issue occurs, and steps to reproduce it. Screenshots can help with interface issues, but redact private information first.
m@mustundead.com无限蹬蹬 是独立第三方工具,与 OpenAI 没有关联、赞助或背书关系。Codex 是 OpenAI 的商标。TokenBell is an independent third-party utility and is not affiliated with, sponsored by, or endorsed by OpenAI. Codex is a trademark of OpenAI.
使用条款
应用许可使用 Apple 标准最终用户许可协议(EULA)。月度订阅会自动续订,价格、试用资格和续订日期以 Apple 购买确认页为准;卸载应用不会取消订阅。可通过 Apple 账户管理或取消订阅,在购买页面恢复购买。终身购买为一次性非消耗型购买。
使用条款