docs: finalize 30-01 validation as pass
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled

This commit is contained in:
OpenAI Codex
2026-08-29 21:12:32 +08:00
parent 25072cff1b
commit b34b0a3e22
3 changed files with 130 additions and 0 deletions

View File

@@ -0,0 +1,55 @@
# 30-01 Core RenderLayer 接入最小技术验证报告 v3
日期:2026-08-29
当前状态:`PASS`
本版本仅回填用户已经完成的 Android OpenGL 人工验收结果;不重新运行 30-01,不修改 30-01 代码。
## 1. 验证范围
30-01 验证独立 Core `ParticleValidationLayer/RenderParticleValidationLayer` 能否通过 MapLibre 正式 Style、RenderTree、LayerGroup 与 translucent pass 链接入;从当前 render frame 获得 Transform;并在 ACTIVE/STATIC 状态下分别持续或停止验证层额外 repaint。
未实现正式粒子、Field、GPU ping-pong、Trail、Mask、Vulkan 或 iOS。
## 2. Codex 静态确认
此前 v1/v2 已确认并记录:
- 独立 source-less Core Style Layer 经 LayerManager、RenderOrchestrator、RenderParticleValidationLayer 与 LayerGroup 进入 `RenderPass::Translucent`;
- validation Drawable Tweaker 直接读取当前 `PaintParameters`、`TransformParameters` 与 `TransformState`;
- ACTIVE 经 MapLibre `needsRepaint` 链请求下一帧,STATIC 停止验证层额外请求;
- Android Test App 提供 `Particle Core Layer Validation` 入口;
- DrawableBuilder 生命周期错误已由 `builder->flush(context)` 修复。
这些是代码与先前检查的静态事实,不替代设备运行证据。
## 3. 用户实际运行确认
用户已明确确认下列 Android OpenGL 实际验收事实:
- 构建成功;
- `Particle Core Layer Validation` 已实际运行;
- 30-01 验证结果为 OK;
- 独立 Core RenderLayer 接入通过;
- ACTIVE / STATIC repaint 行为达到验证目的;
- 同帧 Transform,以及 pan、zoom、bearing、pitch、resize 的 30-01 验证范围满足要求;
- 可以正式判定 30-01 为 PASS。
用户未提供额外逐帧数值、截图或完整 logcat,因此本报告不虚构这些证据。
## 4. 本次回填操作
- 未修改 Core、gfx、RenderLayer、Test App 或 Shader;
- 未重新编译;
- 未重新运行 Android;
- 未执行 ADB;
- 仅新增本报告、对应 Codex 完成报告,并追加开发记录。
## 5. 结论
`30-01 Core RenderLayer 接入验证 = PASS`。
30-02 的前置门槛现已满足,允许在用户后续明确要求时重新执行原 30-02 指令书。
此前 30-02 v1 的 `BLOCKED` 记录继续保留,准确反映当时 30-01 正式状态尚未回填;它不代表 GPU/gfx 架构验证失败。