From b34b0a3e22f91a0101b0bbd02190e3384f6ef2ae Mon Sep 17 00:00:00 2001
From: OpenAI Codex <codex@local>
Date: Sat, 29 Aug 2026 21:12:32 +0800
Subject: [PATCH] docs: finalize 30-01 validation as pass

---
 ...01_CoreRenderLayer接入最小技术验证报告_v3.md | 55 +++++++++++++++
 ..._CoreRenderLayer接入验证_Codex完成报告_v3.md | 67 +++++++++++++++++++
 粒子开发记录.md                               |  8 +++
 3 files changed, 130 insertions(+)
 create mode 100644 docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v3.md
 create mode 100644 docs/报告/30_01_CoreRenderLayer接入验证_Codex完成报告_v3.md

diff --git a/docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v3.md b/docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v3.md
new file mode 100644
index 000000000..ca0811323
--- /dev/null
+++ b/docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v3.md
@@ -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 架构验证失败。
diff --git a/docs/报告/30_01_CoreRenderLayer接入验证_Codex完成报告_v3.md b/docs/报告/30_01_CoreRenderLayer接入验证_Codex完成报告_v3.md
new file mode 100644
index 000000000..40e5e26c7
--- /dev/null
+++ b/docs/报告/30_01_CoreRenderLayer接入验证_Codex完成报告_v3.md
@@ -0,0 +1,67 @@
+# 30-01 Core RenderLayer 接入验证 Codex 完成报告 v3
+
+日期：2026-08-29
+
+任务：30-01 用户人工验收 PASS 状态回填
+
+当前结论：`PASS`
+
+## 1. 回填背景
+
+30-01 v1/v2 原状态均为 `WAITING_MANUAL_VALIDATION`，原因是当时尚未取得 Android OpenGL 运行证据。
+
+用户随后已完成 Android OpenGL 构建与实际运行验收，并明确确认结果为 OK/PASS。本次只将该已确认事实回填到正式项目文档和 Git 历史。
+
+## 2. 用户实际确认与结论
+
+用户已确认：
+
+- Android OpenGL 构建成功；
+- Particle Core Layer Validation 实际运行；
+- Core RenderLayer 接入验证 OK；
+- ACTIVE/STATIC repaint 达到验证目的；
+- Transform、pan、zoom、bearing、pitch、resize 的 30-01 范围已满足。
+
+据此，`30-01 = PASS`，并允许进入 30-02。
+
+未伪造用户未提供的逐帧日志、性能值、截图或额外设备细节。
+
+## 3. Git 基线
+
+- 分支：`particle/main`。
+- 任务开始 HEAD：`25072cff1b3a538af361b572cd7e79cd4a471b07`。
+- 该 30-02 阻塞提交已保留，未删除、reset、rebase 或修改。
+- 开始时工作区无修改；本地与 `origin/particle/main` 同步。
+- 公开远端：`ssh://git@192.168.200.230:2222/tei/MapLibreParticleLab.git`。
+- 远端分支：`particle/main`。
+- commit message：`docs: finalize 30-01 validation as pass`。
+- 本次 commit hash 与 push 后远端 HEAD：因本报告与状态回填同一提交，在最终回复记录，避免自引用。
+
+## 4. 实际修改文件
+
+- 新增 `docs/60_测试/30_01_CoreRenderLayer接入最小技术验证报告_v3.md`；
+- 新增本完成报告；
+- 追加 `粒子开发记录.md`。
+
+未修改 30-01 Core/gfx/RenderLayer/Test App/Shader 代码，也未修改历史 30-02 BLOCKED 文档。未创建或修改 Step。
+
+## 5. 未执行事项
+
+- 未重新编译；
+- 未重新运行 Android；
+- 未执行 ADB；
+- 未重新测试 30-01；
+- 未开始 30-02 GPU 实现；
+- 未开始 30-03。
+
+## 6. 30-02 解锁
+
+30-02 v1 阻塞的唯一前置原因是当时仓库没有 30-01 PASS 正式记录。本报告与技术报告 v3 将该前置状态更新为 PASS，因此 30-02 现在可以在用户后续明确要求时重新执行。
+
+30-02 v1 BLOCKED 历史报告保持不变；后续重新执行 30-02 时必须新建 v2 报告反映“前置阻塞已经解除”。
+
+## 7. 最终结论
+
+30-01 正式完成，状态为 `PASS`。
+
+允许进入 30-02；本任务在 PASS 回填后停止，不自动继续执行 30-02。
diff --git a/粒子开发记录.md b/粒子开发记录.md
index 7ea7ac768..ea10c6dee 100644
--- a/粒子开发记录.md
+++ b/粒子开发记录.md
@@ -72,3 +72,11 @@
 - 当前 30-02 状态为 `BLOCKED`；不允许进入 30-03。
 - 阻塞报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v1.md`。
 - Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v1.md`。
+
+## 2026-08-29 — 30-01 Core RenderLayer 接入验证（用户验收 PASS 回填）
+
+- 用户已完成 Android OpenGL 构建和 `Particle Core Layer Validation` 实际运行验收，明确确认结果为 OK/PASS。
+- 30-01 正式状态由 `WAITING_MANUAL_VALIDATION` 更新为 `PASS`；Core RenderLayer 接入、ACTIVE/STATIC repaint、同帧 Transform 及 pan/zoom/bearing/pitch/resize 验证范围均由用户确认满足要求。
+- 本次只回填验收状态：未重新修改 30-01 代码、未重新编译、未重新运行 Android、未执行 ADB。
+- 30-01 正式完成，允许重新开始 30-02。
+- 30-02 v1 的 `BLOCKED` 历史记录继续保留；它反映当时 30-01 正式 PASS 尚未回填，不代表 GPU/gfx 架构验证失败。