MapLibreParticleLab/docs/报告/STEP-097_A2_阶段验证记录_v1.md

STEP-097 A2 阶段验证记录 v1

状态：PARTIAL / 代码待完成与审查。本记录是 2026-09-26 Mac RDC 当前检查点，不是 A2 交付完成报告，不允许据此进入 B/C。

基线与执行事实

• 仓库：/Users/tei/dev/MapLibreParticleLab；分支 particle/main；起点 HEAD 72d93693842d0f98b1f26b4ec38d5b7389656184。Integration main 同步 HEAD 318f8ccf911ac3136c3086a1d14e61f83e2d4bce。
• A1 的 Android/FZG1 检查点已在 docs/报告/STEP-097_A1_Android专项验收报告_v1.md 记载；iOS runtime 按用户决定豁免，不能把未运行写为 PASS。
• GPT-6-Sol medium 可见 Codex 会话 6215.7445.codex 在 A2 修改 17 个已跟踪文件，并新增内部 GPU 数学头和定向测试；触及当期用量上限后停下，源码和测试仍未形成 A2 完整提交。未启动 B/C；不切换低能力模型冒充完成。
• 用户另有未跟踪 docs/40_任务/STEP-098_QBIN_V4单帧首显与八帧滚动缓存_Codex任务_v1.md，原样保留；与本轮 A2 无关。

已进行的独立检查

检查	真实结果
git diff --check	exit 0
OpenGL cmake --build build-step088-opengl --target mbgl-test-runner --parallel 3	exit 0，28 构建步骤，含新增测试目标
OpenGL 定向 ParticleGpuField.*:Source.RasterArrayV4*:ParticleFieldRuntime.ForecastClock*	16/16 PASS，exit 0
node shaders/generate_shader_code.mjs 连续两次	两次 exit 0、输出一致，未产生额外工作树路径
Metal host cmake --build build-step097-metal-host --target mbgl-test-runner --parallel 3	exit 0，224 步，耗时约 519.65 秒；没有运行 iOS 设备
Metal host 同样的跨 Core 定向测试	16/16 PASS，exit 0

上述编译器提示 Boost vendor 未使用参数、macOS deployment target 链接警告，实际构建 exit 0。测试仅证明已有入口的行为，不等于整项 A2 运行态 PASS。

改动内容尚需复核

• 04 单一 map/source owner 基于 monotonic tick 推进 ForecastClock，Android/iOS Bridge 只作为唤醒调度；
• 05 GPU 双端点身份包含 U/V、validity、空间网格、解释/版本信息；只变 mix 不应触发新上传；
• 06 内部 RGBA8 signed zero 从 byte 128 精确重建，零/量化误差有数学测试；未改变公开 QBIN 格式；
• 07 Mercator 东向 U 与北向 V 采用相同纬度度量及极区夹紧，GL/Metal 代码准备中。

这些是在工作树内可见的实现方向，不是已批准的最终行为。待 Codex 恢复后完成剩余审查、针对性修正和阶段文档，再由 RDC 独立编译/测试/设备验证，明确代码完成后才能进入 B。

原始证据及后续

忽略目录：artifacts/maplibre-particle/step097-a2-rdc/。包含未提交差异备份、新增测试文件备份、build-opengl.log、a2-focused-tests.log、shader-codegen1.log、shader-codegen2.log、build-metal-host.log、a2-metalhost-core-tests.log。本次没有 Android APK/ADB 验收、iOS runtime、Jest 或发布。

当前 Codex 模型用量预计 2026-09-26 13:54（日本时间）恢复；已安排 13:55 从现有会话与工作树核实后继续执行。继续时不得重复启动原有进程、不得先进入 B/C、不得覆盖未跟踪 STEP-098 或旧 .13 发布资产。