Antigravity CLI（agy）— PRO 模型使用笔记

[SozoPC] 环境笔记。相关：decision-log（2026-08-01 条目）、devops_hermes-cron-debugging。

基本信息

• 二进制：C:\Users\Sozo\AppData\Local\Programs\antigravity-cli\agy.exe（v1.1.9）
• 登录账号：ida.czia@gmail.com（Google AI Pro 订阅，2026-08-18 到期）
• 数据目录：C:\Users\Sozo\.gemini\antigravity-cli\
• 可用模型（agy models）：gemini-3.6-flash-high/medium/low、gemini-3.5-flash-*、gemini-3.1-pro-high / gemini-3.1-pro-low、claude-sonnet-4-6、claude-opus-4-6-thinking、gpt-oss-120b-medium
• --model 接受别名：pro / flash / flash_lite / auto / inherit，或完整模型 ID

⚠️ 核心坑：headless 模式静默回退 Flash

--print / headless 模式指定 --model gemini-3.1-pro-high 不报错但静默用 Flash。 官方确认：google-antigravity/antigravity-cli Issue #710（“Headless Mode Silent Fallback to Flash Model when Overriding Model Slug”）。 官方 workaround：交互模式 + /model 斜杠命令。cron 4658b0a0070e 每天 09:00 检查该 issue 是否修复。

✅ 已验证方案：PTY 交互模式（完整链路）

用 Hermes terminal 工具 pty=true 启动 agy（不要用 Python pty 模块——Windows 不可用；winpty + subprocess 管道报 “stdin is not a tty”；Windows 版 pexpect 无 spawn）：

1. pty=true 后台启动 agy → 首次有引导页
2. 数据收集同意页：Tab 移动焦点 → Enter（[x] Yes → [Previous] → > Done）
3. 工作区信任确认：Enter（默认 > Yes, I trust this folder）
4. 主界面输入 /model → 模型选择器 → ANSI 下箭头 \x1b[B 选中 Gemini 3.1 Pro → Enter → 状态栏确认 “Model set to Gemini 3.1 Pro”
5. 状态栏实时显示当前模型（可验证切换成功）；切到 PRO 后首次请求较慢

TUI 按键：↑/↓ 导航用 \x1b[A / \x1b[B（裸 [B 无效），Enter 确认，esc 返回。

已固化到 Hermes skill：D:\hermes\skills\autonomous-ai-agents\antigravity-cli-pro\SKILL.md。

OAuth / 登录机制

• 凭据存 Windows 凭据管理器：LegacyGeneric:target=gemini:antigravity（keyring）
• CLI 无 auth 子命令（agy auth logout/login 不存在——CLI 自己会编答案，别信）
• 删除凭据 → 下次运行触发浏览器 OAuth；但认证窗口仅 60 秒，且每次运行生成新 PKCE code_challenge（旧授权码作废）
• 手动兑换方案（已验证成功）：Python 生成 PKCE → 构造授权 URL（15 分钟窗口）→ 用户授权拿 code → 用 code + code_verifier + client_secret（从 agy.exe 二进制 grep GOCSPX- 提取） 调 token 端点 → 写 token_response.json
• 日志关键行：Auth mode is unspecified, skipping fetchAvailableModels（settings.json 的 auth 字段格式未确认，模型列表仍可用）；quota_manager.go doRefreshQuota（quota 刷新日志）

settings.json

位置：C:\Users\Sozo\.gemini\antigravity-cli\settings.json

• 写入 {"default": "gemini-3.1-pro-high"} 可被部分读取（日志能读到 default），但 auth.mode 字段不被识别
• 模型选择会被持久化：PTY 切到 Pro 后，下次启动状态栏直接显示 Gemini 3.1 Pro · low
• 尝试过的字段（无效/未确认）：telemetry、termsAccepted、privacyNoticeAgreed（同意页仍出现）

2026-08-03 补充：Desktop 版 + 长任务稳定性 + effort 设置

• ⚠️ CLI 后台 PTY 长任务卡死：agy CLI 在 Hermes terminal pty=true 后台跑「生成多个大文件」型长任务会卡死（Gemini 3.1 Pro high 跑了 8.5 分钟无任何输出）→ 大型生成任务不要用 CLI 后台 PTY，改用 Antigravity Desktop 或 Gemini 网页版
• Antigravity Desktop（GUI 版）= 用户实际主力工具：v2.x、能用 PRO、有 agent 能力（执行命令/创建文件）、可直接产出成品（如 2026-08-03 直接生成 Google Sheets 甘特表 + 给 agent 的逻辑文档）
• effort 设置：状态栏显示 Gemini 3.1 Pro · Low/Med/High；直接编辑 settings.json 的 model 字段（2026-08-03 发现位于第 5 行，如 "model": "Gemini 3.1 Pro (Low)"）改为 "Gemini 3.1 Pro (High)" → 重启 agy 后状态栏显示 High（已验证生效）；/model 命令有时被当作普通文本输入（不弹选择器）
• 2026-08-03 实测：启动时默认状态栏就是 Gemini 3.1 Pro（无需切换）
• Gemini 视觉免费 quota 用完（2026-08-03 用户确认）：图片/视觉分析返回被截断 → 视觉验证绕开 Gemini（如用 Sheets API 读结构/单元格背景色）

待办 / 用户偏好

• 用户要求：8/18 前几乎所有任务尽量派给 agy 执行（结合本 agent 知识给出正确路径/命令词）；按任务难度调模型强度（偶尔 flash、偶尔 PRO）
• 研究 agy quota 查看方法（weekly + 5-hour limit；线索：fetchAvailableModels API、quota_manager.go 日志、桌面版设置界面）

2026-08-11 补充：CLI 断线问题解法线索 + 8/18 前配额规划

• CLI 大任务断线问题（用户 21:09 复述，仍未解决）：直接控 agy CLI 跑大任务 → 易断线 → 任务丢。潜在解法两条：① HERDR 托管——agy 跑在 herdr 窗格 → 分离 → 任意终端重连、会话不丢（skill herdr 已吸收备用，未验证，需要时 10 分钟可试出结论）② 派 Prime 解决
• 8/18 前 Pro 配额规划（8/11 晚建议，待用户确认）：排重活清单给 Gemini Pro 跑——SEO P1 30 个 pSEO 区域页扩写 + 9 篇博客加厚（省 DeepSeek 主配额，呼应 ai-compute-routing 分工思路）；Hermes 已问「要排吗」
• 相关：MultiAgent_Graph（HERDR 节点）、2026-08-11（晚间补充）

2026-08-12 补充：HERDR 断线持久验证 ✅ + OAuth 重授权完成 + Pro 模式铁律

• HERDR 断线持久验证通过（8/11 21:27）：杀 client 模拟断线 → server 继续运行 → 重连任务完成（/tmp/herdr_persist_proof.txt 21:27:57 写入）→ agy 跑 herdr 窗格 = CLI 大任务断线问题可解（上条「未验证」升级为 ✅；skill herdr 已记验证路径）

• OAuth 重授权完成（8/11 22:07）：token 过期 → herdr pane 内挂起等授权（herdr 托管不超时的现场展示）→ 用户浏览器授权（ida.czia@gmail.com）+ code 回填 → 已恢复

• 用户铁律（8/11 22:07）：用 agy 必须 Pro 模式，不要 flash——「我要尽量把配额用完」（8/18 Pro 订阅过期）

• 相关：MultiAgent_Graph（HERDR 节点）、2026-08-11（深夜补充）