AI 配额实时监控助手

本地查询 Antigravity/Windsurf AI 配额余额的 Node.js 工具，通过检测本地语言服务器进程并调用其私有 API 获取实时用量数据，帮助开发者监控 token 消耗避免服务中断。

基本信息

• 技能名称?antigravity-balance
• 中文名称?AI 配额实时监控助手
• 作者?finderstrategy-cyber
• 分类?专业技能
• 版本?127.0.0
• 标签?development-engineering, productivity, automation, api, data-analytics

使用方法

使用说明
核心用法
Antigravity Balance 是一款专为 Antigravity（及 Windsurf）用户设计的本地配额查询工具。其核心工作流程分为五步：首先自动检测本地运行的 language_server 进程（支持 macOS ARM/Intel、Linux、Windows 全平台），然后从进程参数中提取 --extension_server_port 和 --csrf_token ，接着扫描邻近端口定位 HTTPS API 端点，再向 https://127.0.0.1:{port}/exa.language_server_pb.LanguageServerService/GetUserStatus 发送认证请求，最终以可视化进度条或结构化 JSON 格式展示用户层级、模型名称、剩余配额百分比及重置倒计时。
使用方式极为简洁，执行 node scripts/agquota.js 即可自动检测并输出结果；添加 --json 参数可获得机器可解析的结构化数据，便于集成到自动化监控脚本； -v 参数则开启详细调试模式，帮助排查连接问题。
显著优点
零外部依赖 是最大亮点——仅使用 Node.js 内置的 https 、 、 child_process 、 、 util 模块，无需 npm install 即可运行，彻底规避了供应链攻击风险。 全平台兼容 设计周到，通过 process.platform 自动识别操作系统并调用对应的进程查询命令（macOS/Linux 用 ps aux ，Windows 用 PowerShell）。 输出体验优秀 ，彩色进度条直观展示配额状态（绿>50%、黄>20%、红≤20%），倒计时格式人性化。 本地闭环通信 确保敏感 token 和用量数据绝不外泄，全部流量限制在 127.0.0.1 回环接口。
潜在缺点与局限性
环境强依赖 是首要限制：必须预先启动 Antigravity/Windsurf 且语言服务器进程需包含 --app_data_dir antigravity 参数标识，否则脚本直接报错退出。 HTTPS 证书验证被禁用 （ rejectUnauthorized: false ）虽为对接本地自签名证书的必要妥协，但理论上存在中间人攻击窗口，尽管实际风险因本地回环而极低。 系统命令执行 依赖 child_process.exec 调用 ps 或 powershell ，虽命令硬编码无注入风险，但在严格受限的沙箱环境（如某些 CI/CD 容器）可能被安全策略拦截。 无持久化功能 ，每次查询均为实时调用，无法历史趋势分析。 平台进程名硬编码 ，若 Antigravity 更新更改二进制命名规则，脚本将失效。
适合的目标群体
Antigravity/Windsurf 重度用户 ：需要频繁监控多模型配额消耗，避免关键时刻触顶
自动化工作流开发者 ：希望将配额检查集成到 CI/CD 或定时任务，利用 --json 输出做阈值告警
本地开发环境管理员 ：统一管理团队成员的 AI 工具用量，优化资源分配
效率工具爱好者 ：偏好命令行交互，追求快速无干扰的信息获取
使用风险
性能层面 ：进程扫描和端口探测在系统负载高时可能超时（Windows 15s/macOS&Linux 5s），频繁调用会轻微增加 CPU 占用。 依赖项风险 ：虽无外部 npm 包，但强绑定 Node.js 运行时版本，极旧版本可能缺失 util.parseArgs 等新 API。 功能稳定性 ：依赖 Antigravity 内部 API 契约，官方更新可能破坏接口兼容性，需关注版本匹配。 安全边界 ： rejectUnauthorized: false 和 child_process.exec 的组合在理论上扩大了攻击面，建议仅在可信本地环境使用，避免部署到共享服务器或容器平台。
development-engineering productivity automation api data-analytics