Files
MapLibreParticleLab/docs/50_Step记录/STEP-085_V4_Renderer性能修复_v1.md
tei 70f112ea27
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
fix: close STEP-085 V4 renderer efficiency
2026-09-19 22:16:36 +09:00

2.4 KiB
Raw Permalink Blame History

STEP-085 V4 Renderer 性能修复 v1

状态:完成(BUILD_NOT_RUN_BY_CODEX — WAITING_FOR_RDC)

基线

  • 机器:Mac-mini-tei.lan。
  • worktree:/Users/tei/dev/MapLibreParticleLab-step085。
  • branch:step/085-v4-render-efficiency。
  • STEP-085 Start HEAD:bc6b8dd84b4c10e5263d61832661508c02d84d88。
  • STEP-084 Final HEAD:bc6b8dd84b4c10e5263d61832661508c02d84d88,已进入 origin/particle/main。

本轮结果

  • V4 WeatherColor PAUSE/静态 window 不再因缺少 legacy timeline 永久 needsRepaint()。
  • V4 Particle 使用 Source-owned backend-neutral cadence;30/60 gate simulation,AUTO 保持 animation-frame 语义。
  • Forecast PAUSE 与 Particle visual simulation 解耦;camera redraw 未到 deadline 时只 composite。
  • V4 Renderer prepare 改持 shared immutable snapshot handle,稳定 window 不深复制大数组。
  • WeatherColor 稳定 wrap/resource 状态复用 drawable,mix/opacity/stops 由 tweaker UBO 更新。
  • 加入 DEBUG/Validation cumulative counters。
  • Android/iOS existing Runtime thin seam 为 V4 30/60 提供 deadline wake;无新 RN API 或平台专用 Core。
  • 自审将 platform wake 收紧为“已绑定的 fieldKey 已收到 accepted V4 submit”;clear 非粒子 field 不会错误停止仍可运行的粒子,disable 后 re-enable 可恢复既有 V4 field 的 wake。
  • 审查 advanceForecastClock production owner;当前未发现,已明确记录而未扩大重构。
  • git diff --check 通过。
  • Native C++/Metal/Android 编译、链接、codegen、artifact、安装、设备和性能采样:BUILD_NOT_RUN_BY_CODEX — WAITING_FOR_RDC。

禁止范围核对

未修改 NavSea、provider/network、QBIN V4、FieldProfile/Binding 对外 contract、RN 公共 API、C-001、detach() 语义或项目总则。未新增第二套 runtime/timeline,也未引入平台专用 Particle Core。

已知风险与下一步

V4 ForecastClock PLAY 的自动生产推进仍无调用 owner,因此未声称 PLAY 自动推进已经修复。RDC 必须先按完成报告进行 Mac C++/Metal、Android Native/AAR、shader/build graph 编译;成功后用统一颜色+性能真机矩阵验证 30/60/AUTO、PAUSE、speed-color、camera 和 debug counters。

本 Step 只完成源码和静态自审;Android Java/Objective-C++ wake 状态调整尚未经过目标平台编译。