docs: record staggered particle lifecycle fix

docs/报告/STEP-055_粒子生命周期错峰小修复_Codex完成报告_v1.md

@@ -0,0 +1,21 @@
+# STEP-055 粒子生命周期错峰小修复 Codex 完成报告 v1
+
+Starting HEAD：`c7acefcb21840bc1db736a5f061ba39b18ba2c36`。
+
+修改文件：
+
+- `src/mbgl/renderer/layers/render_particle_validation_layer.cpp`
+- `shaders/particle_gpu_validation.fragment.glsl`
+- `include/mbgl/shaders/gl/particle_gpu_validation.hpp`（generator 输出）
+
+生命周期基础寿命为 `14400` simulation seconds；在 `1200` simulation seconds/real second 下为 12 real seconds。首次初始化 age 使用稳定 `particleHash(v_uv + vec2(71.19, 29.47)) * maxAge` 错峰；每 slot 的 `maxAge` 使用另一稳定 hash 在基础寿命的 `0.75–1.25` 倍之间抖动。普通运行时 respawn 保持 age=0。
+
+日志将 `activeSlots` 更正为 `configuredSlots`，并明确 `readback=disabled`，不将配置数伪称为 GPU 实测 active 数。
+
+未改动 `VisualSimulationSecondsPerRealSecond=1200`、State Float、Trail UByte、真实 previous→current segment、view-space Trail、time-based fade、canonical Field、Timeline、Runtime Window、WeatherColorLayer 或 REAL WEATHER UI；未新增 GPU readback。
+
+验证：shader generator、Linux OpenGL 受影响 C++ 精确编译、既有非 Jest `style_layer.test.cpp` 精确编译、`git diff --check` 均通过。未执行 Android Gradle/APK/ADB/设备测试或 Jest。
+
+功能提交：`7929052c5828ca86e97a830b75168d34ea516c19`（`fix: stagger particle lifecycle respawn`），已成功 push 至 `origin/particle/main`。本报告随后的文档提交不改变功能实现。
+
+最终状态：**IMPLEMENTED / WAITING_ANDROID_VALIDATION**。