Skip to content

feat: support Antigravity (CLI / extension) — first-class integration #2115

Closed

Description

@ranxianglei

来源: ranxianglei/billion-context#917 分析 留言板「想請問這款支援Antigravity CLI嗎? 或Antigravity extension」时发现。@Hiccup543 于 2026-09-27 在留言板提问,@ranxianglei 同日明确要求立项。

Request

First-class support for Google's Antigravity (CLI and/or its IDE extension) as a bili client — i.e. a bili antigravity launcher and/or a documented config lane, instead of relying on the generic transparent-proxy path.

Current state (verified on master b371bd0)

  • Zero references to Antigravity anywhere in src/ or docs; not in LAUNCH_CLIENTS (src/launcher.ts:149: pi, codex, claude, omp, opencode, hermes, dsh, codebuddy, qoder, trae, jcode, kimi, gemini, iflow, qwen, mcode, aider, copilot, amp, goose); no bili plugin install lane.
  • The generic path DOES exist and likely works today (board answer given to the requester): point Antigravity's model endpoint at http://localhost:8787/bili/<upstream> if it exposes a base-URL override, or route via HTTPS_PROXY + mitm.domains whitelist. Supported wire formats: OpenAI chat/completions, OpenAI Responses, Anthropic messages, Gemini generateContent (src/loop/ adapters).
  • So this issue is about FIRST-CLASS integration, not about making traffic flowable at all.

Design questions to resolve BEFORE implementation (feature-class triage — owner decides)

  1. What model transport does Antigravity actually use? Endpoint URL shape, wire format, auth headers, TLS pinning? Needs a real request capture or official docs — nothing verified from here yet.
  2. Does it expose a base-URL / custom-provider config (file path + schema) that a launcher could write, or only env vars, or neither (→ MITM-only lane)?
  3. CLI vs extension: same model channel, or different? Which one(s) should the first version cover?
  4. If its channel turns out to be WebSocket-only, this becomes dependent on feat: support wss:// (WebSocket) traffic — opt-in transparent passthrough now, protocol-aware compression later #1467 (wss passthrough) — check early, it changes scope entirely.

Suggested shape (indicative, not prescriptive)

  • Launcher entry antigravity in LAUNCH_CLIENTS plus launcher routing following existing per-client patterns (e.g. the kimi/gemini lanes), OR a minimal documented manual recipe if Antigravity's config surface doesn't fit the launcher model cleanly.
  • Regression test per AGENTS.md §7.2 (local proxy, listen(0) ports, no fixed-port assumptions); docs CONFIGURATION.md + README zh/en in sync (§7.3).
  • Reason in BOTH compression modes (§6) if any wire injection is involved; per §7.4 this is a feat → human merge regardless of test results.

Non-goals

