MapLibreParticleLab/docs/50_Step记录/STEP-047_Runtime_Timeline与Playback_v2.md

STEP-047 Runtime Timeline 与 Playback（集中修复）

状态：IMPLEMENTED / WAITING FOR ANDROID RE-VALIDATION

Android Validation Round 1

Round 1 结论：PARTIAL / NEEDS FIX。

已通过：Core Timeline READY、自动 MIX、自动 window advance、OLD_T1 → NEW_T0 reuse、紧凑控制台、MAP/MORE 基础回归、VIS Core property 调用链。

失败或无法充分验证：Pause/Resume UX、速度可视性、Seek 状态语义、GAP/INVALID/RECOVER 入口、播放中 VIS、COLOR 可达性、Preload/Cache 可观测性。

本轮修复

• Validation 逻辑时间窗口从 4 秒扩展到 40 秒，6 snapshot 总时长约 200 秒；Core clock 不使用 Android timer。
• PLAYING→PAUSED 和 PAUSED→PLAYING 保留 cursor；END 时 PLAY 明确从 start restart；END/WAITING 拒绝日志明确。
• PLAYING 的非 END seek 保持 PLAYING；PAUSED seek 保持 PAUSED；Seek END 进入 ENDED；日志记录状态、cursor、目标窗口和 mix。
• TIME 菜单直接提供 NORMAL、GAP、INVALID NEXT、RECOVER NEXT；GAP/INVALID 在边界 fail-closed，recover 恢复此前播放/暂停语义。
• VIS 把 COLOR 放到第二项；Validation 调节步长扩大，状态行即时显示 W/L/O/T/F/C；状态行同时显示 Timeline state/speed。
• 预加载仍是 Source 的有界 CPU snapshot cache（容量 8，绝不预上传未来 GPU Field）；READY 输出 TIMELINE_PRELOAD，窗口推进输出 TIMELINE_CACHE_HIT。

不变项

自动 MIX、GPU T0/T1 window、OLD_T1 → NEW_T0 reuse、只上传新 T1、无 Style reload/simulation reset/trail clear 的正常推进路径，及 STEP-046 visual property-only 均未改动。