Pacer Vibe 项目
macOS 菜单栏双进度环预测 Claude/Codex/Cursor 订阅落点,按速度而非百分比看盘
项目简介
Pacer 是一款 macOS 菜单栏小工具,用两个进度环回答一个订阅制 AI 编程用户每天都会焦虑的问题:我的 AI 编程订阅额度能不能撑到重置时刻?它同时监控 Claude Code、Codex、Cursor、Antigravity、Gemini CLI、GitHub Copilot 等多个工具的用量,机器上登录过的每个账号并排展示。与市面上其他显示"已用百分比"的工具不同,Pacer 显示的是"速度"——按当前节奏推算,到额度重置时会落在百分之几。100 表示刚好用完,绿色表示不超过 80,琥珀色表示 80 到 100 之间,超过 100 进度环会变成一个红色实心圆盘。16% 的用量看起来很安全,直到你意识到这周才过了 10%——这正是它想让你看见的信号。
核心功能
- 速度环预测:两个环分别代表当前 5 小时会话窗口和周窗口,按最近的消耗速率外推到重置时刻,让"照这样用下去会怎样"一眼可见。
- 一句话建议:根据你实际的模型使用结构,给出具体到"减少 Fable 使用、把 X% 的 Opus 任务转到 Sonnet"级别的建议;状态健康时则显示"节奏正常,无需调整"。
- 多账号并排:每个订阅保留最近一次读数,未登录的账号显示已用量与最后检查时间,重置时间一到该窗口归零、进度环转绿,提示你可以切回去用了。
- 成本核算与提醒:以滚动的日、周、三十天窗口统计所有 Claude Code 配置的接口等价成本;当节奏突破 100、回落以及任一窗口超过 90% 时触发通知。
技术实现
Pacer 的实现刻意保持轻量:一个无依赖的 Node 脚本负责每 10 分钟采样一次,一个 Swift 文件构建菜单栏应用,数据落地为一份其他工具也能读取的 JSON 文件。它从不自造数据源,只调用各厂商自带的用量接口,凭据一律使用系统里已有的登录态,从不刷新或写入任何令牌。Claude 的登录信息从系统钥匙串读取,支持默认配置以及所有位于 ~/.claude-* 目录、通过 CLAUDE_CONFIG_DIR 区分的多配置档案;Codex 直接读取其本地认证文件并以会话记录兜底;Antigravity 通过运行中应用的本地语言服务器获取每个转售模型的额度;Cursor 读取编辑器自身的登录。核心的周窗口推算公式是"已用百分比除以窗口已流逝的比例",5 小时会话则取最近 45 分钟的速率外推,避免用整个会话的平均值掩盖突发消耗。每模型权重系数由官方用量百分比与本地会话记录拟合得出,在数据量不足时退化为接口价格比。
快速上手
- 确认条件:需要 macOS 13 及以上系统、Node 18 及以上版本,并通过 xcode-select --install 安装命令行工具。
- 安装:执行 brew install dkremsa/tap/pacer,再运行 brew services start pacer 让采样器每 10 分钟工作一次并开机自启。
- 启动界面:把安装目录下的 Pacer 应用拷贝到"应用程序"文件夹并打开,菜单栏即可看到进度环;需要开机自启可在系统设置的"登录项与扩展"中添加。
- 开始使用:直接点击进度环查看详细卡片,点击卡片中的标签页切换不同账号,菜单栏的两个环会跟随当前选中的订阅同步变化。
适用人群
Pacer 适合所有按订阅方式使用 AI 编程工具、且同时持有多个账号的开发者:重度使用 Claude Code、担心五小时会话或周额度提前耗尽的独立开发者;订阅了 Codex、Cursor 等多个工具、想在一个面板里统一看盘的自由职业者;以及希望量化订阅物有所值、用接口等价成本评估投入产出的技术团队成员。注意它仅支持 macOS 平台,Windows 和 Linux 用户暂时无缘。
官网链接
项目开源在 GitHub:https://github.com/dkremsa/claude-pacer ,通过 brew tap 即可安装,亦可从源码构建。
评论与建议
登录 后参与评论或提建议