Skip to content

docs(AntigravityGateway): 纠偏通道③覆盖范围——桌面 2.32.1 模型流不经 CLOUD_CODE_URL,模型级统计指引收敛至通道② - #299

Merged
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
docs/antigravity-channel3-scope
Nov 16, 2026
Merged

ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
docs/antigravity-channel3-scope

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

变更摘要

2026-11-16 桌面 Antigravity 2.32.1 + v0.6.2 真机验证(Issue #292)发现:CLOUD_CODE_URL 通道实际只接管控制面流量(loadCodeAssist / fetchUserInfo / fetchAvailableModels / cascadeNuxes 等),模型调用流不经该 hook——Electron 主进程以硬编码常量 LS_API_SERVER_URL='https://generativelanguage.googleapis.com' 构造 --api_server_url 注入 language_server(app.asar 内 baseLsBaseArgs(),无 env / settings 覆写点),模型请求以 /v1beta/models/{model}:generateContent 直连 Google;Orca 托管 agy_acp_server runtime 二进制 0 处 CLOUD_CODE_URL 引用。本 PR 将文档口径对齐真机事实:

  • docs/arch/config-reference.md §12:端点描述改为「Cloud Code v1internal 流量」,新增「覆盖范围」块(2026-11-16 实测结论 + 通道②指引)
  • docs/guide/api-reference.md §14:补覆盖范围注意(控制面 only,unknown / 0 token 属预期)
  • docs/user-guide.md §4.8:方式 A / B 标注各自统计能力,模型级统计指引收敛至方式 B(GOOGLE_GEMINI_BASE_URL → /api/gemini)
  • docs/research/antigravity-client-feasibility.md:文首新增真机修正块,§2 矩阵③行裁决更新
  • docs/.agents/issue.md:登记 I-011(表因根因 / 处理方式 / 后续防范)

动机

v0.6.2 用户报障「前端只见 Antigravity 调用次数,模型 / Token 指标全空」。三层取证(隔离实例 e2e、生产库、二进制 / asar 逆向)确认 proxy 侧 gateway / 记账 / Dashboard 渲染均无缺陷,属调研阶段引用的社区旧版逆向结论过时导致文档口径失真;模型级统计需明示走通道②。

验证

  • e2e(隔离实例 + mock v1internal 上游,真实信封 / SSE 多行 data: / CRLF):model / tokens / session_key 全部落账,/api/dashboard/{summary,timeline,sessions} 数据齐全,实机浏览器渲染 Overview 与 Sessions 正常(图例 agy | antigravity、MODELS / TOKENS / CLIENT 列齐全)
  • 生产库取证:antigravity 行全为控制面端点,零 generateContent;lsof 实证 LS 直连 Google 443
  • 文档-only 变更,无代码改动;纯 Markdown,无 lint 门禁

风险点

  • 无行为变更;channel ②(/api/gemini)为零代码既有能力,无需配套实现
  • 桌面模型流捕获的 MITM / 改包路线属产品级投入,本 PR 不涉及

🤖 Generated with Claude Code

…型级统计指引收敛至通道②;

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ThreeFish-AI merged commit 15e4125 into feature/1.x.x Nov 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant