核心用法
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。