TASK: 调研 Antigravity 是否可作为 CodeFlowMu Google Agent Slot

[joinwell52-AI]

背景

当前 CodeFlowMu 已有 Cursor SDK 通道、Claude Code CLI 通道、Google GenAI API 通道。Google GenAI API 路径本质是裸 LLM API 对接，需要 CodeFlowMu 自己补工具循环、MCP 调用、对话历史、失败结算等胶水层，稳定性和维护成本都高。

本任务不是继续扩写 GoogleGenAiAdapter，而是先调研 Google Antigravity 是否提供更接近 Cursor SDK 的 Agent SDK / CLI / 插件能力，从而作为 CodeFlowMu 的 Google Agent Slot。

公开信息显示 Antigravity 是 agent-first coding platform，并有 Agent Manager / artifacts 等产品形态；也有近期报道提到 Antigravity 2.0 包含 CLI / SDK。但是否存在可自动化调用的官方接口，必须以 Google 官方文档、安装包、CLI help、SDK 文档为准，不能凭媒体报道假设。

目标

判断 Antigravity 能否作为 CodeFlowMu 的 AntigravitySlot，替代或补充当前 GeminiApiSlot。

调研问题

请逐项确认：

1. Antigravity 是否提供官方 SDK？
2. Antigravity 是否提供 CLI？
3. 是否支持 headless / 脚本化运行？
4. 是否可以从外部程序创建或选择 Agent？
5. 是否可以指定 workspace / project root？
6. 是否可以向 Agent 发送自然语言任务？
7. 是否支持 resume / reconnect / continue 既有 Agent session？
8. 是否支持 MCP server 注入，或等价的工具/插件机制？
9. 是否可以读取运行事件流、日志、状态或 artifacts？
10. 是否可以判断任务成功、失败、取消、等待用户确认？
11. 是否可以导出计划、patch、截图、测试结果、浏览器录制等 artifacts？
12. 是否支持 Windows 本地自动化运行？
13. 是否需要 Google 账号登录、API Key、OAuth 或本地凭证？
14. 是否有速率限制、付费限制、workspace 权限限制？
15. 与当前 GoogleGenAiAdapter 裸 API 路径相比，是否明显降低 CodeFlowMu 的工具循环复杂度？

输出文件

新增：

codeflowmu-shell/docs/ANTIGRAVITY_SLOT_FEASIBILITY.md

如果仓库文档目录实际不是这个路径，可放到现有 docs 目录，但文件名保持一致。

输出格式

文档必须包含：

1. 结论

只允许三种之一：

A. 可做 AntigravitySlot，优先级高
B. 暂不可做 AntigravitySlot，继续使用 GeminiApiSlot 兜底
C. 信息不足，等待官方 SDK / CLI 文档

2. 证据表

能力	是否支持	证据来源	备注
CLI	是/否/未知	官方链接或本地命令输出
SDK	是/否/未知	官方链接或包名
workspace 指定	是/否/未知
发送任务	是/否/未知
resume session	是/否/未知
MCP / plugin	是/否/未知
artifacts 读取	是/否/未知
事件流 / 状态	是/否/未知
headless	是/否/未知
Windows 可用	是/否/未知

3. 建议插槽形态

如果可行，给出最小接口草案：

interface AntigravitySlotConfig {
  workspaceRoot: string;
  agentName?: string;
  model?: string;
  cliPath?: string;
}

interface AntigravitySlot {
  startTask(input: {
    taskId: string;
    prompt: string;
    workspaceRoot: string;
  }): Promise<RunHandle>;
}

不要求实现，只要求说明是否能落地。

4. 与 GeminiApiSlot 对比

必须明确回答：

• Antigravity 是否能减少 CodeFlowMu 自己维护 tool loop？
• Antigravity 是否能替代 GoogleGenAiAdapter？
• 如果不能替代，GoogleGenAiAdapter 应保留在哪些轻量场景？

5. 风险

至少覆盖：

• 黑箱程度
• 自动化能力不足
• 没有 SDK / CLI
• 无法注入 MCP
• 无法读取 artifacts
• 登录态 / 授权问题
• 供应商锁定

非目标

本任务不做以下事情：

• 不实现 AntigravitySlot
• 不重构 GoogleGenAiAdapter
• 不新增 OpenAI / Anthropic / Ollama Slot
• 不设计完整 Native Doorbell
• 不继续扩大 14 个 gemini 模块

验收标准

