AI 配额智能监控管家

Clawdbot 官方配额监控工具，实时追踪 Claude/Gemini 多账户剩余额度与重置时间，助力开发者高效管理 AI 资源。

基本信息

• 技能名称?antigravity-quota
• 中文名称?AI 配额智能监控管家
• 作者?mukhtharcm
• 分类?专业技能
• 版本?v1.1.0
• 标签?api, automation, data-analytics, devops, backend, productivity

使用方法

使用说明
核心用法
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 参数或环境变量自定义时区，方便跨国团队协作时统一时间认知。
   潜在缺点与局限性
6. 平台绑定限制 ：仅支持 Antigravity + Clawdbot 生态，无法直接用于原生 Anthropic/Google API 或其他代理平台的配额查询。
7. 硬编码凭证设计 ：OAuth Client ID/Secret 采用 Base64 硬编码，虽为公共客户端标准做法，但理论上存在凭证轮换滞后风险。
8. 功能单一性 ：仅提供只读查询，无法执行配额预警、自动账户切换等高级运维操作，需配合外部脚本实现自动化。
9. 网络依赖刚性 ：必须能访问 Google OAuth 和 Cloud API，在受限网络环境下可能完全失效。
   适合的目标群体
   AI 应用开发者 ：需要频繁调用 Claude/Gemini API，需实时监控多账户额度避免服务中断。
   运维工程师 ：管理团队共享的 Antigravity 账户池，需快速识别高可用账户进行负载均衡。
   自动化工作流构建者 ：将配额查询集成到 CI/CD 或监控告警系统，实现资源使用可视化。
   Clawdbot 生态用户 ：已深度使用 clawdbot 进行 AI 模型调度的技术团队。
   使用风险
10. 认证配置依赖 ：工具完全依赖本地 auth-profiles.json 的完整性，若配置文件损坏或权限错误将导致查询失败。
11. API 速率限制 ：频繁调用 Google Cloud API 可能触发速率限制，建议合理控制查询频率（如每 5 分钟一次）。
12. 时区配置误用 ：未正确设置 TZ 环境变量可能导致重置时间显示错误，造成账户切换决策失误。
13. tablesnap 额外依赖 ：图片生成功能需单独安装 Go 工具链，增加环境配置复杂度。
14. 版本兼容性 ：依赖 Node.js 18+ 的原生 fetch API，旧版本 Node 环境需升级或 polyfill。