Skip to content

[PR] fix(v1internal): Fix Antigravity/CloudCode lane pre-compression summary request envelope wrapping and response unwrappin | fix(v1internal): 修复 Antigravity/CloudCode 车道预压缩摘要请求信封包装与响应解包 (Fixes #7286) - #7287

Open
x1051445024 wants to merge 1 commit into
ranxianglei:masterfrom
x1051445024:2026-11-19_fix-v1internal-preflight-envelope

Conversation

@x1051445024

Copy link
Copy Markdown

Fixes #7286

概述

修复 Antigravity / Google Cloud Code (v1internal) 车道在触发预压缩(preflightCompressIfNeeded,含窗口溢出预压缩、上游 400 后的 overflowRefold 重折叠、以及同通道模型摘要)时,因摘要子请求未包装 v1internal 外层信封且摘要响应未解包 chunk.response 而导致的 HTTP 400 / 502 (preflight_compress_failed) 问题。

根因

  1. 出站摘要请求缺少 v1internal 外层信封:
    • src/server/handle.ts 在入口调用 unwrapV1Internal(parsed) 拆出 v1Meta({ project, requestId, model, userAgent, requestType })与 inner,并在 forward() 中使用 wrapV1Internal(..., v1Meta) 重新包回外层信封。
    • 但 src/server/handle.ts 调用 preflightCompressIfNeeded 时未传入 v1Meta,导致 src/preflight.ts 的 requestSummary() 直接将标准 Gemini 格式的顶层 { contents, systemInstruction, generationConfig } 发送至 /v1internal:streamGenerateContent,被 CloudCode 以 HTTP 400 (Unknown name "contents", Unknown name "systemInstruction") 拒绝。
  2. 入站摘要响应未解包 chunk.response:
    • CloudCode /v1internal:* 返回的每个 SSE data: 帧和 JSON 响应均包裹在 { response: <GenerateContentResponse>, traceId, metadata } 中;而 src/preflight.ts 的 googleChunkText(chunk) 与 src/external-summary-http.ts 的 completed("google", ...) 直接访问顶层 candidates / promptFeedback,导致信封形态的摘要响应无法提取出文本。

修改内容

  • src/server/handle.ts & src/server.ts:在 preflightCompressIfNeeded 中接收可选的 v1Meta 并透传至 preflightDeps。
  • src/preflight.ts:
    • PreflightDeps 新增可选字段 v1Meta?: Record<string, unknown>。
    • requestSummary 在 deps.v1Meta 存在时调用 wrapV1SummaryPayload(rawPayload, deps.v1Meta) 包装 { ...cleanMeta, request: rawPayload }(并剥离可能残留的 continuationToken / continuation_token,防止摘要子请求继承主请求续传令牌)。
    • googleChunkText 新增 unwrapGoogleResponseChunk,在满足 v1internal 响应信封特征(存在对象类型 response 且顶层无 candidates / usageMetadata / promptFeedback)时自动解包 chunk.response。
  • src/external-summary-http.ts:completed("google", ...) 同步支持解包 item.response 信封。
  • tests/issue3129-v1internal.test.ts:
    • 新增正反双向测试:验证 v1internal 预压缩摘要请求信封包装、continuationToken 剥离、信封响应解包及端到端折叠成功;同时验证标准 Google /v1beta/models/... 端点仍发送无外层 .request 信封的原始载荷(负向断言)。

验证

  • npm run typecheck 通过(0 errors)
  • npm run build 通过(dist-import-annotations: OK, dist-external: OK)
  • npm run check:unused-exports、npm run check:test-import-graph、node tools/check-architecture-docs.mjs 全部通过
  • node --import tsx --test tests/issue3129-v1internal.test.ts tests/issue3280-v1internal-loop-rounds.test.ts tests/preflight.test.ts tests/external-summary-http.test.ts 全部通过

@ranxianglei ranxianglei changed the title fix(v1internal): 修复 Antigravity/CloudCode 车道预压缩摘要请求信封包装与响应解包 (Fixes #7286) [PR] fix(v1internal): Fix Antigravity/CloudCode lane pre-compression summary request envelope wrapping and response unwrappin | fix(v1internal): 修复 Antigravity/CloudCode 车道预压缩摘要请求信封包装与响应解包 (Fixes #7286) Nov 19, 2026
@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

查重: 不重复。 #7286 是本 PR 的源 bug 报告;检索 open+closed 的 v1internal/preflight 相关条目,无其他在途 PR 修同一「预压缩摘要子请求信封」问题。相邻但不相同:#3129(已关)修的是主请求/响应信封拆包,本 PR 修的是 preflight 摘要子请求这条 #3129 漏掉的旁路;#6963/#6969 是 1M 窗口 + continuationToken 续传腿问题,机制不同。

标签: bug + antigravity + scope/wiring + p1(与 #6963 同车道同 scope 口径;p1 依据 owner 2026-10-19 修订——该 lane 上下文超窗后 preflight 摘要必 400 → 每轮 502 preflight_compress_failed,会话无法继续 = 会话不可恢复类)。已打在 #7286 与 #7287 上。

初审状态(进行中,CI 跑完给完整八问):

  • 方向关:bug 真实存在,已在代码层面钉死——requestSummary 直发 deps.url(v1internal 端点)且载荷是标准 Gemini 顶层 contents 形;googleChunkText 只读顶层 candidates,信封响应 { response, traceId, metadata } 提取不出文本。
  • 本地定向验证(仅 PR 声明的 4 个测试文件,非全量):typecheck 0 错、build OK、89 测试全过;且两个新测试在修复前的 master 上失败——E2E 测试精确复现报告的 502 preflight_compress_failed,单测失败于信封解包缺失。回归测试有牙。
  • 回归面初判:标准 Google 车道 v1Meta 恒为 undefined → 载荷字节级不变(负向 E2E 对照已覆盖);解包条件保守(顶层已有 candidates/usageMetadata/promptFeedback 时不解包);preflightCompressIfNeeded 新参在尾部且全仓仅一个调用点。
  • CI:30 项 check 运行中,0 失败(截至本条)。

@ranxianglei

Copy link
Copy Markdown
Owner

🤖 Powered by ework · qwen3.8-27b

(ai: vllm-qwen/qwen3.8-27b)

PR #7287 审核结论(完整八问)

审核对象:外部贡献者 @x1051445024 的 PR,修复 #7286(Antigravity/CloudCode v1internal 车道预压缩摘要请求/响应信封问题)。head c1d290a,base = 当前 master(0 behind)。5 文件 +175/−4。

一、是什么问题

Antigravity / Google Cloud Code(v1internal)车道的预压缩(preflightCompressIfNeeded:窗口溢出预压缩、上游 400 后的 overflowRefold 重折叠、同通道模型摘要)完全失效:摘要子请求不带 v1internal 外层信封被 CloudCode 以 400(Unknown name "contents")拒绝,摘要响应信封 {response, traceId, metadata} 又解不出文本,会话在窗口溢出后每轮 502 preflight_compress_failed,不可用。

二、什么原因导致的

handle.ts 入口 unwrapV1Internal 把请求拆成 meta + inner,forward() 用 wrapV1Internal 包回外层信封——但 preflightCompressIfNeeded 调用点(src/server/handle.ts:3403)没传 v1Meta,src/preflight.ts 的 requestSummary 把标准 Gemini 顶层 {contents, systemInstruction, generationConfig} 直接发到 /v1internal:streamGenerateContent;入站侧 googleChunkText / external-summary-http.ts 的 completed() 只读顶层 candidates/usageMetadata,信封形态提取为空。根因是「摘要子请求游离在 v1internal 信封协议之外」,PR 修在源头(出站构造处包、入站解析处解),不是掩盖。

三、影响范围与严重程度

仅 v1internal(Antigravity/CloudCode)车道的 preflight 摘要路径:窗口溢出后会话每轮 502,完全不可用(p1 会话不可恢复类,标签已打)。标准 Google /v1beta 车道、其他车道、in-loop 压缩(模型自写摘要、无 HTTP 摘要调用)均不受影响。

四、怎么修复的

出站:v1Meta 透传至 preflightDeps,requestSummary 构造载荷时经 wrapV1SummaryPayload 包成 {...cleanMeta, request: payload},并剥离 continuationToken/continuation_token(unwrapV1Internal 会把主请求顶层所有字段——含续传令牌——收进 meta,摘要子请求不得继承)。入站:unwrapGoogleResponseChunk / completed() 在满足信封特征(response 为对象且顶层无 candidates/usageMetadata/promptFeedback)时解包 chunk.response——条件保守,标准形态字节不变。

五、是否有回归问题

逐项审过既有行为:

  • 标准 Google 车道:v1Meta 为 undefined → 载荷与响应处理字节不变(PR 内负向 E2E 控制断言标准 /v1beta 摘要请求无 .request 信封);
  • 解包条件:标准 chunk 无 response 字段,不触发;
  • API 面:preflightCompressIfNeeded 仅尾部加可选参数,全仓唯一调用点;
  • overflowRefold:重跑 runPreparedPipeline → 同一调用点 → 同一修复覆盖(src/server/handle.ts:3575-3583);
  • in-loop 压缩:无 externalSummary 配置 → applyRanges 用模型自写摘要(无 HTTP);有配置 → 调用户配置的端点(非车道 URL)→ 不受影响;
  • 无 config surface / 持久化 / kernel / model-facing 文案 / 缓存重试策略变更。
    结论:无回归。

六、是否破坏缓存

不涉及——未触碰 prompt cache、重试、增量游标、去重键。

七、是否改了设计方向

不涉及——复用既有 wrapV1Internal/unwrapV1Internal 信封协议,无新架构、无新数据流。

八、是否引入了新的配置

不涉及——无新 env / config / 默认值。

验证

  • 本地:typecheck 0 errors;build OK;4 个定向测试文件(issue3129-v1internal / issue3280-v1internal-loop-rounds / preflight / external-summary-http)89 pass / 0 fail。
  • 回归牙:在 origin/master 上跑 PR 的两个新测试——均失败,E2E 恰好以 issue 报告的 502 preflight_compress_failed(context ~14399 > window 10000)失败,复现原 bug;PR head 上全绿。
  • CI(head c1d290a,实时核对):11 个 test 分片(ubuntu 22×3 / ubuntu 24×3 / windows 22×5)全部 success,全部静态 guard success,0 failure;e2e 真实客户端套件按三层 CI 设计 skip(需 ci:full 标签触发)。
  • 既有行为清点:见第五问逐项结论。

遗留风险(非阻断)

测试的 fake upstream 只建模了 CloudCode 的顶层字段拒绝;摘要请求的 inner 载荷是标准 Gemini 形态,不含 CloudCode 特有的 inner 字段(主请求 inner 有 sessionId,摘要 inner 没有)。若真实 CloudCode 要求摘要请求 inner 携带 sessionId 等字段,修复在生产仍可能失败 → 建议 issue 报告者合并后在真实 Antigravity 设备上确认一次。

小注(不阻断)

4 行解包条件在 src/preflight.ts(具名函数)与 src/external-summary-http.ts(内联)各一份——循环导入约束(preflight.ts 已 import external-summary-http.ts,反向会成环)使抽公共不划算,可接受。

判定

可合。方向对(修根因不修症状)、代码质量达标(无需 ②a 对齐重构)、测试双向有牙、CI 全绿、无回归。合并由 owner 决定;合并后请报告者做真机验证(见遗留风险)。

This branch has not been deployed

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

Projects

None yet

2 participants