From 97aa019f6ff07d1b91e17c46ad0e6e6c0cd339d5 Mon Sep 17 00:00:00 2001
From: OpenAI Codex <codex@local>
Date: Sat, 5 Sep 2026 09:22:57 +0800
Subject: [PATCH] docs: record particle target fail-closed fix

---
 ..._State_fail-closed小修复_Codex完成报告_v1.md | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 docs/报告/STEP-055_Float_State_fail-closed小修复_Codex完成报告_v1.md

diff --git a/docs/报告/STEP-055_Float_State_fail-closed小修复_Codex完成报告_v1.md b/docs/报告/STEP-055_Float_State_fail-closed小修复_Codex完成报告_v1.md
new file mode 100644
index 000000000..9b2a9b985
--- /dev/null
+++ b/docs/报告/STEP-055_Float_State_fail-closed小修复_Codex完成报告_v1.md
@@ -0,0 +1,35 @@
+# 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**。