1. 提交 ANTIGRAVITY_SLOT_FEASIBILITY.md。
2. 文档必须有明确结论：A / B / C。
3. 每个关键能力必须有证据来源，不能写“应该可以”。
4. 若结论为 A，必须给出下一步最小实现任务。
5. 若结论为 B 或 C，必须说明当前 Google 路线应继续保留为 GeminiApiSlot 兜底，而不是继续宣称它是完整 Native Doorbell。

设计原则

CodeFlowMu 不主动造完整 Agent SDK。

优先级：

A 类：Agent SDK / CLI Slot，优先
B 类：Generic LLM API Slot，兜底

Cursor SDK 是 A 类黄金通道。Antigravity 只有在提供可自动化 Agent 能力时，才进入 A 类。否则继续停留在 B 类 Google API 兜底路线。

[joinwell52-AI]

调研更新：已确认存在 google-antigravity Python SDK，可进入 A 类候选

根据 PyPI 与 GitHub 仓库公开信息，google-antigravity 已发布到 PyPI，当前版本为 0.1.2，发布时间为 2026-06-04，项目说明为 “Google Antigravity SDK for building AI agents”。PyPI 页面显示安装方式为：

pip install google-antigravity

其项目描述明确称：该 SDK 是用于构建由 Antigravity 和 Gemini 驱动的 AI agents 的 Python SDK，提供安全、可扩展、有状态的基础设施层，并抽象 agentic loop。

对 CodeFlowMu 的关键意义

这说明 Antigravity 不只是 IDE 产品，也不只是 Gemini API 包装；它已经提供一个可编程的 Python SDK。它应进入 CodeFlowMu 的 A 类候选插槽：

A 类：Agent SDK / CLI Slot，优先
B 类：Generic LLM API Slot，兜底

当前判断：

A-候选：可做 AntigravitySlot PoC，优先级高

但还不能直接定为生产可用，因为 SDK 当前标记为 Alpha，且仍需本地验证 Windows、MCP、工作区、文件写入、会话恢复和事件流。

已确认能力

能力	初步判断	证据
PyPI 包	是	google-antigravity 0.1.2
Python SDK	是	PyPI/GitHub README
安装方式	是	pip install google-antigravity
Agent 生命周期封装	是	Agent 管理 lifecycle、binary discovery、tool wiring、hook registration、policy defaults
Stateful Conversation	是	Conversation accumulates step history，并暴露 history、turn_count、last_response
Streaming	是	ChatResponse 支持 async iteration
Tool call stream	是	response.tool_calls
Custom Tools	是	Python function tools
MCP Integration	是	McpStdioServer
Hooks / Policies	是	deny / allow / ask_user / enforce
Triggers	是	background tasks reacting to external events
Windows wheel	是	PyPI 有 win_amd64 / win_arm64 wheel
状态	Alpha	PyPI classifier: Development Status :: 3 - Alpha

对原 GoogleGenAiAdapter 的影响

之前的 GoogleGenAiAdapter 是裸 Gemini API 路线，需要 CodeFlowMu 自己维护 tool loop、MCP 调用、对话历史、去重、失败结算。现在应调整策略：

AntigravitySlot = Google 路线主攻方向
GeminiApiSlot   = 裸 API 兜底方向

不要继续把 GoogleGenAiAdapter 扩成完整 Native Doorbell。下一步应做 AntigravitySlot 最小 PoC。

建议新增 PoC 任务

新增一个后续实现任务：

TASK: AntigravitySlot 最小 PoC

验收目标：

1. 在 Windows 上安装 google-antigravity。
2. 使用 Agent + LocalAgentConfig 跑通 hello world。
3. 指定 CodeFlowMu workspace root。
4. 注入 fcop-mcp：McpStdioServer。
5. 发送一个 FCoP TASK prompt。
6. 让 Agent 调用 read_task / write_report。
7. 读取 response.tool_calls 和 streaming text。
8. 生成 CodeFlowMu RunHandle 事件。
9. 验证 report settlement 能闭环。
10. 输出 docs/ANTIGRAVITY_SLOT_POC_REPORT.md。

当前结论

Issue #6 的结论应从 C 改为：

A. 可做 AntigravitySlot PoC，优先级高；但生产化前必须验证 Alpha SDK 的稳定性。

注意：这不是让 CodeFlowMu 自己造完整 Agent SDK，而是优先接入官方 Antigravity SDK，把当前裸 Gemini API 路线降级为兜底。