Antigravity Link 是一个面向 Google Antigravity IDE 的 VS Code 扩展，定位为移动端伴侣。当用户需要离开电脑、但又想继续关注正在生成中的 AI 会话时，可以通过扫描二维码，让手机浏览器成为当前聊天窗口的实时镜像，在本地网络内完成阅读与交互。
主要能力
- 实时镜像当前 Antigravity 聊天：在手机上阅读流式输出并与之交互。
- 向当前 Antigravity 聊天上传文件。
- 移动端语音转文字输入（需要 HTTPS 才能获得麦克风权限）。
- 通过专用停止按钮从手机停止生成。
- 支持在多个 Antigravity 窗口之间切换活动实例。
- 提供本地 HTTP API，用于自动化与集成。
- 提供 MCP 服务器，用于与 AI 助手集成，内置 9 个 MCP 工具。
- 仅本地运行的服务器，带令牌认证。
- 界面支持 16 种语言，自动检测并支持 RTL（从右到左）渲染。
使用方式 安装：可从 Antigravity 扩展市场搜索 "Antigravity Link"，或直接从 Open VSX 安装。 环境要求：已安装并运行 Antigravity IDE；手机与电脑处于同一 Wi-Fi 网络；Antigravity 需带远程调试标志启动，否则扩展无法发现并连接会话；多个 Antigravity 会话均需用该命令启动。 快速开始：在 VS Code 中运行 "Antigravity Link: Start Server"，再运行 "Antigravity Link: Show QR Code"，用手机扫描二维码即可打开移动界面。由于使用自签名证书，手机可能提示连接不安全，这是本地 HTTPS 的预期现象，可通过浏览器的 "Advanced" 等选项继续访问。 自动化集成：启动扩展服务器并从二维码 URL 中复制 token（?token=...），然后使用 MCP 工具（mcp-server.mjs）或直接对 https://localhost:3000 发起 HTTP 调用，可用 /snapshot、/send、/stop 验证控制流。项目还提供 OpenAPI 示例与 MCP 客户端配置示例。
工作原理（高层） 扩展启动本地服务器（HTTP 或 HTTPS）；通过 Chrome DevTools Protocol（CDP）发现 Antigravity 目标；手机连接移动 UI 并发送上传/命令请求；扩展注入到选中的聊天目标，并把文件保存到 uploads/ 目录。扩展连接的是本机 Antigravity 暴露的调试端口，即 VS Code 内置调试器与浏览器开发者工具使用的同一 CDP 协议，它读取本地 UI 并模拟按键与点击，如同用户坐在键盘前操作。
安全与隐私 所有网络活动均为本地：扩展只与局域网内的手机（通过其启动的 HTTPS 服务器）、localhost:9000 上的 Antigravity IDE CDP 端口，以及 127.0.0.1 上的 Antigravity 语言服务器进程（用于停止生成的 RPC）通信。除 Antigravity 自身发送的数据外，不向 Google 服务器或任何外部服务发送数据。扩展不注入 Antigravity 的网络流量，不拦截或修改 API 调用；不修改任何 Antigravity 文件，无补丁、钩子或二进制改动；服务器完全在本机运行，除非用户主动将服务器对外暴露，否则提示词、聊天记录与文件不会离开本地网络；扩展不向第三方服务发送数据。源代码为 MIT 许可证，可完全审计。
本地 HTTP API 扩展在 https://localhost:3000（或用户配置的端口）暴露本地 HTTP API。除 /ping 外，所有端点均需携带 Authorization: Bearer <token> 头。token 即二维码 URL 中 ?token= 之后的值。完整 schema 见 openapi.yaml。
MCP 服务器 Antigravity Link 附带 MCP（Model Context Protocol）服务器，可让 AI 助手直接驱动 Antigravity 会话。需将相应配置加入 MCP 客户端配置（如 claude_desktop_config.json），token 同样取自二维码 URL 中 ?token= 之后的值。MCP 客户端连接前，扩展服务器必须已运行。资料列出的可用工具共 9 个。
适用场景
- 离开工位时在手机上继续查看与操控 Antigravity 的 AI 会话。
- 通过移动端上传文件、语音输入或停止生成。
- 在多个 Antigravity 窗口之间切换。
- 通过本地 HTTP API 或 MCP 服务器实现自动化集成，让智能体或外部工具以编程方式驱动会话。
限制与注意事项
- 默认仅限局域网访问；如需远程访问，需要借助 ngrok、wireguard 等隧道进行暴露，令牌认证与 HTTPS 保持不变。
- 需要 Antigravity 带远程调试标志启动，否则无法被发现。
- 自签名证书会触发浏览器警告，属预期现象。
- 上传文件保存后若未出现在聊天中，需在移动 UI 中切换到正确的活动实例。
- 卡在 "Initializing…" 表示服务器可达但聊天界面尚未捕获，可等待数秒让 CDP 连接初始化。
- 关于是否支持 iOS 与 Android：支持，移动 UI 可在任何现代移动浏览器中运行。
- 扩展是自包含的，自带 public/ 资源与 uploads/ 文件夹；若工作区中也存在 public/ 或 uploads/，扩展会优先使用工作区路径，因此不同工作区行为可能不同。
- 支持英文、日语、简体中文、繁体中文、韩语、德语、法语、西班牙语、葡萄牙语、俄语、意大利语、波兰语、土耳其语、越南语、印尼语、阿拉伯语共 16 种语言，阿拉伯语自动从右到左渲染，语言检测使用 navigator.language，无需配置。界面采用语义化 HTML、ARIA 角色、连接状态的 aria-live 区域、键盘导航与屏幕阅读器兼容标签。
版本更新（v1.0.20） 安全改进：完全移除 child_process 依赖；调试端点现在需要认证；所有 LS RPC 调用增加 localhost 防护。
