目录

Google Antigravity 实战指南

如果你日常已经在用 Claude Code、Codex 或 GitHub Copilot CLI,就会发现编码 Agent 的核心竞争点已经从「单模型补全」转向了「多模型交接、远端隔离执行与端到端可视化验收」。2026 年 11 月中下旬,Google 连续推进了三次关键更新:11 月 17 日 Antigravity v2.33.0 引入 SSH 远程 64 位 Linux 宿主机、原生 GitHub PR 状态视图与内置浏览器检索;11 月 18 日上线 Gemini 4 Neon;11 月 20 日 v2.34.0 进一步扩大了 Orchestrator 支持范围。

本文基于截至 2026 年 11 月的 Antigravity 模型文档 与 动态工作流指南,梳理工作台内 512K 上下文上限与直接调用 API 的差异、不同订阅套餐下 Orchestrator 与 /swarm 的真实权限边界,以及在真实仓库里的落地方式。

Gemini 4 三档模型与上下文边界

Gemini 4 家族包含多款模型(如 Argon 等),在 Antigravity 编码工作流里最常对比的是 Carbon、Neon 与 Hydrogen 三档:

模型 定位 Antigravity 工作台上下文与思考档位 典型适用场景
Gemini 4 Carbon 深度长周期规划与高难度推理 高深度推理档位 跨子系统根因分析(RCA)、安全审计、大范围架构评审
Gemini 4 Neon(gemini-4-neon) 主力编码与推理档 Antigravity 最高 512K;界面提供 Low / Medium / High(默认)/ Extra 四档(CLI 可用 xhigh) 日常功能交付、复杂 Bug 排查、代码审查
Gemini 4 Hydrogen 高速低延迟执行器 偏快执行档位 机械性多文件编辑、依赖升级、补齐单元测试、执行器交接

迁移大仓库时务必区分入口上下文上限:Antigravity 工作台公布的 Neon 上限为 512K;而在 Google Cloud Gemini 4 Neon 模型指南 中直接调用模型 API 时,上限为 1,048,576 tokens(输入与输出共享,含思考、工具调用与最终回复)。关于跨厂商思考档位与预算控制,可参考 大模型自适应思考与分级路由实战。

Orchestrator 模式:双模型交接与套餐差异

以往做中等规模需求,工程师经常要手动切换模型:先用强推理模型读代码、定方案,再切成快模型改文件、跑单测。Antigravity 的 Orchestrator 把这个流程做成单会话内的规划者(Planner)与执行者(Executor)交接:

flowchart LR Task["功能需求 / 复杂 Bug"] --> Planner["Planner (Neon 或 Enterprise 下的 Carbon High)"] Planner -->|"拆解步骤与约束"| Executor["Executor (Hydrogen)"] Executor -->|"受阻 / 需要架构决策"| Planner Executor -->|"Diff 与测试结果"| Planner Planner -->|"审查验收"| Done["可合并变更"]

这种单会话交接让主控规划者免于被大量机械改写日志淹没,执行者遇到边界冲突或测试异常时也能把控制权交回规划者重新决策。

选型前需要核对清楚套餐与主控模型限制(见 Antigravity 模型表脚注 与 官方发布说明):

  • Orchestrator (Neon)(Neon 规划 + Hydrogen 执行):适用于 Ultra 及符合条件的 Pro 套餐(Pro 试用存在设备限制);普通 Free / Plus 账号不包含该模式。
  • Enterprise 账号固定配对:现行 Enterprise 的 Orchestrator 固定使用 Carbon High + Hydrogen High。即便 Enterprise 账号可以单独选用 Neon 模型,也不代表能在 Enterprise Orchestrator 中把主控切换成 Neon。

何时启用 Orchestrator 不宜机械按文件数量一刀切(例如「3 个以上文件」仅作直观示例),更合理的判断依据是模块耦合度、执行耗时与验证成本:当任务同时包含明确的方案权衡与较长的机械编辑/测试执行周期时,交给 Planner + Executor 交接更省心;局部单函数改动直接用单模型 Neon 反馈更快。

用 /swarm 驱动多智能体并行开发

当任务需要同时推进多条互不阻塞的子轨道(如跨服务迁移、前后端独立模块改造)时,才需要从单会话的 Orchestrator 升级到 /swarm 并行协作(见 Antigravity 动态工作流):

flowchart LR Coord["Coordinator (Carbon / Neon)"] --> W1["Worker 1 (独立 Worktree · 模块 A)"] Coord --> W2["Worker 2 (独立 Worktree · 模块 B)"] W1 --> Verify["合流验收与全量测试"] W2 --> Verify

需要留意权限边界:v2.33.0 确实将 /swarm 与 UI 插件面板扩展到了商业版与企业版账号,但仍受组织管理员策略开关约束,并非所有企业租户默认开箱可用。

在多 Worker 协作里,核心纪律与 多智能体系统实战指南 一致:按目录或契约切分所有权、避免两个 Worker 同时修改共享核心类型,并在合流后由单一节点跑完构建与集成测试。若改动高度耦合在同一个状态机内部,留在 Orchestrator 单会话推进比强行开 /swarm 更稳。

SSH 远程宿主机、内置浏览器与 PR 闭环

v2.33.0 把「本地轻客户端 + 远端重构建 + 浏览器验收」串成了完整工作台:

  • SSH 远程 64 位 Linux 宿主机:直接复用本地 ~/.ssh/config 连接远端 64 位 Linux 主机,项目代码、Git Worktree、终端与 Agent 执行全部留在远端宿主机上,适合需要大内存或重编译的 Go / Rust / 容器项目。
  • 内置浏览器验收:Agent 可直接打开本地开发服务、执行交互点击并检查页面状态与控制台输出;v2.33.0 新增了 Cmd/Ctrl+F 页内检索。
  • 原生 GitHub PR 状态集成:界面内直接显示实时 PR 状态胶囊、悬停卡片与 Overview PR 视图,把看 CI 和修 Review 意见留在同一工作台。
  • /btw 旁路追问:在不打断主线程上下文的前提下快速提问,v2.33.0 支持把有价值的旁路结论直接插回主对话。

落地清单与常见误区

  • 先把仓库校验脚本做快做稳:无论用单模型、Orchestrator 还是 /swarm,交付上限取决于仓库有没有确定性的单文件测试、Lint 和类型检查(详见 AI Agent 环境工程)。
  • SSH 宿主机必须与生产隔离:不要把 Agent 直接连到带生产数据库写权限的跳板机或线上主机,务必使用独立开发容器或测试机。
  • 按任务复杂度调整思考档位:样式微调或模板脚手架切到 Low 或交给 Hydrogen,可减少不必要的推理等待时间;具体提速与成本收益应以团队自身仓库任务集的实测为准。
  • 人类守住最终 Diff 审阅:浏览器截图与单测通过只覆盖表层行为,核心数据结构变更、安全边界与长期可维护性仍需逐行把关。

参考资料