diff --git a/docs/报告/STEP-055_粒子生命周期错峰小修复_Codex完成报告_v1.md b/docs/报告/STEP-055_粒子生命周期错峰小修复_Codex完成报告_v1.md new file mode 100644 index 000000000..2ce6020b7 --- /dev/null +++ b/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**。