MapLibreParticleLab/docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v1.md

30-02 GPU Ping-Pong 与 Context Recreation 最小技术验证报告 v1

日期：2026-08-29

当前状态：BLOCKED

1. 阻塞结论

30-02 未进入 GPU 验证代码准备阶段。

docs/40_任务/30_02_GPU_PingPong与ContextRecreation验证指令书_v1.md 第 2 节规定：只有当前仓库存在 30-01 = PASS 的正式记录时，才允许开始 State A/B、Trail A/B、RenderTarget、Shader 或 context recreation 验证代码。

当前有效前置记录均为：

• docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v2.md：WAITING_MANUAL_VALIDATION；
• docs/报告/30_01_CoreRenderLayer接入验证_Codex完成报告_v2.md：WAITING_MANUAL_VALIDATION；
• 粒子开发记录.md：修复后的 Android OpenGL 编译和实机运行仍待用户。

仓库中不存在 30-01 正式 PASS 记录，也不存在 30-01 PASS commit。因此 30-02 前置条件未满足。

2. 本轮实际执行

• 完整读取 30-02 指令书并执行前置门槛检查；
• 读取当前 30-01 技术报告、Codex 完成报告和开发记录；
• 检查分支、HEAD、工作区、远端同步与 submodule；
• 生成本阻塞报告和对应 Codex 完成报告；
• 追加开发记录。

3. 未开始的验证项

以下项目因前置门槛阻塞，均未实现、未运行、无结论：

• State A/B GPU resource；
• State A/B ping-pong；
• Trail A/B offscreen RenderTarget；
• previous trail → next trail pass；
• Trail composite；
• 多 pass 同步与 hazard；
• viewport resize 资源重建；
• disable/enable GPU 生命周期；
• context/resource generation；
• Android EGL/surface context recreation 运行验证。

不得把“未开始”解释为 PASS 或 FAIL。

4. 代码与构建

• 30-02 Core/gfx/renderer/shader/Test App 代码修改：无。
• 通用 gfx 修改：无。
• 生产代码修改：无。
• 新依赖：无。
• 编译：未执行。
• Android/Gradle/ADB：未执行。
• APK/AAR 或其他产物：无。

5. 解除阻塞条件

用户必须先在最新 particle/main 上完成 30-01 修复后的 Android OpenGL 手工编译和实机验证，并回传足够证据，使 30-01 正式报告更新为 PASS。至少需要确认：

• validation Drawable/Tweaker 真正进入 translucent render pass；
• 同帧 viewport、zoom、bearing、pitch、projection 证据有效；
• pan、zoom、rotate、pitch、resize 正常；
• ACTIVE 持续 repaint；
• STATIC 停止验证层额外 repaint；
• 地图正常且无 RenderThread crash。

只有 30-01 报告与开发记录正式更新为 PASS 并提交后，才能重新执行 30-02。

6. 30-03 状态

不允许进入 30-03。30-02 当前为 BLOCKED，且其自身尚未开始。