Activity

  1. ranxianglei commented on Oct 4, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 Triage 完成 — feature 类,先给调查结论和建议方案,等你拍板再动手。

    0. 查重

    全库检索(含已关闭 issue/PR):无重复项。#2115 是 Antigravity 主题的唯一条目。仓库内现有唯一 "Antigravity" 字样是 src/registry-snapshot.json 里 Gemini evals 基准表的无关一行(harness: Antigravity),不构成既有支持。src/launcher.ts:149 LAUNCH_CLIENTS 确认无此客户端。

    1. 设计问题 Q1–Q4 的调查结果

    官方文档站从本环境不可达(多次超时),以下结论来自多个独立社区逆向项目(均公开、活跃,证据互相印证):

    Q1 传输层 — Antigravity 桌面端 = Electron 壳 + 闭源 Go "language server" 二进制,LS 经 HTTPS(HTTP/2,SSE 流式响应)直连 Google 内部 Cloud Code API(与 Gemini CLI/Jules 同族后端),鉴权是 Google 账号 OAuth(ya29. access token,refresh token 存于 state.vscdb,约 1h 过期)。线上 wire 形状 ≈ Gemini generateContent/streamGenerateContent(dvcrn/antigravity-oauth-proxy 正是把外部 Gemini/OpenAI 请求翻译进 Cloud Code 暴露成 /v1beta/models/{model}:streamGenerateContent)。模型池含 Claude/Gemini 订阅制模型。
    ⚠️ 重要风险信号(zhe-gu/zero-gravity 实测报告):Google 后端对来源做 TLS 指纹识别(BoringSSL/JA3/JA4 + H2 签名)+ 行为启发式(warmup/heartbeat、jitter);用非原生客户端打该后端的账号有被封记录(Pro 账号 ~3h 封禁案例)。bili MITM 转发意味着第二跳 TLS 由 Node 发起,指纹不是 Chrome/BoringSSL —— 这是本集成最大的实际风险,需要真机验证。

    Q2 配置面 — 不存在官方 base-URL / 自定义 provider 配置。三个独立社区项目(vahapogut/antigravity-add-model、frieser/antigravity-proxy、zero-gravity)全部靠 patch 已安装的 app(Electron runtime hook,Windows 上甚至要二进制 patch LS 的 model-list endpoint 端口 50999)才能加自定义模型。→ launcher 路线没有可写的目标面。

    Q3 CLI vs extension — 两个产品:独立 Electron 桌面 agent + VS Code 系 IDE extension。两者共用同一 LS + Cloud Code 通道(存储同为 state.vscdb 谱系,高置信推断但未逐字节验证)。若 MITM 可行,一份 recipe 同时覆盖两者。

    Q4 WebSocket — 无 WS-only 通道证据,纯 HTTPS/HTTP2+SSE。不依赖 #1467,scope 不变。

    2. 层次分析(根因 vs 现象)

    留言板的真实需求是「让 Antigravity 成为 bili 客户端」。bili 不修改 Antigravity 本体(不是我们的代码,且 patch 用户 app 违反 Install-Lane 契约精神、ToS 脆弱)的前提下,唯一可触达的集成点是网络层(MITM)。所以:

    • bili antigravity launcher 条目 = 不可行:没有可写配置面,加了也是空壳(theater)。
    • 「first-class」在此约束下能兑现的最大形态 = 文档化的 MITM recipe + 必要的小代码 affordance(如 host 发现/白名单),而不是 launcher。
    • 更深集成前有三个未验证项,全部需要一次真机 capture:① Go LS / Electron 是否 honor proxy env / 系统代理(zero-gravity 对 headless LS 被迫用 iptables UID 重定向,暗示至少 headless 模式不认 env proxy);② TLS 指纹/封号风险的实际表现;③ 确切 host/endpoint 与 gemini adapter 对 Cloud Code 请求的兼容性(auth header 形态、额外字段)。本环境无 Antigravity 安装、无 Google 账号,无法自行验证。

    3. 建议(明确推荐,非选择题)

    Phase 1(现在做,docs-only PR): CONFIGURATION.md(+ README zh/en 同步)新增 Antigravity 手工 MITM recipe:启用 mitm → 把 capture 到的 Cloud Code host 加入 mitm.domains → bili root CA 装入系统信任库 → Electron 侧走系统代理/--proxy-server,Go LS 子进程试 HTTPS_PROXY → 看 bili log 验证。附明确警告:上游行为未经官方确认;TLS 指纹风险 → 先用可弃用的 Google 账号测试;这不是 launcher 级支持。低风险、直接回答留言板问题、不碰 wire。

    Phase 2(evidence gate): 请 @Hiccup543 或任何装有 Antigravity 的人做一次 capture(devtools 有现成路径:Help > Toggle Developer Tools > Network > 发一条 prompt > Copy as cURL,或直接跑 Phase 1 的 MITM recipe 把脱敏后的 bili log 贴回来)。拿到确切 host/wire/proxy 行为后:干净 → 小 follow-up PR(host 进 discover/白名单、adapter 细节钉住);发现证书 pinning 或 WS-only → 该 lane 以通用 passthrough 为终点,issue 按「不支持更深集成」结论关闭。

    现在不做: launcher 条目、adapter 改动、任何 acp-kernel 变更(维持 issue non-goals)。

    请拍板:① 是否按 Phase 1 docs-only PR 开工;② 是否同意向 @Hiccup543 发 capture 请求(我会把具体步骤写清楚)。

  2. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    你是否下载了这个东西研究?

  3. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 没有下载过。目前结论的证据基础是:① 本仓库代码核实(launcher/mitm/adapter 路径);② 三个独立社区逆向项目的公开资料(README + 结构说明,只读未运行):zero-gravity(Rust,MITM 拦截 LS)、antigravity-add-model(Electron runtime patch)、antigravity-oauth-proxy(Go,Cloud Code API 翻译)。官方文档站从本环境不可达(多次超时)。所以「wire 形状」「proxy 是否被 honor」「TLS pinning」这几项目前是高置信推断,未真机验证 —— 这正是 Phase 2 设 capture 门的原因。

    我现在补一步能本地做的验证:下载官方 Linux 公开构建到工作区做纯静态分析(不解压运行、不登录、不产生任何真实流量):对闭源 Go language-server 二进制做 strings/符号分析,确认确切 endpoint host、gRPC service 名、JSON 还是 protobuf、是否引用 HTTPS_PROXY、有无证书 pinning 痕迹。做完把结果补进 thread,再定 Phase 1 文档的写法。开始执行。

  4. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 静态验证完成 —— 有重要发现,修正我之前的一个结论。

    做法:官方下载站 antigravity.google 从本沙箱不可达,但 GCS 发布桶可达。经 auto-updater manifest(Cloud Run 端点)解析到最新 Linux 构建 v2.19.1(build 6046815158665216),下载官方 .deb(149,993,504 字节,sha512 与 manifest 一致,可审计),解包后对闭源 Go 二进制 opt/Antigravity/resources/bin/language_server(174 MB,stripped)做纯静态 strings 分析。未运行、未登录、零真实流量。

    核实结果(推断 → 实证)

    # 问题 结论(证据)
    1 模型通道 language_server(闭源 Go),gRPC 服务 google.internal.cloud.code.v1internal.CloudCode,主 host cloudcode-pa.googleapis.com;方法含 StreamGenerateChat/GenerateChat/InternalAtomicAgenticChat/ListModelConfigs 等,REST 映射含 /v1internal:streamGenerateContent、/{$api_version}/{model=models/*}:streamGenerateContent
    2 端点覆盖面 ✅ 二进制内含 env 变量 CLOUD_CODE_URL:字符串 "Overriding CloudCodeServerURL via CLOUD_CODE_URL environment variable: %q" + "[AuthProvider] UpdateEndpointURL skipping update for custom"。这推翻我上一轮「无可写配置面」的判断 —— launcher 路线可行:启动时设 CLOUD_CODE_URL=http://127.0.0.1:<port>/bili/<cloudcode-host> 即可把模型通道直接指到 bili,无需 MITM/CA
    3 proxy 支持 ✅ 含 net/http.ProxyFromEnvironment → honor HTTPS_PROXY。MITM 兜底路线也不需要 iptables(zero-gravity 用 iptables 是 headless 独立跑 LS 的场景)
    4 TLS pinning ✅ 未发现任何 pinning/spki 痕迹,标准平台根证书池 → bili root CA 装入系统信任库即应被接受
    5 WebSocket ✅ 仅本地 IPC ws://127.0.0.1,无 wss 外发 → #1467 依赖排除
    6 wire 形态 ⚠️ 唯一剩余不确定项:gRPC 与 REST/SSE 两套都编译进去了(application/grpc + text/event-stream + application/json 均在)。模型流实际走哪条需一次真机观察。若纯 gRPC,CLOUD_CODE_URL 直指 bili 的 HTTP 服务不成立(bili 不做 gRPC 终结),主路线退为 MITM;社区活跃项目(dvcrn/antigravity-oauth-proxy)用 JSON REST 打同一后端且可用,REST 可行概率高
    7 产品形态 官方分发三件套:desktop(deb/AppImage)、Antigravity IDE(VS Code 系)、agy CLI(二进制内有 agy/antigravity-cli 引用,官方 CLI 安装器在 antigravity.google/cli/install.sh)。desktop 包内置 LS 并由 Electron 壳拉起(env 继承)→ IDE/CLI 大概率同通道,一份实现覆盖

    修订后的建议

    Phase 1 升级为真正的 bili antigravity launcher lane(不再是 docs-only):定位已安装的 antigravity/agy → 以 CLOUD_CODE_URL 指向 bili 启动,跟随现有 per-client 模式(kimi/gemini/qoder 系);CONFIGURATION.md + README zh/en 同步,并保留 HTTPS_PROXY+CA 的 MITM 配方作为文档化兜底。回归测试按 §7.2(listen(0)、本地 mock cloudcode 上游)。

    需要你拍板的一点:CLOUD_CODE_URL 是未公开文档的内部 env(公开资料查不到,只在二进制里),Google 未来版本可能移除或改语义。我的判断:可接受——性质同其他封闭客户端的 env 约定;即使失效,MITM 兜底路线仍在(launcher 检测覆盖失败时回退提示),lane 不会整体失效。

    仍建议向 @Hiccup543(或任何装有 Antigravity 的人)请求一次真机验证:① 设 CLOUD_CODE_URL 是否生效;② 模型流走 gRPC 还是 REST/SSE(devtools Network 一眼可见 content-type);③ 账号安全观察。若确认纯 gRPC,Phase 1 改为 MITM-lane-first。

    工作区暂留该构建产物供 Phase 1 继续取证(PR 前清理)。等你拍板开工。

  5. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 补两条取证结果(接上条):

    1. CLI 形态确认:官方安装器 curl -fsSL https://antigravity.google/cli/install.sh | bash(Windows install.ps1),二进制名 agy,装到 ~/.local/bin/agy;订阅制浏览器登录、无 API key env。多个独立来源(含 google-gemini/gemini-cli 仓库自身代码)确认:Gemini CLI 已于 2026-06-18 停服,agy 是其继任者。→ 本 lane 实际覆盖三个入口:agy CLI、desktop、IDE extension,且与既有 gemini lane 形成新旧接力关系(文档里要写清)。
    2. wire 问题维持开放:二进制内嵌了完整 gRPC 方法路径(24 个 /google.internal.cloud.code.v1internal.CloudCode/*,含 InternalAtomicAgenticChat)与 REST 模板两套,gRPC 客户端面确实在,但模型流实际选哪条仍需真机一次 devtools Network 观察定案(看 content-type: application/grpc vs text/event-stream)。这决定 Phase 1 主路线是 CLOUD_CODE_URL 直指还是 MITM-first,不阻塞拍板。

    其余不变:等你拍板 ① Phase 1 launcher lane 是否开工(含对未公开 env CLOUD_CODE_URL 的接受度);② 是否向 @Hiccup543 发真机验证请求。

  6. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    开工 搞一个再说 另外看是否内置插件能做吗

  7. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    [bot] 🏷 收到,开工。范围确认:

    1. Phase 1 = bili antigravity launcher lane:定位已安装的 agy CLI / desktop → 以 CLOUD_CODE_URL 指向 bili 启动(跟随现有 per-client 模式);CONFIGURATION.md + README zh/en 同步;回归测试 listen(0)。
    2. 内置插件问题:我会专门查证 Antigravity 模型通道上是否存在用户可加载的插件/扩展面(Electron 壳、LS 二进制、IDE extension 三个层面),结论随 PR 一起报。初步印象是模型通道在闭源 Go LS 内部、无 JS 插件 API,但先取证再下结论。

    @dsh 的 @Hiccup543 真机验证请求先不发——launcher 出来前没有可测物;PR 出来后如需要再向用户要一次真机确认(重点:模型流 content-type 定案 gRPC vs REST/SSE)。

  8. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    Phase 1 完成,PR 已开:#2134(Closes #2115)

    bili antigravity launcher lane,跟随现有 per-client 模式(gemini/iflow 系):定位 agy CLI(PATH / ~/.local/bin/agy / Windows %LOCALAPPDATA%\agy\bin)→ 以 CLOUD_CODE_URL=<proxy>/bili/https://cloudcode-pa.googleapis.com 启动;用户已导出自己的 CLOUD_CODE_URL 时改中继该值(claude relay-wrap 语义)。无 MITM、无 CA 安装。代理按 path 识别 wire::streamGenerateContent / :generateContent / :countTokens 走既有 google adapter,压缩行为与 bili gemini 一致;若服务端实际走 gRPC 方法 path(/google.internal.cloud.code.v1internal.CloudCode/*)则原样透传不压缩——优雅降级,确认可用 #1909 的按 lane protocol 声明修复。文档 README zh/en + CLIENTS zh/en 同步(含 Gemini CLI → agy 的继任关系、MITM 兜底配方);web UI launcher chip + i18n zh/en;新增 10 个测试(listen(0) 体系沿用 gemini-family 套件)。取证产物已按承诺在提交前清理。

    结构化七问:

    1. 是什么问题:Antigravity(Google,Gemini CLI 继任者)在 bili 没有一等集成路径,只能靠通用 /bili/ 前缀或手工 MITM 配方。
    2. 什么原因导致的:非缺陷、是能力缺失。「之前做不了」的根因是误判——三个社区项目都靠 patch app 加模型,据此推断「无可写配置面」。对官方 v2.19.1 二进制的静态分析推翻了该假设:闭源 Go language_server 内含未文档化的 CLOUD_CODE_URL env 覆盖(字符串 "Overriding CloudCodeServerURL via CLOUD_CODE_URL environment variable"),网络层因此有了直连点。
    3. 怎么修复的:机制上「借客户端自带的端点覆盖能力,把模型通道直接指向回环代理」——纯 env 注入、零文件写入、零 TLS 拦截;代理按 path 复用 google adapter 与整条压缩管线,未写任何新 adapter 代码。
    4. 是否有回归问题:无。diff 全部 additive(新分支/新 lane),逐项过过的既有行为:LAUNCH_CLIENTS 注册表、per-client 分发点(discoverRoutes / runLaunch / resolveClientCommand / launcherInjectMcp,antigravity 显式排入 v1 pure-wire 排除表)、ModelWindowScope 联合类型、web i18n key parity gate(Web UI 英文翻译开关(i18n)— 社区 PR #807 (@amirzamli) #1024)均验证过;未触碰任何既有 lane 的路由、阈值、时序、输出格式。唯一顺手小修:launcherInjectMcp 上方 JSDoc 块我改写段落内原有 1/2/3 空格混杂缩进,统一为该块主流的 * 两空格体例(cosmetic,已在 commit 内)。
    5. 是否破坏缓存:不涉及。会话身份、前缀缓存、压缩游标逻辑零改动;antigravity 会话只是既有会话机制下的新 lane。
    6. 是否改了设计方向:无转向。遵循 Install-Lane 契约(客户端 home 目录零写入)与双压缩模式框架(v1 pure wire,无 plugin mode——原因见下)。
    7. 是否引入了新的配置:无。不加 bili 配置字段/env/CLI flag;CLOUD_CODE_URL 是 Antigravity 自己的 env,bili 只读取它以决定中继什么(同 bili gemini 读 GOOGLE_GEMINI_BASE_URL 的先例)。

    内置插件可行性结论(你的第二问):Antigravity 有用户插件系统——~/.gemini/config/plugins/<name>/(plugin.json、hooks.json、mcp_config.json、rules/、skills/、JS sidecar SDK;/builtin/plugins/ 随产品内置;config.json plugins.<dir> 启用)。但逐面查证后:每个面都是 additive-only(工具、提示词、UI、事件回调),没有任何一个能拦截或改写模型请求/响应流——那条流完全留在闭源 Go language_server 内部,MCP 工具也够不到它的内部会话状态。所以压缩集成的上限 = 网络层(即本 PR 路线);plugin mode 在 v1 不可行。该结论已写入 CLIENTS 文档(Gemini 系一节收尾段)。

    剩余开放项(请真机验证):① CLOUD_CODE_URL 端到端是否真的接管模型流;② 模型流 content-type 是 REST/SSE 还是 gRPC——若 gRPC,本 lane 降级为透传不压缩,需后续 follow-up(代码已对两种情况都优雅处理,不会报错)。@Hiccup543 或任何装有 Antigravity 的用户:装上含本 PR 的版本跑一次 bili antigravity,devtools Network 看一眼模型请求的 content-type 即可定案;不想装 bili 的话,手动设 CLOUD_CODE_URL 观察也行。另外留意一点:若观察到异常封号/风控迹象请立即反馈——社区对同类工具有 Google 端 TLS 指纹+行为启发式的报告,本路线(回环明文 + bili 直连 Google)理论上不引入第二跳指纹,但未经真机确认。

    收工判定:feat 类,按 §7.4 需人工合并 → #2134。本地 typecheck + 定向套件绿(launcher-gemini-family 28/28、web-i18n/web-routing 14/14),全量回归 + build 交 CI(结果出来我再跟进)。

  9. ranxianglei commented on Oct 5, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    CI 跟进(接上条「结果出来我再跟进」):全绿。

    • 分支现状:a4442802(feat,rebase 后)+ 0fe15c22 / 177bf445(review 会话当场修的两个标注小修)。我对 rebase 做了一次内容核验:rebase 后的 feat patch 与我原始提交逐行一致,差异仅为行号偏移与 master 侧上下文改名(isDesignAbsorbed→isDesignBenign),零内容丢失;两个小修(cli.ts 帮助文本块内缩进对齐、launcher.ts 两处注释指针 CONFIGURATION.md→CLIENTS.md——配方确实只写在 CLIENTS.md,指针改对了)均合理且独立成 commit。
    • CI(head 177bf445):14 个检查组全部 success —— test 矩阵(u22/u24 × ubuntu/windows)、全部 hermetic e2e lane(codex/pi/opencode/dsh/WebSocket)、hermetic registry e2e、docs-sync、docs-coverage、kernel-guard、version-guard、build-artifact。
    • PR 侧:review 会话已发中期审核更新(方向认定成立 + 三项发现处置),最终七问结论在其 thread 收尾。

    收工判定不变:feat 类按 §7.4 需人工合并 → https://github.com/ranxianglei/billion-context/pull/2134(mergeable,无阻塞)。唯一开放项仍是真机验证 CLOUD_CODE_URL 端到端生效与模型流 content-type(gRPC vs REST/SSE),已在此前回复中向 @Hiccup543 发出请求;若确认为 gRPC,本 lane 优雅降级为透传,后续走 #1909 protocol 声明或 MITM 路线补压缩,不会报错。

  10. added a commit that references this issue on Oct 5, 2026
  11. higekibaka commented on Oct 14, 2026

    @higekibaka

    真机端到端验证结果已出(CLOUD_CODE_URL 生效、模型流确认为 HTTP POST + REST/SSE,同时定位到了 CloudCode v1internal 外层请求/响应信封及 sessionId 恒为 FNV-1a 空串哈希导致的 HTTP 400 问题),完整抓包结构与修复方案详见新开 Issue:#3129

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions