1244 lines
181 KiB
Markdown
1244 lines
181 KiB
Markdown
# 粒子开发记录
|
||
|
||
## 2026-09-19 — STEP-085 V4 Renderer cadence 与稳定资源复用
|
||
|
||
- V4 WeatherColor 不再因无 legacy timeline 永久 repaint；Particle 改用 Source-owned shared cadence gate，30/60 的 simulation 仅在 deadline 推进，PAUSE forecast 不冻结可见粒子 visual simulation。
|
||
- V4 materialized T0/T1 改为 immutable shared handle，renderer prepare 不再按 frame 深复制大 snapshot；WeatherColor 稳定状态复用 drawable，动态 UBO 参数不触发重建。
|
||
- Android/iOS Runtime 只为 V4 30/60 future frame 提供 wake；deadline/推进仍由共用 C++ Core 决定。ForecastClock production advance owner 未找到，未擅自创建第二播放时钟。
|
||
- 收尾自审把 wake 条件收紧为“particle binding 对应 fieldKey 已 accepted submit”；clear 无关 field 不影响仍然 ready 的粒子，disable 后 re-enable 可重新启动既有 V4 field 的 wake。以上仅静态审计，Android/iOS 编译留给 RDC。
|
||
- 新增 DEBUG/Validation counters。仅完成静态检查；Native/Metal/Android 编译、artifact 与设备性能验收均等待 RDC。
|
||
|
||
## 2026-09-19 — STEP-084 正式粒子速度着色默认关闭
|
||
|
||
- 正式 `RasterParticleLayer` 与初始 `ParticleGpuResources` 的 `speedColorEnabled` 默认值均改为 `false`，使未显式配置时严格使用宿主 `particleColor`，避免内置高速橙红色带在首次资源创建前覆盖粒子颜色。
|
||
- speed-color shader 分支、公开 Core setter 与 Android Validation UI 显式开关均保留；`Layer.RasterParticleVisualProperties` 覆盖默认 OFF → 显式 ON → 再 OFF。
|
||
- Codex 仅完成源码静态审计和 `git diff --check`，未执行 Native 编译、链接、artifact、设备或真机验证；颜色验收将与 STEP-085 renderer 性能修复由 RDC 统一进行。
|
||
|
||
## 2026-08-27 — STEP-000
|
||
- 建立正式 Ubuntu MapLibreParticleLab 工作目录。
|
||
- MapLibre core：18545ca10d296704b2cba675b182ff2c8da24588
|
||
|
||
## 2026-08-28 — STEP-000 环境基线冻结
|
||
|
||
- Ubuntu 24.04 x86_64 MapLibreParticleLab 主开发环境建立完成。
|
||
- Linux OpenGL Native 构建通过。
|
||
- `mbgl-render` 构建通过。
|
||
- `mbgl-render-test-runner` 构建通过。
|
||
- Android OpenGL Debug `apackage` 构建通过。
|
||
- Android Vulkan Debug `apackage` 构建通过。
|
||
- OpenGL/Vulkan AAR 均包含 arm64-v8a、armeabi-v7a、x86、x86_64 的 `libmaplibre.so`。
|
||
- Vulkan Debug AAR 同时包含 Khronos Validation Layer。
|
||
- Android SDK 路径已通过 `ANDROID_HOME` 与 `local.properties` 固化。
|
||
- 下一步进入 STEP-001：MapLibre Native 粒子接入点只读调查。
|
||
|
||
## 2026-08-29 — 10_架构调查
|
||
|
||
- 按 `docs/40_任务/10_架构调查指令书_v1.md` 完成只读架构调查。
|
||
- 确认当前仓库是 MapLibre Native monorepo，不是 React Native 应用；确认 Android 13.4.1、iOS 6.28.0 和共用 Core 渲染链。
|
||
- 确认 Android OpenGL/Vulkan、iOS OpenGL/Metal、Core CustomLayer/gfx、Camera/Matrix、帧驱动和线程边界；粒子 fixture 目前只有空目录占位，暂无粒子运行时代码。
|
||
- 生成 `docs/20_调查/10_架构调查报告_v1.md` 和 `docs/报告/10_架构调查_Codex完成报告_v1.md`。
|
||
- 本次未修改生产代码、原生工程、依赖或项目总则；遵循用户要求未自行创建或修改 Step 文件。
|
||
|
||
## 2026-08-29 — 20_架构设计
|
||
|
||
- 按 `docs/40_任务/20_架构设计指令书_v1.md` 完成第一版正式粒子系统总体架构设计。
|
||
- 生成 `docs/10_架构/20_粒子系统总体架构设计_v1.md` 和 `docs/报告/20_架构设计_Codex完成报告_v1.md`。
|
||
- 正式主路线冻结为独立 Core `RasterParticleLayer/RenderRasterParticleLayer` + `RasterArraySource` + 隔离 `mbgl::particle` 模块，进入 Style/RenderTree 并使用 MapLibre gfx；CustomLayer/CustomDrawable 不作为产品主宿主。
|
||
- 冻结 WeatherColor/Particle 分层、Field/fixture contract、Wind GLOBAL、海洋场 OCEAN_ONLY 共用 Mask、MapLibre frame driver、同帧 Camera Matrix、GPU resource/context-loss 和平台薄接入原则。
|
||
- 下一阶段选择 `30_最小技术验证`，集中验证独立 RenderLayer、OpenGL/Vulkan ping-pong/trail/context、Camera/wrap/Mask 和 iOS 薄接入。
|
||
- 最终 FPS、最大粒子数、最佳 texture format、生产 Mask 来源、真实天气协议和生产 Host API 仍未确认。
|
||
- 本次未修改生产代码、依赖、构建配置、项目总则或 Step，未运行构建/测试。
|
||
|
||
## 2026-08-29 — 30-01 Core RenderLayer 接入验证（阶段 A）
|
||
|
||
- 按 `docs/40_任务/30_01_CoreRenderLayer接入验证指令书_v1.md` 完成最小验证代码准备。
|
||
- 新增 source-less `ParticleValidationLayer/RenderParticleValidationLayer`，经正式 Style/LayerManager/RenderTree/LayerGroup/translucent pass 链接入；代码明确标记 `VALIDATION ONLY`。
|
||
- 新增默认 false 的 RenderLayer repaint hook；ACTIVE 通过 MapLibre 自身 `needsRepaint → Map::onUpdate → Android requestRender` 链持续帧，STATIC 停止验证层额外请求。
|
||
- 验证 Drawable 在真实 pass 内读取当前 `PaintParameters/TransformParameters/TransformState` 的 viewport、zoom、bearing、pitch 和 projection matrix 摘要。
|
||
- Android Test App 新增 `Particle Core Layer Validation` 页面，提供 ACTIVE/STATIC 切换和蓝/黄普通 Style Layer 顺序参照。
|
||
- Linux OpenGL 重新配置通过；本任务新增/直接修改的 5 个 Core 对象精确编译通过。全量增量因公共头触发 321 个对象重编译，在 41/321 无错误时主动停止，未宣称全量 PASS。
|
||
- 遵循指令书未运行 Android/Gradle/npm/ADB；等待用户手工 Android OpenGL 编译、运行、手势、resize 与日志证据。
|
||
- 当前结论为 `WAITING_MANUAL_VALIDATION`；不得进入下一项 GPU ping-pong/Trail 验证。
|
||
|
||
## 2026-08-29 — 30-01 Core RenderLayer 接入验证（阶段 B 修复轮次 1）
|
||
|
||
- 用户 Android OpenGL 实机日志暴露 `RenderParticleValidationLayer::update()` 的 DrawableBuilder 生命周期错误：当前 Drawable 未完成就调用 `clearDrawables()`，RenderThread 随后触发 SIGSEGV。
|
||
- 对照 `DrawableBuilder::flush(context)` 与仓库既有 Drawable 使用方式，在 `clearDrawables()` 前补充 `builder->flush(context)`，使 custom validation Drawable 完成后再转移给 LayerGroup。
|
||
- 未以空指针判断跳过 Drawable；Tweaker 仍必须进入真实 translucent render pass 并读取同帧 Transform。
|
||
- Linux OpenGL 对应目标对象编译通过；C++ 格式和 `git diff --check` 通过。
|
||
- 未运行 Android/Gradle/npm/ADB，等待用户在新提交上重新手工编译和实机运行。
|
||
- 当前结论仍为 `WAITING_MANUAL_VALIDATION`；未扩大到粒子、GPU ping-pong、Trail、Mask、Vulkan 或 iOS。
|
||
|
||
## 2026-08-29 — 30-01 Android Test App APK 版本标识
|
||
|
||
- 在 Test App 主菜单列表顶部增加当前 APK 构建身份显示。
|
||
- 显示 `versionName/versionCode`、renderer flavor、build type 和构建时 Git revision 前 10 位，均来自 BuildConfig，不写死版本。
|
||
- 版本条用于人工验证时区分旧 APK 与当前源码构建，避免只凭安装时间或文件名判断。
|
||
- `git diff --check` 与 Android XML 标准库解析通过；按用户要求未执行任何编译。
|
||
- 等待用户手工构建、安装后确认设备端显示。
|
||
|
||
## 2026-08-29 — 30-02 GPU Ping-Pong 与 Context Recreation（前置阻塞）
|
||
|
||
- 开始执行 `docs/40_任务/30_02_GPU_PingPong与ContextRecreation验证指令书_v1.md` 并首先检查硬前置门槛。
|
||
- 30-01 最新技术报告与完成报告均仍为 `WAITING_MANUAL_VALIDATION`，不存在正式 PASS 记录或 PASS commit。
|
||
- 按 30-02 指令书第 2 节停止：未创建 State A/B、Trail A/B、RenderTarget、Shader、ping-pong、generation 或 context recreation 验证代码。
|
||
- State A/B、Trail A/B、gfx 同步、resize、disable/enable 和 context recreation 均未验证，无 PASS/FAIL 技术结论。
|
||
- 当前 30-02 状态为 `BLOCKED`；不允许进入 30-03。
|
||
- 阻塞报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v1.md`。
|
||
- Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v1.md`。
|
||
|
||
## 2026-08-29 — 30-01 Core RenderLayer 接入验证（用户验收 PASS 回填）
|
||
|
||
- 用户已完成 Android OpenGL 构建和 `Particle Core Layer Validation` 实际运行验收，明确确认结果为 OK/PASS。
|
||
- 30-01 正式状态由 `WAITING_MANUAL_VALIDATION` 更新为 `PASS`；Core RenderLayer 接入、ACTIVE/STATIC repaint、同帧 Transform 及 pan/zoom/bearing/pitch/resize 验证范围均由用户确认满足要求。
|
||
- 本次只回填验收状态：未重新修改 30-01 代码、未重新编译、未重新运行 Android、未执行 ADB。
|
||
- 30-01 正式完成，允许重新开始 30-02。
|
||
- 30-02 v1 的 `BLOCKED` 历史记录继续保留；它反映当时 30-01 正式 PASS 尚未回填，不代表 GPU/gfx 架构验证失败。
|
||
|
||
## 2026-08-29 — 30-02 GPU Ping-Pong 与 Context Recreation（阶段 A）
|
||
|
||
- 30-01 正式状态为 `PASS`，此前 30-02 v1 的历史 `BLOCKED` 前置原因已解除；开始重新执行 30-02 指令书。
|
||
- validation-only State A/B 已使用两套固定尺寸独立 GPU RenderTarget 实现；每帧 read/write 反向选择，无 CPU 完整状态复制。
|
||
- Trail A/B 已使用两套 viewport 尺寸真实 RenderTarget 实现 previous fade/marker → next，并把 next 合成到 MapLibre 主 translucent pass。
|
||
- 静态确认只注册当帧 write target，read target 不作为当帧附件；RenderTarget 顺序为 State → Trail，主 pass 后续 composite，slot 在 composite Tweaker 到达时提交。
|
||
- resize 只重建 Trail A/B 并保留 State A/B；disable/remove 会停止并释放或重置资源；context lost 记录旧 generation discard，新资源使用递增 generation。
|
||
- 复用 `Particle Core Layer Validation`，保留 ACTIVE/STATIC 并增加 DISABLE/ENABLE；没有修改通用 gfx API、正式粒子、Mask、Vulkan 或 iOS。
|
||
- 静态格式、JSON、shader 注册链与 diff 检查通过；遵守用户要求未编译，未运行 Gradle/Android/ADB。
|
||
- 当前状态为 `WAITING_MANUAL_VALIDATION`：State/Trail 实际 GPU 交替、OpenGL 同步、resize、disable/enable 和真实 context recreation 均等待用户手工运行证据。
|
||
- 不允许进入 30-03；若无法确认真实 context recreation，最终应按指令书标记 `BLOCKED`。
|
||
- 技术报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v2.md`。
|
||
- Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v2.md`。
|
||
|
||
## 2026-08-30 — 30-02 T3 STATIC freeze 实机缺陷修复
|
||
|
||
- 用户 Android OpenGL 手工验证确认：STATIC 静止时 State/Trail 停止，但 STATIC 拖动地图触发 MapLibre redraw 时仍继续推进，停止拖动后再停止；原 T3 正式判定为 FAIL。
|
||
- 原因是 `needsRepaint=false` 只停止 validation 主动请求帧，而原 `update()` 在地图手势帧中仍无条件注册 State/Trail RenderTarget、设置 pending，并由 composite Tweaker提交 slot/frame。
|
||
- 最小修复在 `RenderParticleValidationLayer` 增加 STATIC frozen-composite 路径：地图主 pass 仍正常 redraw 并显示最后 commit 的 Trail，但不注册离屏 target、不执行 State/Trail update、不 fade/加 marker、不 swap、不增加 simulation frame/index。
|
||
- STATIC 下不因 resize 重建/清空 Trail；恢复 ACTIVE 后才继续原 ping-pong 与 resize 生命周期。
|
||
- 仅修改 validation RenderLayer `.cpp/.hpp` 和本轮文档；未修改 Test App、shader、通用 gfx、正式粒子、Mask、Vulkan 或 iOS。
|
||
- C++ 格式、diff 与 GPU scheduling/commit 静态控制流检查通过；按用户要求未编译，未运行 Android/Gradle/ADB。
|
||
- 修复后的 T3 等待用户在 commit `364b8f381e27eee36c4895084b2f0578a023fa61` 上重新手工验证；30-02 总体状态仍为 `WAITING_MANUAL_VALIDATION`，不允许进入 30-03。
|
||
- 技术报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v3.md`。
|
||
- Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v3.md`。
|
||
|
||
## 2026-08-30 — 30-02 Android Rotation 状态恢复定向修复
|
||
|
||
- 用户确认此前 STATIC 的 pan/zoom/bearing/pitch 手势回归已经通过，DISABLE / ENABLE 正常；但旋转导致 Activity recreation 后 STATIC 错误恢复为 ACTIVE。
|
||
- 根因是 Test App 没有将 `active/enabled` 写入 Bundle，且 `onCreate()` 无条件恢复 ACTIVE + ENABLED 并重置 camera。
|
||
- 仅在 `ParticleCoreLayerValidationActivity.kt` 新增 Bundle key、保存/恢复 validation control mode；recreation 复用恢复后的统一 `loadValidationStyle()`，且只在首次进入设置默认 camera。
|
||
- 未修改 Manifest、C++、gfx、RenderLayer、shader、GPU ping-pong、GPU 状态、Gradle 或依赖；未使用 configChanges、方向锁定、SharedPreferences、全局变量或 GPU 序列化。
|
||
- `git diff --check` 与状态控制静态检查通过；按要求未运行 Gradle、Android 编译或 ADB。
|
||
- R1 STATIC、R2 ACTIVE、R3 DISABLED rotation 与 R4 STATIC gesture 回归等待用户实机验证；30-02 保持 `WAITING_MANUAL_VALIDATION`，不允许进入 30-03。
|
||
- 技术报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v4.md`。
|
||
- Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v4.md`。
|
||
|
||
## 2026-08-30 — 30-02 正式关闭（EGL Context Recreation Accepted Risk）
|
||
|
||
- 用户已完成并确认 30-02 的 Android OpenGL 实机结果；ACTIVE/STATIC、GPU ping-pong、STATIC 手势冻结、DISABLE/ENABLE 与 rotation control-mode 恢复纳入正式结论。
|
||
- 30-02 正式状态为 `PASS`，并正式关闭；允许进入 30-03。
|
||
- 真实 EGL Context recreation 没有独立实机验证证据，明确标记为 `Accepted Risk / 未验证项`；用户已明确决定该风险不阻塞后续阶段。
|
||
- 未伪造 context-loss PASS，也未重写 v1 `BLOCKED`、v2、v3 或 v4 历史报告。
|
||
- 本次只回填报告与开发记录；未修改代码，未重新编译，未运行 Gradle、Android 或 ADB。
|
||
- 技术报告：`docs/60_测试/30_02_GPU_PingPong与ContextRecreation最小技术验证报告_v5.md`。
|
||
- Codex 完成报告：`docs/报告/30_02_GPU_PingPong与ContextRecreation验证_Codex完成报告_v5.md`。
|
||
|
||
## 2026-08-30 — 30-03 Camera / World Wrap 与 Land/Ocean Mask（阶段 A）
|
||
|
||
- 30-02 已正式 PASS，EGL Context recreation 作为用户接受的未验证风险不阻塞，故开始 30-03。
|
||
- validation composite 改为使用当前 `PaintParameters::matrixForTile()` 的 canonical z0 world quad；ACTIVE/STATIC 继续区分 simulation update 与 Camera redraw。
|
||
- 通过 `UnwrappedTileID.wrap` 绘制中心和相邻 MapLibre world copy；仅中心 copy commit，避免 world copy 额外推进 30-02 GPU simulation。
|
||
- 增加反经线两侧 deterministic anchors C/D，并以全球 canonical mask UV 复用 MapLibre wrap，不建立第二套 world 状态机。
|
||
- 增加 validation-only shared 16×16 synthetic coastal mask，GLOBAL、OCEAN_ONLY_A/B 复用同一 GPU texture；Camera/consumer 切换不重建，context-destroy 通知后按新 generation 重建。
|
||
- Android Test App 复用既有入口，增加 GLOBAL/OCEAN A/OCEAN B/DATELINE/WORLD WRAP 最小控制；未运行 Android 编译、Gradle 或 ADB。
|
||
- Linux OpenGL 受影响 Core 对象精确编译、C++ 格式与 diff 检查通过；用户 T1–T13 实机验证仍待执行。
|
||
- 当前状态：`WAITING_MANUAL_VALIDATION`；不允许进入 iOS 最小验证。
|
||
- 技术报告：`docs/60_测试/30_03_Camera_WorldWrap与LandOceanMask最小技术验证报告_v1.md`。
|
||
- Codex 完成报告：`docs/报告/30_03_Camera_WorldWrap与LandOceanMask验证_Codex完成报告_v1.md`。
|
||
|
||
## 2026-08-31 — 30-03 Camera / World Wrap 与 Land/Ocean Mask（最终 PASS）
|
||
|
||
- 用户已完成 Android OpenGL 手工验收，T1–T13 全部记录为 `PASS`；30-03 正式状态更新为 `PASS`。
|
||
- 已确认本最小验证范围内的 Camera 同帧地理锁定、ACTIVE/STATIC camera redraw 分离、world wrap、双向反经线连续性，以及 shared Land/Ocean Mask 的 GLOBAL / OCEAN_ONLY_A / OCEAN_ONLY_B 语义。
|
||
- `Rotation/Viewport 自动恢复问题` 为已知问题；用户接受延期，明确在下一个任务修复。本轮不声称该问题已修复，也不将其伪造为已验证功能。
|
||
- 真实 EGL context recreation 的独立设备证据、正式 fixture adapter、正式 NoData fail-closed 和生产 coastline 数据仍未完成；EGL 风险沿用 30-02 的 `Accepted Risk / 未验证` 边界。
|
||
- 30-03 已允许进入下一阶段；下一任务优先处理 Rotation/Viewport 自动恢复延期项。
|
||
|
||
## 2026-08-31 — 40-01 Android 离线 Fixture 到正式粒子渲染最小闭环（Stage A）
|
||
|
||
- 30-03 后进入 Android 第一条离线 fixture 粒子闭环；Rotation/Viewport 自动恢复技术债已纳入本任务。
|
||
- 新增 backend-neutral `OfflineFixtureParticleAdapter` 和 `ParticleFieldSnapshot`，以 v1 metadata、binary length 与 SHA-256 把 uniform-east、uniform-north、vortex 解码为正式 Field；不使用在线数据或 Android UI 依赖。
|
||
- GPU field texture 接入既有 State A/B；Trail A/B 改为读取 State write texture，fixture 切换递增 field/gpu field generation 并清理旧 trail；Mask 继续走既有 shared GLOBAL/OCEAN_ONLY 路线。
|
||
- STATIC 不再阻止 resource bootstrap：Activity/context recreation 后会建立 field/mask/trail/state 并做零步 first composite，`simulationFrame` 不增加；Activity 保存 active/enabled/mask/fixture 选择。
|
||
- Linux OpenGL 受影响 Core 对象、C++ format、diff、fixture checksum 和 adapter smoke test 均通过；未运行 Gradle/ADB/实机验证。
|
||
- 当前结论：`WAITING_MANUAL_VALIDATION`。用户仍需完成 Android OpenGL T1-T12，尤其 T1 rotation 无按钮恢复；iOS、Vulkan、真实数据、生产 mask 和性能均未覆盖，尚不建议进入下一 Android 子任务。
|
||
- Stage A 实现提交 `0b076c6d52fffb2ee4411cac64f06d43cea260c8` 已成功 push 到 `origin/particle/main`。
|
||
|
||
## 2026-08-31 — 40-01 Stage A 正式链、Android fixture 边界与 NoData 修正
|
||
|
||
- 纠正此前实现仍借用 source-less `ParticleValidationLayer` 的偏差：新增正式 `RasterArraySource -> RenderRasterArraySource -> RasterParticleLayer (Source::Required) -> RenderRasterParticleLayer`，并让正式 RenderLayer 复用既有 GPU field、State A/B、Trail A/B、Mask、Camera/World Wrap/Antimeridian 与生命周期。
|
||
- Android Test App 的 Style 现在创建 `raster-array` / `raster-particle`，fixture 由 APK `assets/integration/particle-fixtures/` 的 `asset://` URI 提供；Core adapter 仅接收 FileSource bytes。Linux smoke helper 继续读取仓库 fixture，生成工具验证并同步两端完全相同的 metadata/field 内容。
|
||
- `ParticleFieldSnapshot` 将 cell validity 独立于 fixture validity：合法 NoData cell 产生 invalid mask，GPU texture alpha 表示该 mask；State sample 命中 NoData 后确定性 respawn，不将 `-9999` 当普通速度；NaN/Inf 仍拒绝。新增 `nodata` deterministic fixture。
|
||
- STATIC/context recreation 的 zero-step bootstrap 未推翻：新资源自动建立并首帧 composite，bootstrap commit 不增加 simulation frame。
|
||
- Linux Core 精确编译、format/diff、fixture generator、adapter/asset parity 检查在最终收尾复跑；未运行 Gradle、APK、ADB 或 T1-T12。最终状态仍只能是 `WAITING_MANUAL_VALIDATION`，等待 GPT 再次复审远端代码。
|
||
|
||
## 2026-09-01 — 40-01 RasterArray OfflineDownload 穷尽接入
|
||
|
||
- Android OpenGL 实际 C++ 编译暴露 `OfflineDownload` 的 required-resource-count 与 resource-queue 两处 `SourceType` 穷尽 switch 漏掉 `RasterArray`。
|
||
- 根据当前实现，`RasterArraySource` 只从平台 `FileSource` 获取确定性 fixture metadata/field bytes；40-01 Android 输入固定为 APK `asset://integration/particle-fixtures/...`，且 Source Impl 不包含 tileset、zoom range 或 OfflineDownload 托管资源 contract。因此两处都以显式 `SourceType::RasterArray` no-op 表达语义，不虚报资源数、不进入下载队列。
|
||
- 不增加 `default:`；全仓非 vendor 的 `SourceType` switch 已复核，本次仅修复新增枚举的直接遗漏。Linux/Core `offline_download.cpp.o` 精确编译（`-Werror`）、`clang-format --dry-run --Werror` 与 `git diff --check` 均通过；未运行 Gradle 或 ADB，40-01 继续为 `WAITING_MANUAL_VALIDATION`。
|
||
|
||
## 2026-09-01 — 40-01 RasterArray Source RenderItem 空指针修复
|
||
|
||
- Android OpenGL 首次实机启动确认 field fixture 已加载、RasterParticleLayer 已 evaluate 后，RenderThread 在 State A/B 创建前因 `Renderer::Impl::render()` fault addr `0x0` 崩溃。
|
||
- 调用链确认：loaded + needsRendering 使 `RenderRasterArraySource` enabled；RenderOrchestrator 要求 enabled source 返回合法 RenderItem；RenderTree 无条件解引用。原 `createRenderItem()` 返回空指针违反该既有契约。
|
||
- RasterArray source 改为按 ImageSource 的 prepare/create 生命周期提供 no-op RenderItem（无 upload、无 render pass、无 debug drawable、无 particle draw）；不改全局 RenderOrchestrator，不增加第二套粒子 renderer，粒子 GPU 路径仍由 `RenderRasterParticleLayer` 负责。
|
||
- Linux/Core `render_source.cpp.o` 与新增 source test object 均以 `-Werror` 精确编译；format、diff 与全部 RenderSource `createRenderItem()` return audit 通过。未运行完整 Linux 测试二进制、Android Gradle、ADB 或真机测试，40-01 继续为 `WAITING_MANUAL_VALIDATION`。
|
||
|
||
## 2026-09-01 — 40-01 Android ACTIVE / STATIC simulation lifecycle 修复
|
||
|
||
- 实机日志中反复出现的 `ParticleValidation30_02: disabled reset generation=...` 唯一来自 `RenderRasterParticleLayer::markLayerRenderable(false)`。调用链复核确认：`RenderOrchestrator::createRenderTree()` 在逐一处理每个 source 时为不匹配 source 的 layer 给出临时 `false`；同一 render tree 随后处理匹配的 `raster-array` source 又恢复 `true`。该 `false` 不是持久 disabled 生命周期事件。
|
||
- 原 override 在这个临时回调中移除 target、清空注册、执行 `ParticleGpuResources::resetSequence()`；因此 `committedFrame`（正式 `simulationFrame`）每帧回到 0，`stateRead/trailRead` 每帧回到 A、seed 标记变 false，ACTIVE 永远 schedule/commit frame 1，STATIC 每帧重新走 zero-step bootstrap。
|
||
- 已移除 `markLayerRenderable(false)` 的错误 reset；layer 仍保留 base renderable 状态。State/Trail 资源只在 field/fixture generation 改变、Trail viewport 重建、context lost 后资源重建、或 layer removal 时按已有路径失效/清理。`ParticleGpuResources` 仍由 `RenderRasterParticleLayer::gpuResources` 持有，跨 `render()` 持久存在。
|
||
- ACTIVE 现在连续按 A→B、B→A 交换并让 `committedFrame` 递增；STATIC 在未 seed（初次或真实资源事件）时只做一次 zero-step bootstrap，已有状态时只走 FrozenComposite，不注册离屏 target、不 commit；STATIC→ACTIVE 复用既有 slot/frame 继续 simulation。没有改变 pass 次序 `State,Trail,Composite`、hazard=SAFE、fixture/resourceGeneration contract 或 public API。
|
||
- 日志现在在 ACTIVE/STATIC transition 输出 generation、fixture、frame 与 read slot；schedule/pass/commit 输出前 3 帧及每 60 帧，避免长期高频洪水，同时可明确验收 1→2→3 与 A/B 交替。
|
||
- Linux OpenGL `render_particle_validation_layer.cpp.o` 精确编译、`clang-format` 与 `git diff --check`：PASS。40-01 保持 `WAITING_MANUAL_VALIDATION`，等待用户用新 APK 完成 GLOBAL ACTIVE、ACTIVE→STATIC、STATIC→ACTIVE 手工验收。
|
||
|
||
## 2026-09-01 — 40-01 Formal RasterParticle Trail Composite 显示修复
|
||
|
||
- 实机已证明 generation 稳定、simulationFrame 连续递增、State/Trail A/B ping-pong 与 `hazard=SAFE` 正常；画面静止不再是 lifecycle/repaint/clock 问题。
|
||
- 根因位于最终 Composite：Trail pass 确实从最新 State write 画入 Trail A/B，但 Composite 仅将 Trail RGB 计算为 alpha intensity，最终 RGB 始终是 30-03 legacy 的 stripe/anchor。因此正式 field simulation 没有成为屏幕主体。
|
||
- `ParticleGpuResources::formalDisplay` 由 `RasterParticleLayer` 的 formal source 身份设置，并通过现有 UBO `u_mask.z` 传入 shader。正式 `FORMAL_PARTICLE` Composite 输出当前 Trail RGB 与由其 intensity 导出的 premultiplied alpha；legacy `ParticleValidationLayer` 继续走未改变的 `VALIDATION` stripe/anchor/world-wrap 分支。
|
||
- `ParticleRender` 新增一次性 displayMode 日志；既有低频 schedule 日志补充 `trailStateSource`、`compositeTrailSource` 和 displayMode，可证明 State write → Trail write → Composite Trail write 的数据关系，而不每帧刷屏。
|
||
- `shaders/particle_gpu_validation.fragment.glsl` 为唯一 shader source，使用 `node shaders/generate_shader_code.mjs` 正常生成 OpenGL header；二次生成哈希一致。生成器同时规范化 `src/mbgl/shaders/shader_source.cpp`，该生成物一并保留以保证生成后工作树稳定。
|
||
- Linux OpenGL 受影响 RenderLayer object、相关 `source.test.cpp.o` 均精确编译；C++ format、diff check 通过。按任务边界未运行 Android Gradle、ADB 或真机；40-01 继续为 `WAITING_MANUAL_VALIDATION`，下一轮只验收 GLOBAL + ACTIVE + uniform-east 的可见 eastward 运动。
|
||
|
||
## 2026-09-01 — 40-01 Formal RasterParticle 显式 State Seed 修复
|
||
|
||
- 实机日志确认 formal display、State/Trail/Composite slot wiring、simulation frame 与 hazard 均正确，但正式粒子仍不可见。`RenderTarget::render()` 的既有全局 clear 是 opaque black `(0,0,0,1)`；未修改该 MapLibre contract。
|
||
- 原 State shader 用 `previous.a < 0.5` 判断是否第一次 seed，但新 State target alpha 为 1，导致全部 16×16 texel 从 `(0,0)` 而非各自 `v_uv` 开始。uniform-east 只推动 x，marker 聚集在 canonical world 顶缘、常在当前视口外。
|
||
- `ParticleGpuResources::stateSeeded` 现在是唯一权威。State pass 把 `!stateSeeded` 通过现有 UBO 的 `u_mask.w` 传入；shader 仅以该 flag 选择 `v_uv` 或 `previous.rg`，不再以 texture alpha 推断生命周期。Field `alpha` 仍仅表示 NoData validity。
|
||
- ACTIVE 第一次 State pass 与 STATIC zero-step bootstrap 都对每个 texel 进行 `v_uv` seed；Composite commit 后 `stateSeeded=true`，之后继续 read texture。新 resources、context recreation 和 fixture/field `resetSequence()` 保持重新 seed；普通 ACTIVE、Camera、STATIC 与 transient source renderability 不会 seed。
|
||
- 新增低频 `ParticleRender: stateSeed=INITIALIZE|CONTINUE` 日志，含 generation、State A/B 与 fixture。shader source/header generator parity、生成器幂等、Linux Core 与 Source test object 编译、format 和 diff 均通过；未运行 Android Gradle/ADB/真机，状态仍为 `WAITING_MANUAL_VALIDATION`。
|
||
|
||
## 2026-09-02 — 40-01 RasterArray Source 重建 Field Identity 修复
|
||
|
||
- 用户实机确认 GLOBAL ACTIVE uniform-east、ACTIVE→STATIC→ACTIVE 均通过；点击 uniform-north 后仍 eastward。Android Test App 已正确重建 `raster-array` source，根因不在 UI 或 shader/ping-pong。
|
||
- `RasterArraySource::tryLoad()` 原有 `generation` 是 source 实例成员；Style 用同一 source ID 重建时 east 与 north 都可得到 generation 1。`RenderRasterParticleLayer` 正式路径又只比较 generation，因此错误保留 east GPU field texture。
|
||
- runtime generation 改为 `raster_array_source.cpp` 的 process-wide atomic 单调 revision；它只表达运行时 snapshot identity，不混用 metadata `dataVersion`，也不使用时间或随机数。source load 日志现在含 fixtureId、generation、dataVersion。
|
||
- renderer 使用 shared `fieldIdentityChanged()` 三元判断：generation、fixtureID、dataVersion 任一改变都会重新上传 field texture 并保留既有 `resetSequence()`、State re-seed、Trail clear 路径；三者相同不重复上传。fixture switch 日志记录 from/to、old/new generation、gpuFieldGeneration、trail clear 与 state seed。
|
||
- 新增定向 C++ 测试：两个独立 RasterArraySource 实例加载 east/north 得到不同 generation；同 generation 的 east/north 仍判定 identity changed；同 fixture/generation/dataVersion 不判定变更，dataVersion 改变则判定变更。
|
||
- Linux OpenGL 的 RasterArraySource、RenderLayer 与 `source.test.cpp` 精确编译，format/diff 均通过；未运行 Android Gradle/ADB/真机，40-01 继续 `WAITING_MANUAL_VALIDATION`。下一轮只验收 GLOBAL + ACTIVE + uniform-east 后切 uniform-north 的方向变化。
|
||
|
||
## 2026-09-02 — 40-01 Stage B Android OpenGL 最终关闭
|
||
|
||
- 用户完成 Android OpenGL x86_64 手工验收，40-01 正式状态更新为 `PASS`。
|
||
- GLOBAL + ACTIVE + UNIFORM EAST、ACTIVE→STATIC→ACTIVE、UNIFORM EAST→UNIFORM NORTH→UNIFORM EAST、STATIC OCEAN A/B Rotation 自动恢复、ACTIVE Rotation、Pan/Zoom/Bearing/Pitch、World Wrap、双向 Antimeridian、GLOBAL/OCEAN A/OCEAN B、Shared Mask reuse、DISABLE/ENABLE、快速 fixture 切换与最终重复 Rotation 回归全部 PASS。
|
||
- 同一 RenderThread/resource generation 内 GLOBAL/OCEAN_ONLY_A/OCEAN_ONLY_B 复用同一 `maskGeneration`，日志为 `reuse=true`；graphics resource 重建后的 generation/maskGeneration 递增属于新 GPU resource，不属于同 generation 内重复创建。
|
||
- 40-01 历史调试链完整保留：OfflineDownload exhaustive switch、RasterArray no-op RenderItem SIGSEGV、Android APK/.cxx 旧 native 缓存、lifecycle reset loop、formal Composite Trail 显示、shader source/generated header 同步、opaque clear State seed、field identity generation collision、Rotation/Viewport STATIC restore 均已解决并由最终手工回归覆盖。
|
||
- 本次仅回填 Stage B 文档，不重新运行 Android Gradle、ADB 或实体机；iOS/Metal、Vulkan、真实数据、生产 mask、性能和独立 EGL context-loss 设备证据仍为范围外，不被 40-01 Android OpenGL PASS 隐含覆盖。
|
||
|
||
## 2026-09-02 — 40-02 Android 双时间片 GPU 时间插值（代码阶段）
|
||
|
||
- 在 40-01 唯一正式 `RasterArraySource -> RasterParticleLayer -> GPU Simulation -> Trail -> Composite` 链路上扩展为 T0/T1 两份 immutable Field snapshot；source 通过可选 `next-fixture/next-metadata/next-field` 从同一 FileSource byte boundary 加载，拒绝 grid/bounds/NoData/Field 语义不兼容的窗口。
|
||
- `RasterParticleLayer` 新增 `raster-particle-time-mix` 常量属性；其只更新既有 UBO。State shader 分别从两张 GPU Field texture 解码速度后 GPU `mix`，没有 CPU 完整中间 Field、第二 Layer 或第二 simulation。
|
||
- Renderer 保持一套 State A/B、Trail A/B、shared Mask 和 Composite；T0/T1 使用两个可复用 GPU Field slot。窗口 A/B -> B/C 通过 generation + fixtureID + dataVersion 识别 B，复用其 texture、只上传 C，保留 simulation/trail；无重叠的新窗口沿用 40-01 的安全 reset/reseed。
|
||
- Android Test App 增加 T0 EAST/T1 NORTH、MIX 0/50/100 与 ADVANCE B→C 入口，原 ACTIVE/STATIC、GLOBAL/OCEAN、Camera、wrap/antimeridian 入口保留。
|
||
- Linux OpenGL 受影响 Core/source-test object、shader generator、C++ format 和 diff check 已通过；未执行 Android Gradle、ADB 或设备操作。40-02 当前只能标记 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`，T1–T10 手工 Android OpenGL 验收后才能判 PASS。
|
||
- 实现提交为 `4675a8a29dd6fc7b684bfb64913a8c9075ad8583`（`feat: add GPU particle time interpolation`）；文档收尾提交另行记录，均只面向 40-02。
|
||
|
||
## 2026-09-02 — 40-02A Android Validation 测试界面紧凑化（代码阶段）
|
||
|
||
- 仅调整 Android Test App 的 `Particle Core Layer Validation` UI：底部控制区从 7 个默认大按钮行压缩为 4 行，状态行 36dp、控制行 34dp、padding 4dp，MapView 保持全屏并获得更多粒子观察区域。
|
||
- EAST/NORTH、T0/T1、ADVANCE、MIX、ACTIVE/STATIC、DISABLE/ENABLE、GLOBAL/OCEAN、DATELINE/WORLD WRAP 的 16 个既有 ID/click binding 均保留；状态改为单行 mask/runtime/field/mix 表达，不改变 40-02 业务语义。
|
||
- 未修改 C++ Core、shader、GPU、simulation、trail、composite、mask、Gradle 或 ABI。静态 ID/binding 核对与 diff check 通过；未运行 Android Gradle、ADB 或设备。状态为 `IMPLEMENTED / WAITING FOR ANDROID UI VALIDATION`。
|
||
- 实现提交为 `f4d519ca789c0488d6b9d8259427ac070b15eb63`（`ui: compact particle validation controls`）；文档收尾提交另行记录。
|
||
|
||
## 2026-09-02 — STEP-043 / 40-02C 最终修正
|
||
|
||
- 修正 north-positive V 到 Mercator Y 的最终 displacement 符号；Field canonical contract 未变。
|
||
- MIX 移除 Style reload fallback，未就绪只拒绝并记录日志；GPU reuse 使用已验证 SHA-256 content identity，revision generation 仍独立保留。
|
||
- 状态：`IMPLEMENTED / WAITING FOR ANDROID VALIDATION`；未运行 Android Gradle/ADB，T1--T10 待用户验收。
|
||
|
||
## 2026-09-03 — STEP-043A 源码审查后最小修正
|
||
|
||
- texture reuse 现消费 wanted revision；MIX reject 不再改变 timeMix；补充 lifecycle diagnostics 与 Style reason。状态仍为 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`。
|
||
|
||
## 2026-09-03 — STEP-043B Android→Core MIX 属性桥接
|
||
|
||
- 自定义 raster-particle 没有 Android Java Layer peer，`Style.getLayer()` 不能作为 Core layer readiness；新增最小 NativeMapView bridge 走正式 Core `Layer::setProperty`，MIX 仅 bridge 成功后更新状态。
|
||
|
||
## 2026-09-03 — 40-02 双时间片 GPU 时间插值 Android 最终验收完成
|
||
|
||
- STEP-043B 最终使用 `RasterParticleLayer::setTimeMix(float)`；Android x86_64 OpenGL Debug 编译、安装、启动通过，T1--T10 全部 PASS。
|
||
- A/B→B/C GPU texture reuse、MIX property-only、DISABLE/ENABLE 生命周期通过；`uniform-north + vortex` 的 MIX 50% 局部低速/近零速是正常逐点插值。
|
||
- 单 ABI APK 约 696.5 MiB 是独立 packaging 技术债，不阻塞本阶段。40-02 / 40-02C / STEP-043B 正式 `CLOSED / PASS`。
|
||
|
||
## 2026-09-03 — 40-03 Android OpenGL 粒子数量容量基线（代码阶段）
|
||
|
||
- 正式 RasterParticle GPU 链的粒子数实际由 State A/B render target 网格承载：既有 `16x16` 即 256 个 State shader texel。新增 `raster-particle-particle-count` Core 属性与强类型 `RasterParticleLayer::setParticleCount(uint32_t)`，只接受 256..1,048,576 的平方数，确保实际 count 与 State grid 面积一致。
|
||
- Android Validation 页面新增 256、1K、4K、16K、64K、1M 档位；使用既有 Android→Core 薄桥，不建立 Java layer peer、CPU simulation 或第二 GPU simulation。切换只重建 State A/B、执行一次可解释的 `PARTICLE_COUNT_CHANGE` reset/reseed，Field T0/T1、MIX、interpolation、GPU content reuse、mask 与既有 lifecycle 均不改变。
|
||
- 日志包含请求/实际 count、State grid、State target create/rebuild/release 和拒绝原因；Trail 继续用四个确定性 State texel作低开销可视健康指示，实际并行 simulation 数仍是整个 State 网格。
|
||
- Linux OpenGL 受影响 Core 和新增 Layer test object 精确编译、C++ format、diff check 均通过；未运行 Android Gradle、ADB、APK 或设备，也未加入 Jest。
|
||
- 当前状态只能是 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`。用户将以 x86_64 Android OpenGL 逐档填写容量矩阵后，才能确定稳定区间、性能下降区间和压力边界。
|
||
|
||
## 2026-09-03 — 40-03 Full Particle Draw 补齐（STEP-044 v2）
|
||
|
||
- 暂停 v1 容量验收的根因已补齐：v1 的 State A/B 虽可容纳 N 个 State texel，但 Trail fragment 只读取四个固定 sample，实际 Trail draw 只是全屏 quad，不能证明 N 个粒子已绘制。
|
||
- 正式 RasterParticle Trail 现在先保留既有全屏 fade，再在同一 Trail A/B write target 绘制 N 个 point。particle index 在资源创建/count change 时一次性映射到 State texel `(x,y)`；vertex shader 每帧直接从当前 State write texture fetch RG position，Composite 仍消费 Trail write。没有 CPU readback、每帧 CPU position loop、第二 simulation 或 overlay。
|
||
- 16-bit index buffer 每 segment 最多 65,536 point；1M 使用多个 segment，但继续走同一 State→Trail→Composite GPU path。日志明确输出 `trailDrawCount`、`particleIndexCount` 与 `fullParticleDraw=true`；legacy validation 的四 sample 诊断保留且不再限制正式层。
|
||
- U/V、Mercator `dy=-v`、T0/T1、MIX、Field reuse、seed/lifecycle 和 Android JNI 均未改变。Linux OpenGL 精确 Core/test object 编译、shader generator 二次幂等、format 与 diff check 通过；未运行 Android Gradle、ADB、设备或 Jest。
|
||
- 状态继续为 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`，用户下一轮只验收 256、1K、256→1K→256 的 full draw 正确性，之后才恢复完整容量矩阵。
|
||
|
||
## 2026-09-03 — 40-03 Android OpenGL 粒子数量容量基线最终关闭（STEP-044 v3）
|
||
|
||
- 40-03 正式 `CLOSED / PASS`。原 `c0d1ad43...` 只扩展 State A/B 容量，Trail/render 未 full draw，故验收曾暂停；`a0aae48...` 完成正式 full particle draw，使 `State N -> draw N -> Trail -> Composite` 成立。
|
||
- 用户 Android OpenGL 实机确认：256→draw 256、1K→draw 1024、4K→draw 4096、16K→draw 16384、64K→draw 65536、1M→draw 1048576；所有档位日志均为 `fullParticleDraw=true`，用户确认 1M 运行 OK。T-FULL-01～03（含 256→1K→256 重建回归）全部 PASS。
|
||
- count change 仅重建 State/full draw resources，未引入 Field upload、Style reload 或 MIX 改变；40-02 的 MIX property-only 与时间窗 Field reuse（`simulationRebuild=false`、`trailCleared=false`）保持。
|
||
- 已验证容量 **≥ 1M**，满足当前项目需求，不再扩展 2M/4M/8M 压测。1M 是本验证设备上的已验证容量，不是理论最大值、硬编码产品默认值或所有 Android 设备的统一保证。
|
||
- 本收尾只回填文档；Codex 未运行 Android Gradle、ADB、设备测试或 Jest，也未修改功能代码。
|
||
|
||
## 2026-09-03 — 40-04 Runtime Field 动态更新接口（STEP-045）
|
||
|
||
- 正式 Runtime Field 更新入口落在 `RasterArraySource`：`updateRuntimeFieldWindow(ParticleFieldSnapshot)` 把 Source 权威窗口由 `T0/T1` 推进为 `T1/newT1`，并通过既有 Source observer 通知正式 RasterParticle renderer；没有 Style reload、Source/Layer recreate 或第二套 Field/GPU 系统。
|
||
- `RasterArraySource::Impl::field/nextField` 继续是唯一正式 T0/T1 权威状态。Android Validation 只通过 `MapLibreMap -> NativeMapView -> JNI -> Style::getSource()` 薄桥请求 advance；Kotlin/JNI 不保存窗口，不操作 renderer 私有资源。
|
||
- 离线验证初始 A/B 为 uniform-east/uniform-north；Source 自己预加载 C=vortex、D=nodata。候选在真正进入 T1 时才获得 process-wide runtime generation，避免异步 asset 完成顺序造成 stale/non-monotonic revision。
|
||
- 既有 renderer content identity/slot ownership 未改：A/B→B/C 和 B/C→C/D 都复用 OLD_T1 作为 NEW_T0，只上传新 T1，保留 simulation 与 Trail（`simulationRebuild=false`、`trailCleared=false`）。MIX 仍是 property-only，不参与 Field update。
|
||
- 重复当前内容明确 NOOP；无效、未加载、不兼容、非单调或无候选更新 fail closed，不污染当前有效窗口。没有每帧 Field copy/hash/upload，也未修改 40-03 full particle draw。
|
||
- Linux/OpenGL 受影响 Core/conversion/source test object 精确编译；定向窗口推进 test object 覆盖已加入，完整 `mbgl-test` 因 build tree 缺失大量无关依赖未执行，未将其误报为通过。格式与 diff 检查结果在完成报告收尾记录。未执行 Android Gradle、ADB、APK、实体机或 Jest；当前状态仅为 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`。
|
||
- 实现提交：`45502a53f4fc486bd24cb0008d1ab0ff221e7e63`（`feat: add runtime particle field updates`）；文档收尾提交另行记录。
|
||
|
||
## 2026-09-03 — 40-04 T-RUNTIME-05 Duplicate NOOP 补验收入口
|
||
|
||
- 已有 Runtime API 的 `sameFieldGpuContent(currentT1, newT1)` NOOP 分支正确，但 Android 只有 ADVANCE（候选耗尽后为 T-RUNTIME-06 reject），无法真实重提当前 T1。
|
||
- 新增 Source-owned `repeatRuntimeFieldWindow()` 和最小 Android/JNI 薄桥；`DUPLICATE T1` 只把当前 `Impl::nextField` 重交正式 update API，在 vortex/nodata 窗口返回 NOOP，不推进 candidate queue，不改变 Source window，也不触发 `onSourceChanged()`。
|
||
- C++ Source test 在 C/D 后断言 Noop、T0/T1 不变及 source changed count 不增；Linux/OpenGL 精确 Core/test object 编译、format/diff check 通过。Android Gradle、ADB、设备和 Jest 未执行；状态继续 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`。
|
||
|
||
## 2026-09-03 — 40-04 / STEP-045 Runtime Field 动态更新最终关闭
|
||
|
||
- 40-04 / STEP-045 正式 `CLOSED / PASS`。Android OpenGL 最终统一验证 T-RUNTIME-01～06 全部 PASS。
|
||
- 正式 Runtime Field 接口已证明支持 A/B→B/C→C/D 连续时间窗推进：OLD_T1 复用为 NEW_T0，只上传真正的新 T1，正常推进不重载 Style、不重建 Layer、不重启 simulation、不清 Trail。
|
||
- MIX 保持 property-only；Duplicate 重提当前 T1 返回 NOOP，不产生 Field upload/reset/style reload；候选耗尽 fail-closed，当前 vortex/nodata 窗口继续可用。
|
||
- `STYLE_LOAD reason=TIME_WINDOW` 仅是用户建立初始窗口的允许初始化；真正 Runtime 操作期间 styleEpoch 稳定。MIX 的 `LAYER_CHANGED` 不是 Layer recreate，最终 renderLayerInstanceId 保持 1。
|
||
- 40-04 未改变 U/V、`dy=-v`、GPU interpolation、40-03 full particle draw 或已验证 capacity ≥ 1,048,576；真实网络/GRIB/provider、视觉阶段、WeatherColorLayer、Vulkan、iOS/Metal、生产 mask、APK 技术债仍属范围外，未进入下一阶段。
|
||
|
||
## 2026-09-03 — 40-05 / STEP-046 Android OpenGL 正式粒子视觉与运行时渲染控制（代码阶段）
|
||
|
||
- 正式 `RasterParticleLayer` full draw 从固定 blue point 扩展为短 streak：每个 State texel 对应一颗粒子、两个静态 line endpoint，GPU vertex shader 从 current State write 与 T0/T1 插值 Field 求位置、方向和速度；CPU 不持有 live particle position/direction/color，也不做 readback 或第二 simulation。
|
||
- 继续冻结 `U=east-positive`、`V=north-positive` 与 Mercator 边界 `dy=-v`；EAST/NORTH/vortex 的视觉方向与 MIX 后最终速度一致。NoData、NaN 和近零速 fail-closed，不画 streak。
|
||
- 新增 `raster-particle-line-width`、`particle-length`、`particle-opacity`、`trail-opacity`、`trail-fade`、`speed-color-enabled` 等 Core Render/Visual properties。它们经现有 Android→Core JNI boolean bridge 运行时更新，只改 Render/UBO，不 reload Style/Source、不上传 Field、不 reset State/Trail。
|
||
- GPU fragment shader 使用最终插值 speed magnitude 的最小蓝→绿→橙 ramp；COLOR 控制可以回退固定蓝色。该粒子着色与未实现的 WeatherColorLayer 明确分离。
|
||
- Android Validation 页增加 VISUAL DEFAULT、SIZE、LENGTH、OPACITY、TRAIL、FADE、COLOR 集中入口、直接 VORTEX fixture 与 256K 容量档，并保存 Activity 状态；资源日志补充 `particleDrawCount=N`、`streakVertexCount=2N` 和低频 visual property snapshot。
|
||
- shader generator 二次幂等、Linux OpenGL Core/style test object 精确编译、format/diff 均通过；未运行 Android Gradle、ADB、真机或 Jest。当前状态只能是 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`；用户下一轮以一次 x86_64 APK 编译完成 T1--T8 综合验收后才可关闭。
|
||
|
||
## 2026-09-03 — 40-05 / STEP-046 Android OpenGL 正式粒子视觉与运行时渲染控制最终关闭
|
||
|
||
- 实施提交 `e48fa087e01e9710c5d0c18ab062726226bbb6bd` 已由用户完成 Android APK 编译、安装和最终手工验证；T1--T8 全部 PASS，40-05 / STEP-046 正式 `CLOSED / PASS`。
|
||
- UNIFORM EAST、UNIFORM NORTH、VORTEX 的正式 GPU streak 正常显示；Runtime visual properties、speed color 与 MIX 0/50/100 均正常，MIX 保持 property-only。
|
||
- 40-04 Runtime Field Window 连续推进、`OLD_T1 -> NEW_T0` reuse、Duplicate NOOP、fail-closed、无 Style reload / 无无意义 simulation reset / 无 Trail clear 均无回归。
|
||
- pan、zoom、bearing、DATELINE、WORLD WRAP、DISABLE/ENABLE、屏幕/生命周期恢复、GLOBAL/OCEAN A/OCEAN B 均通过；Renderer 持续 `State -> Trail -> Composite` 且 `hazard=SAFE`。
|
||
- 容量档 256、1K、4K、16K、64K、256K、1M 在新的 streak + speed color 路径均通过。4K 以上在小 Validation viewport 内趋于高密度铺满是可读性现象，不是功能失败；1M 仍只是当前验证设备上的已验证容量，不是全设备保证或产品默认值。
|
||
- Android logcat 的 `TimeStats: RenderEngineTimes are already at its maximum size[64]` 是 RenderEngine/虚拟机环境噪声，未伴随粒子 Renderer crash 或中断，不判为本阶段失败。未进入 WeatherColorLayer、真实网络/GRIB、Vulkan、iOS/Metal 或生产 mask 等范围外工作。
|
||
|
||
## 2026-09-03 — 40-06 / STEP-047 Runtime Timeline 与 Playback（代码阶段）
|
||
|
||
- `RasterArraySource` 现持有唯一的有界 Timeline runtime：六个离线 immutable snapshot、严格递增逻辑时间、T0/T1、mix、cursor、播放/暂停、0.5x/1x/2x、step、seek、gap/invalid/recover/end。Android 只经薄 JNI 发低频命令，没有 Android timer 或 per-frame JNI。
|
||
- RenderRasterParticleLayer 只读取 Source Core 给出的当前 T0/T1/mix；窗口 revision 变化继续进入既有 Field identity/GPU reuse 路径，自动边界维持 `OLD_T1 -> NEW_T0` 的重用语义。正常 timeline MIX 不需要 Style reload。
|
||
- Validation UI 收敛为 `TIME | VIS | COUNT | MAP | MORE`；原有动作均由菜单保留，TIME 提供 load/play/pause/speed/step/seek/gap/invalid/recover。
|
||
- 已加 Source timeline 单元覆盖并运行 Linux/OpenGL Core 精确构建；未运行 Android Gradle、ADB、实体机或 Jest。状态仍为 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`，等待 Android x86_64 逐项验收。
|
||
|
||
## 2026-09-04 — 40-06 / STEP-047 Android Round 1 集中修复
|
||
|
||
- Round 1 为 `PARTIAL / NEEDS FIX`：主链、自动 MIX/window reuse 和紧凑 UI 通过，但 timeline 过短、END/seek 语义、异常入口、VIS 可达性与 cache 可观测性不足。
|
||
- Core validation timeline 改为约 200 秒；END PLAY restart、PLAYING/PAUSED seek 状态保持、GAP/INVALID fail-closed 和 RECOVER 保留此前状态。TIME 直接暴露 NORMAL/GAP/INVALID/RECOVER，VIS 将 COLOR 前置并使用明显的 validation 步长。
|
||
- 仍保持 Source 有界 CPU snapshot preload、GPU 仅 T0/T1、相邻窗口 reuse 与 STEP-046 visual property-only。状态为 `IMPLEMENTED / WAITING FOR ANDROID RE-VALIDATION`。
|
||
|
||
## 2026-09-04 — 40-06 / STEP-047 Playback Tick 根因修复
|
||
|
||
- Android Round 2 确认 PLAY/SPEED bridge 成功、RenderThread 持续，但 Timeline 只短暂推进。根因是 tick 错接到非持续的 RenderLayer update。
|
||
- tick 已移到每个正式 State drawable frame 的 Core tweaker；没有 Android timer、每帧 JNI、线程或自旋。新增低频 PLAYBACK_TICK heartbeat；状态继续 `IMPLEMENTED / WAITING FOR ANDROID RE-VALIDATION`。
|
||
|
||
## 2026-09-04 — 40-06 / STEP-047 Runtime Timeline 与 Playback 最终关闭
|
||
|
||
- Android 最终验收在 `1343929474796b1313489ee9fecbf23b949580a7` 功能基线上全部 PASS，STEP-047 正式 `CLOSED / PASS`。
|
||
- Playback tick、Pause/Resume、0.5x/1x/2x、Seek/Step、Gap/Invalid fail-closed 与 Recover、Preload/Cache、`OLD_T1 → NEW_T0` reuse、仅上传 NEW_T1、无正常 reset/clear trail、VIS/MAP/MORE 与紧凑 UI 均已验证。
|
||
- snapshots=6/cacheCapacity=8 下没有 CACHE_EVICT 是正常容量现象。状态栏对自动 MIX/WAITING/INVALID 的展示记录为非阻塞 Validation UI observability 技术债；TimeStats 上限信息为 Android RenderEngine 环境噪音。此次仅文档收尾，未修改功能代码。
|
||
## 2026-09-04 — STEP-049 Provider-neutral C++ Field Data Adapter 与 Runtime 输入契约
|
||
|
||
- 新增 `ParticleFieldDescriptor`、`ParticleFieldDataAdapter`、structured error result 与 provider-neutral `ParticleFieldSnapshot`；descriptor/payload 边界不携带 provider、URL、token、network 或 Renderer 对象。
|
||
- `OfflineFixtureParticleAdapter` 保留 fixture-v1 whitelist、metadata/checksum 校验，但最终调用正式 Data Adapter；EAST/NORTH/VORTEX/NODATA validation fixture 继续工作，fixture identity 改为 neutral `fieldID`。
|
||
- `RasterArraySource` 继续复用唯一 `updateRuntimeFieldWindow()`；没有第二套 T0/T1、Timeline、Playback、GPU upload policy 或 Renderer 业务语义。`OLD_T1 → NEW_T0`、NEW_T1-only、Duplicate NOOP、MIX property-only 和 fail-closed 保持。
|
||
- Linux OpenGL `mbgl-test-runner` 构建通过，adapter + RasterArray 定向 11 项测试通过，`git diff --check` 通过；未执行 Android Gradle/APK/ADB/设备/Jest。
|
||
- 状态：`IMPLEMENTED / WAITING FOR ANDROID VALIDATION`，等待用户一次 Android 综合验收后再 docs-only closeout。
|
||
## 2026-09-04 — STEP-049 Timeline 回归修复
|
||
|
||
- 根因是 Timeline candidate 在 `tryLoadRuntimeField()` 以 generation=0 进入正式 Field Adapter；adapter 的非零 generation 校验正确拒绝，Runtime Window 因使用已分配 generation 仍正常。
|
||
- 修复为 candidate decode 前分配 Core 全局 runtime generation，Timeline 构建不再重复改写；未放宽 contract，未新增 adapter、Timeline 或 Window。
|
||
- 新增真实 Source candidate preload → formal adapter → Timeline READY 回归测试，并保留 generation=0/invalid descriptor 负向校验；Linux OpenGL 构建通过，定向测试 12/12 PASS。
|
||
- Validation UI 仅明确显示 `TL NOT READY/READY/PLAY/PAUSE/WAIT/INVALID`，与 Window 状态分离；未执行 Android Gradle/APK/ADB/Jest。
|
||
- 状态：`IMPLEMENTED / WAITING_ANDROID_REVALIDATION`，等待用户重新构建 APK 并完成一次综合 Timeline 验收。
|
||
## 2026-09-04 — STEP-049 Android 复验与最终关闭
|
||
|
||
- 用户已在 `e34f04ba7038c5cb8fba8dc72c0d253cc4f7c85b` 基线上完成 Android 综合复验：Timeline READY/PLAY、auto MIX、A/B→B/C→C/D、OLD_T1→NEW_T0 reuse、only NEW_T1 upload、Pause/Resume、Step/Seek、Gap/Recover、Invalid Next/Recover、Duplicate NOOP、Renderer fail-closed 与不黑屏全部 PASS。
|
||
- 正常连续播放保持 `simulationRebuild=false`、`trailCleared=false`；Window 内 MIX 不产生 Field upload、simulation reset 或 style reload。
|
||
- Validation UI MIX 百分比文本可能滞后，保留为 `NON-BLOCKING observability`，不影响 Core/Playback/Window/Renderer/Adapter 结论。
|
||
- 本次为 docs-only 收尾，未执行 Android Gradle/APK/ADB/App/Jest，STEP-049 正式状态更新为 `CLOSED / PASS`。
|
||
## 2026-09-04 — STEP-051 Local Production-like Field Feed 与 Core Snapshot Submit Bridge
|
||
|
||
- Starting HEAD `885e7aebef7fb5d02acaed57f9dcf98b8d9e9ba3`；新增 provider-neutral `maplibre-particle-field/v1` local metadata feed、四个时间片资源与 `LocalParticleFieldFeed`，正式复用 ParticleFieldDataAdapter/Snapshot。
|
||
- `RasterArraySource::submitInitialRuntimeFieldWindow(T0,T1)` 建立薄 Core submit bridge；Timeline 使用 producer `validTime`，旧 fixture null timestamp 保留兼容 fallback，Window/Playback/Renderer ownership 未改变。
|
||
- 新增 local feed 成功、严格 identity/generation/validTime、Timeline READY/PLAY 与非法 generation 拒绝测试；Linux OpenGL 定向 14/14 PASS。Android/Jest 未执行。
|
||
- Android TIME 入口可加载 production-like resources；MIX 文本滞后仍为 NON-BLOCKING observability，Rotation/Viewport 技术债未扩大处理。
|
||
- 状态：`IMPLEMENTED / WAITING_ANDROID_VALIDATION`。
|
||
|
||
## 2026-09-04 — STEP-053 Windy-style Canonical Field 与 Host Submission
|
||
|
||
- 新增 Host 已持有数据后的低频 ingress：`metadata + contiguous binary UV bytes → RasterArraySource::submitHostField() → LocalParticleFieldFeed → ParticleFieldDataAdapter → ParticleFieldSnapshot`；没有新增第二套 Descriptor、Snapshot、Timeline 或 Runtime Window。
|
||
- canonical v1 固定 north-west origin、row-major、north-to-south rows、west-to-east columns、`float32-le interleaved-uv`，其中 U=eastward、V=northward；Field payload 不走巨大 JSON/JS Array。
|
||
- 第一个合法 Field 暂存 T0，第二个复用既有 initial T0/T1 bridge 并建立 Core-owned Timeline，后续 Field 只追加到同一个有界 Timeline；Duplicate/Invalid 均 fail-closed，last valid 保持。
|
||
- Android `MapLibreMap`/JNI 增加单 Field binary submit；Validation Host 增加 HOST FIELD SUBMIT、HOST DUPLICATE、INVALID HOST，并由 Kotlin 读取本地资源模拟未来 React Native Host。旧 fixture 与 STEP-051 production feed 保留。
|
||
- Linux OpenGL `mbgl-test-runner`、`mbgl-render`、`mbgl-render-test-runner` 构建通过；新增 Host/canonical 4/4、Source 44/44、RasterParticle property 2/2 PASS。未执行 Android Gradle/APK/ADB/设备或 Jest。
|
||
- Renderer、GPU simulation/trail、Runtime Window、Playback ownership、WeatherColorLayer 分离边界未改。状态：`IMPLEMENTED / WAITING_ANDROID_VALIDATION`；用户正式数据尚未提供，不能提前关闭。
|
||
|
||
## 2026-09-04 — STEP-053 Android Validation Host 接线补充
|
||
|
||
- STEP-053 Host submission API/JNI 和 Host 控件已在 `b31f80c...` 存在；为让手工入口与 STEP-051 `PRODUCTION FEED` 一眼区分，MORE 现显示 `PRODUCTION FEED → HOST FIELD → INVALID PROD → HOST DUPLICATE → HOST INVALID`。
|
||
- `HOST FIELD` 继续只读取既有 T0～T3 metadata/binary assets 并逐片调用正式 `MapLibreMap.submitRasterArraySourceHostField()`；新增低频 `HOST_FIELD_DATASET_LOAD` 日志，Native 继续输出带 fieldId/generation/validTime 的 Host submit 事件。
|
||
- Host duplicate 与 Host invalid 均重用同一 Host submission contract，不通过 style reload 伪造验证。未修改 Adapter、Timeline、Runtime Window、Renderer、JNI/Core 语义或任何网络/provider 逻辑；状态仍为 `IMPLEMENTED / WAITING_ANDROID_VALIDATION`。
|
||
|
||
## 2026-09-04 — STEP-053 Android 技术验收最终收尾
|
||
|
||
- STEP-053 正式 `CLOSED / PASS`。用户 Android 综合验收确认 `HOST FIELD` 与 STEP-051 `PRODUCTION FEED` 路径分离；canonical `production-wind-t00`～`t03` 真实经过 Host Submission、Adapter、Snapshot、Timeline、Runtime Window 和 GPU Renderer。
|
||
- T0/T1 initial、T2/T3 next、PLAY、automatic MIX 和两次 production→production boundary 全部 PASS；两次 boundary 均为 `OLD_T1 → NEW_T0` reuse、only NEW_T1 upload、`simulationRebuild=false`、`trailCleared=false`。
|
||
- `fieldUploadCount=4 → 5 → 6` 证明正常 boundary 每次仅上传一个 NEW_T1。唯一 `simulationResetCount=1` 属于旧 fixture 切到 Host dataset 的允许初始化，不是正常 production boundary 回归。
|
||
- `HOST DUPLICATE` 返回 `DUPLICATE_NOOP` 且 upload/reset 不增长；`HOST INVALID` 经 Adapter reject fail-closed，last valid field 与 Renderer continuity（`stateSeed=CONTINUE`）保持，无黑屏、无 crash。
|
||
- 用户正式风场数据集仍未提供、未验证，但不阻塞 contract 阶段关闭；后续可在同一 canonical contract 下追加。MIX 文本滞后及 WAITING/INVALID 视觉为 `NON-BLOCKING observability`，本次未修改功能代码或执行 Android/Jest。
|
||
|
||
## 2026-09-04 — STEP-054 真实 WeatherV2 风数据 Canonical 测试 asset
|
||
|
||
- 只读核对 WeatherV2 `bin_export.py`、`decode_wind()`、QBIN/NSFT export 后，确认 `wind_vectors.bin` 为完整拼接 `WVECBIN1` grid：row-major U/V/speed float32-le planes + valid uint8 plane，U=eastward、V=northward，单位 m/s；QBIN/NSFT 均由同一 decoded U/V Field 生成。
|
||
- 从 run `2026080600` 生成真实 ECMWF HRES `2026080700/06/12/18` 四帧。原始日本及周边 bounds 为 112.5/0.0/157.5/55.776573，`513×769`，不裁剪、不重采样；输出 canonical interleaved U/V Android assets，每帧 3,155,976 bytes。
|
||
- 转换器独立放在 `tools/weatherv2_wind_canonical/`，保留 valid/noData：invalid 写既有 -9999 sentinel，不伪造为 0 风；四帧 hash 不同，重复 T0 hash 相同，source→canonical 抽样误差 0。未改 Core/Renderer/Android，也未执行 Android/Jest；等待下一阶段集中 Android 集成验收。
|
||
# STEP-055 — Android 真实 WeatherV2 风场色场/粒子综合可视化（IMPLEMENTED / WAITING_ANDROID_VALIDATION）
|
||
|
||
- 复用 STEP-054 的真实 ECMWF HRES WeatherV2 canonical T0–T3（513×769、原始 validTime、U eastward/V northward、m/s），未重生成或重采样。
|
||
- 新增独立 `weather-color` 层：同一 canonical T0/T1 的 U/V 先插值再计算风速，固定 0–30 m/s 色标；与 RasterParticleLayer 保持分离。
|
||
- `MORE → REAL WEATHER` 通过既有 Host Submission Contract 一键提交真实字段，使用 OSM 无 Key 底图、自动 fit metadata bounds，并恢复旋转/Activity 重建后的可见内容。
|
||
- Android 综合验收待用户手工完成；详见 STEP-055 人工验收指令。
|
||
|
||
## 2026-09-05 — STEP-055 首轮 Android 视觉修复（IMPLEMENTED / WAITING_ANDROID_VALIDATION）
|
||
|
||
- 首轮实机已证实真实 WeatherV2 T0–T3、513×769 canonical Field、Host submit 和 WeatherColorLayer 可用；本轮将 REAL WEATHER 底图从 OSM 切到 GSI，并把入口提升为 `TIME | VIS | COUNT | MAP | REAL WEATHER | MORE` 的一级菜单。
|
||
- REAL WEATHER 首次加载采用 P=2048、W=.75、L=.0040、O=.75、T=.55、F=.88，并提供同状态 HUD、低频 `PARTICLE TUNING` 调整与 RESET；不重载 Style/Field/Timeline，只有容量调整会重建粒子 State/draw resources。
|
||
- 将原无单位 `velocity * 0.00004` 位移替换为 canonical m/s 到 Web Mercator world 的 Earth-circumference/cos(latitude) 换算；6000 simulation-seconds/real-second 是独立的 validation visual clock，不污染 U/V、validTime 或 Timeline。新增低频 `ParticleMotion` CPU 估算日志，未做 GPU readback。
|
||
- Linux OpenGL 受影响 Core/style test translation unit 精确编译与 shader generator 通过；Android Gradle/APK/ADB/Jest 未执行。等待用户按人工验收 v2 做一次综合复验。
|
||
|
||
## 2026-09-05 — STEP-055 Particle State Float 精度修复（IMPLEMENTED / WAITING_ANDROID_VALIDATION）
|
||
|
||
- Android 日志已将“真实 U/V、非零 world displacement、State A/B ping-pong 均存在但粒子静止”收敛为 RGBA8 State 量化：单步 `3e-6–8e-6 world` 小于 UByte `1/255` 的可表示间隔。
|
||
- State A/B 现在为 Float，Trail A/B 保持 UnsignedByte；初次创建、context recreation 与 particleCount replacement 均通过同一 Float target 路径，FBO 创建失败明确 fail-closed，不静默降级。
|
||
- 现有 OpenGL `Float → RGBA32F/GL_FLOAT → FBO check` 支持直接复用，未改 backend、canonical/Timeline/Window/WeatherColorLayer 或 visualSpeedScale=6000。下一次 Android 的首要检查是 Timeline Pause 下真实固定场粒子是否持续移动，并核对 `ParticleStateTarget` 类型日志。
|
||
## STEP-055 Float State fail-closed 小修复
|
||
|
||
在 Particle Validation `createValidationTarget()` 增加局部标准异常与未知异常捕获。Float State RenderTarget/FBO 创建失败会记录结构化错误并返回空 target，不会向上抛出或降级到 UnsignedByte；State A/B=Float、Trail A/B=UnsignedByte 保持。Linux 精确编译通过，仍待 Android 验收。
|
||
## STEP-055 生命周期、真实轨迹与 view-space Trail 修复
|
||
|
||
真实 Weather 路径改为 GPU age/哈希 respawn，StateRead→StateWrite 真实位移 segment，且 Trail 仅在当前 camera view 内累积。相机变化只重建 Trail；`trailFade` 改为 wall-time 指数衰减。visual clock 调整为 1200 simulation seconds/real second。canonical、Timeline、Runtime、WeatherColorLayer 未改，仍待 Android 综合验收。
|
||
## STEP-055 生命周期错峰小修复
|
||
|
||
粒子基础生命周期调整为 14400 simulation seconds（12 real seconds），首次 seed 与 maxAge 都由稳定 hash 错峰，消除同步生命周期到期。日志改用 configuredSlots 并说明无 GPU readback；其他粒子视觉与数据链语义未改。
|
||
## STEP-055 低缩放可见性与 Trail 稳定性修复
|
||
|
||
Particle visual clock 改为基于 zoom 的有界 scale 与 2400s/frame clamp；State lifecycle 改为 12s base 的 wall-time hash jitter。普通 camera 交互只 invalidate 一次并在稳定后恢复 Trail，只有 resize 重分配 Trail texture。canonical 与 Core 时间线边界未改，待 Android 验收。
|
||
|
||
## STEP-055 Zoom 下 Viewport 粒子密度调整
|
||
|
||
configured particleCount 保持不变；稳定相机后，State respawn 域改为“viewport 四角 Mercator AABB + 15% margin”与 canonical Field bounds 的交集。camera moving 期间继续从 full Field respawn，稳定至少 150ms 后才让 viewport 外 slot 回收进入该域；无效/空/过小交集安全回退 full Field。新增独立 respawnBounds UBO，不改变 Field sampling 边界、Timeline、Runtime、WeatherColorLayer 或 canonical U/V，仍待 Android 验收。
|
||
|
||
## STEP-055 v9 Android C++ 编译遗漏修复
|
||
|
||
WeatherColorLayer 的 `ParticleGpuValidationUBO` designated initializer 补齐 `respawnBounds`，并使用与 `fieldBounds` 相同的中性范围；仅修复 Android `-Wmissing-designated-field-initializers` 编译失败。已搜索确认两个 C++ initializer 均完整，未改粒子 respawn、色场行为或冻结数据/时间线边界，仍待 Android 验收。
|
||
|
||
## 2026-09-05 — STEP-056 React Native 天气渲染桥接现状调查
|
||
|
||
- 仓库当前没有 React Native/TurboModule/Fabric/JSI binding；可复用正式入口是 Android `byte[] → JNI → RasterArraySource::submitHostField()`，它已接入 canonical Adapter/Snapshot、Core Timeline/Window 与两个 GPU layer。
|
||
- 推荐先建立 Android Host Weather Runtime typed facade：runtime unload/clear、canonical field submit、timestamp playback、visibility/style 和低频 result/event；RN module 应在具备 RN host/build dependency 的后续任务中薄包裹该 facade。
|
||
- 单帧 WeatherV2 payload 为 3,155,976 bytes；RN v1 应先稳定复用 byte[] path，zero-copy/direct ByteBuffer 仅在 profiling 后处理。动态 WeatherColor stops、独立 particle/trail color 和 weather-local targetFps 均是当前缺口；后者应独立性能批次，不能使用全图 `MapView#setMaximumFps()` 冒充。
|
||
|
||
## 2026-09-07 — STEP-057 Android Host 天气运行时接口基础
|
||
|
||
- 新增主线程 `WeatherRuntime` typed facade，封装 canonical submit、typed result/state、clear、OFF unload、timestamp seek、play/pause/0.5/1/2x、独立 visibility 和 visual API；未来 RN 只需包裹该 facade。
|
||
- clear 后 Source 保持可复用但无 field；Render 线程空场路径释放 Particle State/Trail/draw、field texture 与 WeatherColor resources。OFF 不 reload style，ON 后要求重新 submit T0/T1。
|
||
- WeatherColor 支持最多 8 个 validated dynamic stops；particleColor/trailColor 独立 UBO 数据通路，不依赖 WeatherColor ramp。正常 time seek 和 visual/ramp/color 更新均不重新提交 field 或 reset simulation。
|
||
- Linux shader generator、OpenGL Core 及相关 Source/Style test translation unit 已验证；Android Gradle/APK/ADB/设备/Jest 留待后续人工验收。
|
||
|
||
## 2026-09-07 — STEP-057A 审计修正
|
||
|
||
- `WeatherRuntime` 正式 Host API 改为明确 typed 粒子外观方法，删除 public string property setter；Test App 的通用 fixture 调试仍为低层路径。
|
||
- enable/clear/disable/submit 状态转换已幂等并可恢复，另增加既有 Android JUnit state transition 测试源码；未运行 Gradle。
|
||
- hidden unload 改成 RasterParticle/WeatherColor renderer 的 Host-empty-source 显式 opt-in cleanup，移除对所有 hidden RasterArray layer 的全局 prepare/update。
|
||
- timestamp 测试改用真实 epoch milliseconds，覆盖 T0、midpoint、T1、上下边界和 clear 后拒绝；WeatherColor capacity 由 Java 通过 JNI 读取 C++ `MaxWeatherColorStops`。
|
||
|
||
## 2026-09-07 — STEP-057B WeatherRuntime 状态语义修正
|
||
|
||
- 普通 field rejection 与 facade/runtime failure 分离：Core 保留有效 timeline 时，READY/WAITING 状态不被坏提交改成 ERROR；空 metadata/payload 同样只拒绝本次提交。
|
||
- `REJECTED_SOURCE_MODE`/`UNKNOWN` 才进入 ERROR；ERROR + enable(true) 返回 REJECTED 并保持 ERROR；READY/WAITING enable 保持幂等，DISABLED enable 成功后等待新 fields。
|
||
- 扩展 `WeatherRuntimeStateTest`，覆盖 static state transition 与 Mockito public control flow；未执行 Android Gradle、设备测试或 Jest。
|
||
|
||
## 2026-09-07 — STEP-057C Android JNI 数组读取编译修正
|
||
|
||
- Android x86_64 CMake 编译发现 `jni::Array<jfloat>` 误用底层 5 参数 `jni::GetArrayRegion`，导致 `native_map_view.cpp` 四处编译失败。
|
||
- 已改为 `jni::Array::GetRegion()`，只修正 particle/trail 与 WeatherColor stops 的数组读取，不改变业务语义或渲染生命周期。
|
||
- 功能提交：`4f76245533817751f4e24f76e47e856c35fb23c7`；Android Gradle/设备验证由用户重新执行。
|
||
|
||
## 2026-09-07 — STEP-057D WeatherRuntime 接口收尾与 RN 桥接前冻结
|
||
|
||
- `WeatherRuntime` 新增独立 typed `setParticleColor()` / `setTrailColor()`，分别委托 Core 独立颜色 setter；保留原 `setParticleColors()` 作为兼容成对提交 helper，不猜测或复制 Core 默认色值。
|
||
- REAL WEATHER submit 使用 `FieldSubmitResult`/`accepted()` 与 enum 日志，不再依赖 `getCode()`；REAL WEATHER 的 playback/visual 不再回退到 MapLibreMap 低层入口，旧 fixture/diagnostic 路径继续保留。
|
||
- 本轮仅执行 `git diff --check` 与源码静态审计；未执行 Android Gradle、APK、ADB、设备测试或 Jest，状态为 `IMPLEMENTED / READY_ANDROID_COMPILE_CHECK`。
|
||
|
||
## 2026-09-07 — STEP-058 Weather-local Target FPS 与 Repaint Gate
|
||
|
||
- 新增 source-owned `RasterArrayTargetFps`（AUTO/30/60）与单一 `RasterArrayTimelineRuntime` cadence authority；Particle/WeatherColor 共用 monotonic deadline，真实 wall-time simulation、Timeline、T0/T1 window reuse 保持不变。
|
||
- Android `WeatherRuntime.setTargetFps()` 通过 typed MapLibreMap/JNI source setter 接线；使用已有 `triggerRepaint()` 做目标间隔 delayed wake-up，不使用全局 `MapView#setMaximumFps()`，REAL WEATHER popup 提供 FPS AUTO/30/60 与 HUD。
|
||
- 未到 deadline 的 camera frame 不推进天气 State/Trail/Timeline；两层 visibility、PLAY/PAUSE、clear/disabled 组合按 shared cadence 规则处理。Linux/OpenGL 增量构建与 deterministic/source 定向测试通过，Android Gradle/设备/Jest 未执行。
|
||
|
||
## 2026-09-07 — STEP-058A Shared Cadence 与 WeatherRuntime 生命周期修正
|
||
|
||
- `advanceIfDue()` 将 shared deadline claim、cadence revision、真实 wall-time MIX 推进合为 Source-owned 原子操作；WeatherColor-only PLAY 能推进 timeline，Particle 后到同一 deadline 不重复推进 State/Trail/Timeline。
|
||
- WeatherColor-only PAUSE 不维持连续 repaint；Particle PAUSE 仍可独立按 cadence 运动。`WeatherRuntime.dispose()` 幂等取消 Handler wake，Test App 在 style reload、leave REAL WEATHER、Activity destroy 显式释放旧 facade。
|
||
|
||
## 2026-09-07 — STEP-057D 审计后小修正
|
||
|
||
- 独立代码审计发现 REAL WEATHER 下 `WeatherRuntime` timeline 命令被拒绝时，TestApp 原条件表达式会跳过 reject 分支并误记为成功。
|
||
- 已改为显式 `commandAccepted` 判定：REAL WEATHER 只接受 `WeatherRuntime.CommandResult.ACCEPTED`；拒绝时立即 return，绝不 fallback；legacy/diagnostic 低层 timeline 路径继续保留。
|
||
- 修正提交：`74e3cc911b8cecd4f3d75613055c213a8bcebcdb`；未执行 Android Gradle、APK、ADB、设备测试或 Jest。
|
||
# 2026-09-07 — STEP-060 RN Test Host 与 WeatherRuntime 薄桥接
|
||
|
||
- 建立 `integration/react-native/MapLibreParticleRNTestHost`，冻结 RN/Expo/MLRN 技术基线；style 预先创建 host-field RasterArraySource、WeatherColorLayer、RasterParticleLayer，但不传 Binary Field。
|
||
- MLRN 11.3.6 的共享 ReactTagResolver 实例由 `MLRNPackage` 私有持有；Test Host 改用 RN/Fabric 的公开 UIManager view resolver，即时收窄到 MLRNMapView 并读取其公开 MapLibreMap，不复制私有 mViews 或建立 current-map registry。
|
||
- MapLibreMap 新增 map-owned WeatherRuntime attach/detach seam；style replacement、view detach 与 React unmount dispose 旧 facade。Android custom SDK 必须先手工发布 Maven Local，Host 配置会排除 Maven Central 中 org.maplibre.gl fallback。
|
||
- 非 Android 验证：冻结 package-lock/config、Node config plugin 语法、禁止 Binary Field/global map/private registry 搜索与 throttle 下 `tsc --noEmit` 均通过；Android Gradle/设备/Jest 未执行。
|
||
|
||
# 2026-09-07 — STEP-060A RN Test Host 编译前修正
|
||
|
||
- 按 RN 0.85.2 当前 Codegen 模板为 TurboModule 的 20 个必选 Kotlin Spec 方法补齐 `override`，消除首次 Android 编译的确定 blocker。
|
||
- Test Host package manager 统一为 npm/package-lock；实际 `npm ci --ignore-scripts` 不需 legacy peer deps。文档将 Android toolchain 数值改为首次 prebuild 前的验收目标，待生成工程实测。
|
||
|
||
# 2026-09-07 — STEP-060B Gate C 封存环境与 Custom AAR 接入修正
|
||
|
||
- Gate C 继续只表示 MapLibre Native custom AAR 的封存 Linux 编译环境；STEP-060 Maven Local 继续是 RN Test Host handoff，不因 Expo 生成工程的 Gradle/AGP/NDK 数字反向修改 Gate C。
|
||
- publication 源码确认 custom OpenGL 坐标 `org.maplibre.gl:android-sdk-opengl:13.4.1` 与精确 Maven Local task `publishOpenglreleasePublicationToMavenLocal`。plugin 将 Central 排除收敛到该唯一 custom module，确保 AAR 缺失 fail-closed，且不阻断 MLRN turf/plugins 辅助依赖。
|
||
|
||
# 2026-09-07 — STEP-060C Maven Local 签名隔离修正
|
||
|
||
- Vanniktech `signAllPublications()` 仍负责建立 Maven Central 的 publication 签名；其默认 release required 条件覆盖 Maven Local，导致无 signatory 时 Local handoff 失败。
|
||
- publication build logic 现将 Gradle `SigningExtension.required` 延迟绑定到 task graph：存在 `*PublicationToMavenCentralRepository` 时必须签名；精确 Maven Local publication 则跳过 Sign task，不需要 PGP secrets、`-x sign`、SNAPSHOT 或第二仓库。
|
||
- 实现阶段曾核对中间 AAR SHA-256 `47646fb708d096cf5ee0c3b8eeaeb7e6083081279c79f4a642db554efe88fad7`，当时未重建、未执行 Gradle publish；该 SHA 与等待状态已在随后的人工 publication 验收中被最终 artifact 结果取代。
|
||
|
||
# 2026-09-07 — STEP-060C 人工 Maven Local 验收收尾
|
||
|
||
- 用户在 Gate C 实际运行精确 Maven Local publication task：`signOpenglreleasePublication SKIPPED`，`publishOpenglreleasePublicationToMavenLocal` 成功，`BUILD SUCCESSFUL in 3m 33s`，不再有 `no configured signatory`。
|
||
- 最终 Maven Local AAR、当前 build output AAR SHA-256 一致，均为 `2e73e25cfd31bb181f75ba2d84974afb949640f72de46bc0234d4579abe3ba38`；POM/module 坐标正确，AAR 含 WeatherRuntime/MapLibreMap 和四 ABI，Local 无 `.asc` 符合设计。此前 `47646fb…` 是 publication 前中间 SHA，已失效。
|
||
- STEP-060C 状态关闭为 `CLOSED / PASS`，范围仅 Maven Local signing isolation 与 publication handoff；RN Test Host Android compile、Phase A/B、lifecycle、Binary Field 与 STEP-061 仍未验证。
|
||
|
||
# 2026-09-08 — STEP-060D WeatherRuntimeBridge attach 精确诊断
|
||
|
||
- attach 现独立报告 `rn-weather-fields`、`rn-weather-color`、`rn-weather-particles` 状态；`WEATHER_OBJECTS_NOT_READY` 包含 reactTag、MapView/MapLibreMap/Style 状态、三个 ID 的 present/missing、Style source/layer count 和 weather-first 的有界 ID 摘要。
|
||
- Linux 生成并发布唯一诊断 AAR：`org.maplibre.gl:android-sdk-opengl:13.4.1-step060d`，build output 与 Maven Local AAR SHA-256 均为 `7391440f02e976f295caa265bc15e895a7c0183883a0e2cb08deef4cf42b0096`，含四 ABI。
|
||
- 当前 Expo 生成工程缺失 `NativeWeatherRuntimeBridgeSpec`，标准 codegen task 为 SKIPPED，故 bridge Kotlin compile 不能独立验证；未改生成工程绕过。后续由 CARBON7i 用此唯一 AAR 收集 Android attach 诊断，仍不进入 STEP-061。
|
||
|
||
# 2026-09-08 — STEP-060E CoreOnly Layer 存在性检查修复
|
||
|
||
- 根因确认：WeatherColorLayer 与 RasterParticleLayer 属于 CoreOnly layer，Core 能渲染但没有 Java Layer peer；故 STEP-060D bridge 用 Style.getLayer() 会对真实 layer 产生假阴性。
|
||
- 新增 MapLibreMap.hasStyleSource/hasStyleLayer，经 Android JNI 直接查询 Core Style；bridge attach 三项 weather object 判断统一使用该真值，保留既有成功路径与 WeatherRuntime 生命周期，不增 Java peer、重试或私有 registry。
|
||
- WEATHER_OBJECTS_NOT_READY 改用 styleUri（JSON style 为 <empty>）并移除不可靠的 Java layer/source 枚举；临时 Maven version 升为 13.4.1-step060e。
|
||
- 本轮不构建 AAR、不发布 Maven Local，APK/ADB/设备验收待人工构建该版本后进行；仍属于 STEP-060，未进入 STEP-061。
|
||
|
||
# 2026-09-08 — STEP-060F WeatherColor Opacity 与 Android 收尾修复
|
||
|
||
- Android 已实测 attach PASS，`WEATHER_OBJECTS_NOT_READY` 已由 STEP-060E CoreOnly 真值链解决；无 Binary Field 的 `TIMELINE_NOT_READY` 仍是预期 fail-closed 行为。
|
||
- 修正 WeatherColor opacity 错走 particle-only setter：新增独立 Java/JNI/Core typed 路径，直达 `WeatherColorLayer::setOpacity()`，不扩大 RasterParticle whitelist 或新增 Java Layer peer。
|
||
- Test Host 将 `8091 -> 8091` 与 Android debug probe 所需 `8081 -> 8091` 固化到 Git 受控启动脚本，保留 `app.json` landscape；临时坐标升为 `13.4.1-step060f`。
|
||
- 状态为 `IMPLEMENTED / WAITING_ANDROID_VALIDATION`；AAR/APK/ADB/设备最终复验等待用户，本轮未进入 STEP-061。
|
||
|
||
# 2026-09-08 — STEP-060F Android 最终验收通过
|
||
|
||
- `13.4.1-step060f` OpenGL AAR 以 `JOBS=1` 构建并发布成功；Linux build output、Maven Local 与 CARBON7i 下载 AAR SHA-256 均为 `53dfcd43f3479ae43a3c0fd91c10ccbfec7cf1c84ae22ae3435c94393806da6d`。
|
||
- Bridge 与 MLRN 两条 `dependencyInsight` 均解析到 `13.4.1-step060f`；Test Host APK `assembleDebug` 通过。
|
||
- Android 实测横屏、双 Metro reverse、`WeatherRuntime attached` 均通过；完整验证 UI 的 `weather opacity` 返回 `ACCEPTED`。
|
||
- 当前 App PID 日志无 `WEATHER_OBJECTS_NOT_READY`、`UNSUPPORTED_PROPERTY`、FATAL/JNI/SIGSEGV hard-gate 错误；无 Binary Field 时 `TIMELINE_NOT_READY` 继续按预期 fail-closed。
|
||
- STEP-060 正式 `CLOSED / PASS`；后续可进入 STEP-061 Binary U/V Field Transport。
|
||
|
||
# 2026-09-08 — STEP-061 Binary U/V Field Transport（IMPLEMENTED / WAITING_RDC_REVIEW）
|
||
|
||
- RN Test Host 固定以 Expo FileSystem `File.write(Uint8Array)` 写 raw canonical `float32-le/interleaved-uv` U/V bytes，并经 TurboModule 的 `metadataJson + payloadFileUri` 交给 Kotlin；没有 number-array、payload JSON、base64 或 hex transport。
|
||
- Bridge 限制本地 `file://`/绝对路径、可读非空和 64 MiB payload，再调用既有 `WeatherRuntime.submitWindField(metadataJson, byte[])`；Core Adapter/Timeline/Runtime Window 未修改，仍是唯一验证与状态所有者。
|
||
- UI 提供 invalid byteLength probe（预期 `REJECTED_ADAPTER`）、T0（预期 `ACCEPTED_PENDING_INITIAL_WINDOW`）、T1（预期 `INITIAL_WINDOW_READY`）及 Native READY state evidence；JS 不管理 T0/T1/MIX runtime state。
|
||
- `npm run typecheck`、RN 0.85.2 Codegen（仅 `/tmp` 生成）和 `git diff --check` 已通过；未执行 AAR/Windows/APK/ADB/设备/Jest，等待 RDC 审查真实 diff。
|
||
|
||
# 2026-09-09 — STEP-061 RDC NEEDS FIX 修正（IMPLEMENTED / WAITING_RDC_REVIEW）
|
||
|
||
- Binary UI 改为初始/提交时 PENDING，仅在 invalid/T0/T1/Native state 严格为 `REJECTED_ADAPTER`、`ACCEPTED_PENDING_INITIAL_WINDOW`、`INITIAL_WINDOW_READY`、`READY` 后显示 READY；任一不符 fail-closed 显示 ERROR。
|
||
- Runtime 文案严格分离 Core evidence（`INITIAL_WINDOW_READY + runtime READY`）和 producer identity；MIX 为 Core-owned/not exposed，Android 最终 T0/T1 仍由既有 HOST_FIELD logcat 事件验证。
|
||
- Kotlin 显式捕获 IOException、拒绝无 scheme 相对路径，metadata 上限按 UTF-8 bytes 计算。AAR 坐标已准备为唯一 `13.4.1-step061`，不覆盖冻结 step060f；本轮按限制未 build/publish，待 RDC 后续指令。
|
||
|
||
- 本轮 `npm run typecheck`、RN Codegen（仅 `/tmp`）、plugin `node --check`、禁止 transport 审计与 `git diff --check` 均通过；继续停在 Codex prompt 等待 RDC。
|
||
|
||
# 2026-09-09 — STEP-061 Binary U/V Field Transport Android 最终关闭
|
||
|
||
- Source commit `4467adcce02db7f1bbbea1f4a829023c53085e39` 的 RN binary file-reference transport 已完成 Android OpenGL 端到端验收，STEP-061 正式 `CLOSED / PASS`。
|
||
- AAR `org.maplibre.gl:android-sdk-opengl:13.4.1-step061` 以 `JOBS=1` 构建；Linux build output 与 Maven Local SHA-256 均为 `40ec19724cbe0807c09c6acf9b7e6e0dac2f2498f1269b6bacdd35740a6cd77a`，CARBON7i 下载与 Win11 Maven Local 同 SHA。
|
||
- Bridge 与 MLRN dependencyInsight 均唯一解析到 `13.4.1-step061`；Win11 Test Host `assembleDebug` 为 `BUILD SUCCESSFUL in 1m 50s`。
|
||
- Android `192.168.1.146` 实测：Invalid=`REJECTED_ADAPTER`，T0=`ACCEPTED_PENDING_INITIAL_WINDOW`，T1=`INITIAL_WINDOW_READY`，GETSTATE 后 runtime=`READY / PAUSE / AUTO`；Binary Transport=`READY: FILE_REF / FLOAT32_LE / INTERLEAVED_UV`。
|
||
- 当前 App PID hard gate 中 FATAL/SIGSEGV/WEATHER_OBJECTS_NOT_READY/JNI DETECTED/UnsatisfiedLinkError/NoSuchMethodError 均为 0；非法 payload 的 `PAYLOAD_SIZE_MISMATCH` Warning 可见并保持 fail-closed。
|
||
- Release AAR 的 `HOST_FIELD_SNAPSHOT_READY` / `HOST_FIELD_INITIAL_WINDOW_READY` INFO 日志本轮未在设备 logcat 观察到，已如实记录为 observability 限制；未伪造日志证据，正向以 direct Core result + Native READY 为权威。
|
||
- 未进入 NavSea，未引入 provider/network/vendor 逻辑，未使用 number[]/payload JSON/base64/hex，未加入或运行 Jest；`/mnt/nas/pbf` 临时制品已清理，baseline UI 与 Git 当前 App.tsx 保持一致。
|
||
|
||
# 2026-09-09 — STEP-062 RN Test Host 真实 WeatherV2 底图粒子综合验证（IMPLEMENTED / WAITING_ANDROID_VALIDATION）
|
||
|
||
- Test Host 固定 `13.4.1-step061` AAR，不改 Native/Core/JNI/WeatherRuntime，不 build/publish AAR，不进入 NavSea。
|
||
- style 升级为 `background → GSI raster → WeatherColorLayer → RasterParticleLayer`，GSI 使用 Android Validation 已验证 URL、256/maxzoom18/attribution；Camera 初始聚焦日本及周边。
|
||
- Android Validation 的 ECMWF HRES 20260807 canonical T0–T3 assets 已原样放入 Host assets，四帧各 3,155,976 bytes 且逐文件 SHA-256 一致。
|
||
- `expo-asset` 以静态 `.f32` require + `downloadAsync()` 输出 cache `file://` URI；只把 metadata string 与 local file reference 交给既有 STEP-061 bridge，绝不 materialize payload 为 array/JSON/base64/hex。
|
||
- `LOAD REAL WEATHER T0-T3` clear 后严格断言 Pending、InitialWindowReady、NextSnapshot、NextSnapshot 和 Native READY；控制页提供 timestamp seek、playback/speed/FPS、独立 visibility/stops/colors 与视觉参数。静态 typecheck/Metro/asset hash 通过；RDC 追加 Android Expo export 也已确认四个 `.f32` 正常打包，功能提交 `a91e3601f37f3adfe5d8b7b6a6c3f7f04fcadb8f` 已 push；Android APK/实机待 CARBON7i 一次综合验收。
|
||
|
||
# 2026-09-09 — STEP-062 Android APK-only 最终关闭
|
||
|
||
- 用户已在 Win11 Test Host 手工完成依赖安装、typecheck、APK 编译/安装和实体机综合验收；Metro 确认 `.f32=true`，Test Host 始终使用冻结 `org.maplibre.gl:android-sdk-opengl:13.4.1-step061`。
|
||
- GSI 日本标准底图、真实 WeatherV2 T0–T3、binary file ingress、既有 Native/Core 正式入口、WeatherColor、GPU 粒子、地图拖动/缩放/旋转联动、双层独立显示、视觉参数、四时次切换及其他可操作交互均经用户确认 OK；LOAD 后整体评价为“非常完美”。
|
||
- Timeline/Playback 可操作且未见明确异常；因四帧间隔 6 小时，短时自动播放视觉变化不明显。用户接受当前表现，不追加专用 Timeline 可观测性 UI，不构成关闭阻塞。
|
||
- 最终用户验收未额外执行完整 PID logcat 硬门槛扫描，未声称 logcat 0 error。未改功能代码/Native/Core/JNI/WeatherRuntime，未 build/publish AAR，未接入 NavSea，未执行 Gradle/APK/ADB/Jest；STEP-062 正式 `CLOSED / PASS`。
|
||
|
||
# 2026-09-09 — STEP-063 Android v1 发布工程化（IMPLEMENTED / WAITING_MANUAL_RELEASE_VALIDATION）
|
||
|
||
- 实际 upstream Android 基线确认是 MapLibre Native `13.4.1` / core `18545ca` / OpenGL；建立 `13.4.1-particle.1` release manifest、`@navsea/maplibre-particle-rn` 与 `cc.navsea.maplibre:android-sdk-particle-opengl` 正式契约。
|
||
- Android publication 配置、正式 bridge/package 和 Gradle substitution 统一到 NavSea AAR，MLRN 保持唯一 native module；Consumer Host 只依赖正式 npm package，不引用源码路径、Native tree 或 bridge source。
|
||
- `npm pack` 与 package TypeScript/static audit 完成；未执行 Android Gradle/AAR/APK/ADB/Jest，未决定 registry，未创建 release tag。下一步为用户手工 AAR publication 与 tarball Consumer APK/实体机验证。
|
||
|
||
# 2026-09-10 — STEP-064 RN 纯 Field Renderer 接口 V2（IMPLEMENTED / WAITING_CONSUMER_VALIDATION）
|
||
|
||
- `@navsea/maplibre-particle-rn` 升为 `13.4.1-particle.2`，根入口只提供 `FieldRuntime`、纯类型与 field style fragment；旧 Weather/Wind 公共 API、MLRN facade re-export 与兼容 wrapper 均删除。
|
||
- 包内 WeatherV2 HTTP、manifest、time index、decoder 与 loader 已移出，Consumer Test Host 保留自身的真实 fixture/file URI 业务链，并直接从官方 MLRN 导入 Map/Camera。
|
||
- `FieldColorStop.value` 在 RN 薄层转换为冻结 Native ABI；无 Native module 时 import 安全，实际调用明确失败。图场与粒子继续共享一次 canonical Field 提交，显示可独立控制。
|
||
- Native/Core/JNI/shader/Android AAR 未改，artifact 继续 `cc.navsea.maplibre:android-sdk-particle-opengl:13.4.1-particle.1`；Android Gradle/AAR/APK/ADB/Jest/NavSea 均未执行。package 与 Consumer TypeScript 检查已通过，发布 tarball 的实际 Consumer 验证待后续完成。
|
||
|
||
## 2026-09-10 — STEP-064 Consumer 验证通过 / Release Freeze 前
|
||
- `.2` Consumer 首轮发现 RN style helper 的 `raster-particle-opacity` 非 Native `.1` 支持属性，导致 particle layer 缺失；RN-only 修正为 `raster-particle-active`。
|
||
- 固定 Consumer 复用既有 Native `.1` APK，通过 Metro 加载 `.2`：FieldRuntime attach、真实 T0–T3、Runtime READY、Field/Particle 独立开关与恢复全部通过。
|
||
- hard gate 未见 WEATHER_OBJECTS_NOT_READY、FATAL、SIGSEGV、JNI/链接错误；未重建 Android AAR/APK。
|
||
- 当前进入 `maplibre-particle/rn/13.4.1-particle.2` Release Freeze/Tag。
|
||
|
||
## 2026-09-10 — STEP-064 正式发布 / 冻结
|
||
- `@navsea/maplibre-particle-rn@13.4.1-particle.2` 已正式发布；release source `e43b58707cfd0f87965424477ed3f95625b3f724`，tag `maplibre-particle/rn/13.4.1-particle.2` 已 push。
|
||
- 正式 HTTPS tgz 为 10,660 bytes，SHA256 `ace9e0401824839d18a93cc4201c1f5d4cccbff0636570cfde82fd80b60779b5`，NAS 与公网下载字节一致。
|
||
- Win11 Consumer 已从正式 HTTPS URL 安装并通过 TypeScript/依赖树检查；此前 Android Consumer 已通过 FieldRuntime、T0–T3、Runtime READY 与 Field/Particle 独立开关。
|
||
- Native AAR 继续使用 `13.4.1-particle.1`；STEP-064 冻结，后续 RN 修改从 `.3` 开始。
|
||
|
||
# 2026-09-10 — STEP-065 V3 通用 Scalar / Vector Field 架构冻结
|
||
|
||
- 只读核对当前 v1 Core/RasterArray Timeline/两 renderer/GLSL、Android/JNI/RN binary ingress，以及 WeatherV2 NSFT Wind/Tide/Rain/Wave；未修改生产代码、WeatherV2 或 NavSea，未执行 Gradle/APK/ADB/Jest。
|
||
- V3.0 冻结为 `maplibre-particle-field/v2`：一个 Snapshot 最多一个 scalar plane、一个 interleaved U/V vector plane 和一个 shared validity plane；scalar-only、vector-only、scalar+vector 合法，neither fail-closed。
|
||
- Renderer policy 与数据分离：Field 明确选择 `SCALAR` 或 `VECTOR_MAGNITUDE`，Particle 明确选择 `VELOCITY` 或 `DIRECTION`；Wave direction 是归一化方向，插值近零/反向时 fail-closed，推进 scale 独立于业务数据。
|
||
- 保留 v1 作为最薄 ingress normalize，运行时只保留一套 V3 Timeline/GPU bundle；保护 T0/T1/MIX、pause、OLD_T1→NEW_T0 bundle reuse、only NEW_T1 upload、normal rollover 不重建 simulation/clear trail。
|
||
- 下一步为 V3-02 Core Contract + Scalar Snapshot/Adapter；先完成 Linux/Core fixture 与 compatibility，再统一进入 GPU、Android/JNI/RN 与一次 Android 综合验收。
|
||
|
||
# 2026-09-10 — STEP-066 V3-02 Core Contract 与 Scalar Snapshot Adapter
|
||
|
||
- Core snapshot 现为 optional scalar、optional interleaved U/V vector 与 shared validity；v2 vector-only、scalar-only、scalar+vector 均由独立 plane bundle 解码，neither 和尺寸/semantic/finite/validity 错误 fail-closed。
|
||
- 旧 v1 单 payload 未扩展：adapter 从 U/V noData 派生 shared validity，并归一为 `VELOCITY` vector snapshot；Core 不再以 `WIND/GLOBAL` 判断 capability 或 compatibility。
|
||
- Timeline T0/T1/MIX/pause/rollover ownership 未改；compatibility 收紧为 grid/bounds、channel presence 与 vector semantics；content identity 覆盖 scalar/vector/validity 的逐值变化。
|
||
- 既有 GPU renderer 尚不消费 scalar：本轮只让 scalar-only 不可用，未改 shader 或渲染计算。Linux OpenGL Core/source test 精确编译和 `Source.ParticleFieldV3*` 过滤测试通过；未运行 Gradle/AAR/APK/ADB/Jest。
|
||
|
||
# 2026-09-10 — STEP-067 V3-03 Scalar GPU 与 Generic Field Renderer
|
||
|
||
- WeatherColor 现以显式 `FieldValueSource::Scalar|VectorMagnitude` 决定使用 canonical scalar 或 U/V magnitude；默认仍是 `VectorMagnitude`，保持现有 Wind 色场。两个时间片均按 selected channel + shared validity fail-closed，scalar 在 GPU 作 T0/T1 数值插值后走同一 generic color ramp。
|
||
- `WeatherColorStop` 的 C++ 字段从 `speedMps` 收敛为 generic `value`；shader/UBO/log 不再声称固定 m/s。切换 value source 会重新编码资源，正常 OLD_T1→NEW_T0 rollover 仍复用同一 decoded bundle。
|
||
- RasterParticleLayer 继续只接受 `Velocity` U/V；scalar-only 或 `Direction` 立即不可绘制并释放粒子资源，未实现 DIRECTION advection。
|
||
- shader generator、受影响 C++ 对象和 Core/layer 过滤测试均通过；全量 OpenGL `mbgl-test` 链接受当前单次终端时限限制未完成，未虚报 PASS。未运行 Gradle/AAR/APK/ADB/Jest，未触碰 STEP-062 或历史未跟踪内容。
|
||
|
||
## 2026-09-11 — STEP-067 Linux 全量目标验证收尾
|
||
|
||
- 用户在当前 `HEAD` `06fcbef9ccb820e595f06acbd356950de7e3a73f` 手工执行 `ninja -C build-linux-opengl -j3 mbgl-test mbgl-test-runner`，Ninja 返回 `no work to do.`；确认 `mbgl-test` 与 `mbgl-test-runner` 完整目标及其依赖已经最新，没有待处理构建或重链接工作。
|
||
- 此结果只关闭此前 Linux 全量目标重链复验，不代表重新执行全量测试用例；本轮未执行 Android Gradle/AAR/APK/ADB/Jest，未修改生产代码、STEP-062 用户修改或其他历史未跟踪内容。STEP-067 正式 `CLOSED / PASS`。
|
||
# 2026-09-11 STEP-068：实现 V3 DIRECTION 粒子推进与 renderer `advectionScale`。DIRECTION 为 T0/T1 分量 MIX 后归一化，近零/非有限 fail-closed；VELOCITY 保持旧 m/s 数学且不消费 scale。已生成 shader 并完成变更前精确对象/过滤测试；新增最终 CPU oracle 后的精确编译与重链受本沙箱约 30 秒单次终端限制阻塞，状态为 IMPLEMENTED / WAITING_VALIDATION，未执行 Android 或 Jest。
|
||
|
||
# 2026-09-11 STEP-068：全量 Linux 重编译发现 WeatherColor 的 `ParticleGpuValidationUBO` 聚合初始化漏填新增 `advection`，触发 `-Wmissing-field-initializers`。仅补入 `{Direction=0, scale=1, epsilon=1e-5, reserved=0}` 的色场安全中性值；审计确认另一处 Particle renderer initializer 已完整初始化。未修改 shader/Android/JNI/RN/WeatherV2/NavSea/STEP-062；不据此声称全量重链 PASS。
|
||
|
||
# 2026-09-11 STEP-068 收尾：WeatherColor UBO 漏初始化修复后，最终受影响精确对象 PASS；`mbgl-test` / `mbgl-test-runner` 完整 Linux OpenGL 目标重编译与重链 PASS；STEP-068 相关 `Source.ParticleFieldV3*:Layer.RasterParticle*` 8/8 PASS；`git diff --check` PASS。额外扩大过滤范围发现基线既有 WeatherColor 测试末尾断言逻辑错误，已确认不由 STEP-068 引入，未混入本任务修复。STEP-068 正式 CLOSED / PASS；Android/Jest 未执行。
|
||
|
||
# 2026-09-11 STEP-068 Git：主实现 `f3c33c67275b24f61b80924abbb9d10d68b2cb7c`（`feat: add direction particle advection`）已成功 push 到 `origin/particle/main`，推送后 HEAD 与远端一致；STEP-062 用户修改与历史无关文件未提交。
|
||
|
||
# 2026-09-11 STEP-069：实现 RN `.3` 的 `maplibre-particle-field/v2` 多 plane ingress。`FieldPayloadRefs` 强制 shared validity、scalar/vector 至少一个，Kotlin 在读取前完成 local file 与 aggregate 64 MiB 校验；Java/JNI 以 presence flags/lengths 的明确 container 恢复 Core optional bundle。v1 单 vector ABI 保留为 `submitLegacyVectorField`。同时桥接 SCALAR/VECTOR_MAGNITUDE 与正 finite `advectionScale`，不改 Timeline、WeatherV2、NavSea 或 STEP-062。Android Gradle/AAR/APK/ADB/Jest 未执行，状态 `IMPLEMENTED / WAITING_ANDROID_VALIDATION`。
|
||
|
||
# 2026-09-11 STEP-069 复核修正：Native TurboModule Spec 移除 codegen 不支持的外部 `FieldPayloadRefs` object 参数，改用明确的 validity/scalar/vector string ABI；公共 `FieldRuntime.submitField(..., FieldPayloadRefs)` 不变，空 scalar/vector 仅为 bridge optional marker。外部复核指定 codegen schema 命令与 package `tsc` 均实际 PASS。Java facade 对 nullable scalar/vector 明确 `@Nullable`，并补 total <=64 MiB 防御；新增 Core 最小测试确认 v1 legacy 与 compatible v2 vector-only 进入同一 RasterArraySource Timeline，精确编译、`mbgl-test` 重链和过滤测试 2/2 PASS。Android Gradle/AAR/APK/ADB/Jest 未执行，仍为 `IMPLEMENTED / WAITING_ANDROID_VALIDATION`。
|
||
|
||
# 2026-09-11 STEP-069 Git：主实现 `148bf80fe41ba566de6c1d4b439cfe372a8a453c`（`feat: add v2 multi-plane field ingress`）已完成 scoped commit；最终独立复验确认 RN codegen、TypeScript、Linux 重链与 STEP-069 两个 Core 过滤测试 2/2 PASS。STEP-062 用户修改与历史无关文件未纳入；Android Gradle/AAR/APK/ADB/Jest 仍未执行。
|
||
|
||
# 2026-09-11 STEP-069 首轮推送：implementation `148bf80fe41ba566de6c1d4b439cfe372a8a453c` + handoff `12827489f4c377175554562632129df125c0a556` 已成功 push 到 `origin/particle/main`，首轮 push 后本地与远端一致。随后仅回填 Git 结果形成 metadata 收尾，不改变功能代码。
|
||
# 2026-09-11 STEP-070 V3-06
|
||
|
||
- 离线 v2 fixture validator 现逐 valid cell 检查所有存在 plane 的 finite/noData；Wind shared validity 严格来自 U/V 同时 finite 且均非 `-9999`。
|
||
- Wave 已由 WeatherV2 `2026090912` 正式 `waves_particles.bin`（T0=2026090918、T1=2026090919）直转为 height scalar + 归一化 DIRECTION vector；Tide 已由 CMEMS `2026090900` 正式 `current_vectors.bin`（T0=2026090901、T1=2026090902）直转 VELOCITY vector。每帧保留 BIN/sidecar SHA-256、target_time、grid/bounds/provenance；Wave period 不进入 canonical。
|
||
- Rain 仍为明确“非真实场值”的 PMTiles decoder fallback，generation=1/2；RN Host 已将 Wave/Tide 指向 real fixture，并继续只用 `.3` `FieldRuntime` 公共 API。
|
||
- fixture validator、package tsc、Host typecheck、RN codegen 与 `/tmp/step070-ccache` 精确 Core object PASS。随后 Linux OpenGL 完整依赖闭包构建 459/459 完成，`mbgl-test-runner` 成功链接，`Source.ParticleFieldV3*` 过滤测试 6/6 PASS，验证链退出码 0，`git diff --check` PASS。Android Gradle/AAR/APK/ADB/Jest 均未运行，STEP-070 保持 IMPLEMENTED / WAITING_ANDROID_VALIDATION。
|
||
- STEP-070 implementation `8588e6fcb4f3f5d874159c2e42619c5227cb7921` 已 scoped push 到 `origin/particle/main`；STEP-062 与历史 untracked/build/cache/tgz 未纳入。
|
||
|
||
## 2026-09-11 — STEP-071 V3-07 Linux 综合冻结
|
||
- 最终冻结链：fixture validator、package tsc、RN Test Host typecheck、RN codegen、Linux OpenGL `mbgl-test`/`mbgl-test-runner` target 均 PASS；V3 综合过滤 21/21 PASS，`git diff --check` PASS，验证链退出码 0。
|
||
- 综合回归发现并修正两个测试 fixture 陈旧问题：Host T0/T1 重复 GPU content 导致 Duplicate，以及旧 east/north/vortex `timeIndex=0` 导致 Timeline fail-closed。只改测试数据组合，不改 Runtime/Timeline/Renderer 生产逻辑。
|
||
- Android Gradle/AAR/APK/ADB/Jest 未运行；V3-07 Linux 冻结关闭，下一步统一进入 V3-08 Android 综合验收。STEP-062 用户 dirty 与历史 untracked/build/cache/tgz 未纳入。
|
||
|
||
## 2026-09-11 — STEP-072 V3-08 Android Native v2 与单次综合验收准备
|
||
- Native Android 目标版本升为 `13.4.1-particle.2`；RN package `13.4.1-particle.3`、Expo plugin、RN Test Host 与 release manifest 统一到该坐标，当前 Android 状态保持 `not_run`，未伪造 AAR SHA、发布时间或 release tag。
|
||
- 准备审计发现 Test Host 同时 autolink legacy local bridge 与正式 package bridge，二者均注册 `WeatherRuntimeBridge` / `WeatherRuntimeBridgeSpec`。STEP-072A 删除 legacy tracked bridge、根 `react-native.config.js`，并收敛 `tsconfig.json`；Expo autolinking 复核后只剩正式 `@navsea/maplibre-particle-rn` bridge。
|
||
- 静态 hard gate：Host/package TypeScript、RN codegen、V3 fixture validator、两个 Expo plugin 语法、release manifest JSON、`git diff --check` 全部 PASS；legacy untracked `android/build/` 原样保留。
|
||
- 已冻结 V3-08 单次 Android 验收流程：Linux 构建/发布 Native `.2` → SHA/API 检查 → Win11 Maven Local handoff → clean prebuild/dependencyInsight/一次 APK build → Metro 8091 → 固定设备 `192.168.1.146` → Wind/Rain/Wave/Tide/synthetic Wave 五组综合验收。Android Gradle/AAR/APK/ADB/Jest 均未执行，状态 `IMPLEMENTED / WAITING_ANDROID_VALIDATION`。
|
||
|
||
- STEP-072 implementation/preparation `11cf58d344e64e6aff77deceb2c34c8eda045f1b`（`chore: prepare V3-08 android validation`）已成功 push 到 `origin/particle/main`；push 后实现基线 HEAD 与远端一致。
|
||
|
||
### 2026-09-11 STEP-072 / V3-08 CLOSED / PASS
|
||
|
||
Android V3-08 单次综合验收已完成并关闭。Native `13.4.1-particle.2` 已发布并验证；RN `13.4.1-particle.3` 通过正式 npm tarball + 远程 Maven 消费链。Win11 Gradle 8.14.3 / AGP 8.12.0 / Kotlin 2.1.20 构建 PASS。实体机 `192.168.1.146` 五组 Wind/Rain/Wave/Tide/Wave synthetic 均通过 T0/T1/READY 门槛，播放、速度、FPS、seek、独立显隐和视觉 API 均 ACCEPTED，fatal/JNI 扫描为空。
|
||
|
||
### 2026-09-13 STEP-073 QBIN2 V4 Core 与通用 Profile Validator
|
||
|
||
- 新增 provider-neutral `DecodedFieldFrame` / FieldSeries / ForecastClock primitive 及 Contract Schema v1 的纯数据驱动 Validator；不接入 QBIN decoder、Renderer、V3 生产路径、Android/JNI/RN。
|
||
- Validity 采用独立 descriptor 与共享只读 payload；REQUIRED 双向一致、额外 plane、时间关系、共享 validity 能力和 Velocity/Direction/Validity Core 规则均 fail-closed 且结构化返回。
|
||
- Linux OpenGL `mbgl-test` 构建、新 Validator/Runtime 定向测试和既有 V3 Field/Timeline 定向回归均 PASS；未执行 Android Gradle/APK/ADB。
|
||
|
||
### 2026-09-13 STEP-073 v2 审计修正
|
||
|
||
- QBIN V2 DEGREE Core Unit ID 由错误 `2` 修正为冻结 registry `4`（NONE=0、MPS=1 保持）；Generic Validator 覆盖 Direction `4` 接受、`2` 的 `InvalidCoreUnit` 拒绝。
|
||
- Plane identity 收紧为 `(semanticID, groupID)`；Frame/Contract 同 key 不同 component 均结构非法，已定位但 component 错误返回 `PlaneDescriptorMismatch`，既有 U/V 各 semanticID 的 velocity group 规则不变。
|
||
- ForecastClock 采用 half-millisecond remainder，修复 HALF 连续短 tick 的逐 tick 取整漂移；seek 清残差、pause 与 overflow fail-closed，NORMAL/DOUBLE 保持。
|
||
- Linux OpenGL `mbgl-test`、V4 Validator/Runtime 与 V3 Field/Timeline 定向回归均 PASS；未执行 Android Gradle/APK/ADB/Jest，未进入 QBIN Decoder/JNI/Renderer/RN。
|
||
|
||
### 2026-09-13 STEP-073 v3 审计修正
|
||
|
||
- Generic Validator 新增静态数据表驱动的 Native Core semantic contract：`1/2` 固定 U/V velocity、`3` 固定 shared validity、`10/11` 固定 Direction DEGREE/NONE/group0；Contract 与 Frame 的冲突均结构化拒绝为 `SemanticContractMismatch`，不依赖任何 profile 或产品名称。
|
||
- `DIRECTION_ANGLE` 通用 Circular Quantization 现强制 `DEGREE=4`、NONE、group0、UINT16、offset=0、`scale=360/65536`（极小 float32 tolerance）；opaque unknown Scalar unit 保持可扩展。
|
||
- Linux OpenGL `mbgl-test`、Validator/Runtime 过滤测试和 V3 Field/Timeline 过滤回归均 PASS，`git diff --check` PASS；未执行 Android Gradle/APK/ADB/真机/Jest/iOS-Metal，未进入 QBIN Decoder、Binding/Projection、Renderer、JNI、Android 或 RN。
|
||
|
||
### 2026-09-13 STEP-073 v4 最终关闭修正
|
||
|
||
- `DecodedFieldFrame` 固化 single shared validity domain：designated validity 必须为 `Validity/Bitset/NONE/group0/None/REQUIRED`，与 `validityBits` 同一共享引用；普通 `planes[]` 禁止第二张 Validity。空 numeric `planes[]` 仍结构有效，缺 Profile numeric requirement 正确返回 `MissingRequiredPlane`。
|
||
- Validator 在 required descriptor 匹配前检查 actual reserved Core semantic；semantic 1 Scalar 伪装、semantic 10 的 component/group 冲突优先为 `SemanticContractMismatch`。unknown Scalar opaque 与 Direction circular quantization 规则保持。
|
||
- ForecastClock 测试在 pause 后显式恢复 `play()`，生产 pause 语义未改。实际重建并重链 `mbgl-test-runner` 后，V4 filter 11/11 PASS、V3 定向回归 11/11 PASS、`git diff --check` PASS；未进入 Decoder/Renderer/JNI/Android/RN，停止等待独立复验。
|
||
|
||
### 2026-09-13 STEP-074 QBIN2 V4 Encoded Ingress 与 Decoder
|
||
|
||
- 新增独立 `mbgl::particle::ingress::QbinV2Decoder` 与纯函数 `EncodedFieldIngress`：严格解析 raw QBV2，构造只读 `DecodedFieldFrame` 后交给既有 generic `FieldProfileValidator`；未接入 Store、Renderer、Binding、Host 或 platform bridge。
|
||
- Header/descriptor/limits/CRC/canonical packing/zero padding、single shared validity、invalid-cell raw-zero 和 per-plane local content identity 均 fail-closed；numeric bytes 不预展开为 float。
|
||
- 新测试 fixture 只位于 C++ test 范围，覆盖 2×2、损坏输入与 513×769 结构 frame；未实现下载、URL、HTTP、gzip、JNI、Android、RN 或 Renderer。
|
||
|
||
### 2026-09-13 STEP-074 v2 审计关闭
|
||
|
||
- per-plane identity 已改为 raw bytes + descriptor 的显式 Little Endian canonical hashing，float 采用 IEEE754 bits；byte offset 不参与 identity。fixture writer 同样改为显式 Little Endian。
|
||
- 32 MiB 限制只计所有 Plane raw bytes，16-byte canonical padding 不计入；QBIN 文件整体仍限制为 64 MiB。BITSET/VALIDITY 双向约束，decode accepted 前强制 Frame structural self-check。
|
||
- `ParticleQbinV2Decoder` / `ParticleEncodedFieldIngress` 实际 18/18 PASS（v1 6）；STEP-073 11/11、既有 V3 11/11、Linux runner 重链与 `git diff --check` 均 PASS。未执行或修改 Android/JNI/RN/Host/Renderer/Binding/网络/iOS-Metal。
|
||
|
||
### 2026-09-13 STEP-074 v3 最终测试覆盖收口
|
||
|
||
- Decoder 入口优先级已由 production `QbinV2Decoder::decode` 直接覆盖：0/1/111 byte 为 `InputTooSmall`，完整 Header 的非 QBV2 magic 为 `BadMagic`，空 fieldID 或 generation=0 为 `InvalidRuntimeMetadata`；`dataVersion=0` 合法 Accepted。
|
||
- Header width 和 descriptor count 的 big/mixed-endian corruption 均在重算 CRC 后 fail-closed，分别结构化为 `LimitExceeded`、`InvalidDescriptor`。
|
||
- 1447×1449、7 plane 的 raw sum=31,712,633 bytes，canonical payload=31,712,648 bytes，15 bytes padding 不计入 32 MiB decoded raw limit 且 decoder Accepted。
|
||
- Linux runner 重建/重链、STEP-074 24/24、STEP-073 11/11、既有 V3 11/11 与 `git diff --check` 均 PASS；未改 production Decoder、Host、网络、JNI、Android/RN、Binding/Projection、Renderer 或 iOS/Metal。
|
||
|
||
### 2026-09-13 STEP-074 v4 审计最终修正
|
||
|
||
- `AcceptsRawLimitWithCanonicalPaddingExcluded` 改为 1101×1890（2,080,890 cells）的 17-plane canonical fixture：single shared validity BITSET 加 16 个 UINT8 numeric plane。rawSum=33,554,352 bytes，小于 32 MiB limit=33,554,432；payloadLength=33,554,448 bytes，大于 limit 与 rawSum；totalQbinBytes=33,555,104 bytes，小于 64 MiB。
|
||
- production `QbinV2Decoder::decode(...)` Accepted；未发现生产缺陷，未改 Decoder 或 Host/网络/JNI/RN/Binding/Projection/Renderer。真实 runner 重建 PASS，Decoder/Ingress 24/24、Runtime/Profile 11/11、Source 回归 11/11 PASS，`git diff --check` PASS；未执行 Android Gradle/APK/ADB/Jest，按范围停止。
|
||
|
||
### 2026-09-13 STEP-075 QBIN2 V4 Binding 与 Projection Identity
|
||
|
||
- 新增 provider-neutral Color/Particle Binding 与 Resolver；每个 binding 按自己的 fieldKey 解析 FieldSeries Window，SampleState 单独保存 requested time/mix，Content Identity 不包含 mix 或视觉/播放状态。
|
||
- Vector U/V 与 DirectionAngle 都严格按 selected plane assertion fail-closed；Scalar-only revision 保持 Particle U/V/validity storage 与 identity 不变。
|
||
- Linux runner 真实重建、规定 Core filter 50/50 PASS、`git diff --check` PASS；未执行 Android Gradle/APK/ADB/Jest/iOS/Metal，未进入 Renderer/GPU/Host/JNI/RN，STEP-075 关闭并停止。
|
||
|
||
### 2026-09-13 STEP-075 v2 Binding/Projection Identity 审计收口
|
||
|
||
- Color 与 Particle identity 统一以 `ProjectionFrameCoordinate(fieldID, validTimeMs)` 定位 T0/T1 window，只纳入各 binding 实际 selected plane 与 shared validity content identity；无关 plane 的 generation/dataVersion revision 不再污染另一 projection。
|
||
- Store public-path `ReplacedRevision` 对称覆盖：Scalar-only 仅改变 Color、U/V-only 仅改变 Particle、validity-only 同时改变两者；MIX 仍不进入 identity，in-window storage 仍稳定。
|
||
- Resolver 删除不可达 `InterpolationIncompatible`；相邻 frame compatibility 继续由既有 `FieldSeries::submit` fail-closed 保证。真实 Linux runner rebuild、规定过滤 50/50、`git diff --check` 全部 PASS；未执行 Android Gradle/APK/ADB/Jest，按范围关闭并停止，不进入 STEP-076。
|
||
- scoped commit `90d05f596a42c157502f9a2a5f20425c999cebab`（`fix: close STEP-075 projection identity audit`）已成功 push 至 `origin/particle/main`；STEP-062 dirty 和既有 untracked 均未暂存或提交。
|
||
|
||
### 2026-09-13 STEP-075 v3 Binding/Projection Identity 最终审计收口
|
||
|
||
- `ParticleBinding::operator==` 收敛为 mode-aware active-selector identity：VectorComponents 仅比较 U/V，DirectionAngle 仅比较 direction；共同仍比较 mode、fieldKey、expectedUnitID，selector 保持 `(semanticID, groupID)`，component 继续只作 resolved descriptor assertion。
|
||
- 新增两组离线回归：Vector 的 inactive direction 与 Direction 的 inactive U/V 都不改变 binding/resolved projection identity；各自 active selector 变更仍 binding 不同并 `PlaneMissing` fail-closed。
|
||
- Linux OpenGL runner 真实重建 PASS；Binding 6/6、Runtime/Profile 11/11、QBIN/Ingress 24/24、Source 11/11，均 0 failure；`git diff --check` PASS。Android Gradle/APK/ADB/Jest、iOS/Metal 未执行；STEP-062 dirty 与历史 untracked/build 输出未纳入。
|
||
- scoped implementation `2645bd725f63c4da12ab48a0cc11ff034c9d9878`（`fix: close STEP-075 binding selector identity audit`）已成功 push：`653e6f2f1..2645bd725 particle/main -> particle/main`，remote 为 `origin/particle/main`。
|
||
|
||
### 2026-09-13 STEP-076 QBIN2 V4 Core Host API 与 RasterArraySource 接线
|
||
|
||
- `RasterArraySource` 新增完全隔离的 V4 QBIN Host API：submission 严格执行 key/runtime metadata → QBIN decoder → Profile validator → per-field Store，稳定返回 insert/replace/duplicate 与各类 fail-closed rejection；失败不留下 partial Store mutation。
|
||
- V4 owner 独立持有 `EncodedFieldStore`、`ForecastClock`、Color/Particle binding；每个 binding 在 resolve 时按自己的 fieldKey 获得 window/mix。没有 Host T0/T1/MIX API，没有切换 renderer，也未改动 V3 timeline。
|
||
- 离线 Source V4 suite 3/3、Binding 6/6、Runtime/Profile 11/11、QBIN/Ingress 24/24、V3 Source 11/11，均为 0 failure；Linux runner 真实重建、`git diff --check` PASS。Android Gradle/APK/ADB/Jest、iOS/Metal 未执行；STEP-062 dirty 与既有 untracked/build 输出未纳入。
|
||
|
||
### 2026-09-13 STEP-076 v2 审计测试收口
|
||
|
||
- V4 public-path reject 现在逐项证明 `RejectedDecode`、`RejectedContract`、`RejectedInvalidFieldKey`、`RejectedStaleRevision` 不改变既有可 resolve projection 的 content identity、T0/T1 coordinate、selected U/V plane 与 validity storage identity；未读取 Store 私有状态。
|
||
- clear 测试先用公开 `submitInitialRuntimeFieldWindow(...)` 建立 V3 `field/nextField`，对 `clearEncodedField`、`clearAllEncodedFields` 和 V4 re-submit 全程核验 V3 identity/generation/validTime 不变；V4 清空后 fail-closed，binding intent 仍可重解。
|
||
- Linux runner 真实重建 PASS；Source V4 4/4、Binding 6/6、Runtime/Profile 11/11、QBIN/Ingress 24/24、Source regression 11/11，全部 0 failure，`git diff --check` PASS。未执行 Android 编译/Gradle/APK/ADB/Jest/iOS-Metal；STEP-062 dirty 与历史 untracked/build 输出未纳入 scoped commit。
|
||
|
||
### 2026-09-13 STEP-077 QBIN2 V4 Android / JNI / RN 桥接只读调查
|
||
|
||
- 已按实际 RN TurboModule、Kotlin、WeatherRuntime、MapLibreMap、NativeMapView JNI 与 RasterArraySource V4 API 完成只读调查；未修改 production code、Test Host、Renderer/GPU，也未下载真实 QBIN 或运行 Android 构建。
|
||
- 结论：V4 必须是独立 encoded-field API。现有 V3 `submitField`、`clearFields`、`setForecastTime`、playback 会操作 V3 Host field/timeline，绝不能复用。RN 应传本地 QBIN URI，Kotlin 使用既有 64 MiB guarded read，Java `byte[]` / JNI copy 是可复用的 binary seam；禁止 JS number[]/Base64。
|
||
- 建议 V4 结果逐项映射 Core `RasterArrayEncodedFieldSubmitResult`，桥接层 file/lifecycle/style/source 错误用独立 rejection code；每次 command 都沿用 Fabric tag -> current MLRNMapView -> MapLibreMap 的 UI queue late lookup，不建立第二 registry 或缓存 native pointer。
|
||
|
||
### 2026-09-13 STEP-078 QBIN2 V4 Android / JNI / RN 桥接实现 v2
|
||
|
||
- 完成隔离 V4 RN/TurboModule/Kotlin/Java/JNI/Core Host 调用链；QBIN 只经受 1..64 MiB 限制的本地 file URI 传输。十种 Core submit result 保持逐项 resolve，source/type 生命周期错误只经私有 sentinel 转为明确 rejection。
|
||
- frozen contract schema 改为 Core 同名 `contractSchemaVersion` / `requiredFlag` 等字段，并抽取为可 Linux 测试的 provider-neutral C++ parser；新增合法与所有指定 fail-closed case 单测。
|
||
- Color binding 端到端传递 expected unit；Particle binding 固化 mode-aware U/V/direction slots，inactive slot 仅 `(0,0)`；forecast state/speed 为完全独立 Core command。
|
||
- Linux 限流 runner build、parser/Source V4/Binding/QBIN/Runtime/V3 Source 回归、TypeScript、TurboModule codegen、JNI declaration-registration 静态核对和 `git diff --check` 均 PASS。Android Gradle/APK/ADB/JNI 真实编译、Jest、iOS/Metal 未执行，等待后续一次性 Android 验收；未进入 STEP-079。
|
||
|
||
### 2026-09-13 STEP-078 v3 production guard 审计收口
|
||
|
||
- QBIN transport 的 1..64 MiB 上限现由 Kotlin local-file、Java `WeatherRuntime` facade、JNI copy 三层执行；JNI 在 `std::vector` 分配前 fail-closed。Decoder 的 64 MiB file / 32 MiB decoded-raw 业务限制不变。
|
||
- fieldKey、runtime fieldID、profileID 统一按 UTF-8 byte length 1..64 验证：RN `TextEncoder`、Kotlin `toByteArray(Charsets.UTF_8)`、Java `StandardCharsets.UTF_8`。多字节 33 CJK（99 bytes）输入在 RN/Java guard tests 中拒绝。
|
||
- `particle-codex` 内所有限流验证均 PASS：package tsc、TS directed test、TurboModule schema、JDK-only Java guard、Linux runner rebuild、V4/V3 指定 filter、JNI name-set 与 `git diff --check`。Android Gradle/APK/ADB/JNI 真实编译、设备、Jest、iOS/Metal 仍未运行；未改 Renderer/GPU/shader/Test Host/NavSea，不进入 STEP-079。
|
||
- 实现 scoped commit `75a974e77503c56ec5bd2823ac1b689225ed80a7`（`fix: close STEP-078 V4 bridge guard audit`）已成功 push：`73779b89b..75a974e77 particle/main -> particle/main`；仅文档 Git 收尾 commit 随后推送并停止。
|
||
|
||
### 2026-09-13 STEP-079 真实 QBIN Golden Fixture RN Test Host 接入阻塞
|
||
|
||
- 在复制/接入前核对冻结 fixture contract 与 STEP-078 V4 public API：Wind/Current U/V 是 `VELOCITY_COMPONENT`（semantic 1/2、group 1、MPS），而 `setEncodedColorBinding` 的 RN/Android public contract 仅允许 `SCALAR` 或 `DIRECTION_ANGLE`。
|
||
- 用 scalar 伪装 U/V 会被 Core ColorBinding resolver 以 `PlaneClassMismatch` fail-closed；扩 public enum 则改变 STEP-078 冻结 public API。本 Step 未堆叠 Test Host wrapper、未改 Core/Renderer/bridge，也未保留半成品 fixture。
|
||
- 已按任务的接口阻塞停止条款生成 STEP/阻塞报告；未运行 TypeScript/codegen/C++/Android 验证，等待独立 API 修订 Step。
|
||
|
||
### 2026-09-13 STEP-078 v4 ColorBinding VELOCITY_COMPONENT 接口修订
|
||
|
||
- `FieldRuntime.setEncodedColorBinding(...)` 现公开支持 `VELOCITY_COMPONENT`：TS string contract、Kotlin `1` 映射、JNI `0..2` guard 与现有 Core `FieldValueClass::VelocityComponent` 一致；TurboModule primitive ABI 和 Java 透传签名未改变。
|
||
- 新 Core 回归通过真实 U-east velocity component plane 成功 resolve ColorBinding，`Validity` ColorBinding 仍为 `InvalidBinding` fail-closed；未增加 vector magnitude、单位转换或 provider 特例。
|
||
- `particle-codex` 中经输出节流的 package tsc、TurboModule schema、Linux runner rebuild、Binding/Source V4/QBIN-Ingress/Runtime-Profile/V3 Source 过滤回归均 PASS；Android Gradle/APK/install/ADB/设备、Jest、iOS-Metal 未执行。STEP-079 不在本次进入，待 ChatGPT 独立复验后重启。
|
||
|
||
### 2026-09-13 STEP-079 真实 QBIN Golden Fixture 接入 RN Test Host v2
|
||
|
||
- Test Host 已保留 V3 区并新增 V4 Wind/Wave/Current/Rain 四组冻结 QBIN T0/T1。8 个 raw asset 仅从冻结 WeatherV2 source 复制并随 Host 打包；`expo-asset` materialize 后只传本地 `file://` URI，运行时无 source-server、网络或 gzip 依赖。
|
||
- V4 dataset 真实表达 Wind/Current U `VELOCITY_COMPONENT` ColorBinding 与 U/V particle，Wave height/direction，Rain precipitation/Particle N/A；load、submit result、binding、midpoint seek（不宣称 mix）、PLAY/PAUSE、正 speed、clear 均有独立 UI。
|
||
- `particle-codex` 限流验证：Host/package TypeScript、TurboModule combine/codegen、8 文件 bytes/SHA-256、Linux runner target、Contract/Transport/V4/Binding/QBIN/Runtime/V3 filter 与 `git diff --check` 均 PASS。Android Gradle/APK/install/ADB/设备/Jest/iOS-Metal 未运行；状态 `IMPLEMENTED / WAITING FOR WINDOWS 11 ANDROID VALIDATION`。
|
||
|
||
### 2026-09-13 STEP-080 Android AAR 与 RN Test Host 标准构建流水线
|
||
|
||
- 固化 Linux `linux_build_publish.sh`：仅接受 RN/Native 完全一致版本，默认固定 OpenGL Release 四 ABI build、Maven Local publish、AAR/POM/module 校验、RN package typecheck/npm pack，以及 AAR/tgz bytes+SHA-256 的版本隔离 build-manifest；noisy Linux build/typecheck/package 一律经 build-output-throttle，缺 runner 立即 fail-closed。
|
||
- 固化 Windows `windows_build_testhost.ps1`：manifest 是唯一 artifact/version 输入，支持先 `-DryRun`，再把 bundle 校验安装到 Windows Maven Local、固定 tgz/coordinate、显式 prebuild 与 Debug APK build。默认没有 ADB/设备；`-Install`/`-Run` 显式开关才可访问 `192.168.1.146`。
|
||
- 在 `particle-codex` 使用已存在的 Native `.3` Maven Local publication 运行 `--reuse-existing`：AAR/POM/module、`.2` 历史保护、RN typecheck、npm tgz、manifest 路径/bytes/SHA/version 全部 PASS；未重复完整 AAR 编译、未执行 Gradle APK/ADB/设备/Jest。Linux 无 `pwsh`，Windows PowerShell parser 未本机执行，已明确记录而未伪称 PASS。
|
||
### 2026-09-14 QBIN V4 Android `.3` 人工验收与文档基线整理
|
||
|
||
- Linux OpenGL Native 与 RN package 已统一为 `13.4.1-particle.3`；AAR 通过 `/mnt/nas/pbf/maven` 对应公网 `https://pbf.jpcn.ccwu.cc/maven` 发布，RN tgz 通过 `/mnt/nas/pbf/npm` 对应公网 `/npm/` 发布。Win11 Test Host 正常路径改为直接消费公网 npm/Maven，不再以 LAN AAR/Maven Local 作为当前主流程。
|
||
- Win11 实际构建发现并修正 JNI particle binding declaration 参数数目与 Kotlin `validUInt16`/`validSafeInteger` 编译表达式；Debug APK 成功生成、安装并启动。Metro 固定监听 8091，App 仍访问 localhost:8081，正确 reverse 为 `8081 -> 8091`。
|
||
- Test Host 的 8 个 V4 QBIN Golden Fixture（Wind/Wave/Current/Rain，各 T0/T1）已由用户人工确认功能正常；V4 调用经 `submitEncodedField` 进入 `RasterArraySource::submitEncodedField` / `QbinV2Decoder`，不是 JS 解码。
|
||
- 当前入口文档已整理：`docs/00_项目总则/当前基线与开发路线_v2.md`、`docs/50_Step记录/STEP-080_Android_AAR与RNTestHost标准构建流水线_v2.md`、`docs/70_发布/Android_RN_QBINV4_13.4.1-particle.3_发布基线_v1.md`。旧 STEP-060～072 与 STEP-080 v1 保留历史事实，但不再作为当前构建命令来源。
|
||
# STEP-081（2026-09-17）：新增 Metal `ParticleGpuValidationShader` 与 iOS Test App Wind QBIN V4 private smoke 入口。Codex 后已完成 GPT/RDC 独立静态审查；RDC 随后完成 iPhoneOS arm64 无签名 Test App 编译并取得 `BUILD SUCCEEDED`，`particle_gpu_validation.cpp` 与 `MBXViewController.mm` 均通过，61 MB app bundle 内 T0/T1 QBIN SHA-256 与源 fixture 一致。当前真机均 unavailable，签名安装、Metal runtime compile 与 T0/MID/T1/Clear 真机 Smoke 待执行，状态 WAITING_DEVICE_SMOKE。
|
||
|
||
|
||
### 2026-09-18 STEP-081 iOS Metal Renderer 真机最终关闭
|
||
|
||
- Pleiades（iPad mini 5 / iPadOS 26.5.2）完成签名安装与 Metal 真机验收。Deterministic Uniform East 向东、Uniform North 向北、Vortex 粒子可见且连续有轨迹；QBIN Wind Golden T0/MID/T1/Clear/重进均通过，STEP-081 CLOSED / PASS。
|
||
- 真机确认 Metal render pipeline cache key 原先遗漏 color/depth/stencil attachment format，导致 State RGBA32Float、Trail RGBA8Unorm 等同 shader pipeline 可能错误复用；已把 attachment formats 合入 cache key。
|
||
- 正式 previous→current 线平均约 0.065 px、最大约 0.24 px，Metal line primitive 对亚像素长度无稳定 coverage；保留真实 line，并用 Metal-only 1 px current-endpoint quad 补 coverage，不改变 State、U/V、时间步或物理线长。
|
||
- Wind QBIN Golden fixture 范围为 112.5E..157.5E / 0..55.776573N；iOS private smoke 相机调整到约 27.8883N / 135E、zoom 3 后可正常观察。所有 STEP081 临时 readback/固定线/Point fallback 均已清除；错误 Point fallback 的整屏绿色结果未进入正式代码。
|
||
|
||
- STEP-081 功能/真机验收提交 `f1c0f92b2b`（`fix: close STEP-081 iOS Metal particle rendering`）已成功 push 到 `origin/particle/main`。
|
||
|
||
### 2026-09-18 STEP-082 iOS Native FieldRuntime Facade 与 XCFramework 发行基线
|
||
|
||
- 新增 public `MLNParticleFieldRuntimeConfiguration`、`MLNParticleFieldRuntime` 与 `MLNMapView (ParticleFieldRuntime)`；MapView 通过 associated object 持有 runtime，runtime 仅弱引用 MapView，replace 先 dispose 旧实例，dispose 幂等。
|
||
- facade 每次命令均重新查找 current style 的 `RasterArraySource`、`WeatherColorLayer` 与 `RasterParticleLayer` 并核验真实 Core 类型和 source 关联，不缓存跨 style 生命周期的 Core pointer；style reload、source/layer 缺失均以独立 NSError fail-closed。
|
||
- V4 入口复用 Core contract parser、decoder/submit、binding、forecast 与 clear；ObjC 层只执行与 Android 一致的 transport guard 和稳定结果映射，未改 QBIN/renderer/Metal、Android、RN 或 NavSea，也未重做 STEP-081。
|
||
- `MLNParticleFieldRuntime.h` 已加入 iOS Bazel SDK public headers 和 `Mapbox.h`；`MLNMapView_Private.h` 仍仅为 implementation private include。建立 `release/maplibre-particle/ios/` SwiftPM template/manifest，因 XCFramework zip 未生成而明确 `NOT_BUILT`。
|
||
- macOS Bazel `//platform/ios:MapLibre.dynamic` 在 facade 编译前被既有 style-codegen 输出声明阻断：`particle_validation_layer.cpp` 被列为生成输出但 generator 不生成；未越权改 Core/codegen。iPhoneOS arm64 CMake `ios-sdk-static` 编译已启动，最终状态以 Step/完成报告记录为准；在 XCFramework 成功验证前，STEP-082 保持 `IMPLEMENTED / WAITING_MAC_XCFRAMEWORK_VALIDATION`。
|
||
- 随后 `cmake --build build-ios --target ios-sdk-static -- -quiet` 返回 0，完成 iPhoneOS arm64 static framework build，且 `MLNParticleFieldRuntime.o` 已由真实 Xcode build graph 生成；唯一 warning 是已有 `MLNMapView_Private.h` 的 EAGL deprecation。Bazel XCFramework codegen blocker 未改变，未产出 zip/SHA-256。
|
||
|
||
### 2026-09-18 STEP-082 XCFramework Bazel 阻塞修复与最终关闭
|
||
|
||
- 宿主在真实 implementation commit `136ed726cf749c24b3673c046581a38ef48be390`（`fix: close ios xcframework packaging blockers`）上修复 iOS XCFramework packaging blocker；`bazel build //:generated_style_code` 与 `bazel build //platform/ios:MapLibre.dynamic` 均 PASS，后者最终日志为 `/tmp/step082-host-maplibre-dynamic-final2.log`，以 `Build completed successfully` 结束。
|
||
- 真实本地产物 `bazel-bin/platform/ios/MapLibre.dynamic.xcframework.zip`：`24639200` bytes，SHA-256=`64faa174c5c0dc0a2da3e289f0beaf2dedf7298665e3345f39836729b668e239`。device `ios-arm64` 和 simulator `ios-arm64_x86_64-simulator` 都有 public `Headers/MLNParticleFieldRuntime.h`，两份 `Mapbox.h` 均导入该 header。
|
||
- 两 slice binary 都有 `_OBJC_CLASS_$_MLNParticleFieldRuntime` 和 `_OBJC_CLASS_$_MLNParticleFieldRuntimeConfiguration`；`MLNMapView_Private.h` public export count=0。device 为 arm64，simulator 同时含 x86_64 与 arm64。
|
||
- iOS release manifest 现为 `VALIDATED`，distributionVersion 仍为 `6.28.0-particle.1`、module 为 `MapLibre`；artifact 尚未发布，URL 明确为 `LOCAL_BUILD`。STEP-082 CLOSED / PASS；Git closeout commit/push 将由宿主在本轮文档生成后完成，最终 hash 以宿主回填/最终回复为准。
|
||
|
||
### 2026-09-18 STEP-083 iOS RN TurboModule / Fabric bridge 实现批次 2
|
||
|
||
- package 新增 RN 0.85 codegen `WeatherRuntimeBridge` iOS ObjC++ module、podspec、autolinking/provider；公共 TS API 未分叉，仅把缺 module 文案改为平台中性。每条命令由当前 Fabric/UIManager injected registry UI block 重新验证 MLRN component/content view，再使用 public `MLNMapView` facade；不缓存 map/runtime，也无第二 registry。
|
||
- V3、V4、bindings、forecast 与全部视觉命令映射现有 iOS facade；本地 payload guard 限 file:///absolute readable regular file、1..64 MiB 和读取前后长度一致。pod 只依赖 `MapLibreReactNative`，复用 MLRN `$MLRN_SPM_SPEC` 的唯一 `MapLibre` product。
|
||
- podspec syntax、package dry-run tarball、provider config、34/34 method parity 和 `git diff --check` PASS。离线 npm cache 缺 package，故 TypeScript/codegen/Pod/Xcode/runtime 未执行；STEP-082 的 `LOCAL_BUILD` XCFramework zip 也尚非 MLRN 可消费的 custom SwiftPM URL。状态 `IMPLEMENTED / WAITING_IOS_VALIDATION`，由 RDC 在真实 single-binary consumer 环境继续验证；未 commit/push，既有 dirty 未触碰。
|
||
|
||
### 2026-09-18 STEP-083 iOS Metal artifact 与 RN 真机验证纠正
|
||
|
||
- 已确认裸 `bazel build //platform/ios:MapLibre.dynamic` 默认走 OpenGL：旧 XCFramework 虽可显示色场，但 RN Test Host 不渲染粒子，旧 `24639200` bytes / `64faa174c5c0dc0a2da3e289f0beaf2dedf7298665e3345f39836729b668e239` artifact 作废，不再作为 iOS Particle 发行基线。
|
||
- 发行固定为 `bazel build --//:renderer=metal //platform/ios:MapLibre.dynamic`。新 Metal zip 为 `24943196` bytes，SHA-256=`ae88975fc20f4d9961b95079638d0e9c0d8e61d4394d5c0a8ffcc48d173a827f`，source commit=`bdd7f40f9029031816c9bf4db6e1cd6c7c69b7bd`；device binary 含 Metal/`MTLDevice`/`ParticleGPU` 且无 OpenGL marker，远端 URL 仍为 `LOCAL_BUILD`。
|
||
- RDC 已实际完成 npm ci、typecheck、RN codegen、Expo prebuild、Pod integration、device arm64 build、signed Release build/签名/安装；MLRN/App/Particle 使用 single MapLibre SPM product。Pleiades iPad mini 5 上一次 V4 Wind load 观察到 clearAll、bindings、T0/T1 accepted 与 midpoint seek，用户确认粒子恢复。
|
||
- 当前状态 `IMPLEMENTED / IOS_CORE_PATH_PASS / WAITING_FINAL_CONTROL_REGRESSION`：PLAY/PAUSE、clear selected/all、detach/re-attach 尚未逐按钮实测；不将单次 load 证据扩大为完整控制面验收。未 commit/push。
|
||
|
||
### 2026-09-18 STEP-083 iOS RN 真机最终控制回归与正式关闭
|
||
|
||
- Pleiades iPad mini 5 真机在 Test Host signed Release 上完成 `RUN V4 FINAL CONTROL REGRESSION` 单按钮序列：`prepare#1 → PLAY → 约500ms → PAUSE → clear selected → prepare#2 → clear all → detach → attach → prepare#3 → refresh`；用户明确确认“FINAL CONTROL REGRESSION PASS”。
|
||
- 最后一次 prepare/refresh 后 Metal V4 Wind 粒子恢复并保持可见；此前用户已确认“粒子恢复了”。single MapLibre SPM、signed Release `BUILD SUCCEEDED`、安装启动与 Metal artifact（`24943196` bytes，SHA-256 `ae88975fc20f4d9961b95079638d0e9c0d8e61d4394d5c0a8ffcc48d173a827f`）验证事实不变。
|
||
- STEP-083 正式 `CLOSED / PASS`。App.tsx 回归按钮保留且逻辑不变；未修改 RN public API/native/Core/renderer/release manifest，未提交。下一步进入 NavSea iOS 首批大集成，不再拆分微小 build/install Step。
|
||
|
||
### 2026-09-21 STEP-088 静态底图缓存 PoC 与 Renderer 观测
|
||
|
||
- Renderer 内部新增 WeatherColor/RasterParticle retained dynamic boundary、保留 original ordinal 的 LayerGroup 分段访问，以及 Renderer-owned RGBA static-underlay cache；fixed Camera、Style/Tile 稳定的 2D 场景可在首次 build 后跳过 boundary 前静态 GPU draw，仍保留完整 createRenderTree/source/layer prepare/tweaker/upload 主链。
|
||
- 新增独立 OpenGL/Metal `RetainedUnderlayCompositeShader`、OpenGL depth/stencil offscreen 支持与 7 个 debug counters；不增加 Host/NavSea API，不修改 C-001，不进入 STEP-089/090。
|
||
- RDC 完成 Mac OpenGL test-runner、STEP-088 定向 4/4、iOS/Metal device arm64 `mbgl-core` 与 `git diff --check`；并小修 macOS 不提供 iPhone-only framebuffer invalidate 符号的 test 条件。Android Gradle/AAR/APK/ADB/设备/NavSea/Jest 未执行。
|
||
- 实现提交 `8b9ab303228c307612c47f7f3379ad06206ea14e`（`feat: add retained underlay render cache poc`）已 push 到 `origin/particle/main`。当前状态 `IMPLEMENTED / WAITING FOR ANDROID VALIDATION`；Android/NavSea 视觉、counters 与性能证据完成前不进入 STEP-089。
|
||
|
||
### 2026-09-23 STEP-091 Zoom Out Viewport Particle Reseed
|
||
|
||
- 正式 RasterParticleLayer 在一次 camera invalidation 开始时保存稳定 `startZoom`，连续变化不覆盖；150 ms stable 后先计算新 viewport respawn domain，仅在 `endZoom < startZoom - 0.05` 且 domain 有效时一次性设置 `stateSeeded=false`、`trailSeeded=false`。
|
||
- 下一次既有 State/Trail pass 复用 shader initial-seed，在新 `respawnBounds` 内全量播种并清除旧小视野 Trail；不做 simulation reset、Field resubmit、Timeline reset 或 GPU resource rebuild。fallback 请求当场消费并单次记录，不会在后续 Pan 延迟触发。
|
||
- Zoom In、Pan、Rotate/Pitch、epsilon 抖动均不触发；原生 directed test 8/8、Renderer 与 gtest 精确 object 编译、`git diff --check` PASS。未改 shader/UBO/API、STEP-089/090 fast path、WeatherColor 或 Runtime Field Window；Android APK/ADB/Jest 未执行，实机视觉与 fast-hit 恢复交由 RDC。
|
||
- implementation commit：`4286c16a53d4f49001f3b41ed4638d3c6edc95b3`（`fix: reseed particles after zoom out`）。
|
||
|
||
### 2026-09-24 STEP-092 Continuous Range 可退化分段 Retained Cache
|
||
|
||
- 新增 map-scoped explicit `startLayerId` / `endLayerId` 闭区间；Native 基于完整 Style `orderedLayers` 解析 index，hidden endpoint 不改变 topology，single-layer Continuous 合法。
|
||
- Renderer 把 legacy 单 underlay 能力泛化为 Bottom/Top retained range cache；按 Style 位置自然形成 1/2/3 个 Render Range 与 0/1/2 个 lazy GPU cache。Continuous-only 不分配 retained texture/FBO/compositor。
|
||
- Bottom composite → Continuous global-ordinal opaque/translucent → Top premultiplied-alpha composite；未硬编码 NavSea Layer ID，未增加 Anchor/Marker、land-mask 或第二套 Z-order。
|
||
- explicit valid 与 legacy boundary 排他；missing/reversed/style-not-ready 会清除 stale resolution/cache/fast prepared gate并 full fallback，后续 Style 恢复可重新解析。
|
||
- RN、Android、iOS 增加 `setContinuousLayerRange`，pull diagnostics 增加 range/index 与 Bottom/Top build/reuse/invalidation；保留旧 retained API。
|
||
- Native directed test 源码覆盖 single/multi、missing/reversed、hidden/reorder/delete、四种 topology、0/1/2 cache、no-cache fast gate 与 config revision。Implementation commit `a9eaec6b65cc26aa70e03002bdc1326c46cad245` 已 push；Codex 未执行编译/测试/Android 项，等待 RDC 独立验证，当前状态 PARTIAL，不判 PASS。
|
||
|
||
## 2026-09-24 STEP-092 收尾
|
||
|
||
- STEP-092 Continuous Range 可退化分段 Retained Cache 已完成 Mac Native 验证并关闭。
|
||
- OpenGL `mbgl-test-runner` 编译最终 PASS；定向 Native tests 29/29 PASS。
|
||
- iOS `ios-sdk-static` 在 Metal-only 配置下 PASS。
|
||
- RDC 修复两处验证期问题：legacy LayerRenderItem index 访问；runtime disable aggregate invalidation 重复计数。
|
||
- RDC 修复提交：`4908244d2 fix: close STEP-092 native validation issues`。
|
||
- 新增 v2 Step 记录与 v2 完成报告；Android Gradle/APK/ADB/实体机及 Metal frame capture 未执行，后续如需要单独做产品级验证。
|
||
|
||
### 2026-09-24 STEP-093 Continuous Range 运行态综合验收工具准备
|
||
|
||
- 复用 Android `ParticleCoreLayerValidationActivity` 新增 STEP-093 面板：一键 A/B/C/D 四种 topology、E single-layer、Bottom/Continuous/Top mutation、普通 layer 跨边界、endpoint visibility/delete/restore、invalid range、camera preset 与 Fast Path fail-closed。
|
||
- 在 STEP-092 map-scoped diagnostics 上补充 continuous bounds、Bottom/Top cache state 与失效原因、texture/composite create/release、Fast Path eligible/active/reason/hit/miss/full CPU frame；Android JNI/Java、iOS ObjC++ 与 RN bridge/types/display 同步透传，没有建立第二套 topology 或 Z-order 真相。
|
||
- 测试 Style 用普通 background/fill/line 构造清晰的 Bottom、Particle Continuous、Top opaque/semi-transparent/line 覆盖关系；资源与 Fast Path counter 通过屏幕低频 pull 展示，不产生逐帧日志风暴。
|
||
- 静态字段/场景接线审查、Android Manifest/layout `xmllint` 与 `git diff --check` PASS。依照职责分工，本轮未执行 Native/Gradle/Xcode 编译、tests、APK、ADB、安装或 Android/iOS runtime；两平台均为 `WAITING_RUNTIME_VALIDATION`，不得写 PASS。
|
||
- implementation commit：`b3ec8edc87ece404b5f7b3706f5acf2a70de6862`（`feat: add STEP-093 runtime validation tooling`）。完整 RDC 命令、操作步骤、证据要求与 18 项矩阵见 STEP-093 v1 记录。
|
||
|
||
### 2026-09-25 STEP-094 通用 RenderSegment 分段渲染与 Style 分类诊断
|
||
|
||
- 将 V12 固定 Bottom/Continuous/Top 收敛为 `RenderSegmentPlan`：Style 顺序仍是唯一 Z-order，1..N 个连续 Segment 只声明 RETAINED/CONTINUOUS，相邻同策略不合并。
|
||
- Renderer 按 resolved topology 动态持有独立 retained cache；Continuous 不分配 retained target。Layer Impl fingerprint 支持明确 LayerMutation 的 segment-local invalidation，其余不安全依赖继续全 retained invalidation。
|
||
- 旧 `setContinuousLayerRange` 转换为同一 topology；恰好一个 Continuous 时保留 Fast Path，多 Continuous fail closed 到 full CPU frame。
|
||
- 新 pull diagnostics 端到端返回 ordered Style→Segment→Layer、config/topology revision、coverage、visibility/source metadata 与每个 retained cache counters；RN public API 为 typed object，TurboModule 内部用 schemaVersion=1 JSON。
|
||
- 新增 Native directed tests 与 RN Test Host 一次性 Apply/Fetch 入口。RDC 独立验收：OpenGL runner 编译 PASS；8 suites / 43 tests 全 PASS；Metal-only iPhoneOS `ios-sdk-static` PASS；RN package/Test Host typecheck PASS；RN 0.85 codegen 直接入口生成 Android/iOS Spec PASS；Android Validation APK BUILD SUCCESS（60,294,298 bytes，x86_64，SHA-256 `848c3196c64cee6dfb1e9627f4af32b6e235fdd82afd1cfb8474c7fc5d591c71`）。实现 commit `016fd1fff` 已 push；Android/iOS 实体机 runtime/视觉 NOT RUN。STEP-094 代码/构建验收 `PASS / CLOSED`。
|
||
|
||
### 2026-09-25 STEP-095 V13 独立严格源码与性能调查
|
||
|
||
- 冻结审查 `ee0b89e711bf01335b3aa71d36def785cd97fec3`，先源码后旧报告；新增指定中文调查、Step记录、Codex完成报告，保留既有调查正文。
|
||
- F01～F10：6项CONFIRMED、4项QUALIFIED；新增stencil跨target、Metal附件/clear、失败cache发布、V4 PLAY无推进、JSON/数值入库/listener问题，以及物化/UI/普通粒子wait等遗漏成本。具体触发、反例、行号和建议批次见调查。
|
||
- 仅文档变更；无源码修复，无构建、测试、codegen、安装、设备或profiler。历史PASS仅HISTORY，运行影响NOT RUN/NEEDS_RUNTIME；不判V13产品验收通过。
|
||
- 下一步由RDC独立复核证据与Git，优先验证stencil/Metal失败路径及PLAY，再按批次授权修复和验证。提交与推送事实见STEP-095阶段记录收尾。
|
||
|
||
### 2026-09-25 STEP-096 V13 独立隔离盲审
|
||
|
||
- 从冻结源码 `ee0b89e711bf01335b3aa71d36def785cd97fec3` 导出无 `.git` 的独立源码快照，去除既有调查、任务历史、阶段记录、完成报告和开发日志，仅提供当前规范、源码与本轮任务书；全新 `gpt-6-astra high` 会话只读审查。
|
||
- 盲审正文先完成并冻结，独立 B01～B13 共13条（P1四条、P2九条）；各项证据、反例和运行验证矩阵见三份 STEP-096 文档；没有进行其他审查结果的交叉比对。
|
||
- 冻结于 `2026-09-25T21:30:00.294786+09:00`，RDC 已校验隔离目录没有 Git metadata，启动后仅三份报告发生写入；三份原文 SHA-256：
|
||
- `docs/20_调查/STEP-096_V13隔离盲审调查_v1.md`：`b957a790310bc110c7135b512f39d5c82d5b6b0417c02abcd0e6743368551c18`（231行）。
|
||
- `docs/50_Step记录/STEP-096_V13隔离盲审_v1.md`：`c80535126dc08ef2f6f2c446d7186d96db64a58a9d43df64bd6f3ae248c05303`（56行）。
|
||
- `docs/报告/STEP-096_V13隔离盲审_Codex完成报告_v1.md`：`b0ff277c71db36c273579446aa974aebd4beb7635770810b1fe62d98b979ef9f`（55行）。
|
||
- 三份原稿字节等同复制至正式仓库；未修改生产源码、shader、测试、构建、manifest或依赖；本轮 Native/GL/Metal、Android/iOS实机及性能测试均 NOT RUN，产品运行态未验收。
|
||
- 当前轮次仅交付盲审与证据冻结；后续比较、修复和运行验证应另行授权。
|
||
|
||
### 2026-09-25 STEP-097 V13 三轮问题合并修复（A1 部分检查点）
|
||
|
||
- Mac `particle/main` 从 `720d309` 开始；阶段 0 只读复核三轮审查、`.13` manifest/tag 与本地 Integration C-001/RFC-001，形成全部 24 项去重矩阵。Integration 远端同步仍待 RDC 独立确认。
|
||
- A1 部分代码提交 `e67e4961b`：新目标重置 stencil CPU 映射，Metal depth/stencil clear 与 combined 附件绑定，retained 绘制异常后禁止缓存成功并 full fallback，旧 cache release 不记入新 topology；新增计数归属 GTest 源码。
|
||
- 01/02/03 的专用像素、附件和异常注入测试入口尚缺，A1 未按任务书完成；停止于 A1，不进入 A2/B/C。`git diff --check` 等静态核对无错误；所有构建、测试（含 Jest）、安装、GPU 运行、性能与发布均 **NOT RUN**。后续由 RDC 独立审查并补齐验证入口及集中运行。
|
||
|
||
### 2026-09-25 STEP-097 A1：FZG1 测试 APK 与 ADB 冒烟
|
||
|
||
- Mac clean 基线 `91c2491b0` 以标准 Pipeline 构建 OpenGL x86_64 APK，Gradle `BUILD SUCCESSFUL in 15m 59s`；60,295,184 bytes、SHA-256 `8677197c5f83a22747cb51f0c261edffc5db4678fc25b3f366474f6ecb94dc99`。
|
||
- `adb -s 192.168.200.139:5555` 在 FZG1-2 覆盖安装成功，设备内文件 hash 相同；既有 STEP-093 场景、缓存/相机/非法范围恢复等 20 张截图与日志完成。报告：`docs/报告/STEP-097_A1_FZG1测试APK与实机验证报告_v1.md`；本地证据保存在忽略目录 `artifacts/maplibre-particle/step097-fzg1/`。
|
||
- A1 的 stencil 同 tile、Metal、render exception 以及 19 定向 GTest 未闭合；B/D topPresent 诊断异常待复核，A1 仍 PARTIAL，A2/B/C 未进入，未发布下一软件版本。
|
||
|
||
### 2026-09-26 STEP-097 A1 GTest 实测
|
||
|
||
- RDC 重新编译 mbgl-test-runner 成功，第 19 项 1/1 PASS，RenderSegmentDiagnostics 组 5/5 PASS，全部退出码为 0。
|
||
- 详见 docs/报告/STEP-097_A1_第19项GTest运行验证报告_v1.md。A1 仍因 01/02/03 专项测试缺失保持 PARTIAL，未进入 A2/B/C。
|
||
|
||
### 2026-09-26 STEP-097 A1 第 19 项 FZG1 设备测试
|
||
|
||
- 在 FZG1-2 重新安装源码等价的 OpenGL x86_64 APK，设备内 SHA-256 与构建产物相同。20 个截图与 UI XML、两轮 topology 轮换、缓存 OFF/ON、非法范围与恢复均已 ADB 实跑，粗粒度 B/T 资源创建减释放值均为 0 或 1；最终脚本 exit 0，实时日志无崩溃记录。
|
||
- 设备报告：`docs/报告/STEP-097_A1_第19项FZG1运行验证报告_v1.md`；原生 GTest 1/1 与诊断组 5/5 已通过。B/D topPresent 诊断疑点待复核，A1 其余 01/02/03 仍未完成，未进入 A2/B/C 或发布。
|
||
|
||
### 2026-09-26 STEP-097 A1 专项测试入口续作
|
||
|
||
- Codex 增加本地同源 GeoJSON 的 R-R/R-C-R/C-R-R Android 操作入口、Metal 附件及 clear GTest、LayerGroup 异常与 cache 重试 GTest；仅静态检查，未运行构建、GTest、Jest 或设备。A1 仍待 RDC 验证，A2/B/C 不启动。
|
||
|
||
### 2026-09-26 STEP-097 A1 Android/Core 收口
|
||
|
||
- RDC 标准脚本构建 `8c006ac83` Android x86_64 OpenGL APK，FZG1-2 覆盖安装与 SHA-256 核对通过。18 组同 source/tile Stencil 屏幕、诊断与像素采样一致，03 异常恢复原生 2/2 PASS，19 之前原生 1/1 PASS。证据与限制见 `docs/报告/STEP-097_A1_Android专项验收报告_v1.md`。
|
||
- Metal host 编译可用但设备无 Metal，2 项 SKIP；依用户决定不做 iOS runtime，不虚报 iOS 实测。允许进入 A2，STEP-098 未启动、未纳入提交。
|
||
|
||
### 2026-09-26 STEP-097 A2 中途检查点
|
||
|
||
- A2 修改处于未提交状态，Codex GPT-6-Sol medium 用量限制触发暂停；RDC OpenGL 原生构建 PASS、16/16 GTest PASS、Shader generator 两次幂等，Metal host 编译 PASS、同样 16/16 Core GTest PASS。非 iOS runtime。
|
||
- 记录 `docs/报告/STEP-097_A2_阶段验证记录_v1.md`；保留完整工作树、未跟踪 STEP-098 和产物，不进入 B/C。已设定 13:55 JST 恢复检查。
|
||
|
||
### 2026-09-26 STEP-097 A2 最终 Android/Core 验证
|
||
|
||
- 当前可见 Codex 会话为 GPT-6 Luna High。RDC 独立复核原 58/58 回归、当前 OpenGL broad 121/121、Metal host broad 121/121，A2 focused tests 两平台各 3/3；shader generator 两次幂等。修复旧断言以区分忽略 dataVersion 的 decoded-content equality 与严格 endpoint identity。
|
||
- RDC 标准 Android OpenglDebug x86_64 APK 构建成功，61,753,803 bytes，SHA-256 `27bf4a6cc191bd86c4d1c10398478d81c2999edd61fe7242e40e5188516b0ca5`；FZG1-2 安装包 hash 一致。TEST-ONLY V4 Golden Wind T0/T1 完成加载、seek、倍速、PLAY 30 秒、PAUSE、重播、CLEAR/重载与再次播放；runner exit 0，17 张 PNG、24 steps、ANR=0，15 秒截图可见粒子。
|
||
- mix-only 稳定区间 `fieldUploadCount=6`、`resetCount=2`；显式 CLEAR/重载后计数合法增加到 upload 10/reset 4，故不把 clear/reload 描述为零上传。历史 12:43 同步重入 ANR 与后续 main-thread 高负载/TIME 无响应失败均保留在证据中；修复包含防重入与 mix-only 缓存物化优化。
|
||
- 证据与限制见 `docs/报告/STEP-097_A2_阶段验证记录_v3.md`、集中验证清单和更新后的 24 项矩阵。Metal 结果是 host/Core，不是 iOS 设备测试；iOS runtime 按用户决定标为 `USER_ACCEPTED_WITHOUT_IOS_RUNTIME_TEST`。没有长时间 GPU 性能结论；STEP-097 整体 PARTIAL，B/C 未开始。
|
||
- 本次仅完成报告、Step、矩阵、清单与开发记录；没有执行构建、测试、Gradle、ADB、codegen、提交或推送。用户未跟踪 STEP-098 任务文档保持原样，交由 RDC 独立审查并按范围处理 Git。
|
||
|
||
### 2026-09-26 A2 源码独立 scoped commit 核验
|
||
|
||
- A2 的 26 个生产源码、shader、TestApp-only V4 Golden fixture 和定向测试文件已固定为 `f49ffa68a17e0a505199bdbeccf07f8543f3a05f` 并推送，`origin/particle/main` 回读一致；没有 stage 用户未跟踪 STEP-098。完整代码/设备证据仍见 `docs/报告/STEP-097_A2_阶段验证记录_v3.md`，不因 Git 提交改变原 APK 的 `git_dirty=true` 来源事实。STEP-097 整体 PARTIAL，B/C 待用户指令。
|
||
|
||
### 2026-09-26 STEP-097 B 阶段（独立核查中，未关闭）
|
||
- 08/09/10/20 的 B 源码及测试入口已形成；Codex 使用 GPT-6 Luna High 的两次 `exec --json` 均取得 `turn.completed`，保存 JSONL/status.json。
|
||
- RDC Core 专项 4/4 PASS；旧 16-bit fixture 修正后 OpenGL broad 134/134 PASS。
|
||
- B10 新 Map 销毁 hook 不在正式 .13 Android AAR，Test Host 默认 .13 无法直接编译此 Kotlin 调用；B 记 PARTIAL/BLOCKED，不提交、不进入 C，见 B 独立验收报告。
|
||
|
||
- 2026-09-26 STEP-097 B：RDC 恢复 B10 / fixture 两个 `codex exec --json` 完成状态；Mac Core 6/6、139/139，Android Native JUnit 2/2、Java 编译、隔离 owner JUnit 4/4 通过。默认 .13 AAR 不含新销毁 hook，B 仍 PARTIAL/BLOCKED，C 和 STEP-098 未启动；证据见 B 专项报告。
|
||
|
||
- STEP-097 B 已将 21 个源码、测试和阻塞报告保存至独立远端分支 `step097-b-blocked-20260926`，首提交 `e463ba04ce956a54eed02b77f981eeeedd9a5534`。主线未推送不兼容桥接；B 仍 BLOCKED，Linux 隔离构建结果另记。
|
||
|
||
### 2026-09-26 STEP-098 Codex 源码交付
|
||
|
||
- 用户批准按 Integration `1dd576d3304e267e53ed64d31f9711d2350ce10a` 的 RFC-004、ADR-001、C-002、COORD-005 实施；该新接受契约解除旧 RFC-003 历史阻塞。原任务书与旧阻塞报告均未修改。
|
||
- Core 增加精确单帧窗口、同 key 不同批次共存但严格禁止跨 fieldID/reference/profile 插值、先候选验证再原子滚动淘汰、等距离淘汰原最早端；解码 profile 身份与 decoded raw-plane/validity byte count 可观测。单帧 materialized snapshot 和首次 GPU endpoint 安装复用。
|
||
- 新增/扩展 Core、Binding、Ingress、RasterArraySource 定向测试代码，覆盖 T01–T17 的源代码场景；所有新增/扩展测试均未运行。仅执行 `git diff --check`；没有 CMake、Ninja、Gradle、Pod、npm、Jest、ADB、设备、发布、commit 或 push。
|
||
- 完成报告 `docs/报告/STEP-098_QBIN_V4单帧与八帧滚动缓存_Codex完成报告_v1.md`；源码交付等待 RDC 按 B→C 构建测试和后续 Android/iOS 配套实测。当前不进入 V15 pipeline。
|
||
|
||
- 2026-09-27 STEP-098 RDC：Core B 19/19、OpenGL Host 119/119、Metal Host 119/119 定向 GTest PASS；修复 Source 私有 Store 测试断言和两处无效 Grid fixture。Android/RN/iOS 制品、真机 GPU/内存与 V15 Pipeline 尚未验证；报告见 docs/报告/STEP-098_RDC定向验收报告_v1.md。
|
||
|
||
### 2026-09-27 V15 iOS WeatherColor 纹理生命周期修复（Codex 源码交付）
|
||
|
||
- 核实 manifest V15 `sourceCommit=1fdc5df625d405233703136eb2dc12032d932da2`，后续 finalize release 生成的 tag 指向 HEAD `cd71640a84901212ce4681e296f027befdff4ee0`；两者角色不同且任务相关源码相同，不构成冲突。用户未跟踪任务书继续保留。
|
||
- WeatherColor update 阶段现比较 T0/T1 GPU texture 指针；endpoint 或 wrap 变化会在 LayerGroup upload 前重建 Drawable。移除 Tweaker draw 阶段的 texture 绑定，仅保留 UBO 动态更新；新增 endpoint 转移矩阵定向测试。
|
||
- RDC 首次 OpenGL build 在测试文件第 60 行遇到 `nullptr` 模板推导失败；production renderer object 已编译。Codex 对该测试调用显式指定 `<int>`。RDC OpenGL retry exit 0、6/6；Metal host build exit 0、6/6。日志位于 `/tmp/navsea_v15_weathercolor_validation/`。iPad/Xcode/设备实测待用户手工完成；tag 和发行内容未覆盖。
|
||
- scoped commit `5af91fe7a105f0ac047e18db1dc063c9ffd69d44` 已推送 `origin/particle/main`，推送后 `git ls-remote` 回读同一 HEAD。当前只等待用户手工 iPad 验收。
|
||
- 验证结果补录提交 `4712e1752af2a8238def5839c8754270de4195c9` 已推送，远端回读同一 HEAD；随后仅更新报告/Step 的当前状态措辞。
|
||
- Step：`docs/50_Step记录/V15_iOS_WeatherColor纹理生命周期修复_v1.md`；完成报告：`docs/报告/V15_iOS_WeatherColor纹理生命周期修复_Codex完成报告_v1.md`。
|
||
|
||
### 2026-09-27 v16 统一发行 Bazel 头文件清单修复
|
||
|
||
- 统一发行 Android 四 ABI 和 Maven Local 通过；首次 iOS Metal Bazel 在 render_weather_color_layer.cpp 编译时找不到新增 WeatherColor lifecycle 头文件。
|
||
- 在 bazel/core.bzl 的 MLN_CORE_HEADERS 精确登记该头文件；保留 WeatherColor 业务实现不变。由 RDC 重跑完整 v16 构建、公开回读，iPad 人工验收仍待执行。
|
||
|
||
### 2026-10-06 STEP-099 RenderSource readiness 与 RenderSegment 失效诊断（CLOSED / PASS）
|
||
|
||
- frozen release 为 `maplibre-particle/rn/13.4.1-particle.17` / `e8b451fe70054107773e82484c80e90df3889147`；implementation commit 为 `8a5214d92dd2f8899db76d2194da42999fa0c87d`。未修改 Integration/NavSea。
|
||
- 完成 renderer/source readiness additive snapshot、tile stats、mutation source/tile action、只读 source→segment dependency 与 Android T1～T4。正式 `renderTreeParameters->loaded = styleLoaded && isLoaded()`、Source `isLoaded()`、retained cache、fast path、singleContinuous、多 Continuous 和 RenderSegment execution 均未改变。
|
||
- Metal host `RenderSegmentDiagnostics.*` 6/6 PASS；最终 Android x86_64 OpenGL APK BUILD SUCCESSFUL in 4m54s，APK 61,923,024 bytes，SHA-256 `5de73f0358b835a78d3ae7e2ac22f4efdb2a66775b8c63654a8bb7313957d90a`。Vulkan/最终 Metal rerun 因当前 Mac 缺 libuv pkg-config 未执行，不虚报 PASS。
|
||
- FZG1-2 / Android 13 / API33 实跑：T1 静态仅 1 个 204ms 启动 false window 后稳定；T2 双 GeoJSON 各约 1Hz，10 个 false window、avg 203ms、max 205ms；T3 无 layer 的 disabled RasterArray 仍 isLoaded=false，使 global loaded 持续 false 21.459s；T4 61 次动态更新产生 4 个 false window、avg 203ms、max 207ms。
|
||
- T4 证实 dependency diagnostics 能正确给动态 source `affected=[2]`，但 global contentRevision 1760→2540，R0 虽只依赖 `step099-static`，cache build 仍 1→121、invalidation 20→200，确认 `GLOBAL_CONTENT_REVISION`。源码审计同时确认 global fade/update signature/pending/placement/repaint/annotation/singleContinuous 等 fast-path gate 仍存在。
|
||
- Q1～Q7 与 blocker 分类已闭合：runtime confirmed `PERMANENT_SOURCE_UNLOADED`、`DYNAMIC_SOURCE_READINESS_THRASH`、`GLOBAL_CONTENT_REVISION`；source confirmed `GLOBAL_FADE`、`GLOBAL_UPDATE_SIGNATURE`。
|
||
- 完成报告：`docs/报告/STEP-099_RenderSource就绪与RenderSegment失效诊断_Codex完成报告_v1.md`；Step：`docs/50_Step记录/STEP-099_RenderSource就绪与RenderSegment失效诊断_v1.md`；运行证据保存在忽略目录 `artifacts/maplibre-particle/android-validation/`。
|
||
|
||
### 2026-10-06 STEP-100 SourceScoped RenderSegment 局部失效（CLOSED / PASS）
|
||
|
||
- 基于 `c4b481fd2c5b5da20d31f6ae54011f0552d7dbd0`，Codex `gpt-6-sol / high` 实现 source-scoped revision、production/diagnostics 共用 dependency、per-segment loaded/fading/readiness 以及独立 Build/Reuse/Fallback；global loaded/content revision 与 Fast Path gate 保持原兼容语义。
|
||
- RDC 标准 Android x86_64 OpenGL validation build PASS，APK 61,956,640 bytes，`libmaplibre.so` 39,636,472 bytes，SHA-256 `86e22bf081bf7d3196f0bf0e7c56af51bde01e9f0b01e0bab238cb794273315a`。RDC 同时修复 validation script 在 `pipefail` 下的 `unzip | awk ... exit` SIGPIPE/141，小修不改变产物校验语义。
|
||
- FZG1-2 T4 R-C-R 约 61.6 秒主窗口：global revision 128→973；R0 build 1→1、invalidation 20→20、reuse 132→4042、source revision 不变；R1 build 5→135、invalidation 26→211。动态 source 持续 `affected=[2]`，核心 locality 硬门槛 PASS。
|
||
- T2 双 GeoJSON 约 35 秒仍产生 6 个约 203ms loaded false window，但 R0 build/invalidation 不变；T3 unrelated permanently-unready RasterArray 使 global loaded=false 持续 21.468s，但 R0/R1 build=1、invalidation=19 不变，reuse 11→1200，证明无关 source 不再拖垮 retained cache。
|
||
- T4 运行期间 R1 fallback count 增长而 R0 fallback 不变、reuse 持续增长，实际验证 mixed `R0 Reuse + C Live + R1 Fallback`。未发现 crash/ANR。Fast Path、`singleContinuousSegment`、multi-continuous 语义未改。
|
||
- Native host GTest 因当前 Intel Mac 缺 `libuv` 环境阻塞；尝试 Homebrew 安装时发现会连带升级 CMake/OpenSSL/Python 且 Intel 无 bottle 支持，已停止，未把环境阻塞虚报 PASS。Android full native build + device runtime 作为本 Step 功能验收事实。Jest 未运行。
|
||
- Step：`docs/50_Step记录/STEP-100_SourceScoped_RenderSegment局部失效_v1.md`；完成报告：`docs/报告/STEP-100_SourceScoped_RenderSegment局部失效_Codex完成报告_v1.md`；运行证据在忽略目录 `artifacts/maplibre-particle/android-validation/`。允许进入 V18 unified release。
|
||
|
||
### 2026-10-06 STEP-101 RenderOrchestrator 销毁生命周期修复（源码交付，待 RDC 验收）
|
||
|
||
- 基于 V18 Final HEAD `d29e84c1a90daeea104b389d28b000c4f017d08d`，按 STEP-101 任务 v2 审计现有差异。已证实 readiness mutex/state 早于 RenderSource 自动析构且 tile/source 销毁可同步回调的生命周期漏洞；与 Android FORTIFY 现场高度吻合，但仍待等价实机闭环确认。
|
||
- 现有源码差异包含 RenderSource nullptr observer 回退 NullObserver、Orchestrator 析构双 tagged drain、三类 observer detach 与显式 source clear；Android Validation 增加 T1～T4 Activity recreate 场景和 Native reset 配对日志。静态审计发现 teardown 测试 helper 没有注册 Orchestrator observer，本轮仅补正这一行。
|
||
- render-job 队列独立于 `waitForEmpty()`；OpenGL backend/context 后续清理与真实 Android reset 仍须由 RDC 验收。STEP-100 locality 实现无本次差异，运行态回归待执行。
|
||
- 本轮仅做源码/任务静态审计与 `git diff --check`；CMake/Ninja、Native GTest、Gradle/APK、ADB/设备、NavSea、Jest、iOS、candidate/release、commit、push、tag、publish 全部 **NOT RUN**。不能写 STEP-101 PASS。
|
||
- Step：`docs/50_Step记录/STEP-101_RenderOrchestrator销毁生命周期修复_v1.md`；完成报告：`docs/报告/STEP-101_RenderOrchestrator销毁生命周期修复_Codex完成报告_v1.md`。V19 未发布；下一步 RDC 按报告命令独立验证。
|
||
|
||
### 2026-10-07 STEP-101 源码交付补充
|
||
|
||
- 审计 V18 Final HEAD、任务 v2、正常 source erase/clearData、TileCache 延迟释放和独立 render-job 队列；本轮不扩大正常 source 更新语义。
|
||
- 补齐 C++ 测试对旧 observer 已 detach 的断言；Android 增加 SurfaceView detach、Java/JNI `nativeReset` 与 Native `resetRenderer` 逐轮日志，并补 T3 动态 GeoJSON mutation 标记。
|
||
- `git diff --check` 通过；Native 编译/GTest、Android Gradle/APK/ADB/设备、STEP-100 locality 运行态、NavSea 和 V19 发布均未执行。结论仍为 PARTIAL，待 RDC 独立验收。
|
||
|
||
|
||
### 2026-10-07 STEP-101 RDC 独立验收 CLOSED / PASS
|
||
|
||
- Android x86_64 OpenGL Validation full native build PASS：APK 61,957,678 bytes，libmaplibre 39,637,512 bytes，SHA-256 `14cbd35ed0bc1366389ddea69925901013e3b209ed3575462421a7920c73c721`。
|
||
- FZG1-2 T1/T3/T4 PASS；T2 完整 20 次真实 Activity recreate / `nativeReset` / `MapRenderer::resetRenderer` PASS，四组 crash buffer 均为空，不再出现 destroyed-mutex SIGABRT。
|
||
- STEP-100 locality 回归 PASS：global revision 62→894，R0 build 1→1、invalidation 19→19、reuse 12→3890；R1 正常持续 build/invalidate。
|
||
- Android Native C++ TestRunner 构建 PASS；4 个 RenderSegmentLocality + 2 个 RenderOrchestratorTeardown focused tests 全部 PASS，status=0。TestRunner 临时 fixtures asset 已删除，不纳入 Git。
|
||
- Mac host GTest 仍受本机 libuv pkg-config 环境阻塞，未安装系统依赖、未虚报 PASS。Jest NOT RUN。
|
||
- STEP-101 允许关闭；下一步进入 V19 candidate → NavSea 冷启动 Gate → 正式发布。
|
||
- STEP-101 implementation commit `64cf8f44350eb8ec4b45360db4d3f9505ac4ac0b` 已推送 `origin/particle/main`，远端回读一致；后续只做 docs closeout 与 V19 发行。
|
||
|
||
### 2026-10-08 STEP-102 RenderSegment 无 Placement 段局部复用（代码完成，待验证）
|
||
|
||
- 基于 `6df21dac38f072c5ad35b8dfc7ec5217509602bc` 的独立 `step102-placement-free-retained-locality` worktree，实现结构性 symbol placement capability、full CPU per-segment gate、逐段 fallback reason，以及仅从全局 live 条件移除纯 aggregate placement gate。旧动态 `retainedRangeUsesPlacement()`、Fast Path、mixed executor、C-001 与 RN method surface 保持原语义。
|
||
- diagnostics 新增 `placementCapable`、`placementGatePassed`、`actualExecution`、全局 placement 状态、`mainBufferExecutionMode` 与 `globalLiveFallbackReason`；actual 在 main-buffer 分支执行后记录，允许 cache=reuse 但实际 live 的事实被看见。C++ 测试源码和 Android T1 symbol/T2 two-free 离线场景已交付。
|
||
- 只做只读审计与 `git diff --check` 静态检查；CMake/Ninja、C++ 测试、Android Gradle/APK、ADB/设备、Jest、iOS/Metal、NavSea、发布、commit/push 均未执行。STEP-102 不记运行态 PASS；用户手工 Android 构建与后续独立验收命令见 `docs/报告/STEP-102_RenderSegment无Placement段局部复用_Codex完成报告_v1.md`。
|
||
|
||
### 2026-10-08 STEP-102 RDC 独立验证补记
|
||
|
||
- 在独立工作树 `step102-placement-free-retained-locality` 核查了结构性 placement 判断、per-segment gate、实际 main-buffer diagnostics 与 RN 类型边界，未改 Fast Path、C-001、V20 发布源码。
|
||
- AppleClang 对新增 C++ GTest 源码 `-fsyntax-only` PASS；独立头文件 smoke 测试 10/10 PASS；`git diff --check` PASS。
|
||
- Metal `bazel build -c opt --//:renderer=metal //:mbgl-core` 构建 PASS（642/642，875.118s，产物 `bazel-bin/libmbgl-core.a`）。
|
||
- Mac CMake/GTest 配置遇缺失 `libuv`，未安装依赖，正式 GTest NOT RUN。
|
||
- 修复 STEP-102 Android Validation 入口切换时残留 STEP-093/097 状态与轮询的问题。Android APK 编译、T1/T2 真机及 STEP-100/101 回归仍待手工构建与运行；STEP-102 维持“进行中”，尚非 CLOSED/PASS。
|
||
|
||
|
||
### 2026-10-09 STEP-107 iOS CoreOnly Style Peer 崩溃修复（Native BUILD PASS，iPad 待验收）
|
||
|
||
- 基于远端最新 `particle/main` 的 V22 后 HEAD `24105b1be7`，在唯一 Mac 主目录直接修复 Darwin `MLNStyle.layers` 对 CoreOnly 无 Peer Layer 的 nil 插入问题；补齐 KVC 数量/索引/区间、插入/删除与 aboveLayer ObjC 可见顺序语义，Native 粒子天气渲染层保持不变。
|
||
- 新增 `MLNStyleTests.mm` 混合 CoreOnly/普通 Layer 的集合及顺序回归用例；`git diff --check` PASS。Mac Bazel iOS Native `//platform/ios:MapLibre.dynamic` PASS，982.084 秒，ZIP 校验 PASS，SHA-256 `f16b7f2be761a101bb4b906b900175b95412abfeef09d715e2c9321b300a7b8a`。
|
||
- XCTest 尚未执行；iPad 唐津海图物体直接点击、多 Source、天气开关及粒子渲染尚未真实验收；不能宣称 Bug 已在设备上消失。未修改 V22 Tag、正式发行资料、NavSea、Android 或 Shared Core。
|
||
- Step：`docs/50_Step记录/STEP-107_iOS_StyleCoreOnlyPeer集合修复_v1.md`；报告：`docs/报告/STEP-107_iOS_StyleCoreOnlyPeer集合修复_RDC实施报告_v1.md`。
|
||
|
||
### 2026-10-09 STEP-108 V23 正式发行（构建/公网回读 PASS，Tag 收尾中）
|
||
|
||
- 构建源码 `87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`。统一发行 Android/RN `13.6.1-particle.23`、iOS `6.29.0-particle.23`。Mac 四 ABI Android、iOS Metal opt、RN pack 成功，公网六项文件回读 PASS。
|
||
- GSRL Source Lock 记录六文件 sha256；V23 Android/iOS 实机及 STEP-107 iPad 崩溃复测仍 NOT_TESTED，不能写成设备 PASS。
|
||
|
||
|
||
### 2026-10-09 STEP-108 V23 正式发行 CLOSED / GSRL PASS
|
||
|
||
- build、publish、finalize 三阶段严格串行 exit 0；独立验证六项公网 SHA-256 全 PASS；SwiftPM Tag/校验值与 Git 正式发行 Tag 远端回读 PASS。
|
||
- 构建源码 87f3d1c59a52581fb8339f0ea7d106b9f4b94fef；发行 Tag maplibre-particle/rn/13.6.1-particle.23 保持指向 a0a4787b4379ab2819943d20ce05a7ae760a88c3。
|
||
- STEP-107 XCTest、iPad 崩溃事故实机重放以及 V23 运行时集成 NOT_TESTED，不冒充设备 PASS。
|
||
|
||
|
||
### 2026-10-10 STEP-109 V23 CPU / FieldSnapshot 身份快路（开发态）
|
||
|
||
- 对 Mac particle/main 正式 V23 源码只读核查发现：Particle 与 WeatherColor Renderer 对稳定的 Source T0/T1 仍可能在每帧执行 vector/valid 全数组比较；V21 FZG 热点仅作方向依据，不冒充 V23 实测。
|
||
- 在两个 Native Renderer 文件内保存与 GPU 资源对应的不可变 shared_ptr 快照身份；同一已验证快照用 O(1) 身份判断，新对象仍走严格数据/端点比较。未修改 RN API、RenderSegment Gate 或已发行 V23 产物。
|
||
- 本轮 git diff --check PASS；Mac Metal Core opt 编译触发 649 actions 大量重编译，主动中止且核验 Bazel PID 已退出，故编译 NOT COMPLETED / NOT PASS；Android/iOS 性能 A/B 尚未取得。阶段记录：docs/50_Step记录/STEP-109_V23_CPU_FieldSnapshot深比较快路_v1.md；报告：docs/报告/STEP-109_V23_CPU_FieldSnapshot深比较快路_RDC阶段报告_v1.md。
|
||
|
||
|
||
### 2026-10-10 STEP-110 R0 Placement 跨段归因只读调查（PARTIAL）
|
||
|
||
- 按 NavSea V23 R0 [0,31) 含 Symbol、C1 82 层、static-placement/fastPathMiss 问题，在 Mac particle/main 执行 Codex GPT-6 Astra High 只读调查。Codex 取证完成但文档阶段多次停滞，由 GPT/RDC 独立回读源码并完成三份报告和本记录。
|
||
- V23 GSRL 构建源码 87f3d1c，Tag peeled commit a0a4787，调查起点 main 2df504c；Renderer/Placement/Cache/Fast Path 六份关键源码 Git Blob 三者一致，STEP-109 后续 FieldSnapshot 优化不是 V23 制品事实。
|
||
- 结论：Placement 事件可条件性追源，但不能据此证明 R0 地名 Symbol 位置、显隐、碰撞与 Fade 不变；V23 对 placement-bearing R0 使用全局保守 Gate，与 STEP-102/106 对 placement-free Retained 局部复用的边界一致，**并未证明 Gate Bug**。STEP-106 T2 的两个 placement-free R 可在 global placementChanged=true 下复用，不适用于 R0 含地名 Symbol。
|
||
- 下一步需先形成 per-R0 视觉等价证据与独立诊断，再考虑 Native 内部 Gate 优化；跨项目 API/Style 改动交 Integration。未编译、未运行测试/设备、未更改 Native 或交付发行，状态 PARTIAL。
|
||
- 报告：docs/20_调查/R0_Placement跨段归因与缓存安全边界调查_v1.md；docs/50_Step记录/STEP-110_R0_Placement跨段归因只读调查_v1.md；docs/报告/STEP-110_R0_Placement跨段归因只读调查_Codex完成报告_v1.md。Git Commit/Push 状态以完成报告补记和 RDC 独立核验为准。
|
||
|
||
### 2026-10-10 STEP-111 R 段 Placement 结果等价与独立刷新可行性调查（PARTIAL）
|
||
|
||
- 用户目标：RCRCRC 各 RETAINED R 段仅在自身最终 Symbol/Placement 视觉结果改变时重建；受真实跨段 Collision/Fade 影响者必须失效。
|
||
- 在 Mac 上以用户指定的 Codex GPT-6 Astra High 启动源码调查，虽有部分浏览记录，但两轮长时间无结果后终止，未生成既定文档；不能判 Codex PASS。
|
||
- GPT/RDC 复核当前全局 Placement Gate 和逐段 Cache：`render_segment.hpp:85-90` / `render_orchestrator.cpp:792-809` / `renderer_impl.cpp:638-686`。建议保留全局 Placement，先研究每 R 结果影子比较，再授权安全复用；复杂度约 3→4，真正独立 Placement 引擎为 5/5。
|
||
- 仅落盘 PARTIAL 评估及执行报告，不改 Native/公共接口、未编译/测试/设备、未进行 Source Lock；实际 Git 收尾另行核验。
|
||
- 主报告：`docs/20_调查/STEP-111_R段Placement结果等价与独立刷新可行性调查_v1.md`；Step 与执行状态报告见 `docs/50_Step记录/`、`docs/报告/`。
|
||
|
||
### 2026-10-11 STEP-112 V23 Full Render 循环与 Symbol 缓存准入调查（PARTIAL）
|
||
|
||
- Codex实际会话已核实 `gpt-6-astra/high`；在Mac `particle/main@41b416c261fa72bd21171328045036a124694f47` 完成A—E只读调查，并直接分阶段落盘三份文档。
|
||
- 源码证明正常Continuous Full中，Symbol R重算时changed=true，不重算时stale使Controller transition=true，三条件Placement Gate没有首次Build窗口；fade=0不代表终态，关闭transitions正常Full为true/1/false。Fast还有prepared scene及PREFIX普通Symbol/Line C的独立阻塞。
|
||
- 已交付24项Gate矩阵、R2状态机、开关/Fade真值表、S1—S5和A—D提案。FZG1逐帧配置/来源/CPU、原RCRR完整布局及安全新准入仍待验证，不能称Native已修复或性能PASS。
|
||
- 仅新增主报告/阶段记录/完成报告和本追加；未改源码/Style/脚本/测试/跨项目文件，未编译/测试/Jest/设备操作，未commit/push，两份未跟踪STEP-110/111任务书保留。
|
||
- 主报告：`docs/20_调查/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_v1.md`；阶段记录及完成报告见 `docs/50_Step记录/STEP-112_V23粒子FullRender与Symbol缓存调查_v1.md`、`docs/报告/STEP-112_V23粒子FullRender与Symbol缓存调查_Codex完成报告_v1.md`。后续RDC独立审查和Git收尾，未授权Native修复。
|
||
|
||
### 2026-10-11 STEP-113 FZG1 PBF Layer 与 Fast Gate 诊断（源码交付PARTIAL）
|
||
|
||
- 实际模型已核实 `gpt-6.1-sol/high`；在Mac `particle/main@c6d13e1059d464d312ac33acac87967300fa5dc4` 实现同次input的24Gate首错/失败全集，120帧环形诊断、聚合、pre/post与per-R状态；保留原生产Gate/Placement/Cache准入及安全回退。
|
||
- Test App增加正式PBF63、静态RC、粒子关闭、明示部分RCRR、手动Source变化；3秒查询/30秒摘要与STEP113Gate手动导出。没有伪造113层动态业务图层；本机生产域名回读失败，完整等价需同版本快照及设备证据。
|
||
- 新增4个C++回归用例源码；仅静态核对与diff空白检查，未编译/运行测试/Jest/Gradle/APK/ADB，未commit/push/发行。STEP-102动态poll/fixture与既有未跟踪任务书保持原样。
|
||
- Step与中文交付报告见 `docs/50_Step记录/STEP-113_FZG1_PBF_Layer与FastGate诊断_v1.md`、`docs/报告/STEP-113_FZG1_PBF_Layer与FastGate诊断_Codex完成报告_v1.md`；RDC独立完成编译、FZG1-2逐帧/资源/场景与开销验收，APK成功不等于性能PASS。
|
||
|
||
- 2026-10-11 STEP-113 RDC：标准Android Validation APK构建exit=0；FZG1-2安装成功，五场景稳定Logcat摘要（Native层64/66/66/66/67）均decisionMismatch=0；STATIC_RC Full875/Fast0，PARTIAL_RCRR Full861/Fast0，发现cache-invalid外#22/#23同时阻断。完整113层、手动Source变化、性能和回归未验收，整体PARTIAL；详细证据追加于STEP与报告。
|
||
|
||
- 2026-10-11 STEP-113第二轮：FZG1-2已保存Source变更前后各120帧完整Snapshot，decisionMismatch=0；单次Source mutation=1，Native最后变更为step113-source-probe、影响C1；稳定119帧同时命中#3/#4/#22/#23。已确认内建annotation symbol进入C，且#22/#23可共享根因；Mac Native GTest因缺libuv未运行，NavSea完整113层/性能仍PARTIAL。详见STEP记录追加段落。
|
||
|
||
### 2026-10-11 STEP-114 Fast Path 安全准入与独立 Test App（源码交付 PARTIAL）
|
||
|
||
- 实际模型已核实 GPT-6.1-Sol（gpt-6.1-sol）/ high；Mac particle/main 起点 b02e54de3d45fcf612126ae8f037cba204f590ea。无模型切换、子代理、commit/push/发行。
|
||
- Shared Core 仅修正完整无 Symbol 场景被 controller stale 误挡的 #13 输入；隐藏/空/Annotation Symbol、空表/数量不一致继续保守。CustomMVTVector、非粒子 C、Symbol R Build/scene/资源/碰撞保护均保留 fail-closed。
|
||
- 回读旧 STEP-113 完整 JSON：navsea_delivery 实际是 Vector；R 依赖 tide-spots→tide 但 Native source 表缺 tide。缺源提前明确报 missing-source，不补假源、不放行缓存、不改原 PBF 五场景。
|
||
- 新增独立 FAST_SMOKE 与 Circle C/真实 Annotation/Symbol R 三个反向场景；只在独立空 Annotation 场景移除空内建 layer，使用 Native 真实 Full/Fast/Build/Reuse/24Gate，单次操作自动保存前后短延迟快照。新增3个非 Jest C++用例源码。
|
||
- 中文调查、场景/RDC精确验收命令、Step与完成报告已实际落盘；仅静态检查，未编译/测试/Gradle/ADB/Jest/设备。真实 Fast 未验收，Symbol R 结果证书 BLOCKED，不标 Fast Path 已修复。
|
||
- 下一步 RDC 独立审计/执行 Mac Native 定向检查；用户一次手工 Android/设备闭环并保存源码diff/制品SHA/逐帧/截图证据。详见 docs/报告/STEP-114_FastPath安全准入与TestApp闭环_Codex完成报告_v1.md 与 docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md。
|
||
|
||
- 2026-10-11 STEP-114 RDC：独立核对安全Gate改动、3项C++测试源码、Android Test App接线及STEP-113/102冻结SHA，git diff --check PASS。Mac缺libuv，单独C++ header检查因Xcode找不到标准头array环境阻塞；Android/真机/Fast未执行，PARTIAL，后续用户一次手工构建验收。
|
||
|
||
- 2026-10-11 STEP-115：为原STEP-113专用APP增加Fast Path复测工具，严格校验源码HEAD、build-info APK SHA与设备安装SHA；旧包源码为c6d13e1，与现行21a1081不匹配，preflight正确拒绝。已验证旧Logcat可解码STEP113真实摘要，原五场景保持不改。尚无新Android编译/安装/真正Fast，下一步用户手工build/install后以STATIC_RC为先验收，状态PARTIAL。
|
||
|
||
### 2026-10-11 STEP-116 原 STEP-113 PBF Fast Path 受控修复（源码交付 PARTIAL）
|
||
|
||
- 实际模型 GPT-6.1-Sol（gpt-6.1-sol）/ high，已读取会话turn_context确认；Mac particle/main起点e2d202b560ad0165101546597c43f2ef0ccf4542，无commit/push/发行/子代理。
|
||
- 仅STATIC_RC确认空实例后一次移除SDK内部points层，保留Source及原63层；stop恢复，后续添加/Style替换撤销验收条件。Native AnnotationManager在Symbol add/update/style-loaded同步恢复缺层，no-op更新也dirty，避免依赖3秒poll漏Marker。
|
||
- R缺tide仍missing-source，Symbol R无最终GPU结果证书仍BLOCKED；未补假源/删tide-spots/放宽Core C或Placement Gate。JSON加missingSourceIds，摘要同次保留Placement与真实Build/Reuse/Full/Fast。
|
||
- 新增四个Step116Safety与三个Annotations.Step116非Jest测试源码；STEP115脚本修复实际等待时长并拒绝未锁定tracked源码、生命周期变化/撤销/计数reset。四份中文交付和README已落盘，开发记录仅追加。
|
||
- 已做静态diff/AST/旧JSON及冻结SHA核查，未编译/运行Native测试/Gradle/ADB/安装/Jest；真实Fast与画面NOT VERIFIED。保护STEP110/111，保留STEP114/102源码。下一步RDC独立审计锁定源码，用户一次手工build/install，原STATIC_RC≥75秒与120帧/24Gate/SHA/画面闭环，详见docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md及本Step完成报告。
|
||
|
||
- 2026-10-11 STEP-116 RDC：审查Native空Annotation恢复、原STEP113受限空层移除、缺源诊断、7个C++测试源码与同HEAD/SHA复测脚本，git diff --check、Python AST通过。修正Mac测试命令rg为grep -E。实际CMake macos-metal配置exit1缺libuv，未继续C++测试/Android Gradle/真机Fast，PARTIAL；缺tide与Symbol R仍BLOCKED。
|
||
|
||
- 2026-10-11 STEP-116 RDC实测：按用户明确授权由Mac实际编译并安装Test App，源码c48a72a9、APK SHA a8b7f4e0f8e026bde8835e18a04876062be84cce3a3749a511cb08605d9f8a35、设备192.168.200.139:5555安装SHA一致。原STEP113 STATIC_RC 90s Fast0/Full+920；Native65层C正常两层，#22近120帧零失败，空Annotation修复有效；R缺tide、Build/Reuse0、Placement不稳定，119Full/0Fast，仍FAIL/PARTIAL。报告docs/60_测试/STEP-116_FZG1_原PBF实机验收结果_20261011.md；原始JSON/Screenshot存Git忽略artifacts目录。
|
||
|
||
### 2026-10-11 STEP-117 原 PBF R 首次 Build 与 Fast 安全准入（BLOCKED）
|
||
|
||
- 实际GPT-6.1-Sol（gpt-6.1-sol）/high已从当前会话turn_context核实；Mac particle/main起点43e5f5b91598b9c3d3f1c788052d4bbd2d616668，Integration本地只读HEAD80667d6c343411d03a760425438e3d292f452118。无模型切换、子代理、commit/push或跨仓写入。
|
||
- 完整回读STEP116原STATIC_RC 120帧JSON，SHA cd491d2acca97119f1d4f2d6f77eb7b229c17b90d4be1181a59202308429b219。119Full/0Fast/1pending、mismatch0；pre105帧changed=false/fade非零/transition=true，15帧true/0/false，全部R placementGate失败。原63层/C两天气层及空Annotation受控修复保留。
|
||
- 源码证明缺源无新RenderItem不等于GPU零贡献/无旧数据：双group停用要processChanges执行，markLayerRenderable不清旧drawables/tiles；原JSON无提交代次/旧Renderable数据排除证书。Symbol重算changed、recent stale，无首次Build窗口；fingerprint只有Impl/index，不含最终opacity/vertices/atlas/collision/uniform。
|
||
- 按任务安全停止条件，缺tide继续missing-source，Symbol R继续fail-closed，未放宽24Gate/ready/revision、未删tide-spots或补假tide、未以STEP114烟测替代。零贡献准入和结果证书未实现，真实Build/Reuse/Fast目标未完成。
|
||
- 两个既有C++测试文件新增七项Step117Safety：真实Controller/Placement、真实缺源RenderTree及sourceDiff、RemoveGroup队列、Tile/Glyph/Image回调/context/style epoch、cache墓碑与revision重建；全部NOT RUN/NOT COMPILED，不冒称GPU/并发/像素PASS。
|
||
- 已生成四份中文调查/Step/验收计划/完成报告并追加本记录；仅执行原证据解析、静态一致性/范围/diff检查。未运行Native编译/CMake/Ninja/Bazel/GTest、Gradle/ADB/安装/Jest、设备或性能测量，STEP110/111未跟踪MD与原Git忽略JSON保持。
|
||
- 交RDC独立审计及定向Native验证；由粒子负责人协调Shared Core缺源与Symbol证书设计、Style/Host真实tide语义。受控实现完成后再安排一次用户授权的Android源码/APK/设备SHA与原STATIC_RC≥90秒、120帧24Gate/Mutation/用户画面闭环。详细状态见docs/报告/STEP-117_原PBF_Fast缓存准入_Codex完成报告_v1.md。
|
||
|
||
- 2026-10-11 STEP-117 RDC：新加7个C++非Jest安全回归用例源码，针对缺Source/旧GPU组、Symbol首次Build及源/图像/字形/相机变更fail-closed；两个test/renderer源文件由Android NDK OpenGL/x86_64实际compile_commands.json做C++20 -fsyntax-only，均exit0（6.3s/5.3s）。生产Native/Fast Gate/APK未改，本轮不重复构建相同APK，GTest运行/真实Fast仍BLOCKED。需要Shared Core结果证书和Integration核验真实tide语义，报告见docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md。
|
||
|
||
- 2026-10-11 STEP-117 RDC严格编译校验收尾：发现测试辅助UpdateParameters遗漏retainedUnderlayState初始化会产生Wmissing-designated-field警告，已只补该测试字段，并以真实Android NDK C++20 compile_commands.json、保留-Werror、不再添加-Wno-error，重跑两个测试源的-fsyntax-only，全部exit0无警告。非GTest实际运行、不代表GPU/Fast PASS。
|
||
|
||
- 2026-10-11 STEP-118 用户允许删除tide：旧PBF正式sources实际无tide，唯一坏引用为63基础Layer的tide-spots Symbol。RDC新增TestApp独立STATIC_RC_NO_TIDE副本，只排除唯一孤立Layer，原五场景/63正式Style/Native24Gate不变；严格Python verifier校验原63→有效62加天气2（预期Native64）及真实SHA、来源和R边界。正式远端Style未改。待本轮Mac APK与设备实测判断R missing-source是否解除、Symbol/Cache/Fast是否改善。
|
||
|
||
- 2026-10-11 STEP-118 实机：用户授权后RDC Mac构建Test App源码3051196054，APK SHA 44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9，FZG1-2设备adb install成功且base.apk SHA相同。新STATIC_RC_NO_TIDE（仅Test App修改）90.008秒：原63→有效62基础Layer、Native64，R[0,62)、missingSourceIds=[]、fallback由missing-source变static-placement，缺tide已真机解除；Cache Build/Reuse0/0，FastDelta0、FullDelta942，PlacementGate=false，整体PARTIAL/原Fast FAIL。报告docs/60_测试/STEP-118_潮汐清理新APK设备实测结果_20261011.md。
|
||
|
||
|
||
- 2026-10-11 STEP-119 Codex（实际gpt-6.1-sol/high已核实）：在particle/main@869930046b11dbeb3b147e3be952a2e847316292实现Shared Core最终Symbol结果证书。普通Full先完成全场Placement、vertices、processChanges、tweakers/uploads，再精确比较真实UBO、动态/paint/opacity/索引/排序、wrap、atlas/shader、混合/剔除/全局ordinal与版本；成功提交Full/Build后绑定revision，成功Full Reuse后才Fast。区分stale刷新与实际fade，global/perSegment/preparedScene全部接入；普通Full保留证据、真正reset/异步/错误失效，原24Gate/API/ABI/Style/Source/天气/timeline不改。
|
||
- 新增13项非Jest C++测试源码（两个已登记文件），包含真实Controller/Buffer/回调/Source/registry与失败/Annotation/未知shader反例；全部NOT COMPILED/NOT RUN，fixture不是GPU等价证据。四份中文文档已写，完成报告docs/报告/STEP-119_Symbol缓存_Codex完成报告_v1.md；状态IMPLEMENTED_WAITING_ANDROID，不宣称真机Build/Reuse/Fast改善。16MiB上限、取证性能、Metal/iOS与实际像素/竞态待独立验证，Vulkan/WebGPU Symbol缓存保持保守拒绝。
|
||
- 本轮仅轻量阅读、静态范围/保护哈希与git diff --check；未运行Native/CMake/Ninja/fsyntax-only/GTest、Gradle/APK、ADB/设备、Bazel/codegen/Jest，未commit/push。STEP110/111未跟踪MD、STEP117/118原证据与63/62场景保留。现有verifier源码锁/新APK设备SHA保护不绕过；立即交RDC按STEP119联合验收计划独立审计、源码锁、定向验证及一次集中build/install和>=90秒正负场景/失效/视觉闭环。
|
||
|
||
- 2026-10-11 STEP119 RDC编译核验：Integration与Particle已fetch对应远端主线，保护STEP110/111 SHA不变。Mac CMake配置因既有libuv缺失失败；Homebrew意外尝试连带升级工具链，已停止且原CMake可用，不继续扩大环境修改。复用现有Android NDK OpenGL x86_64精确compile_commands，7个生产Core文件+2个非Jest GTest源码合计9个严格-Werror语法编译最终PASS；修正SymbolLayer/test各一处util::toString命名空间、test Mutable→Immutable。GTest/完整链接/Android真机仍待独立执行，未宣称PASS。
|
||
|
||
- 2026-10-11 STEP119 RDC Android实机：源码锁3d989a00a822989339a6d7cb4d23acc04396670e，新APK SHA 57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135、Mac现有Gradle/NDK整包编译PASS、FZG1-2安装设备SHA一致。新STATIC_RC_NO_TIDE真实90秒R Build=1/Reuse=3276（累计）、FastDelta=1819/FullDelta=0、120帧119Fast/0Full、24Gate mismatch0，证实Symbol缓存首次Build/后续Fast生效。原63 STATIC_RC 90秒因tide缺源保持Build/Reuse/Fast全0、FullDelta=305，缺源fail-closed有效。Mac原生GTest受旧libuv环境缺失阻断，未运行13项测试；Metal/iOS、Pan/Zoom/Rotate、Source/Style异步变更、像素/人工目视仍未验，整体PARTIAL。证据docs/60_测试/STEP-119_FZG1_原PBF真实Fast验收结果_20261011.md。
|
||
|
||
- 2026-10-11 STEP119实机首次FAST_OBSERVED：APK源3d989a00a822989339a6d7cb4d23acc04396670e SHA=57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135，FZG1-2安装/preflight PASS；STATIC_RC_NO_TIDE 90秒 FastDelta1819/FullDelta0、R Build1/Reuse3276、24Gate mismatch0、Native64，missingSourceIds=[]。仅正向目标首次通过，负例/视觉/GTest/iOS未验，STEP119 PARTIAL。详见 docs/报告/STEP-119_Android真机Fast首次通过_阶段验收_v1.md。
|
||
|
||
- 2026-10-11 STEP-119 RCRR续验：原四段 `PARTIAL_RCRR` 在已锁 APK 真机80秒 R0缺tide(Build0/Reuse0)、R2/R3各Build1/Reuse536；FastDelta0/FullDelta596、24Gate mismatch0，安全Full回退。真机原Style Manifest证实tide索引2、clip索引31、weather实际在宽C内。新增窄C、宽C、错误动态R三种Test App RCRR_NO_TIDE对照入口和精确验证器；Style结构静态核对PASS、非Jest Python 4 tests PASS。新APK编译/实机、13项GTest、Metal/iOS和视觉仍未验证，STEP119保持PARTIAL。见docs/60_测试/STEP-119_RCRR多配置验收矩阵_v1.md及docs/报告/STEP-119_RCRR多场景局限性_阶段验收_v1.md。
|
||
|
||
- 2026-10-11 STEP-119 RCRR CPU效率测试准备：按用户新原则，C仅保留RasterParticleLayer，WeatherColor+海图进入R；新增RCR/RCRR/RCRRR的粒子独占C布局和同Style关闭缓存的Full CPU对照。加入进程CPU核秒/秒、近似CPUms/Native完成帧、实际FPS与Full-Fast-Full A-B-A比较器，保留原24Gate和所有历史负例；修复Test App菜单ID冲突。Python 12项非Jest测试PASS、ADB CLK_TCK=100预检；新APK编译/安装和CPU真实对比仍NOT VERIFIED，STEP119继续PARTIAL。见docs/60_测试/STEP-119_RCRR多配置验收矩阵_v2.md及docs/报告/STEP-119_粒子独占C与CPU效率_阶段验收_v1.md。
|
||
|
||
- 2026-10-11 STEP-119 RDC Android CPU真机续验：用户明确授权 Mac 编译，新 x86_64 APK commit=32ac795fc4abd04006673bf644f87a711329e78f SHA256=2bbd1cb4dc9e03ec56d8404363970e56f76b03819f6f2b50c8aee6dbb6fa43d2，Gradle成功、设备gzip+HTTP传输校验及pm安装成功、preflight SHA/ABI匹配。9次CPU基准中8次有效：Full中位60.67ms/帧、RCR两R中位3.50ms/帧、RCRR三R 7.04ms/帧、RCRRR四R 7.82ms/帧；正向全 Fast、Native末120帧119 Fast/0 Full、24Gate完整失配0。Full-Fast-Full控制漂移2.7%，RCRR相对Full估算CPU/帧降低88.4%。错误宽C Fast0/Full+339、Particle误入R Fast0/Full+322，皆安全拒绝。原采样器shell参数和日志环绕错误经RDC复盘纠正；仅证实固定相机CPU稳态，动态天气/Camera/Source/Tile/Annotation/Context刷新、图像同等、GPU能耗、GTest/Metal/iOS仍未通过。STEP119仍PARTIAL，正式报告docs/报告/STEP-119_RCRR粒子独占C_CPU真机验证_阶段报告_v2.md。
|
||
|
||
- 2026-10-12 v25 GSRL 发行记录准备：跳过 v24，Android/RN 13.6.1-particle.25、iOS 6.29.0-particle.25，同源构建提交 f32f6f45fd359007e8b3c77911b66d9e7fc93848。统一构建 exit0、六项制品 NAS 公网回读逐字节 PASS、SwiftPM 发布 PASS；新增 Source Lock 与使用说明，最终 Tag/Push/remote verify 须以后续 Pipeline 结果为准。iOS arm64 预编译未变化资源 Assets.car 的来源/Hash 已另文记录；v25 真机运行 NOT_TESTED，STEP-119 CPU 结果不冒充 v25 运行时验证。
|
||
|
||
- 2026-10-12 v25 正式发行 CLOSED / GSRL PASS：Build Source=f32f6f45fd359007e8b3c77911b66d9e7fc93848；统一 Build/Publish/Finalize 均 exit0，六项公网制品重复回读 SHA/size PASS，SwiftPM 6.29.0-particle.25 已发布；正式 Tag maplibre-particle/rn/13.6.1-particle.25 指向 3774d0a8418daa36d7a988b2ce9650a6a1178fc4，远端 particle/main 与 Tag 在 Finalize 后相同。Source Lock 路径 release/maplibre-particle/13.6.1-particle.25/SOURCE_LOCK.json。v25 正式包真机运行、RN Host 联调 NOT_TESTED；不借 STEP119 旧 APK 的 CPU 结果替代。
|
||
|
||
|
||
### 2026-10-12 STEP-119 SymbolRetained 生命周期修复续作
|
||
|
||
- 状态 IMPLEMENTED / WAITING_RDC_VALIDATION，接续此前中断四文件修改；Mac.lan particle/main@badb515d590fbdf221751b6677de3da0a5650d7e 保持不变。用户指定 GPT-6.1 Sol High（gpt-6.1-sol/high）；本轮工具无执行器元数据、当日 sessions 路径不存在，实际参数未能独立核验，不宣称日志核实，无模型升级/子代理。
|
||
- 读取 Astra 指导及当前规则/STEP119资料、现有 diff；沿用同源 owner/RenderTile 校验、整组 Bucket/Atlas 失配重建、稳定组刷新绑定与 Retained 强引用取证。证据保活 RenderTile/renderData/LayoutResult，不把 owner 地址写入稳定字节；底层 Tile& 寿命仍独立，原24Gate/证书/缓存与原地内容 epoch 保持。
|
||
- 续作补 Retained 未知 Symbol 类型 fail-closed；修测试替身未覆盖 TileRenderData 查询导致基类 assert 的缺口，强化 Text/IconRGBA/IconSDF/Halo 连续 prepare 身份、组内类型失配及证书失效释放。SymbolRetainedLifetime 共13项测试源码，真实 GPU/Placement/完整 update 与资源释放仍待 RDC，不能声称实际测试 PASS。
|
||
- 四源码路径 git diff --check exit0；只做轻量静态检查，未 CMake/编译/语法编译/链接/GTest/Gradle/APK/ADB/安装/Jest，无 commit/push/远端操作。保护 STEP110/111 两份未跟踪任务书及 v25 Source Lock/制品/API/Integration。
|
||
- 新增 docs/50_Step记录/STEP-119_SymbolRetained生命周期修复_v1.md 与 docs/报告/STEP-119_SymbolRetained生命周期修复_Codex完成报告_v1.md（未覆盖旧版），报告含准确 RDC 命令、源码锁前置条件、FZ-G1 正负及动态生命周期/视觉/释放证据、风险与停止门槛；本记录仅末尾追加。立即交 RDC 独立验证，整体 STEP119 未关闭。
|
||
|
||
- 2026-10-13 v26 正式发行 CLOSED / GSRL PASS：Android/RN 13.6.1-particle.26、iOS Metal 6.29.0-particle.26，冻结实际构建源码 fce326a9009d3fc21eb91c5df362f0769163d07e；统一 Android 四 ABI/iOS arm64 真机 Metal/RN 包 Build exit0、Publish exit0、Finalize exit0。六项正式制品 NAS 原子发布及公网二次下载 SHA/size 6/6 PASS；Source Lock release/maplibre-particle/13.6.1-particle.26/SOURCE_LOCK.json，Tag maplibre-particle/rn/13.6.1-particle.26 指向 e3cd9eba3cd02149d431e0061b8d32192d876f78，远端 particle/main Finalize 后同 HEAD。V26 发行二进制 NavSea/FZ-G1 及 iOS 实机未测；STEP119 13 项 C++ GTest 因 Mac libuv 前置依赖未执行，未虚报功能/性能正式全通过。报告 docs/报告/V26_统一正式发行_GSRL_RDC完成报告_v1.md，独立验收 JSON=/tmp/maplibre_v26_independent_receipt_20261013.json。
|
||
|
||
### 2026-10-21 STEP-120 iOS 原始 Filter 无损接口调查（BLOCKED）
|
||
|
||
- Mac.lan / macOS 15.7.7 / x86_64，particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188，原 worktree 与子模块正常；预存未跟踪 STEP-120 任务书保留。用户指定 GPT-6.1 Sol High，当前未取得执行器实际模型/档位元数据，不宣称独立核实；未切模型或启动子代理。
|
||
- 完整读取当前规则、任务、V27 iOS 6.29.0-particle.27 发行记录及 Darwin/Core 源码。指定既有 JSON 桥接对字符串/键用无长度转换，会截断合法嵌入 NUL；反向整数转 double 也有精度风险。严格无损不能仅靠两个直接包装方法保证，未擅改辅助文件或缩小契约。
|
||
- 正常 removeLayer 后私有 pendingLayer 仍拥有有效 rawLayer，现有失效宏不能证明已拒绝 detach；已发出 Host 成员关系/Native 拒绝语义澄清，未答复不当授权。SDK 未建立另一套 Context/生命周期状态，也未修改任何源码；公共 API 尚未实现，D4-13 仍 BLOCKED。
|
||
- 新增 docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v1.md 与 docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md，含 all/第二属性/locale、一般等号、原为空安全样例及准确 RDC 单项构建命令。仅静态审查及空白/范围/保护检查，未编译、codegen、单测、设备、发布或 Git 写操作。先明确契约及范围再实现，由 RDC 独立验收；NavSea 为业务唯一主责。
|
||
|
||
### 2026-10-21 STEP-120 v2 iOS Filter 无损或拒绝接口实现
|
||
|
||
- 状态 IMPLEMENTED_WAITING_RDC_IOS_BUILD；Mac.lan / macOS 15.7.7 / x86_64，particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188 保持。用户指定 GPT-6.1 Sol High，工具无执行器实际参数独立证据；未切模型、启动子代理或其他实例。
|
||
- 按 v2 授权收敛 v1 阻塞，仅改 MLNVectorStyleLayer.h/.mm：公开带 NSError 的 rawStyleFilterJSONObjectWithError: 与 setRawStyleFilterJSONObject:error:，五类错误区分 Unsupported、InvalidLayer、WrongThread、已核实恢复和无法核实恢复。主线程只操作有效 rawLayer，正常 pending/detach 成员关系交 Host 校验，不建另一套 Context。
|
||
- 局部预检和独立 JSON 快照限制深度64、节点4096、字符串/键 UTF-8 合计256KiB，拒绝NUL、特殊数值/NSDecimalNumber、超出±(2^53-1)、未知/不可重放结构；只归一精确数值，保持布尔、数组、对象键和值。经真实桥接及 Core convert<Filter>/serialize、实际 Expression 比较后才能读出或写入，不走 NSPredicate/NSExpression、不改共享转换器。
|
||
- setter 先证明新旧 Filter 可重放并复核 Layer 身份，再写入；后验不符/异常恢复原 Filter 并独立核实，无法核实要求 Host 废弃 Context。NSNull 精确还原 Filter()；不改变 Paint/Layout/Source/层序，原 predicate/description 字节保持。受限 legacy、隐式断言/常量折叠/省略collator默认项等拒绝边界已写 API Doc 和报告。
|
||
- 新增 v2 Step 和 docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md，保留 v1 与任务书，提供等值、两属性范围、locale、NUL拒绝和空Filter样例、真实 RDC 单项 Bazel 命令。仅静态源码、空白及保护检查，未语法编译、Bazel/Xcode/Gradle/codegen/Native单测/Jest、设备或发行；没有 stage/commit/push/tag 或分支/worktree 改动。RDC 编译/链接/运行及 ABI/Host 验收待执行，NavSea 原业务总目标仍开放。
|
||
|
||
## 2026-10-21 — STEP-121 V28 统一 GSRL 正式发行 CLOSED / PASS
|
||
|
||
- STEP-120 iOS 原 Style Filter 无损或拒绝 Native API 代码已由本仓 Codex GPT-6.1 Sol High 完成并通过 Mac RDC iOS Metal opt 编译，源码提交 1aba9875f07d8e609eb5bf42810a4d8f40d15d3f。
|
||
- GSRL Prepare 冻结源码 4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8；Build Android OpenGL 四 ABI/Maven Local、RN tgz 和 iOS Metal XCFramework PASS；Publish NAS 原子发布和六项公网文件逐字节 SHA256 回读 PASS；SwiftPM .28 Tag PASS；Finalize PASS。
|
||
- 版本 Android/RN 13.6.1-particle.28，iOS 6.29.0-particle.28，正式发行 Tag maplibre-particle/rn/13.6.1-particle.28，最终提交 e48258434e5b9ee40ab1d414c223a4ed809be879，origin 推送完成。README/SOURCE_LOCK 和 Release Manifest 已锁定，旧 .27 不覆盖。
|
||
- 中文 Step docs/50_Step记录/STEP-121_V28统一正式发行_v1.md、RDC 报告 docs/报告/STEP-121_V28统一正式发行_RDC完成报告_v1.md。真机与 NavSea Host/Mapping 四档运行验收尚未完成；下一唯一 Owner 是 NavSea，负责 .28 SDK 接收、MLRN iOS Bridge 与双平台 App 构建。
|