核心用法
Antigravity Quota Skill 是一款专为 Clawdbot 用户设计的配额监控工具，用于实时检查 Antigravity 平台下 Claude 和 Gemini 模型的账户额度使用情况。用户通过简单的 Node.js 命令即可获取所有配置账户的配额状态，支持文本、Markdown 表格和 JSON 三种输出格式，并可自定义时区显示。
该工具的核心工作流程为：读取本地 auth-profiles.json 中的认证配置 → 使用 OAuth 刷新令牌获取 Access Token → 调用 Google Cloud API 拉取各模型配额数据 → 格式化输出剩余百分比与重置时间。对于需要可视化展示的场景，可通过管道配合 tablesnap 工具将表格转换为图片，便于在消息平台分享。
显著优点
1. 多账户统一管理：支持同时监控 9 个及以上账户的配额状态，避免频繁切换账户手动查询的低效操作。
2. 智能可视化标识：表格模式下采用颜色编码（🟢🟡🟠🔴）直观展示配额紧张程度，一眼识别需要切换的账户。
3. 零第三方依赖：仅使用 Node.js 内置模块（fs、path、fetch），彻底规避 npm 供应链攻击风险，部署轻量可靠。
4. 灵活的输出适配：原生支持文本终端、Markdown 表格、JSON 三种格式，满足命令行查看、自动化脚本、消息通知等多场景需求。
5. 精准的时区支持：通过 --tz 参数或环境变量自定义时区，方便跨国团队协作时统一时间认知。
潜在缺点与局限性
1. 平台绑定限制：仅支持 Antigravity + Clawdbot 生态，无法直接用于原生 Anthropic/Google API 或其他代理平台的配额查询。
2. 硬编码凭证设计：OAuth Client ID/Secret 采用 Base64 硬编码，虽为公共客户端标准做法，但理论上存在凭证轮换滞后风险。
3. 功能单一性：仅提供只读查询，无法执行配额预警、自动账户切换等高级运维操作，需配合外部脚本实现自动化。
4. 网络依赖刚性：必须能访问 Google OAuth 和 Cloud API，在受限网络环境下可能完全失效。
适合的目标群体
- AI 应用开发者：需要频繁调用 Claude/Gemini API，需实时监控多账户额度避免服务中断。
- 运维工程师：管理团队共享的 Antigravity 账户池，需快速识别高可用账户进行负载均衡。
- 自动化工作流构建者：将配额查询集成到 CI/CD 或监控告警系统，实现资源使用可视化。
- Clawdbot 生态用户：已深度使用 clawdbot 进行 AI 模型调度的技术团队。
使用风险
1. 认证配置依赖：工具完全依赖本地 auth-profiles.json 的完整性，若配置文件损坏或权限错误将导致查询失败。
2. API 速率限制：频繁调用 Google Cloud API 可能触发速率限制，建议合理控制查询频率（如每 5 分钟一次）。
3. 时区配置误用：未正确设置 TZ 环境变量可能导致重置时间显示错误，造成账户切换决策失误。
4. tablesnap 额外依赖：图片生成功能需单独安装 Go 工具链，增加环境配置复杂度。
5. 版本兼容性：依赖 Node.js 18+ 的原生 fetch API，旧版本 Node 环境需升级或 polyfill。