# 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` 发布资产。