cc-bar：macOS AI 额度监控工具

项目简介

cc-bar 是一款用 Swift / SwiftUI 编写的 macOS 原生菜单栏应用，用于集中查看各类 AI 编程订阅的剩余额度与重置时间，并在本机离线分析 Token 消耗、费用和对话历史。

它展示两类数据：订阅额度通过各服务官方接口获取剩余比例与重置倒计时；本机用量由本地日志解析或服务端计量汇总，不上传代码、项目数据或会话内容。项目以 MIT 许可证开源。

主要功能

• 多服务额度监控：支持 Codex（5 小时 / 周额度）、Claude Code（5 小时 / 周 / 模型专属额度）、Antigravity、Cursor（Total / Auto / API）、Command Code、OpenCode Go 等服务的剩余额度与重置时间。
• 低额度系统通知：额度低于设定阈值时发送 macOS 通知，同一周期仅提醒一次，点击通知可直达用量统计。
• 本地离线用量分析：概览、对话、项目与额度四个页面，支持日 / 周 / 月粒度与自定义时间范围，展示总 Tokens、费用、同期变化、模型构成与缓存命中率。
• 对话与项目维度：检索历史会话，查看输入输出、缓存读写、请求数与费用拆分；按项目汇总用量趋势，Git worktree 自动归入主仓库。
• 多账号同屏：Codex 可粘贴 auth.json 或 PAT 导入多个账号，同屏查看额度与额外重置次数，不影响 CLI 登录状态。
• 菜单栏与桌面悬浮窗：支持主窗口、周窗口或双窗口模式，悬浮窗可边缘吸附、记忆位置且不抢占键盘焦点。
• 隐私与体验细节：一键截图隐私模式遮挡邮箱、项目路径、分支与会话 ID；集成 Sparkle 应用内更新；日志本地轮转脱敏，无用户行为遥测。

安装与使用

运行环境：macOS 14 (Sonoma) 或更新版本；相关 AI 编程工具需已在终端或桌面端完成至少一次登录。

1. 打开 Releases 页面 下载最新的 CCBar.dmg（或 CCBar.app.zip）。
2. 打开 DMG，把 CCBar.app 拖入 /Applications 文件夹。
3. 启动后在菜单栏图标中查看各服务额度，在设置中开关服务、调整显示顺序与统计口径。

首次启动若被 Gatekeeper 拦截，可在「系统设置 → 隐私与安全性」中找到拦截提示并点击「仍要打开」；若提示「应用程序已损坏」，可执行：

xattr -dr com.apple.quarantine /Applications/CCBar.app

如需从源码构建，需要完整版 Xcode（仅 Command Line Tools 无法构建 SwiftUI 资产），在 Xcode 中打开 ccbar.xcodeproj 运行；打包 Release 可执行 SPARKLE_PUBLIC_ED_KEY="你的更新公钥" ./scripts/build.sh，产物输出到 dist/ 目录。

注意事项

• 发布的构建为 ad-hoc 签名，未经过付费 Apple 公证，首次启动会有系统安全提示。
• 对 Claude Code 与 Cursor 的凭据严格只读，不会刷新或改写，避免导致官方 CLI 被踢下线；凭据过期时需在终端重新登录。
• 本机会话日志（~/.codex/sessions、~/.claude/projects 等）只读解析，不上传、不改写源日志。
• 对桌面、文稿等受保护目录不做文件系统访问，项目归组仅基于路径文本分词，不会触发隐私权限弹窗。
• 遇到问题时可通过「设置 → 通用 → 诊断 → 导出诊断日志」生成诊断包，附到 Issue 中反馈。

本作品整理自 GitHub 开源项目 nanvon/cc-bar，原作者 @nanvon，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。