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

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。