MapLibreParticleLab/docs/报告/STEP-075_QBIN2_V4_Binding与ProjectionIdentity_Codex完成报告_v2.md

STEP-075 QBIN2 V4 Binding 与 Projection Identity Codex 完成报告 v2

日期：2026-09-13

已完成

• Projection content identity 改为显式 ProjectionFrameCoordinate(fieldID, validTimeMs) 加上 binding 实际消费的 T0/T1 selected plane 和 shared validity content identity。完整 generation/dataVersion 不再污染任一 projection identity。
• 对称 revision 隔离已由 Store 的 ReplacedRevision 公共路径验证：Scalar-only 仅改变 Color，U/V-only 仅改变 Particle，validity-only 同时改变 Color 与 Particle。
• InterpolationIncompatible 已从 Resolver 公共错误语义移除；FieldSeries submit 已 fail-closed 拒绝不兼容相邻 frame，合法公开 resolve 路径不可形成该状态。
• 独立 fieldKey/cadence、MIX identity/storage stability、DirectionAngle success/failure 与既有 V4/V3 回归均保持。

验证结果

• Linux OpenGL mbgl-test-runner 真实重建 PASS（输出节流）。
• 规定 GTest XML：50 tests、0 failures、0 errors；Binding 4、Runtime/Profile 11、QBIN Decoder/Ingress 24、V3 Source 11。
• git diff --check PASS。

未完成或无法验证

• Android Gradle/APK/ADB/Jest、iOS/Metal、Renderer/GPU、Host/JNI/RN、网络和真实 QBIN Golden 数据均按任务禁止或不在范围内，未执行且不能标记 PASS。
• 无已知实现阻塞；本任务不进入 STEP-076。

Git

• scoped commit：90d05f596a42c157502f9a2a5f20425c999cebab，fix: close STEP-075 projection identity audit。
• push 成功：3616daec3..90d05f596 particle/main -> particle/main。