antigravity-rotator

# Antigravity Rotator (反重力轮换器) 🚀

本 Skill 旨在为 OpenClaw 提供一套确定性的 Google Antigravity 模型运维工作流。它将复杂的配额监控与自动化调度封装为简单的 Action。

## 🎯 触发场景 (When to use)
- 当用户拥有多个 Antigravity 账号且希望自动最大化利用配额时。
- 当主账号配额耗尽，需要**无感切换**（不重启会话）到备用账号时。
- 当需要实时可视化监控所有账号状态和轮换历史时。

## 🛠️ 快速部署流程 (Quick Start)

### 1. 环境初始化 (必须执行)
进入 Skill 目录并运行 setup 脚本：
```bash
cd skills/antigravity-rotator
node index.js --action=setup
```
> **作用**：自动探测 `openclaw` 和 `node` 路径，并生成适配你系统的 `config.json`。

### 2. 启动管理看板
```bash
node index.js --action=dashboard
```
- **地址**：`http://localhost:18090`
- **初始化账号**：进入页面点击右上角 **“同步凭证”**，脚本会自动扫描并加载你已通过 `openclaw models auth login` 登录的账号。

### 3. 配置定时任务 (Cron)
为了让轮换全自动运行，必须在系统 `crontab` 中配置驱动：
```cron
# 每 10 分钟自动检查一次
*/10 * * * * [NODE_PATH] [SKILL_PATH]/index.js --action=rotate >> [LOG_PATH]/cron-rotate.log 2>&1
```
*注：具体的路径请参考 `node index.js --action=setup` 运行后的输出结果。*

## 📝 核心配置项详解 (`config.json`)

| 参数 | 类型 | 说明 |
| :--- | :--- | :--- |
| `openclawBin` | String | **关键**。`openclaw` 的绝对路径。 |
| `modelPriority` | Array | 轮换优先级列表。排在前面的模型会被优先尝试。 |
| `quotas.low` | Number | 触发轮换的余量百分比阈值（建议 21）。 |
| `clientId` | String | (高级) Google OAuth 客户端 ID。默认为 Antigravity 通用 ID。 |
| `clientSecret` | String | (高级) Google OAuth 客户端密钥。 |
| `defaultProjectId` | String | (高级) Google 项目 ID，影响配额查询接口。 |

## 🌟 核心特性
- **会话热更新**：利用 OpenClaw Gateway API，在后台悄悄更换模型，用户正在进行的对话完全不受影响。
- **自动 Token 刷新**：内置 Token 刷新逻辑，确保长期运行无需手动重新登录。
- **模型激活 (Warmup)**：自动识别并激活“满血”但在计时外的模型，消除初次切换的延迟。
- **透明化日志**：看板实时展示轮换原因（如：调度更优模型、当前余...