MapLibreParticleLab/docs/报告/STEP-055_Float_State_fail-closed小修复_Codex完成报告_v1.md

STEP-055 Float State fail-closed 小修复 Codex 完成报告 v1

Starting HEAD：f8027312e6e06d539e9ad222b60ac9a496b1758d

修改

仅修改 src/mbgl/renderer/layers/render_particle_validation_layer.cpp。

createValidationTarget() 对整个 target 创建与接线路径捕获：

• catch (const std::exception&)：记录 stage=exception error=...，返回空 target；覆盖 std::runtime_error、std::bad_alloc 等标准异常。
• catch (...)：记录 stage=unknown_exception，返回空 target。
• 可渲染性或 texture validation 不通过：记录 stage=validation，返回空 target。

因此异常不会从 Particle Validation target 创建路径继续传播，也不会静默降级为 UnsignedByte。

冻结语义

State A/B 仍为 TextureChannelDataType::Float；Trail A/B 仍为 TextureChannelDataType::UnsignedByte。未修改 canonical Field、Timeline、Runtime Window、WeatherColorLayer、REAL WEATHER UI 或 visualSpeedScale=6000。

验证

• Linux OpenGL CMake 精确编译 render_particle_validation_layer.cpp：PASS。
• 既有非 Jest style_layer.test.cpp 精确编译：PASS。
• git diff --check：PASS。
• Android Gradle/APK/ADB/设备测试：未执行。
• Jest：未执行。

Git

功能提交：7f66b10013fd851fc819c1fea580e0e19f4c934d（fix: fail closed on particle target creation exceptions）。

已成功 push 至 origin/particle/main；本报告为随后的文档元数据提交。用户既有未跟踪文件未修改、未 stage。

最终状态：IMPLEMENTED / WAITING_ANDROID_VALIDATION。