MapLibreParticleLab/docs/报告/STEP-048_下一阶段规划调查_Codex完成报告_v1.md

STEP-048 下一阶段规划调查 Codex 完成报告

结论摘要

基于当前 particle/main 的真实实现，下一阶段推荐为「Provider-neutral C++ Field Data Adapter 与 Runtime 输入契约」。现有 Runtime Field Window、Timeline、GPU reuse 和 renderer 已可复用；真正阻塞正式数据链的是 OfflineFixtureParticleAdapter 的 fixture-only schema/knownFixture() 限制，以及 Android Validation Activity 仍负责 synthetic asset source 描述。

需要小型新 adapter contract/files，但不需要新的 Renderer、Timeline 或 WeatherColorLayer 架构。WeatherColorLayer 当前没有实际实现，因此不应提前引入。

实际检查文件

• src/mbgl/style/sources/raster_array_source.cpp
• include/mbgl/style/sources/raster_array_source.hpp
• src/mbgl/particle/field/offline_fixture_particle_adapter.hpp/.cpp
• include/mbgl/style/layers/raster_particle_layer.hpp
• src/mbgl/style/layers/raster_particle_layer_impl.hpp
• src/mbgl/renderer/layers/render_particle_validation_layer.cpp
• src/mbgl/renderer/layers/render_raster_particle_layer.hpp
• Android Validation Activity、NativeMap/NativeMapView JNI bridge

Gitea API 与 Git remote 均确认调查基线为 46dceb5cb6110c94393b7413465f843844dd6502。

输出与收尾

生成：本调查报告及本完成报告。未修改功能代码、测试、Android、Renderer 或 build 文件；未执行 Android Gradle、ADB、Jest。git diff --check 通过后仅提交两份调查文档并 push origin/particle/main。

Git 收尾补充

• commit hash：f0954476783b60c6ad4fdde7229657abed2e70f6
• commit message：docs: investigate next particle runtime stage
• push result：SUCCESS
• remote branch：origin/particle/main
• Final HEAD：f0954476783b60c6ad4fdde7229657abed2e70f6