核心用法
Antigravity Balance 是一个用于监控 Google Antigravity AI 模型配额使用情况的本地工具。它通过检测系统进程中运行的 Antigravity 语言服务器（language_server_macos_arm 等），提取其 API 端口和 CSRF Token，进而向本地 HTTPS 端点查询用户状态。支持默认可视化输出（含彩色进度条、剩余百分比、重置倒计时）和 --json 结构化数据输出，便于脚本集成。
显著优点
- 零配置使用：自动扫描本地进程和端口，无需手动输入 API Key
- 多平台支持：覆盖 macOS（ARM/Intel）、Linux、Windows
- 直观可视化：颜色编码进度条（绿>50%、黄>20%、红≤20%）快速识别配额状态
- 开发者友好：提供 JSON 输出模式，便于自动化监控和告警集成
潜在缺点与局限性
- 强依赖本地环境：必须保持 Antigravity/Windsurf 运行，进程检测失败则完全不可用
- 非官方接口：通过逆向工程本地语言服务器实现，API 端点可能随版本更新失效
- 无远程查询能力：无法检查云端账户余额，仅反映本地会话的配额视图
- 权限要求：进程扫描和端口探测可能需要系统权限，某些企业环境受限
适合人群
Antigravity/Windsurf 的重度用户、需要监控 API 消耗以避免服务中断的开发者、以及希望将配额检查集成到 CI/CD 或本地开发工作流的自动化爱好者。
常规风险
- 接口稳定性风险：依赖未公开的内部 API，Antigravity 更新可能导致工具失效
- 安全风险：脚本需读取本地进程参数（含 CSRF Token），在共享/公共机器上可能泄露会话凭证
- 误判风险：若存在多个 Codeium 衍生产品（如 Windsurf、原版 Codeium），进程名相似可能导致检测错误