docs: record V28 GSRL release verification

bazel/core.bzl

@@ -675,6 +675,9 @@ MLN_CORE_SOURCE = [
 })
 
 MLN_CORE_HEADERS = [
+    "src/mln/renderer/symbol_render_inputs.hpp",
+    "src/mln/renderer/symbol_render_result.hpp",
+    "src/mln/renderer/symbol_shader_provenance.hpp",
     "include/mln/particle/field/field_data_adapter.hpp",
     "include/mln/particle/field/field_profile_contract.hpp",
     "include/mln/particle/field/field_profile_validator.hpp",

docs/20_调查/R0_Placement跨段归因与缓存安全边界调查_v1.md

@@ -0,0 +1,116 @@
+# R0 Placement 跨段归因与缓存安全边界调查 v1
+
+**STEP-110，2026-10-10；状态：PARTIAL（只读调查，非修复验收）。**
+
+**执行记录**：Codex CLI 0.161.0 实际会话模型 gpt-6-astra，推理 high，完成源码和历史证据审查；其报告写入阶段重复无响应，故本报告由 GPT 指挥 RDC 根据 Codex 调查结论独立回读关键源码后落盘。未运行测试、编译、ADB，也未修改业务实现。所有源码行号以调查起点 particle/main 2df504c 为准。
+
+## 1. 发行源码核对
+
+| 来源 | Git 提交 | 实际意义 |
+|---|---|---|
+| V23 GSRL Source Lock | 87f3d1c59a52581fb8339f0ea7d106b9f4b94fef | RN / Android Native 13.6.1-particle.23 构建源码 |
+| V23 Tag 剥离后提交 | a0a4787b4379ab2819943d20ce05a7ae760a88c3 | 构建提交之后的发行资料提交；注释 Tag 对象本身是 3ce42184… |
+| 当前 particle/main 和 origin/particle/main 调查起点 | 2df504cdc0403bdad85d3f31f16fd54a8744abac | 包含后续 STEP-109 尚未发行的 FieldSnapshot 比较优化 |
+
+Codex 通过 Git Blob 对照确认：src/mln/renderer/render_orchestrator.cpp、renderer_impl.cpp、src/mln/text/placement.cpp、include/mln/renderer/render_segment.hpp、src/mln/renderer/retained_underlay_cache.cpp 和 particle_fast_path.hpp 在上述三个提交完全相同。此范围内 main 的分析适用于 V23；不能反推 STEP-109 优化已在 V23 APK 生效。
+
+NavSea 输入冻结事实：Android 13 FZG1-2 V23，R0 [0,31) RETAINED 含地名 Symbol，C1 后续 82 层 CONTINUOUS。15.24 秒期间 placementChanged=true、R0 placementGatePassed=false、build/reuse=0、fallback/invalidation=453、fastPathHit Δ0、fastPathMiss Δ452，CPU 约 99%。**快照只能证实 Gate 未通过，不能证实 C1 引发 R0 Symbol 实际位置变化。**
+
+## 2. Q1：Placement 产生、传播、状态语义
+
+1. src/mln/renderer/renderer.cpp:53-65：先尝试 tryRenderParticleFastFrame；未命中即创建 RenderTree、prepare、完整 render，再缓存 prepared tree。
+2. src/mln/renderer/render_orchestrator.cpp:737-749：逐个 RenderLayer.prepare，依据动态 needsPlacement() 构建 layersNeedPlacement。该集合与 R0 的结构性 placementCapable 不是一回事。
+3. 同文件 :758-773：反向遍历整个 RenderTree 的需要 Placement 的图层，CrossTileSymbolIndex.addLayer 汇聚 Tile/Symbol 变化。该过程是整图范围，不按 Segment 独立产生。
+4. 同文件 :775-810：在 Continuous 模式，placementChanged = !placementController.placementIsRecent(now, zoom, override)。为 true 才调用 Placement::create、placeLayers、setPlacement；否则 setPlacementStale。随后取全局 symbolFadeChange，调用 hasTransitions 控制 needsRepaint。它表示**本轮要重新 Placement**，不表示 R0 最终视觉结果必然不同；为 false 也不保证新旧 R0 内容相等。
+5. 同文件 :811-823：非 Continuous 模式还有每次非空 Symbol Layers 就重算的特殊路径，不应混同天气播放运行态。
+6. 同文件 :840-848：全局 Placement、layersNeedPlacement、symbolBucketsChanged 进入 RenderTree。Renderer 再独立判断各 Retained Segment。
+
+src/mln/text/placement.cpp:45-59 CollisionGroups::get 在 crossSourceCollisions=false 时为不同 Source 创建隔离 collision group；开启时跨 Source Symbol 可以互相影响。**Source 不是 Segment**，同 Source 跨段仍存在相互影响，反之分段并不天然保证视觉隔离。
+
+src/mln/text/placement.cpp:688-748 根据新旧 placed icon/text 更新 opacity 与 fadeStartTime；:1282、:1319 提供 symbolFadeChange / hasTransitions。shaders/symbol_sdf.vertex.glsl:153-158 和 shaders/symbol_text_and_icon.vertex.glsl:153-158 表明 alpha 依赖 symbol fade uniform。即使符号几何未变，透明度也可能变化。symbolFadeChange、placementTransitionActive 是全局时间/过渡量，不是 R0 独立验收结果。
+
+Source layout/tile/visibility、Camera、Animation、Transition 均可能令 RenderTree prepare 或 Placement 状态变化；普通非 Symbol 粒子/颜色动画可以触发 repaint，但**不能单靠 repaint 来源判定 R0 新旧 placed 结果**。
+
+## 3. Q2：R0 Cache Gate 的真实数据流
+
+src/mln/renderer/renderer_impl.cpp:634-686 对每个 RETAINED Segment 分别取得：
+- retainedRangeContentFingerprint / layerContentChanged；
+- retainedSegmentSourceState 的 ready、stable、revision；
+- 组合的 segmentContentRevision；
+- retainedSegmentIsStable；
+- retainedRangeHasPlacementCapableLayer 结构性 placementCapable；
+- renderSegmentPlacementGatePassed 的结果。
+
+**确切 Gate**：include/mln/renderer/render_segment.hpp:85-90 规定：无 Placement 能力的段直接放行 Placement Gate；否则必须同时满足 placementChanged=false、symbolFadeChange=0、placementTransitionActive=false。它读取的后三者是全局状态，不读取“事件由 C1 发起”或 R0 实际视觉等价证明。
+
+src/mln/renderer/renderer_impl.cpp:661-686：Cache 支持还需要 Style/Sprite/global resources ready、Continuous 模式、没有 3D/debug、segmentStable、无 legacy/unsupported layer。Gate 失败可选择 static-placement 并传递给 cache.evaluate；:681-692 只有 Build/Reuse 才申请资源。:998-1028 先判断 global-live fallback，否则以 visitRenderSegmentExecution 顺序执行每段 composite/live，保持层序；actualExecution=live 不是证明 R0 Symbol 真变化，只表示本帧未从缓存 Composite。
+
+src/mln/renderer/renderer_impl.cpp:590-630 还保留聚合的 retainedPlacementStable 和 Fast Path 支持判定，说明每段 Gate 局部化**不等于**整个 Fast Path 可局部化。
+
+src/mln/renderer/retained_underlay_cache.cpp:85-105 将 camera/boundary、topology、content、tile、static-transition、static-placement 分别归类；:359-379 的 invalidate 更新 lastInvalidationReason，releaseResources 释放缓存，没有“每帧清零历史原因”的语义。因此早期快照当前 placementChanged=false 同时保留 lastInvalidationReason=static-placement **不是直接矛盾证据**；必须在同一帧比较 Gate、cacheSupported、decision、lastReason 的采样时序。
+
+STEP-102/STEP-106 的作用边界是 **placement-free Retained 的局部复用**。本机原始 Android 保存日志 artifacts/maplibre-particle/step106-t2-fix/runtime-T2/stream.log 末尾 tick130：placementChanged=true、crossSourceCollisions=true，但两个 placementCapable=false 的 Retained 段显示 actual=composite、decision=reuse、build=1、reuse=3878；内部 Annotation Symbol 被放入后续 Continuous。T1 的 Symbol-bearing Retained 未解除保守回退。**历史验收未证明含地名 Symbol 的 R0 可复用。**
+
+## 4. Q3：七种反事实场景
+
+| 场景 | Placement 事件来源能否定位 | R0 视觉是否可独立证明不变 | Reuse 必要安全条件 | V23 结论 |
+|---|---|---|---|---|
+| 1 R0 地名静态，C1 只更新非 Symbol 粒子/颜色 | 可按 Layer/Repaint 来源条件性追踪，Placement Controller 仍是全局 | 不能凭 C1 非 Symbol 就证明 | R0 Tile/layout/content/Camera、全部 Symbol placed/opacity/fade 与缓存时等价，无其他全局影响 | 无充分逐段证明；fail-closed |
+| 2 C1 Symbol 改动，不同 Source、crossSourceCollisions 关闭 | Source mutation 可区分 | 隔离碰撞降低风险，但仍不能独立证明 R0 Fade/Camera/其他 Source 状态不变 | 确认 Source 独立、Collision group 隔离、R0 自身配置、Tile、Fade 和层序均稳定 | 仅全局 Gate；fail-closed |
+| 3 C1 Symbol 改动且跨源碰撞开启 | 可以部分追踪事件 Source | **不能**；跨 Source Symbol 可能排斥 R0 地名 | 比较新旧全局 Collision 后 R0 每个文本/图标位置、显隐、Opacity、层序 | 无独立证明；fail-closed |
+| 4 R0 Symbol layout/tile/visibility/zoom 改动 | 局部 revision/fingerprint 可见 | 默认不能 | 重新 Placement / Build 缓存后验证 R0 版本和绘制结果 | 失效正确；fail-closed |
+| 5 Camera pan/zoom/rotation/pitch 改动 | Camera/signature/matrix 可识别 | 旧屏幕纹理通常不等价 | 新 Camera、projection、viewport 对应重新构建缓存并核对碰撞 | Camera/Boundary Gate；fail-closed |
+| 6 Fade/Placement Transition 活跃或刚结束 | Controller 可观察过渡 | 不能由几何稳定推出 opacity 稳定 | 所有 R0 Symbol opacity/fade、Transition 与缓存时等价，且状态稳定 | 只有全局 Fade/Transition Gate；fail-closed |
+| 7 C1 自动插入 Annotation Symbol | 验证场景的 Annotation layer 可追踪；NavSea 实际归段需运行证据 | 不能：跨段 Annotation 可能参与全局 Collision | 明确真实层序、Source/collision 关系，证明 R0 新旧 placed/fade 等价 | STEP-106 只覆盖 placement-free 段；fail-closed |
+
+重点：不同 Segment **不是** Collision 独立证据。仅识别“谁引起 Placement”并不足以让 R0 安全 Reuse；必须满足实际视觉、相机、图层顺序以及已缓存纹理的等价性。
+
+## 5. Q4：Fast Path 的其他独立必要 Gate
+
+Renderer 的 Fast Path 在完整 RenderTree 之前尝试。src/mln/renderer/renderer_impl.cpp:590-630 的 Retained eligibility/单 C 支持是前置条件；src/mln/renderer/particle_fast_path.hpp 的 Fast Path 判定还检查 boundary、topology、staticStable、hasPlacementTransition、pending changes、nonparticle transition/repaint、fading tiles、是否 Particle repaint、still image、continuous mode、debug、unsupported continuous layer、supported scene、annotation mutation 等。
+
+因此**R0 cache 有效是相关 Fast Path 的必要条件之一，绝不是充分条件**。当前 cache-invalid 说明首先在此受阻，不允许宣称修好 R0 就一定 hit，也不能在本 STEP 扩大调查到 C1 82 层所有性能开销或实施多 Continuous 优化。
+
+## 6. 数据流 / 状态流
+
+Host 更新 / Style / Source / Camera / 动画
+→ Renderer::update 尝试 Fast Path（未命中时）
+→ RenderOrchestrator.createRenderTree
+→ 全局 layer.prepare / needsPlacement / CrossTileIndex / PlacementController
+→ 全局 placementChanged / symbolFadeChange / hasTransitions
+→ 对各 Retained 段独立：Source ready/stable/revision + Fingerprint + structural placementCapable
+→ placement-free 段绕开全局 Placement Gate；Symbol-bearing 段使用全局三项严格 Gate
+→ Style/Resource/Camera/Revision 安全校验
+→ Cache Build / Reuse / Fallback
+→ 保序 RenderSegment Composite / Live
+→ Fast Path 另有单 C、pending、unsupported continuous 等 Gate。
+
+## 7. 确定事实、假设、证据不足
+
+| 确定事实 | 不能直接断言的假设 | 需要补的证据 |
+|---|---|---|
+| V23 核心 Placement/Cache 逻辑与当前 main 等价 | C1 变化直接导致 R0 视觉改变 | NavSea 同一帧事件来源、各 Source mutation、R0 全 Symbol 新旧结果 |
+| placementChanged 是全局计算触发量 | placementChanged=true 意味 R0 所有地名改变 | per-R0 placed/opacity/fade 结果签名 |
+| 含 Symbol 的 R0 使用 global conservative Gate | R0 453 次 fallback 是已证的性能 Bug | 既有语义被违反的状态不变量；当前并无证据 |
+| T2 实验 placement-free 段重复复用 | 现有 T2 足以支持含 Symbol R0 | NavSea 实际 Source/Annotation/跨源碰撞和真实设备对照 |
+| STEP-109 main 更改没有改 Gate | V23 已有 STEP-109 修复 | 需下一正式发行 GSRL 和设备验收（本 Step 禁止） |
+
+## 8. 必选结论矩阵
+
+| 维度 | 明确判定 |
+|---|---|
+| Placement 事件来源能否定位 | **条件性可区分**（Source/Layer 可追踪，global Placement 本身不标 per-Segment 责任） |
+| 能否证明 R0 视觉最终未变化 | **需扩展内部安全证据** |
+| 现有 Gate 性质 | **正确的设计保守限制**，不是已证明违反 STEP-102 语义的 Bug |
+| 缓存失效主要责任 | **多因素**：Native Placement 缺少 per-R0 结果证据 + Native 全局 Gate，受 Collision 语义和 Host Style/Annotation 组合影响 |
+| 下一步 | **Native 内部诊断补强 → 安全判据设计 → 另行授权真机对照**；若改公共接口/Host，则交 Integration 协商 |
+
+## 9. 依赖顺序与最小后续验证
+
+1. 在不影响生产安全和公开 API 的前提下，记录 placement 重算触发原因与时间，拆分 Source/Layer/Camera/Tile/transition 事件；
+2. 设计 per-R0 Placement **结果等价安全证据**，至少包含 R0 Symbol placed IDs、位置、可见性、text/icon opacity/fade、Collision group、Tile/glyph/source 版本、Camera 和合成顺序；先审查其不变量；
+3. 只有确证 R0 不受 C1 影响时，才另立有边界的 Native Gate 优化任务；不能先去掉 placementChanged；
+4. 再调查 Fast Path 单 C / unsupported / pending 等 Gate；进行等条件 V23 与后续版本 CPU/Frame/Visual A-B；
+5. 如需要 NavSea 配合改 Style/Annotation 或改公共 Contract/API，形成 Integration 阻塞请求，不在 STEP-110 擅自实施。
+
+**调查状态：PARTIAL。** 已完成静态因果审计、源码版本对照和 STEP-106 历史证据核对；缺少生产 R0 per-Symbol 等价、事件逐帧对应和 CPU 因果实测。这是安全证据边界，不是“R0 已修好”“缓存已命中”“CPU 已下降”。

docs/20_调查/STEP-111_R段Placement结果等价与独立刷新可行性调查_v1.md

@@ -0,0 +1,56 @@
+# STEP-111：R 段 Placement 结果等价与独立刷新可行性调查 v1
+
+**日期：2026-10-10｜状态：PARTIAL（初步可行性判断，不是 Codex 完整设计或运行验收）**
+
+## 1. 范围及真实证据
+- Mac `/Users/tei/dev/MapLibreParticleLab`，`particle/main`；调查时 HEAD `7ec9ac8c1635c7a3b607abc2ed4be4fd764e7b6d`。Integration `main` 与 `origin/main` 一致于 `80667d6c343411d03a760425438e3d292f452118`。
+- 使用可见 GNU Screen `7445.codex`，真实界面显示 **GPT-6 Astra high**；Codex 进行两轮源码浏览/调查后长期无新事件，第二轮缩窄至直接写报告仍无输出，随后终止会话；未生成任何要求的 STEP-111 正式调查文档。此文件由 GPT/RDC 对当下代码和既有 STEP-110 证据重新核对后撰写，**不冒称 Codex 已完成 STEP-111**。
+- 未改 C++/Swift/Kotlin/JS/测试代码，未编译、未测试、未跑设备；本文件是方案评估，不是新增 Native 功能。
+
+## 2. 现有实现的确定事实（RDC 逐行核验）
+1. `src/mln/renderer/render_orchestrator.cpp:775-810`：Continuous 渲染使用 `placementController.placementIsRecent` 得到全局 `placementChanged`，随后视情况新建 Placement、调用 `placeLayers(layersNeedPlacement)` 并更新 Controller；`symbolFadeChange` 和过渡也作为全局状态处理。这里的 `placementChanged` 表示重算触发，**不证明每一个 R 的最终输出改变**。
+2. `include/mln/renderer/render_segment.hpp:78-90`：R 中只要出现 `layerType == "symbol"` 就被标为 placementCapable；Gate 对这种 R 要求全局 `!placementChanged && symbolFadeChange==0 && !placementTransitionActive`。没有 per-R 最终 Symbol 结果比较。
+3. `src/mln/renderer/renderer_impl.cpp:638-686`：对每个 RETAINED 段已经独立计算内容 fingerprint、Source ready/stable/revision、segmentStable、placementCapable，并在 `cache->evaluate` 决定复用、构建或 fallback；`static-placement` 是 Gate 未通过时的失败原因。逐 R Cache 管理已存在，**缺的是含 Symbol 段的逐段结果等价证据**。
+4. STEP-110 已核对的 `src/mln/text/placement.cpp` CollisionGroups/opacity/fade 说明：Collision Domain 与 RenderSegment 边界不等价；跨 Source 碰撞开关、同 Source 跨段、text/icon Fade 等可能让别的段影响本段可见结果。STEP-102/106 仅能证明 placement-free 的安全复用，不直接证明含 Symbol R 的安全复用。
+
+## 3. 推荐的目标语义（待设计与实测）
+`R0-C0-R1-C1-R2-C2` 六段按图层顺序合成；若 R1 内 Symbol 的**最终绘制结果**与其上次成功 Build 的缓存版本等价，允许 R1 复用，而不因某个 R0/R2/C 段触发 global placementChanged 自动 Fallback。跨段碰撞真的改变 R1 Symbol 的显隐、锚点、位置、opacity 或其它绘制依赖时，R1 必须失效。
+
+**不等于**每个 R 拥有独立 Collision Index。第一阶段可以仍全图计算 Placement，之后对不同 R 的已完成结果分别判等，再控制各段纹理的 Build/Reuse；这只争取避免不必要的段重绘，不能自动省略全局 prepare/Placement、非 R 的 C 绘制或保证 Fast Path hit。
+
+### 待验证的候选签名（不是已实现结构）
+建议研究在 `placeLayers` 完毕之后、`renderer_impl.cpp:638-686` Cache 决定之前提供 `per-R PlacementResultRevision` 或严格结果比较，关联已缓存 Build 版本，而不只与上一帧比较。候选依赖包括：
+- 按层序可稳定归属到 R 的 text/icon 实例、Tile/Bucket/Source 世代与 placement/collision 可见性、锚点、偏移、实际绘制位置；
+- Fade/Opacity/Transition 的可绘制值或明确的“稳定可复用”条件；纹理/glyph/sprite/atlas 的有效世代；
+- Camera/projection/zoom/viewport/pixelRatio、Style 顺序与合成边界；这些可优先复用已有 Camera/Content/Resource Gate，不应盲目重复扫描；
+- 新旧结果缺失、ID 不稳定、资源生命周期不可证明、哈希碰撞或任意未知场景均 **fail-closed**。
+
+上述字段只是**候选调查清单**，现有代码尚未证明可以低开销取得稳定、完整的 per-R 视觉语义。简单“Symbol ID/位置没变”或单一 64-bit hash 相等都不足以证明最终像素安全等价。
+
+## 4. RCRCRC 反事实场景
+| 情况 | 希望达到的复用决策 | 当前证据边界 |
+|---|---|---|
+| C1 只有粒子/颜色更新，R0/R1/R2 视觉稳定 | R0/R1/R2 独立复用 | 当前 global Gate 可能挡住含 Symbol R；仍须取得最终结果不变证据 |
+| C1 Symbol 改变，仅使 R2 发生碰撞结果变化 | R2 重建；R0/R1 如证实未变可复用 | 事件来源不能替代逐 R 结果比较 |
+| C1 Symbol 改变，同时影响 R0 与 R1 | R0/R1 失效、不得复用旧遮挡 | 必须保留全局 Collision 正确性 |
+| R1 自身 Layer/Tile/Style 更改，R0/R2 不变 | R1 失效；其余分别判等 | 现有内容 revision 可局部区分，但 Symbol 仍有全局 Gate |
+| Camera/Zoom/Pitch、Annotation、Fade、Glyph 变化 | 受影响 R 失效；未知则全体安全回退 | 不得将各段等同独立碰撞域；须验证跨平台一致性 |
+
+## 5. 难度分级（GPT/RDC 初估，尚未经 Codex 最终复核）
+| 阶段 | 复杂度 1–5 | 输出与主要难点 |
+|---|---:|---|
+| A：只读设计 + 逐 R trace/reason | 2–3 | 诊断 event 来源与 per-R Cache 状态，不改变业务 |
+| B：Native per-R result fingerprint 的 shadow compare | 3 | 找齐最终 Placement 数据、稳定身份/世代、控制逐帧遍历成本；**只记录，不参与复用** |
+| C：用已验证等价结果替换含 Symbol R 的 global-only Gate | 4 | 与 Cache 生命周期/资源/层序/Fade 联动，必须零 false-reuse；Android OpenGL、iOS Metal 对照 |
+| D：真正把全图 Placement/Collision 改成分段增量计算 | 5 | 全局碰撞依赖与跨 Tile/Source 的更新传播，风险明显更高、不能简单按 R 切分 |
+
+工程周期目前**无法从静态代码得到可信承诺**。复杂度 3 表示可做有限验证原型；4 代表需多阶段视觉/性能门槛；5 代表核心架构重构，不能与缓存命中优化混为一谈。
+
+## 6. 后续建议及未完成项
+1. 下一次正式任务先补只读源码数据所有权审计：Placement 完成后在哪个对象/时间点能列出每 R 所属 symbol 的最终 placed/opacity，并确定 crossTileID、tile/glyph 资源失效契约。输出字段级“已有/缺失/必须新增”清单。
+2. 再授权仅做 **shadow-mode** 内部诊断：per-R `resultComparable/resultChanged/unknown` 与 global Gate 同步采样，**不改变 Gate**；采样成本与候选数量需量化，防止 O(N) 比较本身抵消收益。
+3. 真实 RCRCRC（每个 R 含 Symbol）覆盖同 Source/跨 Source 碰撞开关、Annotation、Fade、Camera、Tile、Layer 顺序及前后多帧；全缓存 ON/OFF 视觉一致，**false reuse 必须为零**。
+4. 通过后才另行授权 C 阶段优化，先看独立 R build/reuse/fallback 与 CPU/帧变化；Fast Path 对单 C、pending、non-particle repaint 等另有门槛，不作为此优化的当然收益。
+5. 若出现跨平台公共语义/公共接口改变，回 Integration RFC/ADR 处理；本阶段不得更改现有 API/Contract。
+
+**未完成：** Codex 未形成字段级可行性结论；无 per-R Placement 结果签名、运行对照、性能证据或真实 Native 修复。不可标“调查 PASS”或“独立刷新已实现”。

docs/20_调查/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_v1.md

@@ -0,0 +1,426 @@
+# STEP-112 V23 粒子 Full Render 循环与 Symbol 缓存准入全面源码调查 v1
+
+日期：2026-10-11（JST）。状态：本轮只读调查与文档交付完成；综合判定 **PARTIAL（现场逐帧归因及安全修复仍未验证）**。核心结论、证据等级和剩余事项见第11章。
+
+## 1. 调查基线与证据规则
+
+- 当前机器：Mac.lan，Darwin 24.6.0，x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 分支 `particle/main`，起点 HEAD `41b416c261fa72bd21171328045036a124694f47`。
+- 实际模型 `gpt-6-astra`、推理 `high`：当前会话 `01a12686-49ee-70b1-953e-f95f8a4bd9ca` 的本地 rollout `turn_context.model/effort` 已核对。任务书建议模型由用户本轮明确要求覆盖。
+- 起点只有 STEP-110、STEP-111 两份任务书未跟踪，无 tracked diff；不改动它们。子模块状态均为空格前缀，无未初始化/偏移标记。
+- Integration `main=80667d6c` 使用用户提供的 RDC 核验事实，不重新同步或修改跨项目文件。
+- 已按顺序读取 AGENTS、PARTICLE_BASELINE、8 份项目规范、总则 README 与四份现行总则、STEP-112、STEP-102/106/109/110/111 的相关任务/记录/报告。初始化基线及现行路线 v2 中旧版本坐标不冒充当前 V23；后续按 Git 实际源码比对。
+- 证据分为 **源码证明**（指定基线静态控制流）、**FZG1 实测**（本任务引用历史现场输入，非本轮重测）、**条件推断**（前提明确的推演）、**仍需设备验证**（频率、真实配置、像素/性能）。
+- 只允许写本主报告、STEP-112 阶段记录、完成报告、开发记录追加。禁止源码/测试/Style/脚本/跨项目写入，禁止编译测试、设备操作、Git 提交推送及分支/worktree 变更。
+
+## 2. 已核实的入口事实
+
+**源码证明**：`src/mln/renderer/renderer.cpp:45-64` 先同步 retained 状态，再尝试 Fast；失败才清除旧 prepared tree、`createRenderTree`、`prepare`、Full render、保存新 prepared tree。Fast 失败与粒子请求下一帧属于不同决策。
+
+**源码证明**：`src/mln/renderer/particle_fast_path.hpp:99-126` 顺序短路。`cache-invalid` 在第 3 项返回，后续 revision、camera、staticStable、placement、pending、非粒子 repaint、C 层支持、scene 等条件没有因此得到通过证明。
+
+## 3. 核心发现：Symbol R 首次 Build 的控制流矛盾
+
+**源码证明（正常 Continuous Full 路径）**：含结构性 Symbol 的 R 没有通过当前逐段 Placement Gate 的窗口。这比“Fade 的 `==0` 可能太严格”更强，且不依赖 Source 变化或实际 Symbol 是否移动。
+
+1. `src/mln/renderer/render_orchestrator.cpp:792-807`：`placementChanged=true` 时执行 Placement；否则无条件 `setPlacementStale()`。
+2. `src/mln/text/placement.cpp:160-175`：旧 Placement 禁用 transitions 时 `placementIsRecent()` 必为 false，故必进入 changed=true 分支；若进入 changed=false 分支，旧 Placement 必启用 transitions，随后 stale=true，使 Controller `hasTransitions()` 必为 true。
+3. `src/mln/renderer/renderer_impl.cpp:593-594,655-659` 读取同一 Controller 的 transition；`include/mln/renderer/render_segment.hpp:85-90` 要求 `!changed && fade==0 && !transition`。
+4. 因而 changed=true 被第一项挡住；changed=false 被 stale→transition=true 挡住。对结构性 Symbol R，两个分支均 false。`RenderTreeImpl::prepare`（`render_orchestrator.cpp:133-138`）仅更新 buckets，不清 Controller stale；没有中间解除路径。
+
+此结论限定正常单线程 Renderer 调用链，不将任意人工注入/未来改动当作当前可达状态。隐藏/空 Symbol 仍按结构归为 capable（`render_segment.hpp:75-90`），所以也不能绕开这层保护。
+
+**源码证明**：原始 `Placement::symbolFadeChange` 是相对 commitTime 的归一化时间增量加 zoomAdjustment，而非“本帧是否改变”布尔量（`placement.cpp:1282-1289`）；transitions 关闭或 duration≤0 返回 **1**。正常 Full 的 `prepare()` 不改写它。只有已通过 Fast 的 `prepareParticleFastFrame()` 才把 RenderTree 字段设为 0（`render_tree.hpp:105-109`），不能反过来帮助首次 Build。
+
+**FZG1 实测（任务书输入）**：末态 true/0/false 与“transitions 开启、此次重新计算、静止 zoom、先前实际 Fade 已结束”的状态相容；与通常 transitions 关闭后的 true/1/false 不同。不能仅凭此末态推断每帧走默认 300ms 周期或 Host 确实关闭 transitions。
+
+**条件推断**：在 retained enabled、正常 Continuous Full、R2 含 Symbol 的前提下，逐帧 `segmentSupported=false` 可令 Build 始终为 0；`retained_underlay_cache.cpp:195-205,359-366` 即使此前没有有效纹理也每次记录 fallback/invalidation。故 1787 次 invalidation 不表示曾成功建成 1787 份纹理。
+
+以下第4—10章已补齐调度、全部 Gate、状态机、时间表、反事实和提案；运行时无新增证明，不能据此声称修复 PASS。
+
+## 4. 版本核验与 A：调度、Full、GPU 和 Idle
+
+### 4.1 当前 main 与发行 V23
+
+**源码证明**：执行只读 `git diff --name-only 87f3d1c59a52581fb8339f0ea7d106b9f4b94fef HEAD -- <相关路径>`，在 renderer/text/map、RasterArraySource、render_segment、TransitionOptions、Android WeatherRuntime/frontend、iOS FieldRuntime、GL/Metal shader 范围内，仅两份文件不同：`render_particle_validation_layer.cpp` 和 `render_weather_color_layer.cpp`。逐 hunk 核对为 STEP-109 的 immutable snapshot 身份快比较，未改变本调查的调度、Placement、Cache、Fast Gate。以下行号一律对应本轮 HEAD，不照搬 V23 两份 Layer 的旧行号。
+
+V23 Source Lock 为 `87f3d1c…`（既有 STEP-110/108 发行证据），Android/RN `13.6.1-particle.23`、iOS `6.29.0-particle.23`。当前 main 包含尚无实机性能验收的 STEP-109；不得称它已在 V23 APK 生效。本轮没有重新下载制品或核对设备内 binary。
+
+### 4.2 可核查调用图
+
+下图箭头“条件”都不是每次必然发生。路径简称只用于图；实际位置见后表。
+
+```mermaid
+flowchart TD
+  H[Host 数据/Style/Camera 更新] --> U[Map::Impl::onUpdate]
+  W[WeatherRuntime 定时唤醒：条件成立] --> T[Map::triggerRepaint]
+  T --> U
+  U --> F[RendererFrontend update / 平台 requestRender]
+  F --> R[Renderer::render]
+  R --> G[tryRenderParticleFastFrame：24 项 Gate]
+  G -->|通过| Q[复用 prepared tree / 更新粒子 / GPU render]
+  G -->|失败| C[createRenderTree / Layer prepare / 全局 Placement 判定]
+  C --> P[RenderTree prepare / bucket opacity 与动态属性]
+  P --> B[各 R evaluate：Build / Reuse / Fallback]
+  B --> D[离屏 Build 或保序 composite/live / GPU 粒子]
+  D --> O[onDidFinishRenderingFrame]
+  Q --> O
+  O -->|needsRepaint 或 camera transition| U
+  O -->|loaded 且无需 repaint/transition| IDLE[onDidBecomeIdle]
+```
+
+| 环节及证据强度 | 文件、函数、行号与条件 |
+|---|---|
+| **源码证明**：粒子是否活动 | `src/mln/renderer/layers/render_particle_validation_layer.cpp:1112-1127`，`isParticleAnimationActive` 检查 active、正式 Source 的 T0/T1、visibility；`needsRepaint` 再检查 V4 cadence 或旧 timeline。active=false、无双端点、visibility=None 不请求粒子 repaint。它不含“必须 Full”标志。单帧输入可投影成可用双端点，不能以业务仅一帧推断无数据。|
+| **源码证明**：粒子暂停和预报暂停不同 | 同上；`RasterArraySource::tickForecastClock`，`src/mln/style/sources/raster_array_source.cpp:487-510` 在 forecast 非 Playing 时不推进预报；这不把粒子 active 设 false。风场时间冻结仍可流动。无向量或语义不匹配另由 Layer `update:1247-1258` 拒绝 GPU 更新。|
+| **源码证明**：Core cadence | `raster_array_source.cpp:149-175,208-227,260-281,1237-1255`；非 AUTO 以 `1/fps` 检查，30 对应约 33.33ms；consume 才推进 cadence revision。AUTO 每次可 due，不等于固定 30。|
+| **源码证明**：Android SDK 唤醒 | `platform/android/MapLibreAndroid/src/main/java/org/maplibre/android/maps/WeatherRuntime.java:228-234,250-269`；有效可见粒子且非 AUTO，或 V4 forecast Playing 且已提交字段时，Handler 每次安排 34ms（60 为 17ms），调用 `map.triggerRepaint()`；disabled/disposed 停止，隐藏粒子但 forecast Playing 仍可唤醒。这里是 SDK Java 调度，不是 NavSea JS 每粒子循环。|
+| **源码证明**：iOS 对应唤醒 | `platform/ios/src/MLNParticleFieldRuntime.mm:173-193`；一次性 NSTimer 0.034/0.017s，触发 `triggerRepaint` 后重新调度。两端意图相同，调度抖动不保证相同。|
+| **源码证明**：进入地图更新 | `src/mln/map/map.cpp:93-95` 调 `Impl::onUpdate`；`src/mln/map/map_impl.cpp:108-153` tick forecast、更新 camera transition、装配 UpdateParameters、调用 frontend.update。非 Continuous 且无 still request 直接返回。|
+| **源码证明**：Android 跨线程链 | `android_renderer_frontend.cpp:118-133,149-152`（路径前缀 `platform/android/MapLibreAndroid/src/cpp/`）AsyncTask 保存最新 params，再 `MapRenderer.update/requestRender`；`map_renderer.cpp:127-149,153-157,221-247` 请求 Java 渲染、后端 scope 中调用 `Renderer::render`。多个 update 可能合并为一次实际 render。|
+| **源码证明**：iOS frontend | `platform/darwin/src/MLNRendererFrontend.h:28-54` 保存 params、setNeedsRerender，backend scope 中 render；不同于强制 Full 命令。|
+| **源码证明**：Fast/Full 分岔 | `src/mln/renderer/renderer.cpp:45-64`；Fast 成功直接 return；否则 create/prepare/render/commit tree。`renderer_impl.cpp:324-327` 只在 `!particleFastFrame` 增加 Full CPU 计数。`FullRendererFrame` 在 :323 两种路径都会计数，名称不能混用。|
+| **源码证明**：Full repaint 汇总 | `render_orchestrator.cpp:775-823,1107-1128`；light、Layer transition/repaint、Controller transition/stale、fading tiles 的 OR；Continuous 时赋 `RenderTreeParameters.needsRepaint`。|
+| **源码证明**：通知与 Idle | `renderer_impl.cpp:1070-1074` → Android forwarding `android_renderer_frontend.cpp:38-44` → `map_impl.cpp:259-288`；needsRepaint 或 transform transition 时 onUpdate，否则 loaded 时通知 Idle。Observer 的 RenderMode::Full 表示 loaded，不表示执行 Full CPU 路径。|
+| **源码证明**：GPU 推进 | Layer `update:1271-1283,1994-2055`；未到 cadence 可只重组 composite，不推进 state/trail；到期才准备 State/Trail pass。`renderer_impl.cpp:807-810,968-980,1047-1053` 执行 render targets 和 present。一次 repaint、一次 Full CPU、一次 simulation advance、一次成功呈现不是同一计数。|
+
+**仍需设备验证**：FZG1 约 30FPS 的真正限速因素是 targetFps=30、平台帧率限制、耗时瓶颈或组合，任务快照不能区分。源码支持“Core 33.33ms 阈值 + SDK 34ms 唤醒”的候选机制，不能把 34ms 直接换算为实测 1792 次 Full 的唯一原因。
+
+**源码证明**：所追踪的 PlacementController 仅在 render 链上比较时间，并无独立定时器调用强制 Full；stale/尚有 Fade 会通过 needsRepaint 延续正常地图帧。没有外部输入且粒子关、其它 transition 完成、资源 loaded 时可 Idle；WeatherRuntime 后续 wake 或 Tile 完成仍能再次唤醒，Idle 不是永久无任务保证。
+
+### 4.3 Full 与 Fast 工作比较
+
+| 工作 | Full | Fast | 证据 |
+|---|---|---|---|
+| diff Style/Source、prepare RenderLayer、CrossTile/Placement、新 RenderTree | 执行相应流程；不等于每帧都 placeLayers | 跳过，复用旧 tree | `renderer.cpp:53-61`；`render_orchestrator.cpp:445-539,737-848` |
+| Source/bucket/atlas upload | 遍历 | 跳过整批 | `renderer_impl.cpp:470-487` |
+| Layer update | 全部 render items | 仅 isParticleAnimationLayer | `renderer_impl.cpp:491-509`；`render_orchestrator.cpp:1458-1483` |
+| tweaker/upload/postRender | 全范围 | 单 C 范围；render targets 仍处理 | `renderer_impl.cpp:707-749,1031-1040` |
+| R GPU | 可 Build、Reuse composite 或 Live | 正常命中应复用；仍进入 cache evaluate/render | `renderer_impl.cpp:637-692,813-862,972-1028` |
+| C GPU、State/Trail、最终 framebuffer/present | 执行 | 仍执行 | 同上及 :1047-1053 |
+
+Fast 不是零 CPU 或零 GPU；Full 不是所有 R 从零重画。PREFIX 中 R0/R3 已复用而 Full CPU 仍增长，正与此结构相符。
+
+## 5. B：Fast 全 Gate 矩阵
+
+下面按 **实际首错顺序**列出全部 24 项。简称：`F=src/mln/renderer/particle_fast_path.hpp`；`I=src/mln/renderer/renderer_impl.cpp`；`O=src/mln/renderer/render_orchestrator.cpp`。表中“Tick”特指静态场、仅粒子 State/Trail 时间推进，不包括 forecast 播放导致新 Source impl；“Full恢复”是假定其它门槛已满足的一次新 Full 能否建立相应证据；FZG1 列区分输入实测与静态推断。
+
+| # / 条件与失败名（F 行） | 输入来源/通过条件 | Tick 本身改变？ | 一次新 Full 后可能恢复？ | FZG1 证据 |
+|---|---|---|---|---|
+| 1 prepared tree / no-prepared-tree (100) | I:247,290-302，tree 非空；reload/miss 清旧 :305-316 | 否 | 是，create 成功后保存 | **FZG1实测** cache-invalid 的那些判定已过此项 |
+| 2 retained enabled / retained-disabled (101) | I:207-208,248，runtime snapshot.enabled | 否 | 需控制面启用，Full 不自动开启 | **FZG1实测** 同上已通过 |
+| 3 所有 R valid / cache-invalid (102) | I:220-228,249，cache 容器与 plan 大小相同，每个 R cache 非空且 isValid | Tick 不改内容；Full Placement gate 可间接 invalidate | 无 Symbol 可建；当前含 Symbol 的 R 不可（第3章） | **FZG1实测** 首拒；R2 Build/Reuse=0 |
+| 4 Build/Static revision / revision-mismatch (103) | I:220-230,250，每 R buildRevision==observedStaticRevision，prepared aggregate static revision==tracker.current | 否；Full 稳定状态变化可推进 tracker | 通常可以，但缓存未建仍失败 | **未知**，被 #3 掩盖 |
+| 5 Content revision / content-mutation (104) | I:236-237,251，prepared 与 O 的 aggregate content revision 相等 | 固定场否；forecast/source 变化可改 | 是，Full 处理后 commit 新值，异步新变更再失效 | **未知**；有历史 Source Mutation 增量，无逐帧对应 |
+| 6 Viewport / viewport-changed (105) | I:214-216,253，Transform size 与 prepared 相等且 backend renderable size 未变 | 否 | resize 后重建可 | **未知**，静止场景不等于逐帧已核验 |
+| 7 Camera / camera-changed (106) | I:217,252，精确投影矩阵相等 | 否 | 新相机完成 Full 后可，持续交互继续失效 | **未知** |
+| 8 non-camera signature / update-parameters-changed (107) | I:151-196,218-219,254，完整签名相等，字段见下段 | timePoint 不入签名；forecast 可能更换 sources | 是，新 params 被 prepare/commit；源持续变则持续 miss | **未知** |
+| 9 Style loaded / style-not-loaded (108) | I:255，UpdateParameters.styleLoaded | 否 | 需真实加载完成 | **未知**（不能以段 ready 代替所有） |
+| 10 Boundary/RangeConfig / boundary-changed (109) | I:209-234,256，唯一 C 的 begin/end、configRevision 与 prepared 相等 | 否 | plan 有效时可；多 C 另被 #22 拦截 | **未知**，已知 PREFIX 数字来自现场 |
+| 11 Topology / topology-changed (110) | I:235,257，prepared topologyRevision==tracker.current；tracker I:542-563、cache.cpp:62-69 | 否 | Full 新拓扑和 cache 可重建 | **未知** |
+| 12 staticStable / static-unstable (111) | I:238-244,258；O:1156-1170，所有 R 稳定、无 light、R 动态 needsPlacement 时 Controller 无 transition、R 无 transition/repaint、**任一 Source** 无 fading tiles | 粒子不直接改 R；时间和 stale 可阻塞 | 取决于 Controller/资源，当前 Symbol 周期不保障恢复 | **条件推断** 部分帧会失败，实际序列未知 |
+| 13 Placement transition / placement-or-fade (112) | I:259-263；O:1281 → PlacementController::hasTransitions(now) 为 false；不读旧 tree 的 changed/fade 代替 | 仅时间推进可结束真实 Fade，但 stale 必须新 placement 清 | 稳定重算帧可清 stale；不重算会置 stale | **FZG1实测** 末态 false；不是所有 Fast 时刻都 false |
+| 14 Pending / pending-changes (113) | I:264；O:1285，pendingChanges.empty；O:1341-1344 入队、1486-1490 消费 | 正常粒子 changes 于 render 中生成/消费；非必然积压 | 通常可以，异步继续到来则不保证 | **未知** |
+| 15 non-particle transition / non-particle-transition (114) | I:265；O:1270-1273，无 light 或任意 Layer.hasTransition | 否；普通 Style transition 可活跃 | 等 transition 真结束再 Full | **未知** |
+| 16 non-particle repaint / non-particle-repaint (115) | I:266；O:1275-1278，非粒子 Layer 均不需 repaint | 固定 V4 场通常否；V3 WeatherColor 播放可 true（Layer :177-180） | 活跃动画不会因 Full 自行结束 | **未知** |
+| 17 fading tiles / fading-tiles (116) | I:267；O:1282-1284，所有 Source 无 fading tiles | 否 | fade 真结束且状态消费后可 | **未知**；与 #12 重复但诊断次序不同 |
+| 18 ParticleNeedsRepaint / no-particle-repaint (117) | I:268；O:1274，至少一个 renderable 且 isParticleAnimationActive；**这里不是 cadenceDue** | active 粒子满足；每次 advance 不取消 active | 数据就绪/显示后可；粒子关不能通过 | **条件推断** 风场活动大概率满足，未逐帧取证 |
+| 19 still image / still-image-request (118) | I:269，stillImageRequest=false | 否 | 请求消耗后可 | **未知** |
+| 20 MapMode / unsupported-mode (119) | I:270，Continuous | 否 | Static/Tile 不自动转换 | **条件推断** 现场连续地图符合，仍需记录 |
+| 21 Debug / debug-options (120) | I:271，NoDebug | 否 | 用户关闭后可 | **未知** |
+| 22 C 支持 / unsupported-continuous-layer (121-123) | I:272,624-627；O:1241-1250，有且仅一个 C、每层 startsRetainedDynamicRange、至少一个 particle | 否 | 固定含普通 Symbol/Line 的 C，多少次 Full 都不恢复 | **源码证明+现场布局前提** PREFIX C[13,33) 必失败 |
+| 23 scene / unsupported-scene (124) | I:273,619-630，preparedSceneSupported=true 且唯一 C；其内部含 loaded、无3D/debug、所有 R stable、aggregate Placement stable、无 legacy/custom、C 支持 | 否；Full 会重算并保存 false | 仅修 R2 局部 Gate 不够；需一致安全判据 | **条件推断** R 有活动 Symbol 或 C 普通层使其 false |
+| 24 Annotation / annotation-mutation (125) | I:202-205,274，AnnotationManager 无 pending changes（weak guard） | 否 | 正常更新消费后可；新 annotation 继续阻塞 | **未知**；不能把末尾 Symbol 存在等同 pending=true |
+
+#8 的逐字段完整范围（I:154-180,186-196）：pixelRatio、mode、debugOptions、styleLoaded、spriteLoaded、transformChanging、gestureInProgress；light/images/sources/layers/fontFaces/fileSource 对象身份；glyphURL；transition duration/delay/enablePlacementTransitions；prefetchZoomDelta、crossSourceCollisions、fastPFOREnabled；tileLodMinRadius/Scale/PitchThreshold/ZoomShift/Mode。viewport、camera 矩阵独立比较；timePoint 不在签名。**对象身份改变可触发 Full，即使负载内容相同；反过来单纯 triggerRepaint 且签名相同没有“必须 Full”语义。**
+
+所有输入在 I:246-275 装配，但 F:100-125 返回首错；现有记录 I:276-280 只有 candidate/reason。#3 的失败不能证明 #4—24 成功。修完 R2 仍会遇到 PREFIX 的 #22、prepared scene #23，以及真实资源/Source/Annotation 等独立门槛。
+
+### 5.1 第二重全局锁
+
+**源码证明**：Full 的 `retainedPlacementStable`（I:590-592）依据动态 `retainedRangeUsesPlacement`（O:1135-1141，即 needsPlacement），而逐 R gate 依据结构性 Symbol。活动 Symbol R 存在时：重算帧 aggregate placementStable=false；不重算帧 Controller stale=true，aggregate staticStable=false（O:1158）。二者分别让 `retainedSupported`（I:619-623）为 false，写入 `particlePreparedSceneSupported`（I:630）。这是独立于逐段 cache 的 **Fast scene 锁**，不是 main-buffer 的 global-live 判定；后者 I:998-1028 已不含 aggregate placement，允许无 Symbol R 继续 composite。
+
+假设以后仅让 R2 valid，旧 preparedSceneSupported=false 仍会在 #23 阻塞；不能等时间到就认为 prepared flag 自己恢复。Fast 的动态 transition 检查已避免直接沿用旧 tree changed/fade（I:259-263 注释），但没有解除 Full 产出的 scene 保守状态。隐藏 Symbol 可能使动态 usesPlacement=false、scene 不受它影响，结构性每段 gate 仍会拒绝首次 Build。
+
+## 6. C：R2 Build / Invalidate / Fallback 状态机
+
+### 6.1 从层结构到每段决策
+
+**源码证明**，按执行顺序：
+
+1. `include/mln/renderer/render_segment.hpp:48-90` 由 Style 元数据列举 Source 依赖与 Symbol 能力；type=symbol 就 capable，不看 visibility、当帧 bucket 或可见像素。越界 range 保守 capable；custom/custom-drawable 依赖 unknown。动态 `needsPlacement()` 则要求 CrossTileIndex::Required 且 placementData 非空（`src/mln/renderer/render_layer.cpp:30-32`），两者不等价。
+2. `render_orchestrator.cpp:1173-1202` 按段依赖查询 Source loaded/fading/revision，CustomMVTVector 暂无 revision contract 而 fail-closed；`retainedSegmentIsStable:1205-1216` 检查 light、相关 Placement transition 和本段 Layer transition/repaint，不再把无关 Source fade 当每段阻塞。对比 Fast 的 `retainedRangeIsStable:1156-1170` 仍检查所有 Source fade。
+3. `renderer_impl.cpp:516-535` 拓扑代际或 cache 数量变化时释放/重建每段 cache 容器；:558-559 的 key 为 viewport、begin/end、cameraMatrix。:641-652 组合 immutable layer impl+index fingerprint、source/global revision、pixelRatio。fingerprint 不是 Symbol 最终视觉签名。
+4. :653-666 将 segmentStable、结构性 placement gate、style/sprite/image ready、Continuous/no3D/noDebug/noLegacy/noCustom 合并为 segmentSupported。
+5. :668-680 首错优先级：source not ready → source unstable → style/sprite/global resource → placement → transition → legacy → unsupported → boundary → 3D → debug → mode。`static-placement` 是此处 gate 的名字，不是“R2 像素变了”的探测器，也不证明其它更后项通过。
+6. :681-691 调 evaluate；只有 Build/Reuse 才 prepareResources；失败改为 resource-or-compositor。所有 supported 条件通过仍不代表最终纹理已经绘制成功。
+
+### 6.2 状态转换和计数
+
+所有状态均据 `src/mln/renderer/retained_underlay_cache.cpp`；这是源码状态机，不是本轮运行截图。
+
+```mermaid
+stateDiagram-v2
+  [*] --> Invalid: 创建 / 资源释放
+  Invalid --> Fallback: supported=false
+  Ready --> Fallback: supported=false / invalidate
+  Fallback --> Fallback: 下帧仍不支持 / 再计 invalidation
+  Invalid --> BuildPending: enabled 且 key存在 且 supported
+  Fallback --> BuildPending: 准入恢复
+  Ready --> BuildPending: key或revision变化
+  BuildPending --> Ready: 资源准备 + 离屏绘制成功
+  BuildPending --> Fallback: resource或draw失败
+  Ready --> Reuse: valid 且 key/revision相同
+  Reuse --> Ready: 纹理保持有效
+  Ready --> Invalid: releaseResources
+```
+
+| 分支 | 行号及真实后果 |
+|---|---|
+| 无 key | :173-182，原来 valid/key 存在才 invalidate/release，返回 Disabled；与 R2 static-placement 不同 |
+| runtime disabled | :184-193，记 fallback；控制面同步 :129-163 另负责 invalidation/release |
+| supported=false | :195-205，**无条件** fallback++、invalidate；revisionChanged 才 release。即使 valid 本来 false，也再次 invalidation++。未走 first-frame 和 BuildPending 分支 |
+| revision 变化 | :171-172,207-213，invalidate/release、装新 key；这里 staticRevision 参数实际是每段 content 合成 revision，区别 aggregate tracker |
+| 初次无 key / key 改变 | :214-219，first-frame / viewport / camera-or-boundary；设 key。普通 key 变化未必释放同尺寸 GPU allocation，但 valid 失效 |
+| buildRevision 不一致 | :220-224，invalidate/release；不能复用旧代际 |
+| valid=true | :225-236，reuse++，返回 Reuse；不代表 main-buffer 必 composite，还要看全局 live gate |
+| invalid 且可支持 | :238-243，BuildPending，返回 Build；此时 buildCount 未增 |
+| GPU 资源 | :246-303，离屏 RGBA unsigned-byte texture（带 depth/stencil 参数）及 composite drawable；失败返回 false |
+| Build 真成功 | renderer_impl.cpp:813-862，beginBuild→R opaque/translucent→finishBuild→markBuildSucceeded；cache.cpp:332-345 设置 valid、buildRevision、build++、Ready |
+| Build 失败 | cache.cpp:347-356，fallback++、invalidate、release，reason=resource-or-compositor；需要该 reason/资源计数，不能从 Build=0 单独推断 GPU 坏了 |
+| invalidate / release | :359-380，前者 valid=false、记原因和计数；后者清 key/buildRevision/texture/compositor，不必增加同一种 invalidation 计数 |
+
+`lastInvalidationReason` 是最后一次记录，Reuse 或成功 Build 不在此函数中自动抹掉它；采样必须连同本帧 decision、gate、frameId 使用。`plan.valid=true` 也不等于 `cache.isValid=true`。
+
+### 6.3 FZG1 数字支持什么
+
+**FZG1 实测（任务书第二区，历史输入）**：PREFIX 约60秒，Full +1787，R0 reuse +1787，R2 build/reuse=0/0，fallback/invalidation≈1787，R3 reuse +1755，Fast=0，首拒 cache-invalid。
+
+**源码证明 + 条件推断**：每次 Full 的 R2 结构 capable → 第3章矛盾使 placement gate=false → supported=false → evaluate 直接 Fallback/invalidate → 正常 main-buffer live → 新 prepared tree 保存但 R2 invalid → 下一粒子帧 Fast #3 再失败。该闭环不需要假设 Source 每帧变化，也不需要假设 GPU 资源损坏。
+
+**仍需设备验证**：本轮没有60秒每帧原始 trace，不能把一次末态 static-placement 扩成每帧唯一首因；若某帧 Source not ready，:668-672 会先报 Source。提供的 build 是绝对值还是窗口增量、topology 重建是否清计数，也应在后续原始 diagnostics 中核对。若“Build=0”只表示窗口增量，不能排除窗口前构建过；当前源码正常含 Symbol Full 无准入窗口则给出更强的机制约束。
+
+Full 中 Symbol 正确显示，是 main buffer 的 live 绘制结果；cache Build 是单独离屏 render pass，:817 的 decision!=Build 会直接不画离屏纹理。没有自动把 main framebuffer 的 R2 像素拷贝成缓存的路径。R3 少于1787的32次复用差额可能来自资源/Source/全局条件，**没有足够逐帧证据归因**。
+
+### 6.4 Collision 与资源边界
+
+- **源码证明**：Placement::placeLayers 按完整 layer 列表逆序碰撞（`placement.cpp:201-206`）；CollisionGroups::get（:45-62）在 `crossSourceCollisions=false` 时才按 Source 隔离，开启时使用无过滤组。:46-48 的英文注释与实际 if 的开关文字不一致，本文依执行分支，不照抄注释。相同 Source 跨段仍同组；关闭跨源碰撞也不等于关闭段内碰撞。
+- **源码证明**：`Placement::commit:687-749` 内部同名局部变量 placementChanged 根据 text/icon placed 变化更新 fadeStartTime；外层 RenderTree.placementChanged 表示是否运行新计算。两个变量作用域和语义不同；全局 commit 也没有比较 R2 最终纹理。
+- **源码证明**：Source/Tile mutation 可按依赖映射每段，glyph/image/style/context 未能局部定位时推进 global epoch（`render_orchestrator.cpp:243-275,327-347,1519-1521,1555-1559,1582-1594`；`render_segment.hpp:114-133`）。Camera/viewport/pixelRatio/拓扑另有 key/revision 保护。Source ready 不等于每个 Symbol shader 输入稳定。
+- **条件推断**：别段符号或 Annotation 可能改变 R2 text/icon 可见性；同一位置/ID 也可能 opacity、variable anchor、orientation、line reprojection 改变。只有新一次完整 Placement 后证明最终有效输出及资源代际等价，才有候选复用条件。任何无法比较项必须 fail-closed。
+
+## 7. D：Placement/Fade 真语义与可达状态
+
+### 7.1 两个时钟、一个 stale 标记
+
+**源码证明**：TransitionOptions 默认 enablePlacementTransitions=true（`include/mln/style/transition_options.hpp:12-26`），默认 duration=300ms（`include/mln/util/constants.hpp:59`）。`Placement` 构造保存当次 options、commitTime、placementZoom（`placement.cpp:180-192`）。因此 UI 当前 option 与 Controller 中旧 Placement 的 option 在下一次新建前可能暂时不同，诊断必须同时记录。
+
+当 transitions 开启且 duration=D>0：
+
+- `symbolFadeChange(now) = (now - commitTime)/D + prevZoomAdjustment`（:1282-1289）；这是无 clamp 的增量，可能>1，零只说明刚 commit 且 zoomAdjustment 为零等特殊条件。
+- shader 使用 `clamp(baseOpacity ± symbolFadeChange,0,1)`，符号实际已终态时 uniform 仍能变化；Fade 终态不以 uniform==0 定义。
+- `Placement::hasTransitions` 用 **fadeStartTime** 而非 commitTime：`now-fadeStartTime < D`（:1319-1322）；commit 没有 text/icon placed 改变时继承旧 fadeStartTime（:748-749）。新计算与新的真实 Fade 不是同义词。
+- `placementIsRecent` 用 commitTime+updatePeriod>now（:160-167）；普通 period=`max(300ms,D)*(1-zoomAdjustment(currentZoom))`（:1307-1312）；zoomAdjustment=max(0,(oldZoom-newZoom)/1.5)（:1292-1298），zoom-out 可缩短到零甚至负值；此处没有下限 clamp。
+- 新 Symbol buckets 且非 tiltedView 才使用 30ms **periodOverride**（O:778-789），不是把 Fade duration 改成30ms，也不是所有 Source 变化都立即重算。
+- Controller `hasTransitions` 在 transitions 开启时 **stale 优先返回 true**（:170-175）。它含“需要重新评估”的语义，不能直接当作真实 opacity 正在变化的精确检测器。
+- delay 保存在 options/signature，但上述三个 Placement 时间公式没有读取 delay；不能将一般 Style paint transition 的 delay 机械套给 Symbol placement fade。
+
+### 7.2 transitions 开启的逐帧示意
+
+**条件推断（非 FZG1 实测时间线）**：固定 camera、无新 bucket、D=300ms、约33.33ms一帧，t0 首次 placement 后内容稳定。忽略调度抖动，t0+300ms 的边界实际取决于 Clock。
+
+| 时刻/情况 | RenderTree changed | fade increment | Controller transition | Symbol R gate | 解释 |
+|---|---:|---:|---:|---:|---|
+| t0 新可见 Symbol | true | 0（静止 zoom） | true，fadeStart=t0 | false | 真实淡入开始；base opacity 可能0 |
+| t0+33…267ms，不重算 | false | 约0.11…0.89 | **true，stale**（即使真实 Fade 早已结束也如此） | false | O:805-806 无条件 stale |
+| ≥t0+300ms，重新计算且显隐未变 | true | 重新归零 | false（旧 fadeStart 已到期、setPlacement 清 stale） | false | 可出现现场 true/0/false，但 changed 阻塞 |
+| 再下一帧，显隐仍未变 | false | >0 | true（重新置 stale） | false | 不是新像素变化的证据 |
+| 后续每到普通 period 重算 | true | 通常0 | 若无新显隐变化则false | false | 循环重复，未提供 Build 窗口 |
+| 新 bucket 触发30ms override | 到期时true | 新 commit 通常0 | 视 actual placed/Fade 而定 | false | 约30FPS时可能每次新增 bucket 帧均到期，需事件证据 |
+| zoom-out、period≤帧间隔 | 可每次true | prevZoomAdjustment≥0，可非0 | 取决于真实Fade | false | 不使用固定300ms频率推断 |
+
+### 7.3 transitions 关闭（及 duration=0 的区别）
+
+**源码证明**：已有 Placement.transitionsEnabled=false 后，`placementIsRecent` 总是 false（:163），所以**每次到达 Continuous Full 都新建并执行 placeLayers**，即便 layersNeedPlacement 为空也调用函数；Controller.hasTransitions=false（:171），`symbolFadeChange=1`（:1289）。因此正常关闭配置是 **true / 1 / false**，不是 true/0/false。这并不意味着有独立线程每帧强迫 Full：必须先有 render request 且 Fast 失败。
+
+若仅 duration=0 而 enablePlacementTransitions=true，recent 仍使用至少300ms（zoom/override 除外），fade=1；真实 Placement.hasTransitions 通常false，但 non-recompute Full 仍 stale=true。仍不能通过 Symbol gate。
+
+**源码证明**：Android JNI `platform/android/MapLibreAndroid/src/cpp/native_map_view.cpp:1012-1017` 明确传 duration、delay、enable；iOS `platform/darwin/src/MLNStyle.mm:521-539` 可分别设置 transition 和 performsPlacementTransitions。当前任务没有生产 Host 此项逐帧配置证据；不能拿 SDK 默认值替代 FZG1 实际值。Android getter :1000-1008 对 unset duration 返回0，若只记录 getter 值还需区分“未设置的默认300ms”和“明确设置0”。
+
+**对任务假设的明确判定**：`symbolFadeChange==0` 不能代表“Fade 已稳定”，此语义误读已被源码证伪；但缓存无窗口的充分原因是 changed/stale 的互斥准入，不是仅这个比较符。任务要求解释末态 true/0/false：该值与开启配置的稳态重算相容；在未改写字段的正常 Full 中，不支持直接解释为“关闭 transitions”。Fast 重置树字段为 false/0，而不是 true/0。若日志声称关闭且仍 true/0/false，应优先核对同帧采样、运行二进制/选项生命周期，不能改源码迎合假设。
+
+### 7.4 真值表：P=!changed && fade==0 && !transition
+
+下表针对 placementCapable=true；无 Symbol R 直接通过本 gate，但仍受其它保护。以 c=changed、z=(fade==0)、t=Controller transition：
+
+| c | z | t | P | 正常 Full 可达性/意义 |
+|---:|---:|---:|---:|---|
+| 0 | 0 | 0 | 0 | Continuous 正常 no-recompute 分支不可达：会 stale；抽象状态不足以证明安全 |
+| 0 | 0 | 1 | 0 | 开启且未重算、时间增量>0；Fade 活跃或已结束都可 |
+| 0 | 1 | 0 | **1** | 唯一逻辑通过组合；**正常 Continuous Full 不可达**。已命中 Fast 的树重置可有此形态，但不能自举 |
+| 0 | 1 | 1 | 0 | 同 timestamp 重复 render、增量仍0而 stale；可达也不通过 |
+| 1 | 0 | 0 | 0 | transitions关闭（fade=1）；或开启duration0/zoom修正且无实际Fade |
+| 1 | 0 | 1 | 0 | 新显隐变化伴随非零zoom修正等 |
+| 1 | 1 | 0 | 0 | 开启、静止zoom、重算但旧Fade结束；现场末态相容 |
+| 1 | 1 | 1 | 0 | 开启、新显隐/Fade、刚commit |
+
+Bucket 增减、跨段碰撞可能改变 `Placement::commit` 内部 placed 状态、重置 fadeStart；其是否真实改变 R2 需逐 Symbol 数据。即便完全不改变，也落入上述无窗口分支。没有 Source 变化也足以卡住；Source 变化不是这个机制的必要条件。
+
+### 7.5 Shader 与 Full 后安全 Build 的必要证据
+
+**源码证明**：`Placement::commit:694-724` 将上一 placement 的增量折入新的 OpacityState；`OpacityState:18-24` 保存 base opacity 和 placed 方向。`RenderTreeImpl::prepare`（O:133-138）→ `Placement::updateLayerBuckets:752-757` → `SymbolBucket::updateVertices`（`src/mln/renderer/buckets/symbol_bucket.cpp:346-366`）更新 opacity 与动态属性；`Placement::updateBucketOpacities:962-1029` 处理 duplicate、default、placed hidden 和属性编码。
+
+`renderer_impl.cpp:462,755-766` 把树的 fade 送入全局 shader uniform。OpenGL：`shaders/symbol_sdf.vertex.glsl:153-158`、`symbol_text_and_icon.vertex.glsl:152-158`、`symbol_icon.vertex.glsl:127-129`；Metal：`include/mln/shaders/mtl/symbol.hpp:157-164,372-374,644-646`，都将 opacity 基值加/减 fade 并 clamp。Metal fragment :257-263,495-530 再乘 paint opacity；GL `shaders/symbol_sdf.fragment.glsl:77` 和 `symbol_text_and_icon.fragment.glsl:53-57,94` 也乘 paint opacity。零 fade 可以对应 base=0 的新符号或 base=1 的已完成符号，数值自身不足以判稳。
+
+**条件推断（提案前提，尚非安全证明）**：可候选在完整 Placement 和 bucket 更新、shader 输入就绪后，使用一个与 Build 世代绑定的“输出已终态且不会仅随时间变化”证据，再建立 R2。必须同时覆盖 text/icon、duplicate、variable anchor/orientation、沿线重投影（placement.cpp:776-959）、paint opacity transition、glyph/image atlas、Tile/Source/camera/context、层序/深度/混合边界。仅 `!Controller.hasTransitions` 不足以替代这些证据，因 Controller 的 stale 是待重算语义；仅删除 changed 或把 ==0 改成≥1 也无法建立与缓存像素绑定的不变量。
+
+## 8. E：S1—S5 反事实与因果闭环
+
+### S1：仅粒子持续推进，所有静态输入就绪且不变
+
+**源码证明/条件推断**：以任务要求的“仍有含 Symbol 的 R2、粒子30FPS”为前提，而不是把“纯粒子”误解为地图根本没有 Symbol。
+
+- f0 无 prepared tree，必 Full；R2 gate 拒绝，R0/R3 若无 Symbol 且其余条件通过可 Build。
+- f1 Fast 首先看到 R2 invalid；Full 中要么 changed=true，要么 stale=true，再次拒绝 R2。R0/R3 可 Reuse。
+- f2…重复；启用 transitions 的重算频率由 period/zoom/bucket 决定，关闭时每次 Full 重算。**即使无任何外部 Source mutation，当前 Symbol R 仍无法从第一次正常 Full 自举。**
+- 反例边界：若全部 R 都无 Symbol，单 C 只包含受支持的 WeatherColor/Particle，所有 Gate 满足，正常 Full 能建缓存、随后 Fast 可以命中；Placement 不需每300ms独立强迫新 Full。若 f0 还有真实全局 Fade，则等待必要 Full 结束后才可能命中。
+- **仍需设备验证**：以上状态机不等于已测到30FPS、具体 CPU 成本或缓存最终像素正确。本轮未执行场景。
+
+### S2：粒子关闭，只剩偶尔地图刷新
+
+**源码证明/条件推断**：关闭 active/visibility 或清掉必要场数据会取消粒子 needsRepaint，#18 不能命中 Particle Fast。若同时停止 forecast、没有其它动画及 pending 资源，就失去高频 SDK wake/repaint 链；最终 loaded 且无 transition 可 Idle。期间每个真实 Full 仍进行 recent 判定，关闭 transitions 时每个 Full 都算 Placement，开启时仍可能用几帧完成 Fade/stale。
+
+**FZG1 实测**：关闭粒子对照约83次Full/分钟来自任务输入。**不能证明**这83次都由导航、Placement 或 Tile 任一单源造成；也不能证明 Placement 从不运行。若只隐藏粒子却仍 forecast Playing，WeatherRuntime :252 仍唤醒，因此“粒子关=无天气高频唤醒”必须同时核对预报状态。83次与1792次的差异支持高频粒子场景增加 render 请求，但不提供精确按来源分摊。
+
+### S3：真实 Host Source Mutation + Annotation + Tile 异步输入
+
+**源码证明**：Style Source 更新先由 `src/mln/style/style_impl.cpp:348-351` 通知 onUpdate；新 sources identity 会令 Fast #8 失败。Full 的 O:525-537 每批非空 sourceDiff 推进一次 aggregate content revision，并为每个增删改 Source 推进 local revision。Tile callback O:1555-1559 则每次推进 aggregate/local 并 invalidate；Glyph/Image 无明确 source 时推进 global。Annotation dirty（`annotation_manager.cpp:213-227`）使 #24 拒绝，Full O:360-363 消费 dirty。
+
+**理论量化（条件推断，非测量）**：
+
+- 一批 Full sourceDiff 含 m 个 Source 修改：aggregate 增1、local advance m 次；m 不等于 m 个 Full。
+- N 次独立 onTileChanged：当前实现 N 次 aggregate/local revision advance；若在下一 render 前合并，仅需要一次承载最新状态的 Full，若穿插 N 帧则可每帧拒 Fast。Fade、stale、继续到来的异步输入又可能延长 Full 序列，故不能用 N 推出总 Full=N 或每次 mutation 固定只需1帧。
+- 已 valid 的无 Symbol R，若仅依赖 Source S，S 的新 revision 使下一次可支持的 evaluate invalidate/build；其它无 Symbol R 可复用。global epoch 变化则所有段的新 revision 都不同。每段 Build次数≤它实际有资格 Build 且绘制成功的 Full 次数；当前 Symbol R 无资格，所以 Build仍0并非 mutation太频繁的唯一解释。
+- 只在 C 的 Source 变化可使整帧 Full，却不必令独立 R 的 local revision改变；碰撞关系仍可使 Symbol R 输出变化，不能以 source依赖表忽略跨段 Symbol。
+
+**重要独立来源**：V4 forecast Playing 时 `Map::onUpdate` → `tickForecastClock` → `refreshV4RendererState`；后者 `raster_array_source.cpp:569-608` 在投影 sampleState/端点变化时换 Source impl 并通知，即使 T0/T1 纹理可复用，也可能令 #8 每次失败。这是 Native forecast 的真实输入更新，不等于静态风场粒子 advection，也不能无证据统归 NavSea 导航 Mutation。S1 必须固定 forecast 时间；S3 诊断应分别计 external Source 和 forecast projection。
+
+### S4：布局对照，保留真实层序
+
+| 布局及证据 | 分段 | R 缓存 | C / Fast 独立门槛 |
+|---|---|---|---|
+| 原 RC（STEP-110 现场历史） | R[0,31)、C[31,113)，R含地名 Symbol | Symbol R当前无Build窗口 | 后段含大量普通业务层，若有普通 Symbol/Line，#22必拒；不能把 RC1/RC2 的所有字段与旧快照自动认作同一采样 |
+| 原 RCRR（四段的泛型/候选基准） | 若为 R[0,31)、C[31,33)、R[33,107)、R[107,113)，须由原始 plan 确认；**本轮任务未给该原配置完整边界，不将此数字当实测** | 首R和R2若含Symbol仍被阻塞 | 条件下 C仅 WeatherColor+Particle 则类型Gate可过，但 scene及所有R仍要过。泛型RCRR只说明策略排列，不保证边界和类型 |
+| **RCRR_PREFIX（任务书现场输入）** | R0[0,13)、C1[13,33)、R2[33,107)、R3[107,113) | R0复用1787、R2不建、R3复用1755；与Full mixed执行相容 | C1含普通Symbol/Line+WeatherColor31+Particle32；`O:1247` 遇普通层返回false，#22确定被#3掩盖 |
+| **理想保序反事实，未实施** | R[0,13)、R[13,32)、C[32,33)、R[33,107)、R[107,113) | 新R[13,32)及R2含Symbol，当前一样卡住；WeatherColor31也进入R | 恰好一个C且只有Particle可消除类型障碍；不消除Symbol Gate、scene、资源/source/annotation。若forecast/WeatherColor继续变化，新R必须重建/回退 |
+
+`singleContinuousSegment` 在 `renderer_impl.cpp:55-63` 限定唯一 C；`RenderLayer::startsRetainedDynamicRange` 默认false（`render_layer.hpp:113-120`），Particle/WeatherColor 才 override true（对应 layer头 :31-33/:27），普通 Symbol/Line 即便暂时隐藏也不会因不可见自动成为受支持 C。多 R 本身不是禁止项；多 C 是当前 Fast 的独立阻塞。STEP-106 的 R-C-R-C 是缓存局部性测试，不是生产 Fast 性能证明。
+
+**仍需设备验证**：补原始 RC1/RC2/RCRR plan JSON、113层完整 id/type/source/visibility/顺序，才能逐层定位实际布局；本轮没有跨项目改 Style。理想配置只做反事实，不能承诺 WeatherColor永远静态，更不能删海图Symbol或把普通层批量挪C作为优化。
+
+### S5：动态安全回退
+
+| 变化 | 必须处理的 R / Full 条件（源码证明+条件推断） | 不可盲复用的理由 |
+|---|---|---|
+| pan/zoom/rotate/pitch、viewport/pixelRatio | 屏幕缓存 key 改变的所有R重建；Fast camera/viewport/signature拒绝 | 旧屏幕纹理、anchor/reprojection不再对应当前相机；定图仍需碰撞正确 |
+| 相关 Tile/source更新、缺失/fading | 依赖段 Source gate/revision失效；Fast aggregate/content/fading可能整帧Full | 异步完成意味着可见内容改变；非依赖段只在全局证据允许时继续复用 |
+| Glyph/Sprite/Image/fontFace | 当前实现 global epoch及ready；通常所有R保守失效 | atlas/字形纹理可能变化，sourceReady不足以覆盖 |
+| text/icon opacity Fade或paint transition | 受影响Symbol R不能冻结随时间变化的像素；现有全局Controller/gate更保守 | uniform与base opacity共同决定alpha；不能从fade=0/Controller=false单独得出结果等价 |
+| 跨段Collision变化 | 所有碰撞影响到的Symbol R必须刷新；当前没有可靠per-R证据时保守回退 | source不等于segment；跨源关闭只隔离不同source，同source仍相互影响 |
+| Annotation插入/更新 | 拓扑/Source/pending及碰撞具体属性分别处理 | 自动 points Symbol由 `annotation_manager.cpp:176-192` 添加，默认iconAllowOverlap/iconIgnorePlacement=true，**不能断言它一定排斥R2**；结构gate照样capable，实际影响还看其它Symbol/配置 |
+| Style属性/顺序、Layer增删、Plan边界 | 本段fingerprint或全局topology变化；对应cache释放/重建 | 层序和混合语义不能被texture复用改变 |
+| context/resource/compositor失效 | 已损坏资源全部重建；失败保持live/fallback | valid标志不能替代真实资源准备和draw成功 |
+
+## 9. A—D 提案比较（均未实施）
+
+优先顺序：**A诊断补齐 → B建立严格生命周期准入原型并同步处理scene → C按需求扩展per-R等价；D先交Integration确认公共“强制Full”语义，再决定实现**。C范围布局问题与这些方案独立：保序单粒子C是候选配置，任何产品Style变更都另行授权。
+
+| 提案 | 首次Build / 全局scene / C Gate | 正确性与风险 | CPU / GPU / 内存代价 | 候选修改文件、复杂度、双平台与最小验证 |
+|---|---|---|---|---|
+| **A 全Gate+R2状态诊断，优先P0** | 不改变Build或scene/C结果；一次取齐被短路掩盖项 | 不改变fail-closed；读状态需同frame和phase，不能额外调用有计数副作用的needsRepaint造成伪观测 | CPU约O(现有gate数+R数)，复用已算结果；固定环形缓冲有界内存；GPU零额外工作。采样成本须实测 | `particle_fast_path.hpp`、`renderer_impl.cpp`、`render_orchestrator.cpp/.hpp`、`placement.hpp/.cpp`、现有diagnostics结构；**2/5**。Shared Core同字段，Android/iOS只分别接低频导出。最小验证见第10章，记录schema无需新增公共API即可先做Native内部诊断 |
+| **B Full后安全Build，优先P1** | **目标解决首次Build**；必须同时替换每段准入和prepared scene的旧证据，单改其中一处无效；不解决普通C层Gate | 保留全图Placement与全部资源保护，以已经完成的Symbol shader输入/终态证据授权。先shadow，不直接删除changed/stale/fade条件。危险为早冻结Fade、漏collision/atlas/paint状态、引用过期bucket | Full本来就做Placement，可在commit/bucket完成点记录代际，稳态尽量O(1)/段；首次离屏多一次R绘制，后续composite；每R现有全屏RGBA颜色约4WH字节，另depth/stencil和backend开销，更多R线性增加 | `placement.hpp/.cpp`、`symbol_bucket.cpp/.hpp`、`render_orchestrator.cpp/.hpp`、`renderer_impl.cpp`、`render_segment.hpp`、cache状态结构；按所需证据可缩减，非已定设计。**4/5**。GL/Metal shader不预设需要改；必须两后端同提交检查opacity精度和texture合成。最小：静止Symbol R开启/关闭transitions、首次可见、fade长尾、camera/context/资源失效，false-reuse=0 |
+| **C 更细per-R结果等价，优先P2** | 可以为B提供首建/重建的证据；单纯“新旧签名相等”没有旧Build时不能自举；scene也必须接纳相同证据；不解决C Gate | 与STEP-111一致，仍全图碰撞，再按R比较结果；stable ID、世代和实际GPU输入齐全才允许reuse。hash相等不是完整安全证明；未知必须回退 | 每次Full placement后O(受影响symbol数)，避免每粒子tick遍历；签名/版本及必要精确快照占O(symbol数)或O(段数+变化集)；降低R GPU重绘但不自动省CPU prepare | `placement.hpp/.cpp`、`cross_tile_symbol_index.cpp/.hpp`、`symbol_bucket`、`render_layer`、`render_orchestrator`、cache/renderer接口。**4/5**；深改分段Collision为**5/5且不推荐本轮**。双平台共用结果证据、验证shader差异。最小：同Source跨R、跨源开关、C1仅影响R2/影响多个R、duplicate/variable-anchor/沿线字/Annotation/重载；以缓存关对照 |
+| **D 外部Full与Particle Tick分流，Integration先行** | 单独不解决Symbol首次Build、scene或C类型；可明确某次更新必须Full，并在纯tick时优先Fast | 用户要求外部明确Full不能以数据相同去重/延迟；需明确序号、确认时点、合并规则、生命周期与平台一致性，禁止把重要资源更新当tick | 内部原因bit/epoch通常O(1)；若每个命令都必须独立一次Full会增加CPU/GPU，额外队列可能有界内存需求。收益取决于频率，不能承诺2 Full+28 Fast | `UpdateParameters`、`Map::Impl`、Renderer入口、Android frontend、Darwin frontend及必要RN公共层；**3/5**（跨项目/生命周期可到4）。现有triggerRepaint不是此契约。最小：相同数据两次明确Full、命令与tick/异步tile竞态、禁用销毁重建、Android异步合并和iOS，检查每个accepted序号按决议完成；不得私建API |
+
+### 9.1 B/C 的数据所有权与最轻量可行方向
+
+**源码证明**：`Placement` 持有 placements、opacities、variableOffsets、placedOrientations（`placement.hpp:184-201`），以 crossTileID 索引；`getSymbolPlacement`（`placement.cpp:1301-1304`）查具体Symbol。`placeLayers` 后 commit 已完成，但最终bucket opacity/duplicate和动态投影更新在 RenderTree.prepare，GPU drawable/tweaker又在之后。`Placement` 至多保留上一代（:190-192），cache可能跨更多代存在，因此只能与上次成功Build版本绑定，不能仅比较相邻两次Placement。
+
+`getPlacedSymbolsData` 对普通 Continuous Placement 返回静态空数组（:1325-1327），TilePlacement有专门实现（:1378-1387）；不能把现有public查询当完整R2结果快照。STEP-111的候选字段仍需要逐项实现与验证，本任务不宣称已设计出可直接上生产的签名。
+
+**候选轻量方案（条件推断）**：先争取“静态输入代际相同 + 完整Placement结束 + 所有目标symbol有效opacity已终态 + 无未消费资源/桶变更”的全局生命周期证书，授权该次Full离屏Build并保存buildEpoch；下次tick只比epoch和既有Gate。比每次tick全symbol hash轻。但必须证明碰撞/hidden/duplicate/variableOffset/paint动画均被证书覆盖；如不能低成本取得这一证明，继续fail-closed，退回shadow per-R比较，而非改用Controller.stale=false假装稳定。
+
+更细C候选字段分工：Source/tile/bucket generation、crossTileID及R归属、text/icon placed/hidden、实际anchor/orientation/动态顶点和编码opacity需要结果证据；Camera/viewport/pixelRatio、Style顺序、Source/global资源代际优先复用已有key/revision；paint opacity/transition必须覆盖时间依赖。首次帧没有参考就Build，未知或资源重建丢弃证书，真实结果变化则重建。内存与比较开销需要新增计数验证，不能从“理论可hash”推出安全或高性能。
+
+### 9.2 D 的 Interface Blocker
+
+**源码证明**：当前 `Map::triggerRepaint`（map.cpp:93-95）只调用onUpdate；`UpdateParameters`（`src/mln/renderer/update_parameters.hpp:25-61`）没有 externalFull/原因序号字段；Fast签名不比较timePoint，入口每次都先试Fast。`packages/maplibre-particle-rn/src/RendererRuntime.ts:12-27` 只有retained控制、continuous range/segment plan和diagnostics，未提供“外部指令强制Full并确认”的方法。Android frontend AsyncTask/最新params设计还有合并行为，不能自动保证每次命令一帧。
+
+**Interface Blocker（提案，不是当前调查阻塞）**：若用户希望公共Host“明确Full”命令具有不可被相同数据去重/延期的语义，Integration必须确认：完整更新是CPU prepare/全图Placement重新评估，还是强制所有R GPU重画；两个相邻命令能否同一Full满足、如何回执、如何与异步资源到达排序。既有C-001/C-002没有该公共语义。本轮仅只读 `/Users/tei/dev/navsea-particle-integration/contracts/PARTICLE_NAVSEA_BOUNDARY.md`、`CONTRACT_VERSION.md` 和COORD-005决议；C-001边界继续有效、C-002是QBIN窗口增补。不得通过Native私有通道绕过协调，未修改Integration，也未发送跨项目消息。
+
+纯内部性能优化可先留在Shared Core，不需要借口更改Host职责；明确Full请求一旦获授权，不能用“内容相同”跳过或推迟它，普通粒子tick则优先Fast并保留相机/资源/Placement等安全Full。**2 Full+28 Fast只是目标例子，非当前实现承诺或验收门槛。**
+
+## 10. 下一阶段最小诊断提案与独立验收证据
+
+**仅提案，未插桩、未执行、未创建下一Step。** 当前源码已能证明控制流矛盾；诊断用于确认FZG1实际选择的配置/路径、其它Gate和主要CPU成本，并为安全改造建立基线。
+
+### 10.1 同帧字段与采样点
+
+| 位置 | 最小字段 | 判别目的 |
+|---|---|---|
+| Map::onUpdate / SDK cadence wake | map generation、update/request序号、SDK wake/observer repaint/Host mutation/forecast tick来源、targetFps、active/visibility、forecastPlaying、sourceId、Clock时间 | 区分下一帧请求与外部数据更新；调度来源标识仅Native内部提案，不私建公共命令 |
+| I:199-278，Fast判定前 | frameId、UpdateParameters.timePoint、实际render时间、24项bitset、首错、changed signature字段mask、prepared tree/scene标志、所有R valid/buildRevision/staticRevision、config/topology/content revision | 一次记录所有Gate；多request合并和同一params重渲染可识别；避免只看cache-invalid |
+| O:778-810，Placement前后 | **当前options与旧Placement options** enable/duration是否unset/delay、commitTime、fadeStartTime、now、zoom/prevZoomAdjustment、override及原因、bucketAdded/Changed、recent、stale前后、outer changed、commit实际placed变化计数、raw fade和Controller/Placement各自hasTransitions | 验证开关分支、300/30ms和zoom影响；区分实际Fade与stale |
+| RenderTree.prepare后 / I:637-691 | tree fade、shader fade、每R capability、动态usesPlacement、placementGate、sourceReady/stable、fingerprint、content revision、supported、fallback各项bitset、cache前状态、evaluate decision | 确认是否Gate阻止首次Build、是否其它失败被placement reason遮蔽 |
+| cache Build/execute / I:813-862,998-1028 | BuildPending/成功/失败、valid/key/资源世代、texture/compositor create/release、build/reuse/invalidation/fallback累计及delta、actualExecution、globalLiveReason、GPU pass耗时（如平台已有可靠计时） | 拒绝Build与GPU失败分开；Reuse与实际composite分开 |
+| frame完成 | FullCPU/fast/simulationAdvance计数、createTree/placement/prepare/layerUpdate/encode耗时、repaint原因bits、loaded/Idle | 不能用Full计数代替Placement次数或simulation次数 |
+
+字段不存在时新增只读诊断accessor应另行授权；不可通过额外一次placeLayers获得“测量值”。重用本来算出的gate bool与needsRepaint值，避免观察过程增加计数或推进cadence。
+
+采样建议：每组先10秒预热、再60秒统计；前3秒及状态变化前后保留连续逐帧详情，60秒完整保留紧凑gate/段决策和计数；用固定容量Native环形缓冲、超限显式记录dropped计数。日志导出1Hz摘要或窗口结束统一写，不每帧JSON/JS bridge、不每Symbol默认打印。以实测结构大小和容量给出内存上限；对trace开/关同场景比较CPU/frame，目标开销预算先建议≤1%，达不到则缩减详细采样但保留全部gate bitset。这个预算不是当前已达到指标。
+
+### 10.2 最小场景与判断
+
+1. FZG1原V23、同场/同camera：粒子开/关，分别固定forecast暂停；保留原plan和所有113层元数据。复现计数只用于基线，不要求改变现有结果。
+2. 同输入分别enablePlacementTransitions=true/false；true下记录D=默认/显式值，false预期Full组合true/1/false。每个Symbol R应在每个Full看到gate=false；若有正常Full gate=true，是本报告不变量反例，应保留原始帧/版本并停止假设式修复。
+3. PREFIX，记录#22普通层第一个拒绝的id/type/index，同时#3失败；原RC和真实RCRR分别保留配置，不复用旧布局推断。
+4. 无外部Mutation的固定field、forecast暂停，与导航/Annotation更新、Tile完成、forecastPlaying分别对照，按来源和phase对齐revision。不得靠降低粒子FPS制造好看CPU。
+5. 后续B/C shadow原型才验证：首建可达、fade长尾/variable anchors/跨源碰撞/同源跨段/相机/Style/清场/context；缓存开关同帧结果对照，**false-reuse=0**，不能用总FPS掩盖陈旧字/图标、错层或缺字。Android OpenGL和iOS Metal同源码各跑，不能用一端替代另一端。
+
+独立验收需要：源码commit及制品SHA/实际SDK版本、plan JSON与Style层表、全部gate bitset、Placement两套配置和时间、R状态机计数、trace开关开销、CPU阶段耗时、同帧视觉/必要图像差异证据、原始日志路径。任何提升Fast命中/CPU降低数字必须来自新实验。本轮不提供尚不存在的诊断开关命令，也不执行构建、测试或设备动作。
+
+## 11. 最终结论、未确定事项与责任边界
+
+### 11.1 已证明
+
+1. **源码证明**：粒子/SDK只请求下一次正常地图渲染；每次先试Fast，没有粒子专属“必须Full”命令。当前Full CPU频率是请求频率与准入失败共同作用，不等于静态像素每帧变化。
+2. **源码证明**：正常Continuous Full对结构性Symbol R的三项gate无可达通过分支：changed或stale→transition二者必挡其一。它足以解释在静态输入下仍无法首次Build；不是仅仅“可能比较符用错”的猜测。
+3. **源码证明**：fade=0不是终态证明；关闭transitions正常返回1。FZG1 true/0/false快照不能用来断定关闭配置或每帧300ms周期。
+4. **源码证明**：还有prepared全局scene锁与C范围类型锁；PREFIX普通Symbol/Line C不支持Fast。仅修R2不能承诺Fast命中。
+5. **源码证明**：缓存invalidate计数不要求曾valid；Full可复用其它R并live画R2，正常主屏显示不等于离屏Build成功。
+6. **源码证明**：V23相关核心gate与本轮main一致；STEP-109仅改变两Layer的field深比较快路，不解除以上限制。
+
+### 11.2 假设判定与历史报告关系
+
+| 假设 | 判定与证据强度 |
+|---|---|
+| 粒子每次tick直接改变静态R内容 | **不成立为必然关系，源码证明**；纯simulation不改R，forecast/Host更新另算 |
+| C1每帧碰撞使R2符号真实变化，才导致Build0 | **未证实且非必要条件**；gate控制流在零mutation也不可达 |
+| `symbolFadeChange==0`等于Fade结束 | **源码证伪**；它是增量，不是稳定布尔量 |
+| FZG1 true/0/false证明关闭transitions | **源码不支持**；关闭的正常Full为true/1/false |
+| 删除placementChanged或改==0即可安全修复 | **不支持**；stale/scene/C/资源/碰撞/opacity仍独立存在 |
+| 现有Gate是合理保守且没有任何进展性问题 | **需细化**：fail-closed保护正确，但正常Symbol R Full首次Build不可达是可证的功能/性能准入限制；是否按产品契约命名为Bug由后续设计确认，不是视觉错误或可直接放宽安全的证据 |
+
+STEP-110/111保留原样。它们强调“来源不等于视觉影响、缺逐R安全证据”的结论仍成立；本轮新增的是 **changed/stale互斥导致准入不可达** 的完整控制流证据，不能把旧PARTIAL说成已实现修复，也不重写历史来伪装一致。
+
+### 11.3 尚不确定 / 仍需设备验证
+
+- FZG1每一帧enable/duration、bucket添加、zoom修正、调用来源和24项Gate真实值；末态仅一个快照。
+- 原RCRR完整边界和RC1/RC2精确同版Style列表；本报告不把推测布局写为实测。
+- 导航Source、Native forecast投影、Annotation、资源异步输入各自占多少Full/CPU；83与1792不是按来源归因数据。
+- R2每个Symbol实际最终输出是否与某个候选缓存时刻完全等价、可接受证书的充分字段及实现成本。
+- B/C实现后的首建、Fast hit、CPU/GPU/内存收益、GL/Metal像素一致性和安全回退；本轮都没有实现或运行结果。
+
+**交付判定：本轮A—E源码调查与提案已完成；综合结论保留PARTIAL（生产逐帧归因、完整原始布局及安全修复/性能未验证），不标实现/运行/性能PASS。** 已有决定性源码机制证据，不再以猜测“等Fade结束就可能Build”作为建议。下一阶段最小工作是A的同帧诊断和B的安全证据设计；维持现有fail-closed，不直接修Native。
+
+Codex调查阶段只交付四份文档，不承担Git操作；STEP-112任务书第十一节要求RDC独立进行仅文档scoped提交、推送和远端回读。Git最终状态以RDC收尾补记为准。

docs/20_调查/STEP-114_FastPath安全准入与闭环判定_v1.md

@@ -0,0 +1,78 @@
+# STEP-114 Fast Path 安全准入与闭环判定 v1
+
+日期：2026-10-11（JST）。结论：**PARTIAL；安全子集源码与独立最小场景已交付，真实 Fast 尚未验收。**
+
+## 1. 基线、证据等级与阅读
+
+Mac / Darwin 24.6.0 / x86_64，`/Users/tei/dev/MapLibreParticleLab`，`particle/main@b02e54de3d45fcf612126ae8f037cba204f590ea`。源码版本 `13.6.1-particle.23`，没有发行或改 Source Lock。实际模型 GPT-6.1-Sol / high 已从当前本地 rollout 的 `turn_context` 核实。
+
+已读根 AGENTS、PARTICLE_BASELINE、项目规范全部八份、项目总则 README 与四份有效总则、本任务、STEP-112 调查/完成报告、STEP-113 完成报告/Step（含两轮 RDC 追加）、实际 Shared Core 和 Test App 源码。Integration 只读 AGENTS、README、WORKFLOW、TEAM_MODEL、C-001/C-002、Contract 版本规则、RFC-001/002/004、ADR-001、COORD-005 决议；不写跨项目文件，不改 RN/JS API/ABI。
+
+SOURCE-PROVEN 表示本轮源码控制流；RETAINED-EVIDENCE 表示本机保留的旧 RDC JSON；IMPLEMENTED 表示已改源码；NOT RUN 表示未编译/运行。旧设备证据不是本轮改动的设备验收。
+
+## 2. R 的真实 SourceType 与初建失败点
+
+不能从 `unknown-dependency` 推断 source 一定是 CustomMVTVector：它还覆盖未知依赖、缺 revision 登记等情况。
+
+本轮只读 `artifacts/maplibre-particle/android-validation/step113/source-change-after-full.json`：Native source 表为 mapple/raster、navsea_delivery/vector、org.maplibre.annotations/annotations、rn-weather-fields/raster-array、step113-source-probe/geojson。R0 `[0,63)` 的依赖为 mapple、navsea_delivery、**tide**；第2层 `tide-spots` 是 `symbol`、sourceId=`tide`，source 表却没有 tide。R0 的 sourceRevision=0、sourceReady=false、Build=0、fallback=unknown-dependency。
+
+源码 `style/conversion/source.cpp::convertVectorSource` 创建 `VectorSource`；其构造函数指定 `SourceType::Vector`；`RenderSource::create` 创建 `RenderVectorSource`。因此该 Test App 的正式 PBF source **不是 CustomMVTVector**。任务书列出的 CustomMVTVector 限制是独立安全约束，本轮完整保留。没有改旧报告，也没有补造 tide 数据、删原正式 PBF 层或修改服务 Style。
+
+`retainedSegmentSourceState` 原先先读取 revisionFor，缺少 tide 的登记会返回 nullopt，从而提前返回默认 unknown-dependency。现在在读取 revision 前发现缺失 RenderSource 时明确返回 `missing-source`；本例的ready/stable=false、revision=0 不变。有旧tombstone记录的缺源也提前返回revision=0，而不暴露旧登记hash；它仍不得Build/Reuse，RevisionBook登记机制不变。这是诊断修正，**不改变缓存准入**。source 存在但无 revision、CustomMVTVector、未知 layer dependency 仍 fail-closed。
+
+后续即使 Host 合法补齐 tide，R 仍包含大量 Symbol，Placement 首建阻塞不会自动消失。缺源与 Placement 是不同失败点。
+
+## 3. 已支持的本地 GeoJSON/circle 子集
+
+FAST_SMOKE 选择本地 GeoJSON 非空点与 circle R，不新增 source 类型授权。其现有追踪链：
+
+| 输入或事件 | 源码链与保护 |
+|---|---|
+| GeoJSON setGeoJSON | `GeoJSONSource::setGeoJSONData` 替换 immutable Impl 并通知 SourceChanged；Fast non-camera signature 比较 sources；Full `diffSources` 推进全局 content 和本 source revision |
+| Source 增删/同ID重建 | `createRenderTree` 的 sourceDiff added/removed/changed 都 advanceSource；RevisionBook 保留 tombstone；PreparedTree 在 Full 更新对象前释放 |
+| 异步 GeoJSON 数据/布局 | `RenderGeoJSONSource::update` → GeoJSONTile::updateData；capturedData 和 weakPtr 防陈旧/销毁回调；GeometryTile correlationID 保护 pending；`onLayout` 每次更换 layoutResult 都 onTileChanged；RenderSource → orchestrator 推进 source-local revision 和全局 content，再 invalidate |
+| Tile 未就绪/淡入 | `isLoaded`、hasFadingTiles、source assessment、#17 与 R 稳定性检查继续保留 |
+| Layer paint/layout/顺序 | immutable layers signature、per-R content fingerprint、resolved plan/topology；有 transition/repaint 仍阻止 |
+| Camera/viewport/pixelRatio | #6/#7/#8、RetainedUnderlayKey 与 revision state；旧 texture 不能按新矩阵复用 |
+| Style reload | styleLoaded/signature、配置/层序/Source 新身份、PreparedTree 生命周期保护；trace 在实际看到 loaded→false 时重置 |
+| Image/Sprite | imageDiff、spriteLoaded、imageManager readiness、missing/unused image callbacks 推进全局 revision；#8 先捕获新 images 输入 |
+| Glyph/fontFaces/URL | non-camera signature、glyph URL/font identity 追踪、onGlyphsLoaded 推进全局 revision；不删除资源门禁 |
+| Annotation | #24 pending 检查、source/tile/图片变化与层表；实际 Symbol 继续纳入全场结构检查 |
+| context/reset/destroy | markContextLost、Renderer.clearData 清 PreparedTree/trace，orchestrator 推进 revision；析构 detach observer 前排空 source/tile 工作；Test App 取消 callback、dispose runtime、删除自有 marker，MapView 原生命周期仍由 Activity 执行 |
+
+这一闭环是现有实现的源码依据，**不是本轮已跑出的 Source mutation/GPU PASS**。异步过渡中 Full 也可能继续展示尚未更新的旧 bucket；要求 Fast 与同一时刻合法 Full 等价，而非承诺提交 API 后同步完成画面更新。成功布局后必须失效并正确重建；不可用两张稳定末态截图代替事件顺序证据。
+
+R source policy、RevisionBook、GPU Build/Reuse 算法本轮零语义修改。新增 C++ 用例验证既有 revision/cache 状态机组合；unit 中显式推进 epoch/标记构建只用于状态机测试，不是实际 Native 帧或 GPU 成功的证据。
+
+## 4. C、Annotation 与 Scene 聚合
+
+`continuousRangeSupportsParticleFastPath` 要求每个 C layer 都 startsRetainedDynamicRange，并至少有粒子动画层。WeatherColor 与 RasterParticle 符合；普通 circle、Symbol、内建 Annotation Symbol 不符合。`particlePreparedSceneSupported = retainedSupported && fastContinuousSupported`，并要求单一 C。#22/#23 可以共享 C 不支持根因。
+
+本轮没有修改 #22/#23、C GPU 复合流程、层序或 AnnotationManager。不能证明非粒子 C 与既有 Fast prepare/postRender 等价，故不放行。
+
+独立 FAST_SMOKE 在确认 `map.annotations.isEmpty()` 后，仅从本场景 Style 删除自动生成且空的 `org.maplibre.annotations.points` layer，保留内建 source；若缺层或 remove 失败则 BLOCKED。Native annotation 更新规则未变，正式 PBF 五场景不删除该层。baseline 层序应为 background、R circle、weather-color、raster-particle，实际 JSON 仍需 RDC 核对。
+
+ANNOTATION_BLOCKED 重新加载一个正常 Style，保留自动内建层并用现有 `map.addMarker` 加真实 marker；可单次修改其 position。内建 Symbol 位于 C，#22/#23 必须继续阻止 Fast。从该场景切回 baseline 时只删除本场景拥有的 marker，不能清除其他 Annotation。若存在其他 Annotation，baseline 拒绝启动。该场景转换含合法 Style reload，不是生产 Annotation 零重载支持的证明。
+
+## 5. Placement：安全局部修复与 BLOCKED
+
+正常 Continuous Full：placementIsRecent=false 则 placeLayers/commit，placementChanged=true；recent=true 则 setPlacementStale，controller.hasTransitions=true；关闭 transitions 时正常 Full changed=true、fade=1。含结构性 Symbol 的 R 无可证明的首次 Build 稳定窗口。
+
+本轮保持 Symbol R 的三项 gate、scene placementStable、全图碰撞、fade/transition 和跨 source 规则。完整 GPU symbol 输入、bucket/atlas/opacity/duplicate/anchor 的结果证书仍不存在；建立它需要独立结果签名或更大生命周期设计。**Symbol R 准入修复 BLOCKED，不能删除 changed/stale/fade 条件。**
+
+唯一行为修复限定于**完整非空层表没有任何结构性 Symbol**：此时 controller 的 stale/transition 没有 Symbol 像素消费者，单独阻止 #13 不代表画面可能变化。`particleFastPathHasPlacementTransition` 按完整 Style 表检查；隐藏/空数据的 Symbol 与 Annotation Symbol 一律保守保护。production 还核对层表数量与 renderLayers 数量，不一致保持原 transition；空表也保守保留。
+
+这是 Shared Core 内部实现优化，无 Android/iOS 分叉，不新增控制 API、不禁止正常 Full Placement、不修改原始 controller。其余23项 Gate、source/cache/scene 条件全部继续生效。新增 Symbol 尚未进入旧表时，immutable layers 的 non-camera signature 不相等，且 Annotation pending 单独阻止 Fast；Full 更新后表重新包含 Symbol。未取得新层表前不得只凭这个 helper 放行。
+
+反例边界：同场只要存在一个隐藏 Symbol、空 Symbol、C Annotation Symbol，仍使用原 controller transition；缺层表、source mutation、未完成 tile layout、image/glyph 更新、camera/viewport、style reload、debug/context 问题都不能被本修复抵消。未来若引入新的 Placement-capable layer 类型，应先扩展结构检测及测试；当前源码仅 Symbol 的 LayerTypeInfo 使用 CrossTileIndex::Required。
+
+## 6. 实施结果、验证方案和限制
+
+- IMPLEMENTED：缺源明确诊断、无 Symbol 场景的 #13 限定检查；3个非 Jest C++ 用例源码；独立4场景及 UI/Intent、真实 Native 快照与操作前后自动采样；中文文档和追加记录。
+- 保留 fail-closed：CustomMVTVector、未知 revision、缺源；非粒子 C；所有 Symbol R Build/Placement 保护。
+- NOT RUN：Native/Kotlin 编译、C++ 测试、Android build/设备/GPU/Fast 命中、像素对照、性能、iOS Metal 设备验证。
+- 保留：正式 STEP-113 五个 PBF 场景实现原样、STEP-102 fixture 原样、STEP-110/111 未跟踪文件原样。新增菜单明确标识独立 smoke，不冒充63/113层等价。
+
+验收步骤和命令见 `docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md`；Native 定向命令也直接写在本轮完成报告。baseline 必须取得真实 Native Full>0、Fast 增长、CacheBuild>0、Reuse 增长、completed fast-rendered、24 PASS/knownMask 完整/decisionMismatch=0；否则维持 PARTIAL，不能标 Fast Path 已修复。
+
+Source/Image/Camera/缓存禁用/Reload 的反向证据需保存事件前/提交后/100/500/1500ms 快照，必要时以更早的精确帧复核；未捕获瞬间 gate 不能用计数猜测。后台/恢复/Teardown、Symbol/Annotation 与原 PBF 回归、双平台共享源码独立检查仍为 RDC/用户待执行项。

docs/20_调查/STEP-116_STEP113原PBF_FastPath阻塞安全修复审查_v1.md

@@ -0,0 +1,73 @@
+# STEP-116 STEP-113 原 PBF Fast Path 阻塞安全修复审查 v1
+
+日期：2026-10-11（JST）。结论：**部分实现（PARTIAL）；空 Annotation 生命周期受控修复已落源码，缺源和 Symbol R 准入继续 BLOCKED。没有新的设备 Fast 证据。**
+
+## 1. 当前事实与范围
+
+仓库 `/Users/tei/dev/MapLibreParticleLab`，`particle/main@e2d202b560ad0165101546597c43f2ef0ccf4542`，Darwin 24.6.0 / x86_64。起点 tracked clean，只有 STEP-110/111 和本次 STEP-116 任务书未跟踪。版本仍 `13.6.1-particle.23`，不能用版本号相同推断 APK 源码相同。Integration main `80667d6c343411d03a760425438e3d292f452118` 为用户提供的 RDC 核验事实，本轮只读相关规范，没有 fetch 或跨仓写入。
+
+已读取 AGENTS、PARTICLE_BASELINE、项目规范全部八文件、总则 README 和四份有效总则、STEP-116 任务及 STEP-112/113/114/115 当前记录/报告和相关源码；Integration AGENTS、README、WORKFLOW、TEAM_MODEL、contracts、rfc、adr、instructions、status、compatibility 只读。本轮不使用子代理，不修改公开头文件、公开 API/ABI、Host/RN/JNI 控制协议、NavSea 或公网 Style。
+
+## 2. 缺源 R：证据成立，空依赖准入不实施
+
+保留文件 `artifacts/maplibre-particle/android-validation/step113/source-change-after-full.json`，SHA-256：
+
+`24a06fa1cb072a628c650723c58a880895ec656f4972fa55d3cb064bfb2aabda`
+
+Native 原层 index=2、ID=`tide-spots`、type=`symbol`、source=`tide`。R[0,63) 依赖 `mapple/navsea_delivery/tide`。Native 实际 Source 表是 `mapple:raster`、`navsea_delivery:vector`、`org.maplibre.annotations:annotations`、`rn-weather-fields:raster-array`、`step113-source-probe:geojson`；没有 tide。该文件属于旧 SOURCE_CHANGE 完整窗口，不冒充本次 STATIC_RC 实测。原记录中 fallback=unknown-dependency；当前 STEP-114 代码已提前报 missing-source。
+
+`RenderOrchestrator::retainedSegmentSourceState` 在查 revision 前先检查缺源及 CustomMVTVector；普通 Vector 不走 CustomMVTVector 拒绝分支。`renderSegmentDependencies` 不因隐藏或当前桶为空删依赖。`RenderSegmentRevisionBook::revisionFor` 对未登记来源返回空值，保留删除墓碑用于同名重建；墓碑存在不能代替当前 Source 的 readiness。
+
+源码链路审查：
+
+| 链路 | 当前实现与限制 |
+|---|---|
+| 零贡献候选 | createRenderTree 的 source/layer 匹配循环不会给缺源层生成 LayerRenderItem，updateList 默认 false；这支持“本轮没有对应新 RenderItem”，不等于全部旧 GPU 对象已完成禁用的证书 |
+| 旧 GPU 生命周期 | RenderLayer::markLayerRenderable 调用 activateLayerGroup 提交 ChangeRequest；Symbol 还处理 collisionTileLayerGroup，layerRemoved 停用两类 group。CPU 状态、待处理 requests、旧 buckets 与实际执行时点需要一起核验；无 source 的循环边界也不能只靠 bool 推断 |
+| Source 创建/删除/同名恢复 | createRenderTree 的 sourceDiff 递增全局内容及对应 source revision；prepare 输入的 immutable sources 身份变化使 NonCameraSignature 不匹配，必须先 Full |
+| 同名更新/异步完成 | changed sourceDiff、onTileChanged → TileMutation → 内容/source revision + observer invalidate；feature-state 同样走 source 变更，不能按 HTTP 下载或 loaded 时间代替 |
+| 全局输入 | layerDiff / 层序、imageDiff、Glyph URL/fontFaces、onGlyphsLoaded、Sprite/ImageMissing、context/style cleanup 保留原失效链 |
+
+因此本轮**没有把 missing-source 当 empty**，没有登记虚构 tide revision，没有补假源或删除 tide-spots。后续需要“该 R 在成功 Full 中实际参与 GPU 绘制的 group/碰撞 group 已排除、无待应用资源变化”的有界证据，以及 source 出现/恢复后下一次尝试必定 Full 的回归。当前仅 Source 表缺失不足以承担这项新准入契约。服务器正式 Style 缺源仍是 BLOCKED。
+
+本轮只在现有诊断 JSON 的每段增加可选 `missingSourceIds`，由同次 snapshot 的依赖和 Source 表计算，包含缺失来源的具体 ID。查询不写 revision、不构造缓存、不修改首错和 24 Gate。
+
+## 3. 空 Annotation C：局部修复与保护
+
+旧 STATIC_RC Native 66 层：原63层 + weather-color + raster-particle + 自动 points Symbol。C 从 rn-weather-color 开始，普通 Symbol 不支持 particle dynamic range，阻挡 #22，并影响聚合 #23。SOURCE_CHANGE 的额外 circle 也必须保留。
+
+仅在 Step113PbfGateScene 的 STATIC_RC 第二次 Style 加载完成时执行一次空层调整：
+
+1. 生产基础 ID 不含 points，生产Sources不得占用org.maplibre.annotations；SDK `map.annotations` 必须为空；实际层必须是 SymbolLayer、sourceId 为 org.maplibre.annotations，内部 Source 必须存在。来源由本次原始JSON无内部ID、Native加载路径与实际层共同核对，避免把生产同名Source误当空SDK来源。
+2. 使用 `Style.removeLayer(Layer)` 对象重载，保留可重加的 wrapper；Source 保留，原63层定义/顺序及生产 Sources 原样。
+3. 记录 `emptyBuiltinAnnotationLayerRemoved`、实例数0、Source保留、移除层ID/作用范围，保存 productionSources；poll/export 继续使用真实 Native 计数。静态预期正常 STATIC_RC 65 层，不能当实际计数。
+4. 不周期删除任何层。后续普通 Style.addLayer 保持原行为，native immutable layer/signature/topology 变化继续 Full；Style 更换后不对新 Style 再做移除。
+5. stop 在相同 Style 且该 ID 仍缺失时重加原 wrapper，已有同名层不覆盖。Style 身份改变或 Annotation/points 重新出现时，3秒 poll 撤销场景验收条件并报 BLOCKED；poll 是报告保护，不承担恢复可见内容的时序保证。
+
+关键修复位于内部 `src/mln/annotation/annotation_manager.cpp/.hpp`：原 updateStyle 只在 Source 不存在时创建 points，Source 保留而层被删除会让后续 Marker 无绘制层。提取私有 ensurePointLayer，独立检查 Source 和层；首次添加 SymbolAnnotation、更新已有 SymbolAnnotation、Style loaded 三个入口修复缺失层。更新没有 geometry/icon 变化时也把 dirty 置真。已有同名 Layer 不被覆盖。
+
+时序：Map::addAnnotation / updateAnnotation → AnnotationManager 修复 Style layer vector → Map::Impl::onUpdate 捕获新的 immutable layers → Fast NonCameraSignature/annotationMutation 拒绝旧树 → Full 执行正常 Annotation 渲染。恢复不依赖3秒poll，也没有在 renderer thread 的 updateData 内重写 Style。Shape Annotation 原接口/图层仍按原逻辑处理，碰撞、Fade、Glyph/Image 和 C 判断完全保留。
+
+风险：这是 Shared Core 内部生命周期修复，所有后端共用；需 RDC 编译并跑真实图像用例，确认无锁/重入问题及旧 Annotation 行为回归。用户主动提供同名层时尊重其语义；若其配置本身无法绘制，该情况不被当作 Test App 空层安全条件。恢复失败在日志保留，不写成功。
+
+## 4. Symbol R：首次 Build 仍 BLOCKED
+
+已读 PlacementController、Placement::placeLayers/commit/symbolFadeChange、RenderTreeImpl::prepare、SymbolBucket::updateVertices、renderer Full 准入和 scene 聚合。
+
+| Continuous Full 分支 | 当前 Symbol R gate |
+|---|---|
+| placement 不 recent | placementChanged=true；placeLayers 后 commit、setPlacement，changed 本身阻断 |
+| placement recent | setPlacementStale；hasTransitions 返回 true，阻断 |
+| transitions 关闭 | placementIsRecent=false，Full changed=true；symbolFadeChange 返回1，不是 settled=0 |
+
+RenderTreeImpl::prepare 在 bucket updateVertices 中更新 opacity/dynamic attributes，并置 uploaded/dynamicUploaded/placementChangesUploaded 等状态。Placement commit 只提交 CPU placement/opacity 结果，不证明当前 R 的最终 GPU 输入一致。per-R `renderSegmentPlacementGatePassed` 和 `retainedSegmentIsStable`，全局 retainedPlacementStable / retainedSupported / preparedSceneSupported 均保留。隐藏/缺源/当前 placementData 为空的 Symbol 仍结构上具备 Placement 能力。
+
+**需要的额外设计证据**：成功 Full 对应的 GPU 上传/绘制完成代次、R 使用的 bucket/tiles/跨瓦片ID与排序、跨Source碰撞与所有参与碰撞层的 Placement结果、text/icon opacity和dynamic vertices、atlas/glyph/image代次、Style/Source/layer identities与revision、camera/projection/viewport/pixelRatio、uniform fade及debug/3D条件、待处理requests/异步变更纪元。证书必须绑定一次成功 Cache Build，变化即 invalid/Full，并对 GL/Metal 验证等价及 shadow。现有代码没有完整证书，本轮不做跨层重写，不用毫秒阈值、loaded、无手势或counter装配代替。
+
+## 5. 测试源码与结论边界
+
+新增四个 `Step116Safety.*` C++ 用例：缺源/Source加入未loaded/异步revision/删除墓碑和恢复；JSON缺源审计与Placement并存、查询无副作用；Symbol两个Continuous分支及关闭transition保护、无变化/Source与全局资源revision；Annotation/层序/disable/reload多失败 shadow 全集。revision用例验证的是账本契约，不伪造实际 Glyph/Tile 回调或 GPU完成。
+
+新增三个 `Annotations.Step116*` 用例：空points移除后真实添加在render前恢复并比对既有point_annotation图像；已有Marker no-op update恢复且出图；已有同名层不覆盖、reload恢复且出图。这些是测试源码，全部 NOT RUN；设备的annotation/Style、async mutation、GL/Metal回退还须独立验收。
+
+本轮实现后预期消除原 STATIC_RC 的空内部 C Symbol；无法承诺 #23 清除，也无法承诺 R Build/Fast>0。旧快照、AST或diff检查均不构成新制品安全、像素或性能 PASS。

docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md

@@ -0,0 +1,137 @@
+# STEP-117 PBF R 首次缓存 Build 安全证据 v1
+
+日期：2026-10-11（JST）。结论：**安全准入 BLOCKED；本轮保持 missing-source 与 Symbol placement fail-closed，交付七项非 Jest C++ 回归源码。没有实现 R 零贡献准入或 Symbol 结果证书，没有新的 Native/Android PASS。**
+
+## 1. 工作区与证据等级
+
+Mac.lan / Darwin 24.6.0 / x86_64，仓库 `/Users/tei/dev/MapLibreParticleLab`，`particle/main@43e5f5b91598b9c3d3f1c788052d4bbd2d616668`。起点 tracked clean；STEP110/111 与 STEP117 任务书未跟踪。实际模型 GPT-6.1-Sol（gpt-6.1-sol）/ high，由当前 rollout `01a12912-9a0c-7712-9624-793f04b3f681` 的 `turn_context.model/effort` 核实。Integration 本地只读 HEAD 为 `80667d6c343411d03a760425438e3d292f452118`，没有跨仓写入或远端操作。Android VERSION 仍 `13.6.1-particle.23`。
+
+已读根 AGENTS、PARTICLE_BASELINE、全部项目规范、总则 README 与四份有效总则、STEP117 任务、STEP112–116 关键任务/调查/Step/完成报告/验收文件；Integration AGENTS、instructions、README、WORKFLOW、TEAM_MODEL、contracts/rfc/adr/status/compatibility。本报告用以下等级区分事实：
+
+- **源码事实**：当前 HEAD 的控制流和所有权；不等同运行安全证明。
+- **保留实测**：STEP116 原设备 JSON 与报告；不是 STEP117 新二进制。
+- **测试源码**：本轮已写、全部未编译和未运行。
+- **待证明设计**：尚未实现的证书、影子比较与平台验证。
+
+## 2. 原 120 帧重新核对
+
+原文件：`artifacts/maplibre-particle/android-validation/step113-retest-20261011_121308/static_rc/native-full.json`；274,693 字节；SHA-256：`cd491d2acca97119f1d4f2d6f77eb7b229c17b90d4be1181a59202308429b219`。本轮只读解析完整 JSON，逐帧复算 failMask，不修改或纳入 Git。
+
+实测源码 `c48a72a9d492ea0d05e4d58464f9643453158d50`，APK SHA `a8b7f4e0f8e026bde8835e18a04876062be84cce3a3749a511cb08605d9f8a35`，设备 FZG1-2 / `192.168.200.139:5555`。STEP116 报告记录安装 SHA 相同、90.008 秒 FastDelta=0 / FullDelta=920。本轮未接设备。
+
+原正式 63 基础层保留；Native 65 层，R[0,63)、C[63,65)；C 仅 `rn-weather-color`、`rn-weather-particles`。正式 Style fingerprint 为 `e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996`。生产 sources JSON 只有 mapple/raster 与 navsea_delivery/vector；Native 另有 org.maplibre.annotations/annotations、rn-weather-fields/raster-array。没有 tide。R index=2 的 `tide-spots` 为可见 Symbol，source/source-layer 均为 tide。
+
+| 实测项 | 复核结果 |
+|---|---|
+| 120 帧范围 | sequence 5631–5750；119 completed Full / 0 Fast / 1 pending |
+| 24 Gate | 120/120 knownMask=0xffffff、decisionConsistent=true；decisionMismatch=0 |
+| #3 / #4 / #23 | 各失败120帧 |
+| #12 / #13 | 各失败105帧 |
+| #22 | 最近窗口失败0；生命周期累计6，不称启动全程零失败 |
+| R cache | Build=0 / Reuse=0；textureCreate=0 / compositeCreate=0；fallback=missing-source |
+| R dependency | mapple、navsea_delivery、tide；missingSourceIds=[tide]；placementGatePassed=false |
+| pre Placement 状态 | 105帧 false/非零/true；15帧 true/0/false（changed/fade/transition） |
+| post Placement 状态 | 104帧 false/非零/true；15帧 true/0/false；pending 的 post=null |
+| fade 范围 | pre/post 均为0至0.9914085268974304 |
+
+这解释了一个容易误判的现象：15帧的 #12/#13 通过，并不建立 R cache；这些帧仍有 #3/#4/#23，且上一完成树的 changed=true。Fast #13 使用当前 controller transition，R 首建使用当前 Full 的三条件，二者取样点与职责不同。不得拼接 pre 与另一帧 post 来造出通过状态。
+
+## 3. 缺 tide：新 RenderItem 为零与 GPU 零贡献的区别
+
+### 3.1 Style 与 Source 创建
+
+`src/mln/style/style_impl.cpp::parse/addSource/addLayer` 先加入 parser.sources，再加入 layers。addLayer 在 source 存在时检查兼容性；source 不存在时仍保留原层（源码 TODO verify source）。这正是原 Style 能保留 tide-spots 而没有 tide 的路径。removeSource 会拒绝仍被 Layer 引用的 source；同名恢复不能依靠违法删除调用，合法整份 Style 更换及后续创建也必须覆盖。
+
+`RenderSource::create` 根据真实 SourceType 创建 RenderVectorSource、RenderRasterSource、RenderGeoJSONSource 等。原 navsea_delivery 是普通 Vector，不能将它归因为 CustomMVTVector；后者的未知 revision 准入限制继续保留。
+
+### 3.2 Full 的注册、停用和绘制时序
+
+| 环节 | 当前源码事实 | 能支持的结论 / 不能支持的结论 |
+|---|---|---|
+| createRenderTree source/layer 匹配 | `render_orchestrator.cpp` 在已有 sourceImpls 的外循环中收集 LayerRenderItem；缺源层不匹配，updateList 初始false | 本轮缺源层无新 RenderItem；不能单凭此证明旧 group 已移出 registry |
+| renderability 更新 | 每次 source 更新后比较 isLayerRenderable 与 updateList，调用 markLayerRenderable | 有 source 的正常 Full 能排队停用；所有 sources 为空时此循环不执行，不能推广为任意状态的清理保证 |
+| RenderLayer::markLayerRenderable | 更新 CPU bool；activateLayerGroup 创建 Add/RemoveLayerGroupRequest | bool=false 不是 request 已执行的证明；该方法没有清除 drawables、renderTilesOwner、placementData |
+| RenderSymbolLayer 停用 | 同时为普通 group 与 collisionTileLayerGroup 排队停用 | 需覆盖两类 group；不能仅数普通 RenderItems |
+| layerRemoved | RenderLayer 调用虚方法 removeAllDrawables；Symbol 的实现清除两类 group 的 drawable，然后停用 | 删除 Layer 与缺源导致不 renderable 的生命周期不同，不能互相替代 |
+| processChanges | 移动 pendingChanges 后逐个 execute，RemoveLayerGroupRequest 删除对应 registry entry | 删除 registry 不等于销毁 Layer 所持 group/bucket/atlas；指针仍可能持有旧数据 |
+| Renderer Full | tree.prepare → source/layer upload → updateLayers → processChanges → cache评估 → tweakers/group upload → Build/live draw → present/endFrame | Cache 评估位于处理 changes 之后，但此前没有生成覆盖旧数据与成功提交的零贡献证书 |
+| Cache Build | R 使用 orchestrator 的 layer group range 双 pass；没有只遍历新 LayerRenderItem | 缺源层无 RenderItem不等于range里无旧group；需要独立registry与层身份审计 |
+
+本轮实际读取 `render_layer.hpp/.cpp`、`render_symbol_layer.hpp/.cpp`、`change_request.cpp`、`render_orchestrator.hpp/.cpp`、`render_tree.hpp`、`renderer.cpp`、`renderer_impl.cpp`、`retained_underlay_cache.hpp/.cpp`。当前 src/include 中未找到名为 ResourceManager 的类；实际资源所有者是 gfx Context/backend、RetainedUnderlayCache 的 offscreen/composite、LayerGroup/Drawable 与 RenderTile bucket/atlas，以及 DynamicTextureAtlas/ImageManager/GlyphManager。GL 的 `Texture2DPool`（`src/mln/gl/resource_pool.hpp`）管理纹理复用，不提供“某个缺源层本帧零绘制”的语义证书。
+
+**限定的正向事实**：新加载且从未获得 source 的 tide-spots，没有匹配 RenderItem；新 RenderLayer 默认 isRenderable=false。**仍缺的事实**：原设备 JSON 没有 per-layer registry identity、两类 group 的已执行停用、旧 drawables/tiles/placementData 清空和成功 Full 提交代次。不能从其他 sources 已 Loaded、cache textureCreate=0 或 pending-changes Gate=PASS 推出这些条件全部成立。尤其 task 要求“无旧 Renderable 数据”，单纯停用并不满足它。
+
+### 3.3 失效链已存在，但不存在缺源的受控依赖状态
+
+`retainedSegmentSourceState` 在读 revision 前要求每个 sourceId 存在；缺失即返回 ready=false/stable=false/revision=0/reason=missing-source。renderSegmentDependencies 从完整层表收集 source 和 Symbol 全局前提，不因隐藏/空桶删依赖。RevisionBook 没有为从未出现的 tide 登记；删除墓碑可保留，但不代表当前 source 存在或 loaded。
+
+`sourceDiff.added/removed/changed` 增加 content revision 与对应 source revision，先删/建 RenderSource，再 update。同名同类型但 immutable Impl 改变属于 changed。Fast 的 non-camera signature 比较 immutable sources 身份，下一帧在 createRenderTree 之前拒绝旧输入；已有 PreparedTree 在 Full 创建前释放。异步 onTileChanged 增加全局 content 和局部 source revision并 invalidate。Image/Glyph/Style/Context 的全局 epoch、层身份 fingerprint、camera/viewport key也各自保留。
+
+因此“同名 source 出现后可拒绝旧 Fast”的机制已有源码依据；**不能由此反推不存在的 source 可合法登记成 loaded/stable/零 revision**。新的缺源状态需要绑定 source absent identity、完整层集合、应用后 registry/旧对象状态和成功绘制代次；source 出现、替换、异步 layout、context改变必须撤销它。当前没有这些存储和核验，不实施空依赖准入。
+
+## 4. Symbol 首次 Build 的安全根因
+
+### 4.1 两个 Full 分支和第二重 scene 锁
+
+`PlacementController::placementIsRecent` 按 commitTime+updatePeriod 判断；transitions关闭则总返回false。Continuous `createRenderTree`：
+
+1. 不 recent：placementChanged=true；Placement::create → placeLayers → commit；setPlacement 清 stale，CrossTileSymbolIndex prune 与 source fading 更新。
+2. recent：placementChanged=false；setPlacementStale；controller.hasTransitions 在 enabled 时优先因 stale 返回true。
+
+`renderSegmentPlacementGatePassed` 对结构性 Symbol 要求 `!changed && fade==0 && !controllerTransition`。每个分支至少违反一项。关闭 transitions 时 Full 为 true/1/false；duration=0但enable=true时fade=1，recent分支仍stale。等待更久、改300/30ms阈值或关闭fade无法提供证书。
+
+`renderer_impl.cpp` 还有独立保护：retainedPlacementStable、retainedStaticStable、retainedSupported，以及 `particlePreparedSceneSupported=retainedSupported && fastContinuousSupported`。只放宽 per-R Gate不会使 #23 安全通过；只放宽 #13也不能自举 Build。Fast 成功后 prepareParticleFastFrame 才重置树的 changed/fade；调用它来准备第一次 Build会循环假定尚不存在的安全证据。
+
+### 4.2 CPU 结果不等于最终 GPU 输入
+
+读 `placement.cpp::commit/updateLayerBuckets/updateBucketOpacities/updateBucketDynamicAttributeData`、CrossTileSymbolIndex、SymbolBucket::updateVertices、SymbolLayerTweaker 与 DrawableAtlasesTweaker，以及 GL/Metal symbol shader：
+
+- commit 以每个 crossTileID 的 text/icon placed 状态更新 opacity；显隐未变可继承旧 fadeStartTime。controller transition=false不等于所有桶在GPU中已上传或与旧帧等价。
+- RenderTreeImpl::prepare 更新 bucket opacity/dynamic data；SymbolBucket 将 uploaded、placementChangesUploaded、dynamicUploaded 标记为false。SymbolBucket::upload 的标记不是成功GPU Drawn R的证书。
+- opacity处理 duplicate、默认allow-overlap、justReloaded、variable anchors、orientation、text/icon配对；沿线重投影与camera相关。碰撞为全局 Placement，并可能跨 source/段产生依赖。
+- shader实际使用 `clamp(baseOpacity ± symbolFadeChange,0,1)`，再乘paint opacity。fade=0既可能为全透明新符号，也可能为已显示符号；fade非零也可能因clamp不再改变像素。用==0或>=1替代逐输入等价均不足。
+- LayerTweaker 还使用tile/label/coord矩阵、size binders、paint插值、纹理尺寸与shader变体；DrawableAtlasesTweaker绑定glyph/icon atlas和sampler。
+- retainedRangeContentFingerprint 只散列 layer.baseImpl 指针与index；它不包含 placement结果、opacity buffer、bucket身份、atlas纹理、uniform最终值。Source revision也不替代这些内容。
+- Build成功计数来自双pass编码无捕获异常、finishBuild与markBuildSucceeded；随后主buffer present提交。现有实现没有完整的 per-R GPU输入证书或设备completion fence记录。将编码成功说成GPU执行完毕属于证据越界。
+
+### 4.3 可继续的设计边界与反例
+
+| 候选条件 | 反例 / 缺少的证明 |
+|---|---|
+| source loaded、无手势、静止90秒 | changed/stale循环继续；异步glyph/tile/image可改变结果 |
+| Placement placed布尔相同 | opacity方向/基值、duplicate、anchor/orientation或dynamic vertices可不同 |
+| fade=0且controller=false | 实测15帧changed=true，Build仍拒绝；刚出现符号可能base opacity=0 |
+| 当前 RenderItems 为空 | 旧group可能仍在registry或旧数据留在RenderLayer；pending请求可能未执行 |
+| layer fingerprint/source revision相同 | 不能区分同桶的dynamic opacity/atlas/uniform变化 |
+| 两张末态截图看起来相同 | 未捕获变更瞬间、碰撞受害段及GPU提交代次，不能建立持续复用不变量 |
+
+待证明证书至少应覆盖：R层身份/层序和drawable集合；bucket/tiles/crossTileID及跨段碰撞结果；text/icon显隐、opacity方向/基值、dynamic vertices、沿线/variable placement；paint/layout revision；glyph/image/atlas/shader/uniform版本；projection/camera/viewport/pixelRatio；context generation；已应用ChangeRequests及异步content epoch。只能在正常Full完成prepare/upload/tweakers、真实Build成功提交且资源一致时绑定，任何不一致先Full+invalidate/rebuild。不能只加入一个“结果稳定”bool。
+
+这涉及 Placement→Bucket→Drawable/Atlas→Renderer提交生命周期的跨层实现，当前没有足够设备/图像证据保证安全。本轮停止该准入实现，不删或强制置假 placementChanged、symbolFadeChange、controllerTransition，不改24Gate。
+
+## 5. 七项测试源码及真实覆盖限制
+
+两个既有 test/CMakeLists.txt 已登记的测试文件内新增 `Step117Safety.*`，无需改构建表，全部 NOT RUN：
+
+| 用例 | 实际测试目标 | 不覆盖的事实 |
+|---|---|---|
+| RealPlacementControllerHasNoFirstSymbolBuildWindow | 用实际Controller/Placement::create/placeLayers/commit执行120个逻辑时刻；两个分支均fallback，Build/Reuse为0 | 空桶生命周期最小复现，无原PBF碰撞/GPU |
+| RealPlacementDisabledOrZeroDurationIsNotAResultCertificate | 实际enable=false与duration=0/enable=true，fade=1、stale行为继续保护 | 没有禁用生产fade |
+| MissingAndSameNameRestorationCannotReuseAnOldCache | 缺源→创建→状态机构建/复用→删除墓碑→同名恢复必须新Build | 模拟status与markBuildSucceeded仅为cache状态机，无GPU成功 |
+| CameraStyleAnnotationAndContextRequireRebuildBeforeReuse | camera/viewport/content/topology/config变化经过实际revision tracker和cache，使旧cache无效且#3/#4失败 | epoch输入是模拟，未触发真实Annotation/camera设备事件 |
+| RealMissingSourceTreeHasNoRenderItemButStillFailsClosed | 真实createRenderTree：缺源Symbol零RenderItem/零group仍missing-source；实际sourceDiff创建、同名替换、移除；layer fingerprint保持不变而revision变化 | 使用step117-source无数据GeoJSON测试对象，未改生产tide；无旧GPU对象场景 |
+| QueuedGroupRemovalIsNotAppliedUntilProcessChanges | 两个测试group实际进入registry，真实Remove请求入队前后遍历差异与pending变化 | 测试group代表两类生命周期，不是实际Symbol collision group或GPU Draw |
+| RealAsyncCallbacksAndContextStyleCleanupAdvanceContentEpoch | 实际Tile/Glyph/Image observer分派、markContextLost/clearData推进content epoch；旧content输入单独命中#5 | 事件在测试线程注入，无实际网络并发/完整Renderer/设备 |
+
+未新增Jest，未编译或运行这些测试。生产 src/include、所有Gate/计数、Android场景和63层零修改。既有Annotations.Step116图像用例保留；新测试不代替glyph/tile并发、跨段collision、old GPU drawable清理或Full/Fast像素验证。
+
+## 6. 具体阻塞与协调需求
+
+| 编号 | 无法继续的状态 | 应由谁处理 / 需要的产出 |
+|---|---|---|
+| B1 缺源零贡献 | 当前只有absent Source与新RenderItem缺席；无应用后双group/旧drawable数据/提交世代证书；revision=0不能登记为有效 | Shared Core制定absent依赖内部状态及销毁/禁用证书；Android/Metal分别验证初始缺源、曾有旧数据、合法Style替换、同名恢复 |
+| B2 Symbol首次Build | 重算changed、recent stale；所有可达Full状态都不满足现有准入；无最终GPU结果等价/时间不变证书 | Shared Core提供跨层结果证书设计与影子比较实现任务；先影子不放行，证明后才讨论受控准入；粒子负责人组织双平台审查 |
+| B3 正式tide语义 | 生产Style宣告tide-spots但sources不含tide；本仓库不能自行补业务数据、改服务器或删层 | Integration协调NavSea/Style所有者明确是否属于合法宿主动态注入、何时提供真实source及身份；改变公共缺源语义才走RFC/ADR，纯内部优化不强制新Contract |
+| B4 独立验证 | 本轮没有Native编译、测试或设备新证据；STEP116历史Mac配置缺libuv | RDC复核当前环境、执行定向测试，首错保留；用户明确授权后由RDC/普通Terminal集中Android验收 |
+
+B1/B2应形成具体设计/实现任务，不通过业务开关、假tide、删Symbol、改24Gate或STEP114烟测绕过。Integration是协调入口，本轮不向他人发消息、不写跨仓文件。当前代码阶段止于测试和证据交付；详见STEP117验收计划。原目标 Build>0、Reuse>0、FastDelta>0仍未完成。

docs/20_调查/STEP-119_Symbol结果证书与R缓存Build实现依据_v1.md

@@ -0,0 +1,77 @@
+# STEP-119 Symbol结果证书与R缓存Build实现依据 v1
+
+日期：2026-10-11（JST）。状态：IMPLEMENTED_WAITING_ANDROID；Shared Core已有实质实现，尚无本轮编译、GPU、Android或视觉验收结论。
+
+## 1. 基线与原证据
+
+仓库 `/Users/tei/dev/MapLibreParticleLab`，Mac.lan / Darwin24.6.0 / x86_64，particle/main@869930046b11dbeb3b147e3be952a2e847316292。Native版本13.6.1-particle.23。Integration本地只读HEAD=80667d6c343411d03a760425438e3d292f452118；已读取AGENTS、instructions、README、WORKFLOW、TEAM_MODEL和contracts/rfc/adr/status/compatibility，未写跨仓文件。纯Renderer内部优化，不新增公共接口、所有权或错误协议；C-001/C-002和Core-owned timeline/playback保持。
+
+STEP117揭示：Continuous重新计算令placementChanged=true；recent复用设置stale，hasTransitions=true。旧Symbol gate要求changed=false、fade=0、transition=false，两个分支都不能自举。global retainedPlacementStable、retainedStaticStable、retainedSupported、preparedSceneSupported还有独立阻断。
+
+STEP118保留原63基础层manifest，仅测试副本排除tide-spots：62基础层+2天气层，Native64，R[0,62)、C[62,64)，missingSourceIds=[]，static-placement、Build0/Reuse0。旧设备90.00806697399821秒FastDelta0/FullDelta942、decisionMismatch0，不是本轮结果。
+
+旧APK源码3051196054c7b69815c298040dae61d26499d9f2，SHA=44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9。旧result.json SHA=d3d20fc35bbd17e9f0ea0dd014ca4af8e0c5c5284d9f0c009bc20981d876ff10；screen.png SHA=c8b57a8432626c9209ca9a614a747728d4256bd09273b28c26a793a75a6d44d4。本轮只读解析/核对，文件未修改。
+
+## 2. 实际渲染生命周期
+
+1. 正常Full先createRenderTree：Source/style差分、跨瓦片ID匹配、全场Placement碰撞与commit继续使用原实现，没有按R段拆碰撞或冻结新结果。
+2. RenderTreeImpl::prepare调用Placement::updateLayerBuckets，继续处理text/icon、重复符号、variable anchors、方向、opacity、动态顶点、沿线投影和排序。
+3. Renderer依次上传source/layer/atlas，updateLayers创建或更新Drawable，processChanges实际应用注册/移除队列。
+4. 所有正常Full LayerGroup先runTweakers并upload。SymbolLayerTweaker记录**同一份传给GPU的**evaluated props、drawable/tile UBO字段；记录frameCount，并确认evaluated/drawable/tile UBO存在和consolidated容量，未执行、出错、缺buffer或错误帧不能补证。
+5. 此后采集每R的原生Symbol绘制输入，与上一成功提交Full的证据精确比较。符合就准入首次Build，不依赖已有缓存。
+6. Build保持原双pass和原始全局ordinal；finishBuild后再检查输入未改变。资源/绘制错误走Fallback；实际主缓冲按原R/C层序composite或live绘制。
+7. present和endFrame成功返回之后再次检查输入、epoch及错误代次，才记录完成Full/Build证书。它证明成功编码和提交，不宣称GPU fence完成或像素等价已经测量。
+8. 后续一次正常Full Reuse成功提交后，才允许Fast。Fast使用相同证书版本、content/topology/config、相机、backend viewport、pixelRatio和crossSourceCollisions，并继续原24项Gate。
+
+普通Full替换旧prepared tree时只销毁引用式RenderItem；证据拥有复制的字节和必要资源引用，跨Full保留。style/context/显式prepared-tree reset仍清证书。symbolCompletedSignature独立保存上一Full的非相机输入，防止glyphURL/fontFaces/placement设置等在旧树销毁后丢失保护。
+
+## 3. 结果证据包含什么
+
+| 实际输入 | 采集与保护 |
+|---|---|
+| Symbol uniforms | 从SymbolLayerTweaker实际提交的CPU参数复制；包含paint颜色/透明度/halo、tile/label/coord矩阵、尺寸/插值、gamma、text/icon/halo标志；忽略SymbolDrawableUBO末尾12字节非shader padding |
+| 顶点与实例属性 | 对实际Drawable绑定的VertexAttributeArray/InstanceAttributeArray记录属性索引、类型、stride、offset、vertexOffset和共享原始字节；包含静态布局、动态位置/角度、opacity、data-driven paint、排序实例；共享属性必须已有GPU背板，索引必须已上传且非dirty |
+| 已释放的不可变buffer | 只在producer已release且存在GPU backing时用保持存活的对象/背板身份；不能读取的可变输入拒绝。不是把任意空数据当相等 |
+| text/icon/索引与排序 | 原生SymbolBucket对应text/icon/sdfIcon buffer、segment范围、instance/vertex/index长度、sortKey；两条路径均记录实际三角索引字节，release后必须保持不可变索引对象与GPU背板身份；instancing固定quad和segment仍核对 |
+| fade | 检查每个实际opacity顶点的packed值及当帧fade；必须在放置目标方向达到shader clamp终点，并且真实Placement fade已结束；非有限值、负值、非整数或越界packed值拒绝 |
+| atlas/texture/sampler | 保持atlas、glyph/icon及实际绑定纹理/原生atlas tweaker身份，核对尺寸/format、上传状态和实际绑定一致。原生tweaker的sampler策略由固定bucket/layout和相同camera/无手势状态决定；glyph/icon像素原地更新由既有全局epoch保护 |
+| shader | 独立provenance记录只在实际GL/Metal编译源码与原生Symbol源码完全相符、额外宏属于原生uniform白名单时登记；保留shader对象身份。名称相同的未知/替换shader不借用fade契约 |
+| LayerGroup/层序 | processChanges之后验证Symbol组确实注册，隐藏层无旧注册组，collision额外组或陌生组拒绝；记录全局group总数、原始ordinal、组身份/层索引/数量/enable，以及Drawable实际混合方程/因子/颜色mask、剔除/深度/3D状态。全局depth range与跨段排序因此参与证据 |
+| 版本与生命周期 | 精确结果revision、成功Build revision、成功Reuse状态；绑定content/topology/config、camera矩阵、viewport、pixelRatio、crossSourceCollisions；原update signature/SourceRevisionBook/Annotation Gate继续使用 |
+
+每个结果字节缓冲上限16MiB，超限拒绝证书；没有提高公共容量或假装完整证明。资源引用避免地址ABA；比较对象是字节序列而不是散列。既有segment cache revision组合仍保留，但Fast还直接核对证书状态，不能靠组合散列碰撞取得证书；Full Reuse也要求candidateHasBuild精确版本，缺匹配Build时显式invalidate旧Cache，再走Build。
+
+## 4. Placement与fade语义
+
+没有修改placementIsRecent、setPlacementStale、原hasTransitions、commit/fadeStartTime、updatePeriod或placement计算频率。原hasTransitions仍用于正常renderer请求刷新。新增内部hasActiveSymbolFade仅表示实际fade；retainedRangeIsStable、retainedSegmentIsStable、retainedPlacementTransitionActive和Fast动态输入改用它。
+
+GL三个原生Symbol vertex shader和Metal symbol.hpp三类shader均使用unpack后的base opacity加/减fadeChange并clamp到[0,1]。>=1在合法packed值上足以达到fade终点，但不能证明顶点、uniform、atlas或层序相同。因此没有单独用>=1放行，而是逐opacity检查+完整结果比较+提交代次。
+
+重算仍令placementChanged=true，诊断继续如实记录；它不再被当成最终GPU输入改变。recent/stale仍请求刷新，不能单独代表正在fade。Fast rebase保留被证书确认的Full fade值，不把它清为0来取得准入。
+
+## 5. 完整准入与失效
+
+首次Build路径：已完成Full证据 → 下一Full同绑定同输入且已settled → Build编码成功 → present/endFrame及复核 → Build证书。Reuse/Fast路径：同版本缓存 → 正常Full Reuse成功提交 → 原24Gate全部通过 → Fast。preparedSceneSupported与global/perSegment稳定性均使用同一结果证明，不存在只改perSegment条件的旁路。
+
+以下继续fail-closed：missing Source、CustomMVTVector未知revision、tile fading、未loaded style/sprite/image manager、paint/light transition、非粒子repaint、3D/debug/非continuous、不支持C、Annotation pending、相机/viewport/pixelRatio/非相机参数、异步content或pending changes、资源/编译/上传/绘制错误、未知placement-capable类型或shader（Symbol原生typeInfo指针必须匹配，名称相同不足以强制转换）、证据超限/不可读取。
+
+Glyph requested/error/loaded、Tile error/changed、Symbol error新增或保持epoch推进；Image missing/remove/update、Source差分、Context reset、Style clear沿用原保护。捕获到的renderer/registry错误推进错误代次与全局content epoch；逃出上传/编码/present的异常由Renderer外围捕获，清prepared/证书、失效所有旧Cache后原样抛出；证书不能使用失败更新的旧Drawables。Build前和成功提交后都有epoch复核，证据观察期间的变化拒绝完成证书。
+
+现有回调/registry操作运行在renderer调度线程；content revision是原有atomic。此优化不建立后台并发访问Drawable的通道，不改变callback线程合同。真正跨线程竞态仍需RDC平台实测。
+
+## 6. 反例与保守限制
+
+- 同placed布尔但variable anchor/角度/opacity不同：实际属性字节变化，revision递增，重新Full取证。
+- controller不fade但尚未上传/陌生shader/atlas未绑定：complete=false，拒绝证书。
+- glyph/icon纹理指针不变但内容更新：content epoch变化，旧Build/ReUse证书失配。
+- Source同名替换、原63层缺tide：SourceRevisionBook/loaded/缺源保护仍拒绝，不能借空RenderItem作零贡献证明。
+- 下方段删除group导致上方R ordinal/depth改变：全局group数量/ordinal证据变化，上方R不得复用旧结果。
+- Build存在但没有成功Full Reuse：canFast=false；失败/未完成的Full不能刷新成功提交证据。
+- Vulkan/WebGPU目前没有本轮原生shader provenance登记，Symbol结果证书保守拒绝；它们的普通Full渲染不变。本轮不宣称跨后端运行通过，也不以GL代替Metal验证。
+- 16MiB上限、非常大的PBF、持续Glyph/Tile更新、不同native实例buffer生命周期均可能继续阻止Build；须保留真实结果修复，不能提高测试阈值制造PASS。
+
+## 7. 测试与待证事实
+
+新增13项Step119SymbolResults，位于已登记的两个test/renderer文件。覆盖真实Controller lifecycle+SymbolBucket opacity/dynamic buffer、packed clamp反例、variable位置/角度、camera/viewport/pixelRatio、CollisionGroups、真实uniform/wrapped tile编码、未知shader、失败提交、Annotation与24Gate、真实Tile/Glyph/Image/Context/Style回调、Source同名替换/缺失和跨段registry移除。
+
+所有新增测试NOT COMPILED/NOT RUN。部分Build标记和字节payload是状态机fixture，绝不称真实GPU等价；现有CrossTileSymbolLayerIndex和Annotations图像测试必须由RDC一并验证。原PBF跨段collision、实际Glyph/Atlas延迟、Full/Fast图像、真实Build/Reuse/Fast和性能仍全部待独立验收。源码去除逻辑自举死锁，不承诺本机实机目标已实现。

docs/40_任务/STEP-110_R0_Placement跨段归因只读调查_Codex任务_v1.md

@@ -0,0 +1,161 @@
+# STEP-110 R0 Placement 跨段归因与缓存安全边界只读调查 — Codex 任务 v1
+
+## 一、任务性质与核心问题
+
+**性质：Particle Native / Shared Core 专项，只读调查；不实现、不修复、不编译、不上机。**
+
+用户要求粒子项目独立回答：
+
+> Native 能否区分“R0 自己的 Placement 变化”和“其他 RenderSegment 引起的 Placement 变化”？如果能区分，是否足以在**不破坏 Symbol 碰撞、文字/图标位置及图层顺序**的条件下让未变化的 R0 复用缓存？
+
+必须把以下不同概念分开审查：
+1. **事件来源**：哪个 source/layer/segment 引发了 placement/repaint/revision；
+2. **实际影响范围**：全局碰撞计算是否使 R0 的 Symbol 位置、可见性、fade 或绘制结果改变；
+3. **缓存安全判据**：能否证明 R0 内容/Placement 仍与已缓存画面等价；
+4. **当前实现**：上述信息目前是否已有、是否按 Segment 使用、还是仅采用全局保守 Gate。
+
+禁止预设“全局 Placement 变化一定是 Bug”，也禁止以“R0 自己没有提交数据”直接推导“R0 视觉必然没有变化”。
+
+## 二、仓库、版本与事实优先级
+
+- 项目：`/Users/tei/dev/MapLibreParticleLab`，正式分支 `particle/main`、远端 `origin/particle/main`。
+- 创建任务时只读确认：`particle/main` HEAD `2df504cdc0403bdad85d3f31f16fd54a8744abac`、干净工作树。执行时必须**重新读取 Git 实际状态**，不得把此 HEAD 当作永恒基线。
+- NavSea 产品实机所用 APK 内 `assets/component-manifest.json` 记录：RN / Android Native AAR `13.6.1-particle.23`。V23 正式来源对应 `refs/tags/maplibre-particle/rn/13.6.1-particle.23`、GSRL Git commit `87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`。
+- **必须分别标明 V23 发布源码与当前 `particle/main` 的事实**。如当前 main 有未发行后续改动，不能以 main 代替 V23，不能以 V23 APK 推断未发行修复已经生效。
+- 跨项目事实遵循 `D:\React\navsea-particle-integration\instructions\NAVSEA_PROJECT_INSTRUCTIONS.md` 及最新 COORD / RFC / ADR / Contract / Status；当前既有外部契约 C-001。此任务不新增/更改公共 API 或契约。
+- 粒子项目根 `AGENTS.md`、`PARTICLE_BASELINE.md`、`docs/00_项目规范/`、`docs/00_项目总则/README.md` 与四份有效总则必须先读，按当前项目事实处理过时的历史环境/发布坐标。
+- 必读既有证据：STEP-088、089、090、092、094、099、100、102、106、108、109；重点对比 STEP-090 早期缓存/快路成功条件、STEP-102 placement-free 分段隔离范围、STEP-106 T1/T2 Symbol 与 Annotation 边界的真实验收。
+
+## 三、来自 NavSea 的问题证据（仅作为输入，不由本任务修改 NavSea）
+
+FZG1-2 / Android 13 / V23 当前 APK，NavSea 采用**两段 R-C**：
+
+- R0：RETAINED，31 层，`background` 至 `place-labels-land-ja`，包含有 Placement 能力的 Symbol；
+- C1：CONTINUOUS，82 层，`rn-weather-color` 至 `chartDangerScanCenterLineLayer`，包含天气/粒子和其他业务层。
+
+固定同一风场、同一 map 生命周期，连续约 15.24 秒，`mapReactTag=864`、`generation=4`、`configRevision=1`、`topologyRevision=8`、113 层均不变：
+- 风场期间进程 CPU 样本均值约 98.6% / 99.1%，关闭天气后约 4%～8%；
+- `fastPathHit Δ0`、`fastPathMiss Δ452`、`fullCpuFrame Δ453`；
+- R0 `build Δ0`、`reuse Δ0`、`invalidation Δ453`、`fallbackCount Δ453`、texture/composite create `Δ0`；
+- 两端 `valid=true`、`fallback=false`、`sourceReady=true`、`sourceStable=true`、`placementChanged=true`、`placementGatePassed=false`、`cache.supported=false`、`cacheState=fallback`、`lastInvalidationReason=static-placement`；
+- `mainBufferExecutionMode=mixed`、`globalLiveFallbackReason=none`、`fastPathFallbackReason=cache-invalid`。
+
+**这些是症状，不代表已证明 C1 导致 R0 Placement 改变。** 此外，历史较早的 V23 短时快照曾观察到 `placementChanged=false` 但 R0 记录仍为 `static-placement`，需要区分“当前门槛值”和“上次失效原因/诊断时序”，避免误读。
+
+Mac 粒子团队如无法访问 Windows 原始快照，可依据上述冻结事实做 Native 只读审计；缺失证据须列为“需要后续验证”，不得自行编造 NavSea 图层或运行结果。
+
+## 四、必须回答的调查问题
+
+### Q1：Placement 的产生与传播
+
+从真实 V23 Native 代码绘制完整的因果链：
+- 触发 RenderTree / Placement 计算的入口与时机是什么？
+- `placementChanged`、`symbolFadeChange`、`placementTransitionActive`、`crossSourceCollisions` 分别表示**当前帧/上帧/全局/局部**的什么事实？何时清零或稳定？
+- Source/Layer 的 layout、tile、visibility、camera、animation 等变化，分别可能影响哪些 Placement 状态？
+- R0 以外的 C1 Symbol/Annotation/业务层变化，**在哪些条件下**可能影响 R0 的符号碰撞与最终视觉？
+- 如果 RenderTree 每次都重新算 Placement 但画面没有变化，如何区分“执行过计算”和“R0 最终结果发生变化”？
+
+### Q2：现有 R0 Gate 的作用域
+
+调查 V23 实际调用链及数据结构，至少解释：
+- R0 结构性 `placementCapable` 如何判定，与动态 `needsPlacement()` 有何区别；
+- R0 `placementGatePassed` 如何使用全局 `placementChanged`、fade、transition；
+- R0 `cache.supported`、`static-placement`、`actualExecution=live` 的完整因果关系；
+- R0 的 source-local mutation、segment fingerprint、retained revision 与 placement gate 是否真正各自独立；
+- STEP-102 对 **placement-free** R 的隔离已解决什么、**placement-bearing** R 仍未解决什么；
+- `lastInvalidationReason` 与当前失败条件是否可能属于不同采样/缓存生命周期。
+
+### Q3：能否证明“R0 不受 C1 变化影响”
+
+针对以下反事实场景逐项作出有证据的判断：
+1. R0 含静态地名，C1 只有普通非 Symbol 动画/颜色/粒子更新；
+2. R0 含静态地名，C1 的 Symbol 内容变化，但不同 Source 且跨源碰撞关闭；
+3. R0 含静态地名，C1 的 Symbol 内容变化且跨源碰撞开启；
+4. R0 Symbol 自身 layout/tile/visibility/zoom 发生变化；
+5. Camera/pan/zoom/rotation/pitch 变化；
+6. Symbol Fade/Placement Transition 活跃或刚结束；
+7. C1 有内部自动插入的 Annotation Symbol（参照 STEP-106）。
+
+每行必须分别给出：
+- “谁触发 Placement”能否识别；
+- “R0 最终 Placement/可见性是否改变”能否独立证明；
+- **允许 R0 Reuse 的必要安全条件**；
+- 当前 V23 是否具备这种判定能力及证据来源；
+- 无法证明时为什么必须继续 fail-closed。
+
+严禁把“不同 Segment”简单等同于“碰撞和 Placement 相互独立”。
+
+### Q4：对 Fast Path 的影响（仅限前置依赖）
+
+解释“R0 缓存有效”是否为 Fast Path 的必要条件但**非充分条件**。只读标出 R0 Gate 与单 C / unsupported continuous layer / revision / pending changes 等后续 Gate 的先后关系。不要扩大成 C1 全图层性能调查，不实施多 C 优化。
+
+## 五、只读检查范围与方法
+
+允许读取：
+- 当前 Particle Core 的 Renderer、RenderOrchestrator、PlacementController、RenderTree、Symbol/Collision、Retained Cache、RenderSegment Plan、Diagnostics 与 Fast Path 相关源码；
+- V23 tag 与当前 `particle/main` 的只读 `git show`、`git diff`、`git log`；
+- STEP-090/102/106 等历史设计、报告、设备验证结果；
+- 现有 C++ 定向测试源码与 Validation 场景源码（只读，不执行、不修改）。
+
+建议从当前实际路径 `src/mln/renderer/` 与相关 Shared Core 源码定位，**不得沿用旧 STEP 中过时的路径假设**。
+
+每一条重要结论必须给出：**文件路径 + 类/函数或结构名称 + 适当行范围或 commit + 相关调用顺序**。核心论断不得只引用历史文档或本任务描述。
+
+允许纯只读 Git/文本搜索，不要求也不允许额外建立实验分支、修改 Native/JS/Kotlin/测试代码、插桩、添加日志、运行 Jest、运行测试、Gradle、CMake/Ninja/Bazel、ADB 或重新安装 App。不得改 NavSea、Integration 或正式 release/tag。
+
+## 六、最终必须提供的结论矩阵
+
+**每个问题必须选择明确判定**，而不是只罗列建议：
+
+| 维度 | 可选结论 |
+|---|---|
+| 能否定位 Placement 事件来源 | 现有数据可区分 / 现有数据不足 / 条件性可区分 |
+| 能否证明 R0 的实际视觉结果未变化 | 已能证明 / 需扩展内部安全证据 / 不能按段安全证明 |
+| 现有 Gate 是什么性质 | 正确的设计保守限制 / 明确可证的过度阻塞 Bug / 混合 / 证据不足 |
+| 缓存失效的主要责任边界 | Native Placement 数据模型 / Native Gate 判定 / 当前跨段碰撞语义 / Host Style 组合 / 多因素 / 未确定 |
+| 可选后续方向 | 无需代码调整 / Native 内部诊断补强 / Native 内部安全判据设计 / 宿主层序方案需协调 / 需真机对照实验 |
+
+如果判断是 Bug，必须指出**违背了哪项既有语义/可复现的状态不变量**；如果判断是安全限制，必须指出**缺少何种证明才不能放宽**。如有多个阻塞项，按必要性和因果顺序排序，避免“修第一个之后才继续猜下一个”。
+
+## 七、报告与交接产物
+
+只允许新建/更新以下本 Step 文档（不改现有源码）：
+
+1. `docs/20_调查/R0_Placement跨段归因与缓存安全边界调查_v1.md`（主报告）；
+2. `docs/50_Step记录/STEP-110_R0_Placement跨段归因只读调查_v1.md`（状态及完成项）；
+3. `docs/报告/STEP-110_R0_Placement跨段归因只读调查_Codex完成报告_v1.md`（执行报告）；
+4. `粒子开发记录.md`（简短追加式记录）。
+
+调查主报告必备章节：
+- V23 tag / 当前 main 基线对照，说明是否有相关行为变化；
+- Q1～Q4 的逐条答案及代码证据；
+- **数据流/状态流**：Placement 事件 → 全局/局部状态 → R0 安全判定 → Cache Build/Reuse/Fallback → Fast Path；
+- 七类反事实场景矩阵，明确跨源碰撞、Fade、Annotation 的影响；
+- 已确定事实、假设、证据不足之处三栏；
+- 结论矩阵、根因优先级、最小下一步验证建议；
+- 若需调整公共 Contract / API，则仅提出 Integration 阻塞，不自行实施。
+
+完成报告必须逐项按“**已完成 / 未完成 / 无法验证**”回答任务项并说明原因；记录实际检查范围、当前 branch/HEAD、Git 提交及推送信息。不得用“源码已读”代替代码证据。
+
+**状态判定**：只读因果审计证据完整才可标为 `调查 PASS（不等于修复 PASS）`；否则 `PARTIAL/BLOCKED` 并列出缺失项。严禁声称“Native 已修复”、“R0 已缓存”或“CPU 已下降”。
+
+## 八、Git 收尾与执行界限
+
+- 本任务**只负责调查**。Codex/粒子项目未经用户后续明确授权，不得实施任何缓存、Placement、Fast Path 逻辑修改。
+- 完成相关文档后，仅提交本 Step 新增报告、Step 记录及追加的开发记录；保留所有无关 dirty/untracked 文件，不得强制清理。
+- 将本任务相关文档 scoped commit 到正式主线 `particle/main` 并 push 到公开远端 `origin/particle/main`。禁止 force push、改写历史、推送 upstream 或增加无关文件。
+- 完成报告必须给出**实际 commit hash、commit message、push 结果、远端分支**；push 失败不得宣称完成，应明确报告阻塞。
+- 本 MD 是交给粒子项目执行的**待办合同**。写入任务书本身不代表调查已执行、已验证或已得出结论。
+- 本任务不包含 Jest，不涉及原生编译、测试执行或 Android 设备操作。
+
+## 九、停止条件
+
+遇到以下情形须停留在调查层，提交 PARTIAL/BLOCKED 事实，不得扩大实现：
+1. V23 tag 与当前代码差异导致无法确认实际执行版本；
+2. Placement 影响关系必须依赖运行时数据，静态源码无法证明；
+3. 证明缓存安全需新增 per-segment collision/placement fingerprint 或改写 Core 算法；
+4. 需要改变对外 Native/RN 公共接口或跨项目责任；
+5. 需要 NavSea 配合修改 Style、增加调试或重新编译/测试；
+6. 所需证据缺失或与 STEP-090/102/106 的历史结论相冲突。
+
+出现以上情况，在报告中给出**最小下一步任务建议**，等待用户/Integration 决定；不得在本任务中直接实施。

docs/40_任务/STEP-111_R段Placement结果等价与独立刷新可行性只读调查_Codex任务_v1.md

@@ -0,0 +1,41 @@
+# STEP-111 R 段 Placement 结果等价与独立刷新可行性只读调查 — Codex 任务 v1
+
+## 一、用户目标
+用户希望 Native 对 R-C-R-C-R-C（简称 RCRCRC）中的每一个 RETAINED R 段单独决定是否更新。若该段本身最终视觉输出未变化，不应仅因另一段 Symbol/Placement/Fade 全局状态更新而被动重建；确实受跨段碰撞影响的 R 段必须正确更新，不能破坏文字、图标或层序。此任务是下一步架构/可实现性调查，不是授权实施优化。
+
+**核心区别**：A. 哪个 Layer/Source/Segment 触发重新计算；B. 全图 Placement 后每一个 R 段的最终 Symbol 视觉结果是否改变；C. Retained R 段缓存能否安全复用；D. 是否可进一步省略 R 段 prepare/placement 计算。A≠B、B≠C、C≠D。不要把各 R 分段直接当作 Collision Domain，也不要承诺每段无需参与全图 Placement 计算。
+
+## 二、正式边界与必读
+- Mac /Users/tei/dev/MapLibreParticleLab，particle/main，origin/particle/main；执行时重新记录 HEAD、branch、dirty、远端基线；保留未跟踪 STEP-110 任务书。
+- 先读仓库 AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范/、docs/00_项目总则/README.md 和全部现行总则；读 STEP-110 主报告和 Codex 完成报告，以及 STEP-102、106、109、Fast Path 相关历史证据；以当前源码事实为准。
+- 先检查 /Users/tei/dev/navsea-particle-integration 的 main 与 origin/main 同步状态，读取其 README、WORKFLOW、TEAM_MODEL、contracts、rfc、adr、status、compatibility；已有跨项目结论优先。本 Step 只讨论 Shared Core Native，不直接修改 Integration/NavSea/Android/iOS。
+- STEP-110 已证明：PlacementController 仍是整图语义；R 的 placementCapable=true 时 Gate 消费 global placementChanged、symbolFadeChange、placementTransitionActive；跨 Source Collision 可能影响 R0，source≠segment。STEP-102/106 只验收过 placement-free R 的安全复用。本 Step 不能简单重复这些事实，重点给出**新增的判等/判无变化能力**具体可行性。
+
+## 三、只读调查工作项
+1. **从源码定位可实现性**：追踪 CrossTileSymbolIndex、Placement::placeLayers/commit、CollisionIndex/CollisionGroups、symbol buckets、placed icon/text、opacity/fade、RenderTree、RenderLayer、RenderSegment/Retained Cache 的真实控制与数据所有权。指出计算结束何处可以读取每一个 R 的最终 Placement 输出，是否已有稳定 ID、可见性/位置/opacity；写明路径、函数、行号和生命周期。辨别层间/Source 间/段间影响。
+2. **定义每段结果等价契约候选**：提出具体 per-R PlacementResultKey/Signature/Revision 候选字段（Symbol 实例稳定 ID、tile/source/bucket generation、placement result、collision visible/hidden、text/icon anchor/offset、paint opacity/fade/transition、zoom/camera、glyph/image atlas、style/layer order、render target boundary 等）。逐项解释哪些是 Placement 专属，哪些已有其他 cache gate 覆盖，哪些必须动态比较，哪些不需要加入，避免对每个 Symbol 每帧做过度 O(N) 或漏比较；比较发生于何时、如何处理首次帧、transition、reset、missing data。
+3. **RCRCRC 示例与判定表**：至少 R0/C0/R1/C1/R2/C2，其中 R0/R1/R2 都有 Symbol。分别分析：
+   - C1 仅粒子/颜色动画，R 均无可见变化；
+   - C1 Symbol 变动且只影响 R2；
+   - C1 Symbol 变动，碰撞也影响 R0/R1；
+   - R1 自己改变但 R0/R2 不变；
+   - 同一 Source 跨段、不同 Source 且 crossSourceCollisions=true/false；
+   - Annotation Symbol 自动插入，layer 顺序、camera/zoom/pitch、tile/glyph fade/opacity transition；
+   - 不能证明者 fail-closed。
+   结论表需区分“依然执行全局 Placement”、“该段仅避免 cache rebuild/composite 是否可复用”、“能否避免 render/prepare”、“Fast Path 仍被哪些其它 Gate 阻断”。
+4. **方案对比与难度**：对 A 只加 tracing/per-R 指标（不改变判定）、B 新增 per-R result fingerprint 但 shadow compare（仅记录真假）、C 利用已证明等价替换 global-only Symbol Gate 允许单段 Reuse、D 深改 Placement/Collision 成分段增量计算，逐一评估前提、复杂度（1-5）、改动范围、CPU/GPU/内存开销、风险、能否只改 Shared Core、对 Android OpenGL/iOS Metal 的影响。不能因为理论上可 hash 就声称 hash 一定安全。
+5. **执行与验收计划**：给出最小分阶段实现建议和真实可验证指标，包括 per-R signature stable/change、false invalidation、false reuse（严格 0）、build/reuse/fallback、视觉 A/B、Fade 长尾、CPU/frame、same frame draw ordering；指出先做诊断或原型是否需要新 Native 内部接口，哪些行为必须同时覆盖 Android/iOS。分别评估改善 retained cache 命中与改善整帧 CPU/Fast Path 的边界。
+6. **明确推荐结论**：回答每个 R 段可否“自身未变就不刷新”、可做到的最小粒度、不能保证的情形、最佳第一阶段（原型）与中长期方案，给出具体源码位置和工程量区间；区分源码已证实 vs 推断 vs 必须运行时验证。
+
+## 四、禁止项
+调查只允许读取 Native/历史 Git/本机历史实验文件以及新增本 Step 文档。禁止修改任何 C++/JS/Kotlin/Swift/编译脚本/测试代码；禁止执行编译、链接、测试、Jest、Gradle、ADB、Bazel、CMake、设备操作；禁止更改 NavSea、Integration、公用 Contract/API、GSRL、release/Source Lock、发行 Tag；禁止放宽当前 fail-closed Gate。禁止重置/清除现有 dirty、禁止 force push。除非明确用户授权，不执行后续实施。
+
+## 五、必做输出（实际生成）
+1. docs/20_调查/STEP-111_R段Placement结果等价与独立刷新可行性调查_v1.md — 主报告：代码路径/行号、RCRCRC 场景矩阵、Signature 草案字段逐项依据与生命周期、可行方案 A-D 对比、复杂度与工程量估计、风险、可执行的后续 Step 拆分、源码已证/待验证标识。
+2. docs/50_Step记录/STEP-111_R段Placement结果等价调查_v1.md — 简短中文 Step 记录，状态 PASS（调查完整）/PARTIAL/BLOCKED，记录未验证项与下一步。
+3. docs/报告/STEP-111_R段Placement结果等价调查_Codex完成报告_v1.md — 完成报告：实际模型与 reasoning effort（仅凭运行会话证据）、读取资料、逐任务结果、调查起/终 HEAD、branch、dirty、文件修改、未运行构建和测试、检查命令、限制、Git/Push 状态如实记录。
+4. 粒子开发记录.md — 本阶段简短追加（不要重写历史）。
+Codex 仅负责内容调查和上述报告落盘，Git scoped commit/push/远端验证由 GPT 指挥 RDC 独立负责，完成报告不得预报未执行 Git 结果。原有未跟踪 STEP-110 任务文件不纳入提交。本任务书自身保持未跟踪，避免误提交。
+
+## 六、验收与停止
+只在调查结果有对应源码位置/函数/调用顺序，明确安全条件、未证实风险、工程阶段与复杂度对比时，记“调查 PASS”；如生产实际视觉等价无法仅通过源码证明，可记“调查 PASS / 运行验证未执行”，不得声称优化已通过。必要的实机状态/插桩超出只读范围时明确给出下一阶段最小需求，不得扩大当前范围。不得把历史 STEP-110 的 PARTIAL 当成本次已经实现结果。任务退出前向 GPT 汇报生成文件、最后状态和未完事项。

docs/40_任务/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_Codex任务_v1.md

@@ -0,0 +1,138 @@
+# STEP-112：V23 粒子 Full Render 循环与 Symbol 缓存准入全面源码调查 — Codex 任务 v1
+
+**状态：待执行｜类型：全面只读源码调查｜编写日期：2026-10-10**
+
+## 一、用户目标与必须回答的问题
+
+NavSea 的 FZG1 连续风场场景中，粒子约 30 FPS，Native Particle Fast Path 持续 0 hit，约 1,787～1,796 次 Full CPU Frame/分钟；粒子关闭对照约 83 次 Full CPU Frame/分钟。含 Symbol 的 R2 缓存长期失效，理由为 static-placement。用户要求由粒子系统全面分析 Native 源码，找出导致“粒子 Tick → Fast Path 失败 → Full Render → R2 仍无法建立缓存 → 下一次继续失败”的真实原因，并提出安全修复方向。本任务**不授权修复**。
+
+必须明确回答：
+1. 谁请求每帧重绘？粒子是否只是要求下一帧，而非要求 Full Render？什么时候 MapLibre 能进入 Idle？
+2. Fast Path 全部准入条件的实际来源与执行顺序是什么？为什么 FZG1 的首个拒绝原因是 cache-invalid？
+3. R2 为什么 Build=0，而不是建好后偶尔失效？static-placement 实际检查了什么？
+4. placementChanged、symbolFadeChange、placementTransitionActive 是否在正常连续运行下形成难以通过的组合？原因来自时间机制、Transition 配置、Source，还是其它条件？
+5. Full Frame 已经正确绘制 Symbol 时，什么条件下可以安全地建立缓存供后续 Particle Tick 复用？修复 R2 后还会遇到哪些独立阻塞？
+
+**假设不是结论**：此前讨论认为 symbolFadeChange == 0 可能被误用为“Fade 已稳定”，这只是必须严谨验证或推翻的假设；不得直接断言为 Bug。
+
+## 二、环境、权威文档和既有事实
+
+- Particle 源码：Mac /Users/tei/dev/MapLibreParticleLab；执行时记录实际 branch/HEAD/dirty。编写时 branch=particle/main，HEAD=50ae48ad70，不能把该 HEAD 当执行时已固定版本。
+- 按 AGENTS.md 顺序先读 PARTICLE_BASELINE.md、docs/00_项目规范/、docs/00_项目总则/README.md 及现行总则、本任务、STEP-102/106/109/110/111 相关调查与报告；以执行时源码事实为优先。
+- 跨项目事实依照 /Users/tei/dev/navsea-particle-integration 的最新 COORD/RFC/ADR/Contract/Status。公共 API、Host/Native 职责改变只写提案，跨项目协调另立事项。
+- 现有未跟踪 STEP-110 与 STEP-111 任务书不得移动、覆盖、代为提交。现有 STEP-110/111 调查属于 PARTIAL，不表示 per-R 安全复用已经实现。
+- 执行模型建议 GPT-6 Sol Medium，实际完整模型与 reasoning effort 在开始前核实并报告；MD 不负责自动切换。提高推理档位须先停止说明理由、由用户确认。
+
+### FZG1 现场证据（不等于逐帧因果证明）
+
+| 指标（约 60 秒连续风场） | RC1 | RCRR_PREFIX | RC2 |
+|---|---:|---:|---:|
+| Full CPU Frame 增量 | 1792 | 1787 | 1796 |
+| Fast Path Hit | 0 | 0 | 0 |
+| R0 Reuse | 0 | 1787 | 0 |
+| R2 Build/Reuse | — | 0/0 | — |
+| R2 Invalidation/Fallback | — | 1787/1787 | — |
+| R3 Reuse | — | 1755 | — |
+| Fast 首个拒绝 | cache-invalid | cache-invalid | cache-invalid |
+
+RCRR_PREFIX 分段：[0,13) R0；[13,33) C1；[33,107) R2；[107,113) R3。C1 **含普通 Symbol/Line，以及 index31 WeatherColor 与 index32 Particle**，并非纯粒子段。R2 含大量 Symbol。FZG1 末态记录 placementChanged=true、symbolFadeChange=0、placementTransitionActive=false，**只是快照不是每帧时间序列**。此前也观察到导航 Source Mutation 计数增长，不能未经证据归咎于它。Full CPU Frame 不等于所有 Layer 重绘，不等于 Placement 实际重算次数。
+
+## 三、必须完成的源码分析 A：从粒子请求到 Full Render 的调度链
+
+逐级核查：
+- RenderRasterParticleLayer::isParticleAnimationActive / needsRepaint，SourceTimeline / V4Cadence / cadenceDue，粒子启动、暂停、无数据、隐藏时的返回条件。
+- RenderOrchestrator::hasTransitions，RenderTreeParameters::needsRepaint，Map::Impl::onDidFinishRenderingFrame / onUpdate，RendererObserver、RendererFrontend/Backend、Renderer::render / tryRenderParticleFastFrame。
+- 明确粒子 Tick、下一帧调度、Native Full 准备、GPU 粒子更新及 MapLibre Idle 的不同概念。检查 30 FPS 来自哪个实际 cadence，以及是否存在独立的 Placement 定时器强制 Full。
+- 输出**可核查调用图**，带文件路径、函数、行号及关键条件；区别“必然调用”“在特定配置调用”和“只是假设”。
+
+## 四、必须完成的源码分析 B：Fast Path 全条件审计
+
+检查 src/mln/renderer/particle_fast_path.hpp 的 evaluateParticleFastPath 与 renderer_impl.cpp 的 tryRenderParticleFastFrame：
+- Prepared RenderTree、Retained enabled、**所有 R 段** Cache valid、Build/Static Revision、Content Revision、Camera/Viewport、non-camera update signature、Style、Boundary/Topology/RangeConfig。
+- staticStable、Placement transition、pending changes、non-particle transition/repaint、fading tiles、ParticleNeedsRepaint、still image、MapMode、Debug、Continuous 支持层、scene support、annotation mutation。
+- **必须产生全 Gate 矩阵**：条件/来源函数与行号/通过条件/失败原因/是否被粒子 Tick 本身改变/是否在一次新 Full 后可能恢复/FZG1 已证实或未知。
+- 确认短路返回首个错误是否掩盖 unsupported-continuous-layer、unsupported-scene 等后续失败；不得因只看见 cache-invalid 就宣布其他条件已通过。
+- 比较 Full 与 Fast 路径的 CPU Prepare、RenderTree、GPU 绘制工作，避免将 Fast 解释成零 GPU render。
+
+## 五、必须完成的源码分析 C：R2 缓存 Build/Invalidate 状态机
+
+从图层结构到 GPU 缓存逐级核查：
+- render_segment.hpp 的 renderSegmentHasPlacementCapableLayer / renderSegmentPlacementGatePassed；隐藏 Symbol 是否同样触发结构级保护。
+- render_orchestrator.cpp 的 retainedRangeUsesPlacement / retainedRangeIsStable、Source/Tile/Glyph/Sprite/Annotation 的有效性及跨段 Collision 依赖。
+- renderer_impl.cpp 的 retainedPlacementStable 全局 Scene Gate、每段 segmentPlacementGatePassed、segmentSupported、Segment fingerprint/source revision、segmentFallbackReason、缓存 evaluate 与合成控制。
+- retained_underlay_cache.cpp 的 RetainedUnderlayCache::evaluate / invalidate / BuildPending / markBuildSucceeded / markBuildFailed / releaseResources；区分“首次未建立”“有效缓存因 Gate 被主动 invalidated”“底层资源损坏”“revision 变化”。
+- 以 FZG1 的 R2 Build=0、Reuse=0、Fallback/Invalidation≈1787 为约束，写出完整状态转换和所有可支持或反驳的来源；解释为什么 Full 的正常绘制不自动等于缓存离屏纹理 Build 成功。
+- 对 placementChanged=true 分清“发生 Placement 计算”与“R2 Symbol 最终可见性/位置/像素变化”。还须分析跨 Source/跨段 Collision、Fade、Shader opacity、Camera、异步资源所需安全边界。
+
+## 六、必须完成的源码分析 D：Placement 和 Fade 真正语义
+
+逐函数追踪 PlacementController::placementIsRecent / setPlacementStale / hasTransitions；Placement::getUpdatePeriod / commit / symbolFadeChange / hasTransitions；Style TransitionOptions；Symbol 在 OpenGL/Metal Shader 中如何消费 symbol_fade_change、opacity。
+
+**必须分别分析两种运行配置**：
+1. enablePlacementTransitions=true：默认 300ms 更新间隔、Symbol Bucket Added 可能导致 30ms override、Zoom 修正、Fade 从 0 到终态的数值变化、hasTransitions 与 setPlacementStale 的交互。
+2. enablePlacementTransitions=false：placementIsRecent() 为什么可能持续返回 false、Placement 是否每次 Full 都重算、symbolFadeChange 实际取值、为何末态可能为 true/0/false。
+
+针对 Gate **!placementChanged && symbolFadeChange == 0 && !placementTransitionActive**，逐行给出真值表与相应真实可达时刻：
+- Placement 刚计算后；
+- Placement 未重算但仍有淡入淡出；
+- Fade 完全结束后；
+- 关闭 Transitions；
+- Symbol Bucket 增减、跨段碰撞等变化；
+- Camera/Style/Source 不变、只有粒子的稳态。
+
+回答：在正常运行下是否存在可用于 Build 的安全窗口？如果不存在，是哪一条造成的？全局 Scene Gate 与每段 Placement Gate 是否构成第二重锁死？FZG1 末态数据不能被机械套进默认 300ms 时间表。**绝不通过直接删除 Gate 或仅更改 ==0 比较符来宣布安全修复。**
+
+## 七、必须完成的源码分析 E：反事实场景与因果闭环
+
+对下列情况分别输出逐帧状态推演与 Fast Gate 判定（明确“已证明/条件推断/需设备验证”）：
+
+- **S1 纯粒子稳态**：Camera 不动、所有 Source/Tile/Style/Glyph/Sprite ready 且不变、无外部 Full 指令、粒子 30 FPS。能否从第一次正常 Full 构建 R2 缓存并进入 Fast？何时会卡死？
+- **S2 粒子关闭**：没有粒子连续重绘，仅偶尔正常地图刷新。分析为何 Full CPU Frame 频率低，不能误判 Placement 从不执行。
+- **S3 真实 Host Source Mutation**：导航相关 Source/Annotation 更新与 Tile 异步输入同时存在，量化其对 Revision、Cache Build、Full Frame 的理论影响；不能假定所有变化都来自粒子。
+- **S4 不同布局**：原 RC/RCRR、实验 RCRR_PREFIX、理想保留图层顺序的 [0,13) R / [13,32) R / [32,33) C / [33,107) R / [107,113) R。检查 C 范围有普通 Symbol/Line 是否会触发 unsupported-continuous-layer；不能将最后一个仅为反事实的配置写成已实现。
+- **S5 动态安全回退**：相机缩放/旋转、Tile/Glyph/Sprite 完成加载、Opacity Fade、跨段 Collision、Style/Layer 改变时，哪些 R 必须重建，哪些状态不能盲目复用。
+
+务必清楚界定：“粒子导致下一帧”与“粒子本身让静态 R 内容变了”不等价；“需要 Full 准备”与“所有图层从零画一次”也不等价。
+
+## 八、方案对比与建议（仅提交提案）
+
+至少比较四类选项并给优先级：
+- **A 全 Gate 与 R2 状态诊断**：一帧内采集所有 Gate 状态，而不是仅返回第一个 Miss；记录 Placement 配置、计算原因、Fade 值、各 R 的 Build/Reuse/Fallback/Invalidate，控制 tracing CPU 开销。
+- **B Full Frame 后安全建立 Symbol R 缓存**：寻找 Placement、Opacity、GPU Shader、资源与 RenderTree 都满足安全条件的 Build 时机，打破可能的“永远无法首次 Build”自举问题。
+- **C 更细粒度 per-R 结果等价**：与 STEP-111 对照，是否有必要做 per-R Signature/Revision 或可采用更轻量的生命周期证据；跨段 Collision 不能被忽略。
+- **D 外部 Full 更新与 Particle Tick 分流**：用户要求外部明确 Full 指令到来即完整更新，不因数据相同去重/延迟；无外部指令时粒子优先 Fast，仍保留 Native 必要安全 Full 回退。核对目前内部/公共接口是否支持；涉及责任或公共语义必须由 Integration 正式协调，本任务不得私建 API。
+
+每项必须列：是否解决首次 Build、是否能解决全局 Scene Gate 和 C 段 Gate、数据正确性、GPU/CPU/内存代价、需改文件、风险、复杂度 1～5、Android OpenGL / iOS Metal 一致性、最小验证方案。
+
+**性能目标是 30 FPS 粒子与低频外部 Full 更新各司其职；2 Full + 28 Fast 是理想例子，不是当前 V23 已实现或零安全回退的承诺。** 不以降低粒子 FPS、删除海图 Symbol、移动一批普通静态 Layer 到 C、放宽 fail-closed 或忽略外部指令作为优化手段。
+
+## 九、本轮权限、限制与停止条件
+
+**仅执行全面只读调查**，允许阅读本仓库源码、历史 Git、已有 FZG1 数据、现有调研报告；允许写入本任务要求的调查文档、Step 记录、Codex 完成报告与对粒子开发记录的短条追加。不得修改 Native、Android/iOS、Shader、JS/TS、构建脚本、测试源码、Host/NavSea、Integration 契约、Style、Renderer Gate 或公共 API。
+
+不执行编译、链接、打包、设备操作、发布或新的性能测试。本轮如无法通过源码证实最终触发频率，必须给出下一阶段**最小诊断插桩提案**，记录字段、调用点、采样窗口、FZG1 验收场景与预期判断方法；不可未经授权直接实施插桩。严禁清理其他 dirty/untracked、变更上游、强推、改历史 Step。无法证明安全则维持 fail-closed。
+
+需要涉及跨项目职责/API 调整的提案，先输出 Interface Blocker，返回 Integration 决策。遇到重大事实冲突时报告并停止冲突部分，不得自行扩大修改范围。
+
+## 十、必做输出（调查完成时必须真实落盘）
+
+1. **主报告**：docs/20_调查/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_v1.md。必须包含：
+   - 完整粒子调度→Fast→Full 调用图、源码路径/函数/行号；
+   - Fast Path **全部 Gate** 对照矩阵（含短路掩盖条件）；
+   - R2 Cache 的首次 Build、Invalidate、Fallback 状态机与实际决策链；
+   - enablePlacementTransitions 开/关及 Fade 时间/数值状态表；
+   - 原始、PREFIX 和理想单粒子 C 的分段对照；
+   - S1～S5 反事实和证据强度；
+   - A～D 方案风险/成本/工程改动/优先级及推荐的下一步；
+   - 不同问题分别标注“**源码证明** / **FZG1 实测** / **条件推断** / **仍需设备验证**”。
+2. **阶段记录**：docs/50_Step记录/STEP-112_V23粒子FullRender与Symbol缓存调查_v1.md。写状态、目标、完成项、未完成、阻塞与下一步。
+3. **Codex 完成报告**：docs/报告/STEP-112_V23粒子FullRender与Symbol缓存调查_Codex完成报告_v1.md。逐项按“已完成 / 未完成 / 无法验证”报告，必须解释未完成原因；记录实际模型/推理档位、Git 起终 HEAD、branch、dirty、变更文件、检查结果、未做构建/运行的事实、Git/Push 实际结果。
+4. **粒子开发记录.md**：本阶段追加简短事实记录，不能更改历史。
+
+## 十一、验收与 Git 收尾
+
+只有 A～E 的关键问题有源码级证据、全部 Gate 有出处、root-cause 假设被验证或明确证伪、方案风险和最小验证路径充分时，才能写“源码调查 PASS”；**运行时未验证、Native 未修复、Fast Hit 未改善**必须明确列出，不能写实现/性能 PASS。没有决定性证据，结论应 PARTIAL，明确下一轮需要的最小运行时信息。
+
+本任务研究完成后，对**本任务范围的文档变更**进行 scoped Git 提交并 push 到 origin/particle/main，核对远端 HEAD；不得纳入现有未跟踪 STEP-110/STEP-111 任务书或无关修改。依 AGENTS.md 的 Codex→RDC 职责分工，Codex 交付调查结果，RDC/获授权操作方独立完成 Git/Push 与核验；Push 未确认不得冒称 Git 收尾完成。记录真实 commit hash、message、远端分支与 push 结果。禁止 force push、upstream push。
+
+**本任务结束条件：调研证据、报告与 Git 收尾；不得继续直接实施 Native 修复。**

docs/40_任务/STEP-113_FZG1_PBF_Layer与FastGate诊断_Codex任务_v1.md

@@ -0,0 +1,41 @@
+# STEP-113 — NavSea FZG1 PBF/Layer 等价测试 App 与逐帧 Fast Gate 诊断
+
+## 授权与范围
+用户明确授权：在 Particle Android 测试 App 接入与 NavSea 相同的正式 PBF 与图层分段，找到每帧阻止 Particle Fast Path 的所有 Gate；RDC 可以编译 APK、使用已连接 FZG1-2 的 ADB 测试。使用 Codex **GPT-6.1-Sol High** 实施源码，RDC 独立编译/设备验收。不得把调研中的假设冒充真机结果。
+
+## 项目与协作
+- Particle repo: /Users/tei/dev/MapLibreParticleLab, `particle/main`; NavSea **只读**: /Users/tei/dev/NavSea-Build。Integration **只读**: /Users/tei/dev/navsea-particle-integration；已 fetch 核实 Integration main 80667d6c。
+- 先完整阅读 Particle `AGENTS.md`、`PARTICLE_BASELINE.md`、`docs/00_项目规范/`、`docs/00_项目总则/README.md` 和其四份有效总则，以及 STEP-112 源码调查、上一步报告。
+- Native/Shared Core 仅增加诊断，Android Test App 增加测试 UI/场景。**禁止**改变现有 Fast Path Gate 准入逻辑、Placement/Fade、安全回退、公开 RN API、NavSea 源码、Cache 等价安全判定。Common Core 诊断数据不能含 Android 专有语义。
+- 仓库中两个已有未跟踪 STEP-110/111 任务 MD 必须原样保留，不得 add/reset/clean；禁止新分支或工作树。
+- Codex 不编译、不执行 Android Gradle/ADB、不执行 Jest（用户没有要求），不做正式发行、Git commit/push；由 RDC 负责这些步骤。
+
+## 目标 A：准确复制生产 Style、场景与真实 R/C 分层
+现有测试 App 已支持 `NAVSEA PBF`，使用生产 URL `https://pbf.jpcn.ccwu.cc/style/style.navsea-delivery-full-semantic-extentfix.json`，但仅有 **63** 个基础图层；它与 NavSea FZG1 实测 **113** 个最终渲染图层尚未等价。NavSea 源码 `src/config/builtinRuntimeUrlConfig.ts` 是 URL 事实源；`src/map/particle/RenderSegmentHost.tsx` 是宿主分段控制。STEP-112 用户 FZG1 的 RCRR_PREFIX 诊断：R0 [0,13), C1 [13,33), R2 [33,107), R3 [107,113)。注意 NavSea 当前源码 R/C 初始 plan 可能与运行诊断不一致，必须记录版本/选择器，不得当作同一事实。
+
+- 基于现有 `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/ParticleCoreLayerValidationActivity.kt`/fixture 增加独立 **STEP-113 FZG1-PBF Gate** 测试场景。真正加载生产 Style、Sprite、Glyph、VectorTile URI；原有场景全部保留，且不得改为假矢量地图。
+- 与 NavSea 对齐层顺序、类型、Source ID 和显隐规则：优先从 NavSea 实际源码、已有 FZG1 快照/资料得到完整清单，至少能证明原始63层一致；对于 RN 额外动态层，若没有真实 Source/图层定义，不得将同名假图层宣称为“同等画面”，应分别标注原样/结构仿真/缺失。严格实现全113层和所述四分段如能力允许；若其余层无法准确复制，仍完成可运行的 **真实 PBF 63 层模式 + 明示的部分等价模式**，并记录阻塞原因，不要卡死整个任务。
+- 每个场景导出/Logcat：实际 styleLayers (index/id/type/source/visibility)、总层数、每段 [begin,end)/类型与层名、分段配置接受/拒绝原因、当前 Style URL/版本/fingerprint、预报时间和 Particle Tick 状态；严格用实际 Layer ID 定义分段，不假定第13/33/107的 ID 永远不变。
+- 支持至少静态30fps粒子且 camera/forecast fixed、粒子关闭、Source 变化、场景对照。静态场景不可每500ms自行修改 Symbol；原 STEP-102 的动态 fixture 保持原样。
+
+## 目标 B：逐帧 24 Gate 完整诊断
+- 阅读 `src/mln/renderer/particle_fast_path.hpp` 的 `ParticleFastPathGateInput` (24 条固定顺序) 与 `src/mln/renderer/renderer_impl.cpp::tryRenderParticleFastFrame`；每次真实 Fast 尝试，记录统一 frame/sequence、所有 24 条 Gate 的 **PASS/FAIL** 或明确不可观测的 UNKNOWN，并保存首个实际短路 Gate 与同帧失败全集。不得通过二次调用有副作用的函数来获取字段；优先使用现成的已计算 `ParticleFastPathGateInput` 在单次调用无副作用完成独立掩码计算，并确保首错与 `evaluateParticleFastPath` 决定一致。
+- 对于 CacheInvalid 等早期阻断，也能看出后面的 `unsupported-continuous-layer` / `unsupported-scene` 是否同帧成立。记录 per-R cache state/build/reuse/invalidation/fallback, Placement changed/transition/fade、原因分类、FullFrame count。不要把 Full 绘制导致的 post frame Placement 数据冒充 pre-fast 原子时刻；必要时为 pre/post 两种 phase 分离记录。
+- 诊断必须为有界环形缓冲/低开销低频导出（例如保留最近120或256帧，另聚合失败计数），不得每 33ms 从 JS/Android UI Logcat 输出大 JSON。沿用已存在的 Android `getRenderSegmentDiagnostics` Native JSON 出口，新增 `fastGateTrace` 可选诊断字段，避免新 RN API/ABI；必要时增加手动/低频截图/Logcat 导出入口。控制每分钟几条摘要而非每帧 log。
+- 同一渲染生命周期 reset 要有清晰逻辑；不引入 data race，遵循现有 shared snapshot/atomic/锁语义，避免在 map UI 线程操作 Native mutable renderer state。
+
+## 目标 C：可验收性
+- Test App UI 能切换 STEP-113 场景、查看 Gate 首错/失败排名与各段状态；可用 Logcat 定向标签稳定抽取机器可读 JSON (包含 schema/version, style parity summary, frame window计数, gate-failure聚合, R状态摘要)。不要让 UI 实时多次 Native 查询产生额外帧，使用约2至5秒刷新。
+- 提供实际验证步骤（Mac PowerShell不要，macOS shell可用），基于标准 `tools/particle_android_validation/build_validation_apk.sh` 构建，确认设备 ABI 与脚本默认 ABI一致后交 RDC 运行。ADB 必须明确 `-s 192.168.200.139:5555`（这个设备本轮是 FZG1-2），不可无参数误操作其他设备。
+- 文字报告区分：SOURCE-PROVEN / TEST-APP-STRUCTURAL / DEVICE-MEASURED / NOT-VERIFIED。成功构建 APK 不表示真机性能验证通过。
+
+## 必做输出与收尾
+1. 所需 Shared Core / Android Test App 源码实现（尽量只局部变更）。
+2. `docs/50_Step记录/STEP-113_FZG1_PBF_Layer与FastGate诊断_v1.md`：实际状态、设备验收填写栏、剩余风险。
+3. `docs/报告/STEP-113_FZG1_PBF_Layer与FastGate诊断_Codex完成报告_v1.md`：改动文件列表、与 NavSea 样式/层等价度证据、24 Gate 定义、精确构建/ADB/场景命令、产物/日志预期、静态检查事实、未做项。
+4. `粒子开发记录.md` 中文末尾追加少量本次进展（append-only）。
+5. Codex 最终回报真实 model=GPT-6.1-Sol / high，以及剩余需要 RDC 独立验证事项。
+6. 文件变更仅 scoped；`git diff --check`，不提交不 push；避免 Jest 和 Native/Android 长时编译。任何公共跨项目 API 变更先停、写明需要 Integration RFC。
+
+## 优先次序
+优先先完成 **B 24Gate真正可靠同帧采集**，再实现已有 PBF Mode 的专项布局与 UI；不允许因为“113层不能精确复刻”就省略实际可交付的完整 Gate 诊断。

docs/40_任务/STEP-114_FastPath安全准入与TestApp闭环_Codex任务_v1.md

@@ -0,0 +1,41 @@
+# STEP-114：Fast Path 安全准入受控修复与 Test App 闭环（Codex 任务 v1）
+
+## 执行授权与基线
+- 用户明确同意继续受控修复，不要求完全复刻 NavSea 113 层。
+- Mac 仓库 /Users/tei/dev/MapLibreParticleLab，particle/main 起点 b02e54de3d45fcf612126ae8f037cba204f590ea。Integration 最新 main 80667d6c343411d03a760425438e3d292f452118 经 RDC 验证。
+- Codex 固定 GPT-6.1-Sol High (gpt-6.1-sol / high)。先读 AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范、docs/00_项目总则/README.md 及四份有效总则、STEP-112/113 报告、Integration 的正式 Contracts/RFC/ADR，严格遵守项目边界。
+- 本轮 Codex 只改代码与文档；不能运行 Android Gradle、ADB、Jest、CMake/Ninja/Bazel 大编译或正式打包；Native 定向验证由 RDC 另行执行，Android 编译由用户在授权条件下手工统一验收。
+- 不碰原有两份未跟踪 STEP-110/111 文件、无关文件、NavSea 源码和 Integration；禁止 git add -A / reset --hard / clean；不得变更 RN/JS 公共 ABI/API、发行版本或 Source Lock。
+
+## 根因事实
+- STEP-113 STATIC_RC 66 Native layers，R[0,63) Build=0、unknown-dependency；C[63,66) 含天气色场、粒子、内部 Annotation Symbol。Fast=0。
+- 119 个最新 completed Full 帧：24 Gate shadow mismatch=0；#3 cache invalid、#4 revision mismatch、#22 unsupported continuous layer、#23 unsupported scene 全部失败；#12/#13 placement 105 帧失败。
+- RenderOrchestrator::retainedSegmentSourceState 对 CustomMVTVector 明确 fail-closed，已有源码注释说明无 retained cache revision contract；不得删掉这个限制来伪造 Fast。
+- continuousRangeSupportsParticleFastPath 要求 C 全层以 Particle dynamic API 标记；内部 Annotation Symbol 不满足，且 #23 聚合依赖部分与 #22 重合。
+- STEP-112 证明含结构性 Symbol 的 R 在旧 Placement stale/changed/fade 时可能根本无法进入首次 Cache Build；禁止只删条件或假设视觉没变。
+
+## 实施步骤（依次、受控）
+1. 做当前源码静态闭环：明确 Test App 对应 SourceType、Source/Tile/Style/Glyph/Image/Annotation mutation 追踪、R 的初建失败点、C 准入及 Scene 复合条件、Placement 控制流。
+2. R 缓存：只对确有完整 Source revision 与异步失效追踪的类型建立安全准入；若 CustomMVTVector 无法严格证明，保留其 fail-closed。优先为已支持的保守 source 子集提供可用的独立 R-cache 正向测试。保留 Source mutation、Tile update、camera、style reload、image/glyph、destroy/reset 的反向用例。
+3. C 非粒子层：只有证明原有 GPU 复合内容/Source revision/Placement/Annotation 在静止场景与 Full 等价、变化时 Full 回退，才能受限放行。否则不可移除 Gate #22：可通过单独 Test App 最小场景或安全 Layer 拓扑证明能进入 Fast。不要丢失原始正式 PBF 5 场景。
+4. Symbol R Placement：基于已提交的真实 Placement/资源 revision 与 transition/fade 审核是否有安全稳定窗口；如须新增独立结果签名或其他跨平台设计，停止该项并在报告中写 BLOCKED，不做危险简化。
+5. 优先实现独立 Test App FAST_SMOKE 场景（如安全可行），按 UI 菜单明确区分正式 PBF 与独立最小场景。使用 Native 真实 Full/Fast/CacheBuild/Reuse 计数和24 Gate JSON，测试稳定、Source mutation、Annotation、Pan/Zoom、Reload、前后台/Teardown；不许伪造 Frame 结果或直接注入 candidate=true。
+6. 所有公共 Shared Core 代码仍跨 Android/iOS 共用，不得建立平台分叉。任何需要改公共语义/API的部分暂停，留给 Integration RFC。
+
+## 测试/运行要求
+- 可改/新增现有非 Jest C++ 相关测试源，但 Codex 不执行测试/编译。
+- 必须写出 RDC 可以执行的精确定向 Mac Native 检查命令；后续 Android 编译和设备 Gate 集中一次进行。
+- 只证明能证明的部分；可产出 PARTIAL / BLOCKED 与可用局部修复，不允许“关掉Gate提升Fast数字”。
+
+## 必做输出
+1. 本次实际修改的 C++、Android Test App 和非 Jest 测试源（不能安全改的部分写明零修改）。
+2. docs/20_调查/STEP-114_FastPath安全准入与闭环判定_v1.md：R/C/Placement 证据、可能的反例、实现范围、安全前提、实际测试方案。
+3. docs/50_Step记录/STEP-114_FastPath安全准入与TestApp闭环_v1.md：当轮修改、状态、验证事实及后续步骤。
+4. docs/报告/STEP-114_FastPath安全准入与TestApp闭环_Codex完成报告_v1.md：模型全名档位、改动文件、影响/兼容、RDC 具体命令、已做/未做的验收、Git check。
+5. 追加中文 粒子开发记录.md：当前改动、当前状态、下一步。
+6. 新增 Test App 入口时更新相关场景说明，清楚区分真实 PBF 与独立 smoke。
+7. 文档必须实际写入并保留，不能任务后要求用户补交。
+
+## Git 收尾
+- Codex 只能执行无构建型静态检查与 git diff --check，回报 git status 和必要的验证命令；禁止将未运行的测试写成 PASS。
+- Codex 完成后先停下由 RDC 独立审计/运行定向检查；阶段结果达到合理门槛后由 RDC scoped commit 到 particle/main 并 push origin，核验远端 SHA。若未达真实 Fast，不得标示 Fast Path 已修复。正式发行独立处理。

docs/40_任务/STEP-116_STEP113原PBF_FastPath实际阻塞修复_Codex任务_v1.md

@@ -0,0 +1,26 @@
+# STEP-116：STEP-113 原 PBF Fast Path 实际阻塞修复
+
+## 授权、当前基线与配置
+用户要求继续修复，并以原 STEP-113 专用 Android APP 的 STATIC_RC 真正进入 Fast 为目标，而非 STEP-114 简化 FAST_SMOKE。当前仓库 Mac /Users/tei/dev/MapLibreParticleLab，particle/main HEAD e2d202b560ad0165101546597c43f2ef0ccf4542。Integration 已由RDC fetch 并核实 main 80667d6c343411d03a760425438e3d292f452118。仅内部 Shared Core 安全修复与 Android 专用 Test App；不改跨平台公开 API/ABI/协议，不改 NavSea、不发行。
+
+Codex 模型必须为 GPT-6.1-Sol High (gpt-6.1-sol / model_reasoning_effort=high)。先读根AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范、当前 docs/00_项目总则 README及四份有效总则，读 STEP-112/113/114/115、Integration instructions/README/WORKFLOW/TEAM_MODEL/contracts/rfc/adr/status/compatibility，按事实和边界执行。Codex只编辑、静态检查、中文报告；不可执行Native/Gradle大编译、ADB、安装、Jest、发版、commit/push。Native独立审计由RDC；Android编译安装由用户手工集中一次完成。
+
+## 已确定的真正阻塞
+STEP-113 STATIC_RC：正式63个PBF基础层，Test App Native实际66层；R[0,63) Build0、Fast0、Source fallback unknown-dependency，C[63,66)中有自动添加的 org.maplibre.annotations.points Symbol，#22/#23持续失败。后续 STEP-114 源码/快照发现R依赖mapple、navsea_delivery和tide，Native source表实际没有tide，tide-spots Symbol层引用它；navsea_delivery实际是Vector，不是CustomMVT。即使R的missing-source得到解决，Symbol R首次cache Build仍被Placement的changed/stale/fade保护阻挡。不可把去掉一个Gate误写为全套修好。
+
+## 工作：真正解决而非假通
+1. 通过静态源码和保留的 STEP-113完整JSON逐环确认R缺源的原层及fallback、真正的 SourceType、source/Style变化导致的revision与GPU生命周期。
+2. R的缺失源：只有能证明缺失源永远贡献零像素，且后续Source创建/恢复/同名更新强制缓存失效/Full重新处理时，才允许把它作为有界的empty依赖；否则保留fail-closed并明确报告服务器正式Style存在缺源而无法安全缓存。不能偷偷创建假的tide Source或删除原始tide-spots层。
+3. C的内部Annotation Symbol：可以在专用 Test App 确认地图无任何Annotation实例时，参照 STEP-114 仅移除 SDK 自动创建的空内部 Annotation 层，保留原正式63层定义、Source/Layer顺序不变；必须有代码防止遗留Annotation/Style添加时漏内容，并在日志、manifest明确记录原STYLE层原样、仅内部辅助层调整。其他已有原场景继续原语义，不为了Fast删除SOURCE_CHANGE中的测试circle。未经证明不能改Core C准入逻辑。
+4. Symbol R初建：必须读PlacementController、onRender、commit/fade、renderSegmentPlacementGatePassed、retainedRangeIsStable和full-frame时的状态。真正放宽必须有结果等价的Placement/atlas/glyph/tile/style/source/camera/opacity证据，并在变更时立即invalid/full；不能仅凭stable多少毫秒、场景没有手动操作、tile加载完成来放行。若现有Core没有可核实的已提交GPU结果签名，禁止危险跨层重写，列为BLOCKED并说明需要的精确额外数据/设计。
+5. 要保留24Gate shadow mismatch=0与实际Cache Build/Reuse/Full/Fast原生计数。可添加同帧诊断或快速失败细项，便于用户一次Android build后通过原STATIC_RC脚本迅速定位仍失败的Gate。保留PBF63、PARTICLE_OFF、PARTIAL_RCRR、SOURCE_CHANGE五场景、STEP114独立Smoke和STEP102原场景；不要改变公网PBF Style或NavSea，也不要求精确113层。
+6. 增加与安全修复对应的非Jest C++源码测试，含缺源/源加入/async mutation、Annotation、Symbol R /全局变化/无变化、Style/Source/Tile/Glyph/Image以及Layer顺序/disable/reload；不要假造rendered Fast、不要把不运行测试记PASS。
+
+## 交付文件，全部本轮必须实际生成
+- 本轮实际源码和适当非Jest测试源码；修改Test App后更新必要README。
+- docs/20_调查/STEP-116_STEP113原PBF_FastPath阻塞安全修复审查_v1.md：每条阻塞证据/解决方案/风险/未解项。
+- docs/50_Step记录/STEP-116_STEP113原PBF_FastPath实际修复_v1.md：真实完成度及未运行项目。
+- docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md：严格按最新HEAD一次用户手工Android build/install→STEP115 preflight→原STEP113 STATIC_RC 75s以上→完整120帧/24Gate/源码/设备SHA/用户画面；失败后如何判断R/C/Symbol，不得依赖旧APK。
+- docs/报告/STEP-116_STEP113原PBF_FastPath实际修复_Codex完成报告_v1.md：实际模型全名档位、改动清单、公共API（必须不变）、逐项Implemented/Blocked/Not Run、Git/源码证据、RDC具体命令及用户构建/设备步骤。
+- 粒子开发记录.md追加中文结果与下一步；必要README与相关已有文档说明保持一致。
+- Codex运行git diff --check、静态核查；不运行Native编译、Android编译、Jest、ADB、安装、Git commit/push；本轮用户原有两个未跟踪STEP-110/111 MD一律保护。禁止git add -A/.、reset --hard、clean。完成后停止由RDC独立审计并scoped提交推送；若Fast尚未实测只能PARTIAL归档，不写Closed/PASS。

docs/40_任务/STEP-117_原PBF_R段首次Build与Fast安全准入_Codex任务_v1.md

@@ -0,0 +1,26 @@
+# STEP-117 原STEP-113 PBF的R缓存首次Build与Fast安全准入
+
+## 用户目标、代码基线和约束
+2026-10-11 用户要求继续 STEP-116 实机之后的实际修复：原专用Android Test App STEP-113 STATIC_RC，保留所有正式PBF 63基础层，不代换成STEP114简化FAST_SMOKE。真正验收须Native Cache Build>0、Reuse>0、FastDelta>0，同时画面正确、24Gate mismatch=0、异步更新fail-closed。若现有证据不能安全准入，必须保留真实阻塞并如实标 PARTIAL/BLOCKED，禁止伪造Fast或PASS。
+
+Mac repo /Users/tei/dev/MapLibreParticleLab 当前particle/main起点43e5f5b91598b9c3d3f1c788052d4bbd2d616668。Integration /Users/tei/dev/navsea-particle-integration origin/main同步至80667d6c343411d03a760425438e3d292f452118。模型固定 GPT-6.1-Sol High (gpt-6.1-sol, model_reasoning_effort=high)，不得升级。先读AGENTS、PARTICLE_BASELINE、docs/00_项目规范、docs/00_项目总则README与全部4份当前总则、Integration instructions/README/WORKFLOW/TEAM_MODEL和contracts/rfc/adr/status/compatibility。阅读STEP112-116全部关键任务记录和实际源码。Shared Core代码仍同时服务Android/iOS，本次限平台中性的内实现与Test App诊断，不改跨平台公开API/ABI/RN/JNI合同、不改NavSea/iOS/外部PBF服务器。若改动需要新公共contract或跨项目决定必须停止该部分，并在报告中指出应由Integration协调RFC/ADR，不自行做新平台业务语义。
+
+## 已测事实，一定先读取实机JSON和报告
+docs/60_测试/STEP-116_FZG1_原PBF实机验收结果_20261011.md。原完整JSON：artifacts/maplibre-particle/android-validation/step113-retest-20261011_121308/static_rc/native-full.json，SHA=cd491d2acca97119f1d4f2d6f77eb7b229c17b90d4be1181a59202308429b219。
+
+STEP116新APK源码c48a72a9，设备192.168.200.139:5555：原STATIC_RC已65层，原正式63层保留，C[63,65)仅WeatherColor与RasterParticle，#22最近120帧失败0。R[0,63)缺Source=tide，原style tide-spots Symbol引用tide；真实sources只有mapple:raster、navsea_delivery:vector、org.maplibre.annotations、rn-weather-fields。R Cache Build0 Reuse0、fallback=missing-source、placementGatePassed=false；24Gate最近120帧 #3/#4/#23失败120、#12/#13失败105、mismatch0，119Full/0Fast/1pending。90秒FastDelta=0、FullDelta=920。STEP116修好的空SDK Annotation条件和原63层定义不许回退。
+
+## 必做实现/根因研究
+1. 读 Style/Source creation、RenderOrchestrator::createRenderTree及LayerRenderItem、RenderLayer group disable/activate/processChanges、ResourceManager、sourceDiff、retainedSegmentSourceState、RenderSegmentRevisionBook、contentFingerprint、GPU提交。缺tide只可在具有可检查的零实际GPU绘制/无旧Renderable数据且同名Source添加/重建时完整Full+invalidate证书时作为缓存零贡献依赖；不得补假tide、删tide-spots、通过忽略revision/ready来放宽。无法证明则保持missing-source fail-closed，报告具体证据。
+2. 读PlacementController::setPlacement/placementIsRecent/hasTransitions、Placement::placeLayers/commit/fade/opacities、RenderSymbolLayer/SymbolBucket::updateVertices、RenderTree::prepare、Renderer::render Full与Cache Build及particleFast path判定。当前全帧重算时placementChanged=true、不重算时stale=true，fade不断非零；使首Build一直0。若能建立与成功提交的GPU Drawn R精确等价的结果证书，才受控放宽首次缓存，包括crossTile collision/placement、glyph/image/atlas、dynamic opacity、tile/source/layout revision、projection/camera/viewport、GPU context、异步ChangeRequests；任何变更必须Full/rebuild。不能将任何placementChanged、symbolFadeChange或controllerTransition强制false或删除24Gate。若需跨层较大重写无法保证安全则保留Gate报告BLOCKED。
+3. 原STEP113的正式63基础层完全保留，C空Annotation受控修复保留；旧五场景及SOURCE_CHANGE的负例保留。必要最少的Native诊断/Android测试入口增强可以做，但不可改变真实Fast计数/24Gate判定或把FAST_SMOKE当PASS。
+4. 以一次未来Android用户授权的RDC标准完整build/install测试为目标批量实现可证明安全的改动；提供非Jest C++测试源码，覆盖缺源零绘制/新增同名Source后失效、Symbol placement/symbol fade、异步glyph/tile/style/annotation/camera/context改变时fallback。不能将没有运行的测试标PASS。Codex不要运行大编译/Gradle/ADB/CMake/Ninja/Bazel/Jest、安装、commit/push，由RDC独立执行。
+
+## 必做中文交付文件
+- 真正实施的源文件、非Jest测试源码；必要Test App README更新。
+- docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md：真实源码/原设备JSON，GPU生命周期与Source缺失和Symbol placement安全边界、各项状态、设计/反例。
+- docs/50_Step记录/STEP-117_原PBF_Fast缓存准入_v1.md：改变、阶段验收、未执行与下一步。
+- docs/60_测试/STEP-117_FZG1_原PBF真实Fast验收计划_v1.md：严格原STEP113 STATIC_RC >=90秒、新APK源码SHA/设备SHA、Cache Build/Reuse/Fast及120帧24Gate、原63层与C、Source/Style/CAMERA mutation和用户画面、失败停止。
+- docs/报告/STEP-117_原PBF_Fast缓存准入_Codex完成报告_v1.md：模型全名档位、源码文件/公共ABI不变、证据、静态检查、当前BLOCKED和RDC实际测试步骤，commit/hash留RDC回填。
+- 粒子开发记录.md 末尾中文追加，必要README/说明文档修正。
+- git diff --check、静态API一致性与中文交付核查。禁止git add -A/git add ./git reset --hard/git clean，不触碰用户两份保护未跟踪文件 docs/40_任务/STEP-110_...和STEP-111_...，保留原Git忽略设备JSON。未经RDC工具真实返回，不得自称Native/Android PASS。最后停止交RDC进行独立代码审计、scoped commit/push/remote verification及一次集中Android build/installation/test。

docs/40_任务/STEP-119_Symbol稳定结果证书与R首次Build_Fast准入_Codex任务_v1.md

@@ -0,0 +1,33 @@
+# STEP-119 Symbol稳定结果证书与R首次Build/Fast安全准入
+
+日期2026-10-11。用户批准立即继续实施上一轮讨论的Shared Core方案，不是只读调查。
+项目 /Users/tei/dev/MapLibreParticleLab，particle/main基线869930046b11dbeb3b147e3be952a2e847316292；Integration /Users/tei/dev/navsea-particle-integration已同步origin/main=80667d6c343411d03a760425438e3d292f452118。实际Codex须GPT-6.1-Sol High（gpt-6.1-sol，model_reasoning_effort=high）。
+Codex负责开发、定向非Jest测试源码、中文文档，不执行Gradle/ADB/Native大编译/Bazel/Jest/commit/push。RDC独立核验、限定Git收尾并按用户授权集中执行一次APK build、install和真实设备验证。
+
+## 优先读取
+根AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范、docs/00_项目总则README和4份当前总则；Integration的instructions/PARTICLE_PROJECT_INSTRUCTIONS.md、README.md、WORKFLOW.md、coordination/TEAM_MODEL.md、contracts/、rfc/、adr/、status/、compatibility/。STEP117根因调查 docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md 与STEP118真机报告 docs/60_测试/STEP-118_潮汐清理新APK设备实测结果_20261011.md及STEP112-116关键报告。必须逐段核对src/mln/text/placement.cpp、render_orchestrator.cpp、renderer_impl.cpp、render_tree.cpp、retained_underlay_cache.cpp、include/mln/renderer/render_segment.hpp、RenderSymbolLayer/SymbolBucket/atlas/shader、24FastGate/RevisionBook及现有测试。
+
+## 已证实
+STEP118原生产63基础PBF图层测试副本只排除一条失效tide-spots（用户允许），保留其它62基础层、天气2层=Native64；R[0,62)、C[62,64)，missingSourceIds=[]、R fallback=static-placement、R Cache Build0/Reuse0；90.008s FastDelta0 FullDelta942；PlacementGatePassed=false，24Gate mismatch0。当前源码perSegment Gate对Symbol要求 !placementChanged && symbolFadeChange==0 && !placementTransitionActive；Full新排布置changed=true，recent复用设stale->hasTransitions=true，而Fade完全稳定时通常>=1而非0。独立global retainedPlacementStable/retainedStaticStable/retainedSupported/particlePreparedSceneSupported又阻断。首次Build与Fast复用需要分开。
+旧设备真实证据在Git忽略artifacts/maplibre-particle/android-validation/step113-retest-20261011_140448/static_rc_no_tide/result.json和screen.png。新测试APK源commit=3051196054c7b69815c298040dae61d26499d9f2、SHA=44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9。现HEAD较新只包含报告。
+
+## 本次必须优先真正实施的内容
+1. 在平台无关的Shared Core内部区分Placement计算调用与最终Renderable Symbol结果变化，建立可检验稳定状态、revisions/epoch/证书。不能用单一布尔值代替真正GPU输入一致性，不能把placed结果布尔不变当成vertices/opacity/atlas全部一致。保留跨瓦片collision、text/icon、variable anchors/方向、fade、glyph/icon/atlas、shader uniform/tweaker及绘制层序语义。必须检查GL和Metal两侧shader的symbolFadeChange clamp行为。普通Full应完成placement、updateBuckets/vertices、processChanges、tweakers/uploads，才决定可安全建立R缓存（同次或下一帧）。Build/reuse需要匹配版本，任何可影响像素的异步状态立即invalid并走Full。
+2. 解决Placement::placementIsRecent / setPlacementStale / hasTransitions语义和symbolFadeChange的>=1状态对首次Build的逻辑死锁。重新计算 != 真正GPU结果变化；stale不是强制正在fade。fade未完成仍必须阻断，所有真实动态Symbol/tiles/glyphs/Source/style/camera/viewport/pixelRatio/context/Annotation更新都fail-closed。不得简单常置false或单改renderSegmentPlacementGatePassed、删除24Gate、修改计数或强行把其它Symbol放进C。
+3. 必须同时审查并修复global/perSegment稳定性、revision/state跟踪和preparedSceneSupported，让首次R在安全的Full后建立Build，Reuse后才能Fast。缺失证明的Symbol子类严格拒绝，不能用概括性稳定状态假设可缓存。尽可能真正做到原62基础层静止时Build>0、Reuse>0、FastDelta>0；若架构上无法证明，明示BLOCKED，安全停止危险路径，但应尽量完成有证明的实现。
+4. 非Jest C++定向测试（已登记test/renderer文件），覆盖真实PlacementController生命周期、fresh->settled->build->reuse、fade过程拒绝、相机/缩放/旋转、纹理字形异步、新Source/style、Annotation、Context、tile/wrap/crossTile collisions、跨段LayerGroup安全重建；不能把无GPU predicate当真正GPU等价。
+5. 不改RN/JNI/ObjC/Java/Kotlin公共API与ABI、正式PBF/Source/MapLibre外部URL或NavSea/iOS业务、不变更Core-owned timeline/playback、不能改天气层语义。跨项目公共接口新语义须Integration RFC/ADR授权，必要则只报告并保留旧合同。
+6. 保持原STEP113 63 PBF和新STEP118 STATIC_RC_NO_TIDE派生测试、原24Gate、现有真实version/SHA的严格核对。不能新增虚构tide数据。
+7. 不触碰用户两个未跟踪 docs/40_任务/STEP-110_...与STEP-111_...，不git add . / add -A / reset --hard / clean；不修改Git忽略旧真机证据。Codex不运行Gradle/ADB/Jest/Native大编译、也不commit/push，最后交RDC。
+
+## 必做中文输出文件（缺一不得完成）
+- 实际Core实现+必要非Jest C++测试源码及直接相关诊断/README改动。
+- docs/20_调查/STEP-119_Symbol结果证书与R缓存Build实现依据_v1.md：真实渲染生命周期、核心不变量、结果证书如何绑定真实GPU绘制、反例、风险。
+- docs/50_Step记录/STEP-119_Symbol缓存实际实现_v1.md：状态、变更、验证、下一步。
+- docs/60_测试/STEP-119_原PBF_FAST实机联合验收计划_v1.md：一次build/install，新STATIC_RC_NO_TIDE >=90秒真实Build/Reuse/Fast+24Gate mismatch0，原63负对照及source/style/camera/glyph/annotation/context负例，视觉核验与fail closed。
+- docs/报告/STEP-119_Symbol缓存_Codex完成报告_v1.md：真实模型档位、文件、已实施/未实施、清楚BLOCKED或IMPLEMENTED_WAITING_ANDROID、静态检查、RDC命令、git commit由RDC负责。
+- 粒子开发记录.md在末尾中文追加。
+Codex只跑轻量静态范围和git diff --check；不可宣称Native/Android/iOS/用户视觉PASS。
+
+## RDC严格实机目标
+有实质Shared Core行为修改且独立审计通过后，Mac标准 ./tools/particle_android_validation/build_validation_apk.sh 一次Android OpenGL x86_64 APK；设备FZG1-2 ADB serial 192.168.200.139:5555且全部命令显式-s；运行 python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario STATIC_RC_NO_TIDE --seconds 90。必须真实R Build>0、Reuse>0、FastDelta>0、Symbol画面/24Gate一致、更新时缓存失效与Full正确。失败最多5轮当前步骤修复，不能跳过并声称通过。无行为改动则不重编毫无意义APK。

docs/40_任务/STEP-120_iOS原始Filter无损Native接口_Codex任务_v1.md

@@ -0,0 +1,33 @@
+# STEP-120 — iOS 原始 Style Layer Filter 无损 Native 公共接口（JOINT-PBF-001 D4-13 支持方）
+
+## 1. 主责和环境
+
+- 联调唯一业务主责：NavSea；本任务专业支持方：MapLibreParticleLab，只增加 iOS Native SDK 的可复用无损 Filter 公共接口，不能把 NavSea Provider/CM95 逻辑迁到 Native。
+- Mac 原仓库 `/Users/tei/dev/MapLibreParticleLab`，原分支 `particle/main`，当前 HEAD `9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`，开工必须重新检查 Git status/worktree/submodule，预期干净。**禁止新建/切换 branch/worktree**、reset/clean、stage/commit/push/tag、升级依赖或发行，保留其它项目。
+- Codex **GPT-6.1 Sol High**，由外部 CLI 明确配置；只实现/自检，不执行 Bazel/Xcode/Android Gradle 构建或发布。后续 RDC 负责独立编译和版本发行管理。
+- 开始前必须完整读取本仓 `AGENTS.md`、`PARTICLE_BASELINE.md`、`docs/00_项目规范/`、`docs/00_项目总则/README.md` 及 README 中现行全部规范、`docs/00_项目总则/当前基线与开发路线_v2.md`、本任务和最新 iOS 正式发行文档 `release/maplibre-particle/13.6.1-particle.27/README.md`、当前 C++/Darwin 实际源码。本仓早期 Linux 说明与当前 Mac 实际基线冲突时，以已确认 Mac 主机事实为准；报告真实差异，不自行编辑项目总则。
+
+## 2. 真实问题与任务目标
+
+NavSea MLRN11.5.0 D4-11 Android 已支持 existing Style Layer 三个 Filter 接口且 Mac Kotlin/Java/AAR 编译通过；D4-12 iOS 支持被明确阻断：`MLNVectorStyleLayer.predicate` 的 C++ `Filter` → NSPredicate 转换对某些复杂 `all` / 带 `locale` 条件会有损，加载时 `styleJSON` 不是当前 Layer 状态，无法保证外部修改检测和原图层 Filter 精确恢复。不得使用 `NSPredicate` getter 或 Style 初始化 JSON 伪造安全快照。
+
+本 Step 仅在 MapLibre iOS Native SDK 的 `MLNVectorStyleLayer`（或同一现有 Style Layer 类层次）提供 **C++ `style::Filter` → 原始 JSON 对象无损读取 + JSON 对象 → C++ `style::Filter` 直接设置** 的最小公开 ObjC API，让 MLRN 按已冻结单一 Context 语义完成操作。直接使用 `self.rawLayer->getFilter().serialize()` 和真实 `MLNJSONObjectFromMBGLValue`，设置通过 `mln::style::conversion::convert<mln::style::Filter>(mln::style::conversion::makeConvertible(json),error)` 解析并且只在成功后 `self.rawLayer->setFilter()`，不经过 NSPredicate 的有损中转。具体以真实可编译 SDK API 为准。
+
+## 3. 严格修改范围及安全条件
+
+允许修改：`platform/darwin/src/MLNVectorStyleLayer.h`、`platform/darwin/src/MLNVectorStyleLayer.mm`，如果必须引用已有内用辅助头可包含，不修改具体 Style Layer 生成器，不增加 NavSea 专用 API、不修改 C++ 算法/滤镜语义、不修改 Android/Particle/RenderCore。若真实源码要求触及其他文件，先报阻断，不自动扩大。
+- 暴露稳定、简洁、明确的 ObjC 方法，例如 `- (nullable id)rawStyleFilterJSONObject`、`- (BOOL)setRawStyleFilterJSONObject:(id)json error:(NSError **)error`；最终名称与语义请依据当前代码风格确定，务必公开到随 XCFramework 构建的 Headers。
+- **未修改的原始 Filter** 必须从当前 rawLayer 的 Filter 精确读取，不能触发模型折叠/locale/条件丢失；序列化只允许无损 `mln::Value` 到 Foundation JSON（含 NSNull）。过深/不合法输入应拒绝且不修改原层。源 Layer 已 invalid/detach、非 Vector Layer、解析错误必须拒绝或抛出明确错误。Style generation/Layer ID/revision 上下文属于 MLRN Host，SDK 不自行创建另一套状态管理。
+- 新接口只改 Filter，绝不可删除 Layer、改变 Paint/Layout/Source/Z-order、重载 Style 或触碰 Particle 渲染。保持既有 `predicate` 原功能/签名及其旧行为不变。
+- 提供至少三组源码级安全样例（含 `all` 第二个属性与 `locale` 参数、一般 `==`、原为空）作为受限测试/报告中的验证条件；可以用现存 Core/Style 单测框架若实际可用，但本任务不涉及 Jest。无可运行单测时记录待 RDC Test Gate，不编造 PASS。
+
+## 4. Codex 验收输出
+
+- 静态检查（无构建时可做 C++/ObjC 语法和源码审查，绝不可冒称 iOS 编译）；`git diff --check`。
+- 所有已完成/未完成/无法验证项和当前 ABI 兼容/新 API 约束写入中文报告：
+  `docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md`，如果同题已存在须递增版本，禁止覆盖。
+- Step 文件 `docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v1.md`，以及 `粒子开发记录.md` 仅追加。不能编辑现有旧报告、Release README/SOURCE_LOCK 或产物记录。
+- 结论 `IMPLEMENTED_WAITING_RDC_IOS_BUILD` 或明确 BLOCKED；不标记 iOS 可打包、发版、真机 PASS；不创建/切换 Git 分支/worktree、不执行 Commit/Push/Tag。
+- GPT/RDC 将独立复核并执行实际 Mac Bazel iOS SDK 精确编译，复测无损接口可用性；如通过，另起正式发行/NavSea Host 集成步骤，遵守 GSRL 与跨项目发布边界。主责仍 NavSea。
+
+目标不漂移：本 Step 为双平台原始 Style Layer Filter 功能提供底层无损基础，不是原始多源 Provider 项目的最终完成。

docs/40_任务/STEP-120_iOS原始Filter无损Native接口_Codex任务_v2.md

@@ -0,0 +1,20 @@
+# STEP-120 v2 — iOS Style Filter 无损或拒绝的最小 Native 接口（续行）
+唯一业务主责 NavSea；专业支持仓 Mac `/Users/tei/dev/MapLibreParticleLab`，原 `particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`，禁止创建/切换分支/worktree、reset/clean、Git stage/commit/push/tag/发布。Codex 必须 **GPT-6.1 Sol High**。用户授权 Mac 自动完成双平台以便之后自行打包。本续行任务针对 v1 的真实阻断**收敛准入范围**，不是降低安全条件。
+
+## 必读和原始目标
+阅读仓库 AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范、docs/00_项目总则 README 及全部现行总则、当前路线、v1任务 `docs/40_任务/STEP-120_iOS原始Filter无损Native接口_Codex任务_v1.md`、v1报告 `docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md`、当前 native iOS Filter源码及 Git status。原目标仍是 NavSea 多 PBF Provider/唯一 Mapping/原始 Style/四档/Pickup/Danger/Planning；本 Step 只解 iOS Filter 快照/修改底层能力，不碰业务内容。
+
+## v1 阻断的确认与限定设计裁决
+
+1. 当前 `MLNJSONObjectFromMBGLValue` 使用 c_str 导致 Foundation 对合法内嵌 NUL 字符串/键可能截断（另有数值和 legacy Filter 折叠风险）。**无需为了支持所有 JSON 扩大修改到全局转换器**。只对本次 API 的数据执行 preflight 与后验验证：支持被证明转换无损的 Filter；任何包含 U+0000、超出大小/深度/节点限制、数字不能无损转换、Core 重新转换/serialize 与原始 C++ `Filter.serialize()` 不等价、或无法证明互逆的输入必须 **E_FILTER_UNSUPPORTED / NSError**，不能返回截断后的成功对象。用 C++ `mln::Value` 结构/语义等价检查和反向 Core `conversion::convert<Filter>` 验证；仅对可重放的子集返回结果。
+2. Layer 在正常 `removeLayer:` 后 `rawLayer` 可能仍合法但已不属于 Style；SDK 只有通用“rawLayer 是否有效”检验，**Style 成员关系必须由 MLRN Host 调用侧校验**（当前 Style 根据 Layer ID 返回的对象身份、Token 等）。SDK API 只操作**当前有效 rawLayer**，不能伪称它能证明当前 MapStyle Membership。严格记录此边界到 API Doc 和报告，不因单独 Native SDK 无 MapView 访问而阻断可行实现。已销毁的 rawLayer 要 reject。
+3. 保留 `NSPredicate` getter/setter 现有行为不变。提供新的独立 ObjC API，在现有 `platform/darwin/src/MLNVectorStyleLayer.h`/.mm 内使用真实 C++ Filter 与现有转换器，无 NSExpression/NSPredicate 读写中转。空 filter 可返回 NSNull，恢复 set Filter()，上游 MLRN 如遵循 Android 约束可选择 fail-closed 不下发 null 修改。
+4. 新 Native Setter 必须先确保输入 JSON 是支持类型（数组/NSNull 等），在调用 `rawLayer->setFilter` 之前转换、完整验签；绝对不能先写再发现数据损失。若 Core setter 后与预期不符应作可验证原状态回滚/抛错误，必要时由 Host 毒化 context。方法命名稳定、NSError 代码明确，公开头将由当前已确认 Bazel 目标收录。
+5. 修改范围仍仅 `platform/darwin/src/MLNVectorStyleLayer.h` 与 `.mm`，另只新增中文 Step、报告、追加开发记录；不允许修改全局 `MLNStyleValue.mm` 等辅助文件、不改 C++ Filter、生成器、iOS Build、Android、Particle。若确实无法在两文件实现“无损或拒绝”，再次明确阻断，不制造占位。
+
+## 实施与校验要求
+- 实现并精确记录拒绝域：包含 NUL 的字符串/键、特殊数值、大/深对象、legacy filter、SDK不支持的复杂表达式；尽可能不阻断常见 `all / any / ! / get / has / == / literal`，但宁可拒绝也不得删语义。
+- 静态证明输入与原始 Core `Filter.serialize()` 一致性，至少采集简单等值、范围两个属性、locale，以及 NUL 拒绝例；如果不能在 Codex 环境运行 Native 单测，标记 RDC 待测，不冒称通过。
+- Codex 不运行 Bazel/Xcode/Gradle 长构建或 Jest；只做 `git diff --check` 等精确源码检查，RDC 后续负责真实 iOS Metal 编译和产物。
+- 必须输出中文 `docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md`（若已存在则新版本），`docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v2.md`，追加 `粒子开发记录.md` 而不覆盖 v1；报告逐项完成/未完成/无法验证，Git/源码/编译/设备证据边界明确。
+- 禁止任何 Git 分支切换、stage/commit/push/tag、正式发行、破坏其它工作区修改；Codex 只实现；GPT/RDC 完成后严格独立验收。原始多源 Provider 目标仍开放。

docs/50_Step记录/STEP-108_V23统一正式发行_v1.md

@@ -1,7 +1,7 @@
 # STEP-108 V23 同源统一正式发行 v1
 
 - 日期：2026-10-09（JST）
-- 状态：**构建 PASS / 六项公网回读 PASS / GSRL 锁与 Tag 收尾中**
+- 状态：**CLOSED / GSRL PASS / RELEASED（设备验收独立进行）**
 - 冻结源码提交：`87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`
 - 主目录：`/Users/tei/dev/MapLibreParticleLab`，分支 `particle/main`
 - 版本：Android/RN `13.6.1-particle.23`，iOS Metal `6.29.0-particle.23`
@@ -12,9 +12,20 @@
 2. Build：`tools/particle_release_pipeline/release.sh 23 build`，exit 0；Android OpenGL 四 ABI Release、Maven Local、iOS Metal Bazel opt 与 RN tgz 均 PASS。日志：`/tmp/maplibre_v23_unified_release_build_20261009.log`。
 3. Publish：`tools/particle_release_pipeline/release.sh 23 publish`，exit 0；六文件 NAS 公网逐字节回读 PASS，SwiftPM `6.29.0-particle.23` Tag 可取。日志：`/tmp/maplibre_v23_unified_release_publish_20261009.log`。
 4. GSRL：六项文件实际 SHA-256 与下载地址见 `release/maplibre-particle/13.6.1-particle.23/SOURCE_LOCK.json`。
-5. Finalize：正式源码 Tag `maplibre-particle/rn/13.6.1-particle.23` 及最终远端核验执行后记录。
+5. Finalize：release.sh 23 finalize exit 0；正式发行 Tag 已成功 push；远端 main 和 tag 回读验证通过。
 
 ## 未验收及禁区
 - STEP-107 XCTest 与 iPad 直接点击崩溃场景尚未运行；不得宣称已实机修复。
 - V23 Android 实机、React Native 宿主整体集成、iOS Metal 真机 NOT_TESTED。
 - 原 V22 Tag/Source Lock 与发行制品不覆盖；禁止新建 worktree、擅自纳入无关 dirty 文件。
+
+
+## 最终发行验收证据
+
+- 实际构建源提交：87f3d1c59a52581fb8339f0ea7d106b9f4b94fef。
+- 发行清单提交：a0a4787b4379ab2819943d20ce05a7ae760a88c3，Tag maplibre-particle/rn/13.6.1-particle.23 指向该 Commit。
+- SwiftPM Tag 6.29.0-particle.23 公网可读，二进制 checksum 匹配。
+- 六个制品再次经 curl 公网下载，全部 HTTP 200，长度、SHA-256 与 GSRL Source Lock 全部一致，TASK_PASS_V23_GSRL_FINAL_VERIFY。
+- 最初独立 Python urllib 请求遇到 HTTP 403，改用正式发布脚本使用的 curl 请求后六项全部 PASS，文件没有被重新上传或修改。
+- V23 GSRL 发行 CLOSED / PASS，STEP-107 XCTest、iPad 事故重放、Android/RN/iOS 设备测试仍 NOT_TESTED。
+- 本补充属于发行 Tag 之后的审计提交，不更改发行 Tag、SOURCE_LOCK.json 或公开二进制。

docs/50_Step记录/STEP-109_V23_CPU_FieldSnapshot深比较快路_v1.md

@@ -0,0 +1,35 @@
+# STEP-109 V23 CPU FieldSnapshot 深比较快路 v1
+
+日期：2026-10-10（JST）
+状态：进行中（源码已改；Mac Native 编译及设备 CPU 对照待验）
+
+## 基线
+- 设备：Mac.lan，仓库 /Users/tei/dev/MapLibreParticleLab。
+- 分支：particle/main；起点 HEAD：5b8bdfbfbb4263fe12a060e77bc310cf77f27d61；起点工作区干净。
+- 已发布基线：Android / RN 13.6.1-particle.23，iOS 6.29.0-particle.23；正式 V23 Tag、Source Lock 及制品均保持不变。
+- V21 FZG1-2 曾有天气持续运行高 CPU 与疑似浮点数组比较样本；不是 V23 的测量结果。
+
+## 调查依据
+- render_particle_validation_layer.cpp 稳定每帧通过 sameFieldGpuEndpoint() 比较 T0/T1，比较包含整个 vector 与 valid。
+- render_weather_color_layer.cpp 稳定每帧通过 sameFieldGpuContent() 比较完整 scalar/vector/valid。
+- V23 源码中已保留 STEP-090 Fast Path；STEP-102/106 已处理部分 RenderSegment Placement 语义，不对 V23 再次假设 cache-invalid。
+
+## 本次非正式修改
+- [x] ParticleGpuResources 记录与真实 GPU T0/T1 槽位相应的 shared_ptr<const ParticleFieldSnapshot>。
+- [x] WeatherColor Resources 同样记录两帧快照身份。
+- [x] 相同不可变 shared_ptr 且资源代际未变时，跳过 O(N) 深比较。
+- [x] 新快照对象、窗口更换、旧资源不存在时保留严格内容/端点对比。
+- [x] 只有真实纹理安装成功或严格等价比较后更新资源绑定身份；clear、context loss 与资源重建自动丢弃旧身份。
+- [x] 保留 T0/T1、MIX、时间跳转、窗口重用、编码/内容身份、双平台 Renderer 语义。
+- [x] 未改公共 API、RN、JS/TS、RenderSegment 安全 Gate、任何发行制品。
+
+## 构建与验收
+- [x] git diff --check PASS；只修改 2 个 C++ 文件。
+- [ ] Mac Metal Native Core 编译：**NOT COMPLETED / 用户验收前主动中止**。`bazel build -c opt --//:renderer=metal //:mbgl-core` 因触发 649 个通用 Core actions 的大量重编译，尚未走到构建成功/失败结论；已中断 Bazel 客户端并核对其 PID 退出。日志 /tmp/maplibre_step109_cpu_field_identity_bazel_20261010.log。此项不能写为 PASS。
+- [ ] C++ directed regressions（snapshot identity、new-object differing payload、window shift、clear/reload）。
+- [ ] Android OpenGL / FZG1-2 同场景 V23 原版与修改版 CPU A/B：尚未执行。
+- [ ] iOS Metal iPad 实际天气场/时间窗回归：尚未执行。
+- [ ] 真实性能目标：至少比较相同场数据、帧率、图层与设备条件下的平均进程、RenderThread、JS CPU；同时检查 FieldTextureUpload / SimulationReset 计数无异常增加。
+
+## 交付边界
+本 Step 不创建新发行版本，不覆盖不可变 V23 产物。开发态代码已通过 scoped commit `2aae38f4023f2ef682c9039c93dfa1e96b0e6e1b` 并 push 到 origin/particle/main（远端 SHA 回读 PASS）；这不是 Native 编译、性能或正式版本验收。正式使用仍须完成编译/设备测试、另立版本并执行 GSRL Source Lock、SHA-256、接收验收。若编译失败，则先记录错误并修复，不得宣称优化 PASS。

docs/50_Step记录/STEP-110_R0_Placement跨段归因只读调查_v1.md

@@ -0,0 +1,31 @@
+# STEP-110 R0 Placement 跨段归因只读调查 v1
+
+- 日期：2026-10-10
+- 状态：**PARTIAL（调查性质；非修复/性能 PASS）**
+- 仓库：/Users/tei/dev/MapLibreParticleLab；分支 particle/main
+- 调查起点 HEAD：2df504cdc0403bdad85d3f31f16fd54a8744abac
+- V23 Source Lock：87f3d1c59a52581fb8339f0ea7d106b9f4b94fef；V23 tag peeled commit：a0a4787b4379ab2819943d20ce05a7ae760a88c3
+- Codex 实际模型：gpt-6-astra / high（CLI 启动日志确认），CLI 0.161.0；Codex 调查完成，文档交付会话多次卡住，之后由 RDC 整理、落盘并独立审查关键源码。
+- 主报告：docs/20_调查/R0_Placement跨段归因与缓存安全边界调查_v1.md
+
+## 已完成
+
+1. 读取 STEP-110 任务书、根 AGENTS/基线、项目总则，以及 STEP-088/089/090/092/094/099/100/102/106/108/109。
+2. 比较 V23 GSRL build Commit、Tag commit 和 main；核心六份 Renderer/Placement/Cache/Fast Path Git Blob 完全一致。
+3. 只读追踪 Renderer::update、RenderOrchestrator::createRenderTree、CrossTileSymbolIndex、PlacementController、RenderTree、per-segment Placement Gate、Retained Cache、Fast Path。
+4. 读取 STEP-106 本机既有 T1/T2 设备日志，确认 placement-free Retained 段复用，不推定含 Symbol R0 可复用。
+5. 回答 Q1–Q4、七个反事实场景、结论矩阵与风险优先级，并明示 cannot prove 的范围。
+6. 不涉及 Native/JS/Kotlin/测试代码修改；未运行测试、Jest、构建、Gradle、CMake、Bazel、ADB 或设备验证。
+
+## PARTIAL 原因
+
+- NavSea 生产 R0 逐 Symbol placement/fade/visibility 等价证据缺失；只读源码不足以证明 C1 的 Placement 变化完全不影响 R0。
+- 本次不允许插桩、修改 Core 算法、重测 NavSea 或新建安全机制。
+- 需要另行授权 Native 内部诊断/安全判据，再进行跨 Source 碰撞与真实 CPU/视觉 A-B。
+- 本地报告写入由 RDC 完成，不能误称 Codex 已直接交付文档。
+
+## 结论及停手范围
+
+R0 含地名 Symbol，V23 全局 Placement/Fade Gate 的保守失效与现有设计相容；**当前没有证据判定为既有不变量遭破坏的 Bug**。对 placement-free R 的 STEP-102 隔离已通过历史测试，不能直接解除 placement-bearing R0 的 Gate。
+
+Git 收尾证据以 STEP-110 完成报告和最终 RDC Git 验收为准；禁止提交原来未跟踪的 STEP-110 任务书或其他无关文件。本任务无正式 Binary/Source Lock 发行。

docs/50_Step记录/STEP-111_R段Placement结果等价调查_v1.md

@@ -0,0 +1,21 @@
+# STEP-111 R 段 Placement 结果等价调查 v1
+
+- 日期：2026-10-10
+- 状态：**PARTIAL；调查未完成，Native 未实施**
+- 仓库：Mac `/Users/tei/dev/MapLibreParticleLab`，`particle/main`
+- 任务起点 HEAD：`7ec9ac8c1635c7a3b607abc2ed4be4fd764e7b6d`
+- 模型：Codex CLI 0.161.0，实际可见 TUI `GPT-6 Astra high`。
+- 执行：Codex 两轮源码探索后停止新增事件；尝试同会话缩窄为直接出报告，仍无报告生成。会话已人工中断并退出，未取得可靠退出码，不能认定正常完成。
+- GPT/RDC 随后只读核验 `render_segment.hpp:85-90`、`render_orchestrator.cpp:775-810`、`renderer_impl.cpp:638-686` 与 STEP-110，并编写 PARTIAL 评估；不是 Codex 完整调查报告。
+
+## 有证据的阶段结论
+- Retained Cache 已逐 R 管理，但含 Symbol 的 R 使用全局 Placement/Fade Gate，未依据该 R 的最终 Symbol 结果判等。
+- 可以把“全图 Placement 后按 R 判断纹理是否复用”作为候选优化路线，不把 Segment 当作独立 Collision Domain。
+- 难度初估：诊断 2–3/5、shadow 比较 3/5、安全独立 Reuse 4/5、分段增量 Collision/Placement 5/5；数字仅为工程评估，未通过真实实现检验。
+
+## 未完成、禁止夸大
+- 未形成稳定/完整的 per-R 视觉等价签名设计或生命周期证明；无新 Native 插桩、运行数据、编译、测试、Jest 或设备 A/B。
+- Codex 未生成预定三份交付文件；由 GPT/RDC 记录 PARTIAL，不写“Codex PASS”。
+- 原有未跟踪 STEP-110 任务书和本次 STEP-111 任务书均保留，不参与文档 Git 提交。
+- 主报告：`docs/20_调查/STEP-111_R段Placement结果等价与独立刷新可行性调查_v1.md`。
+- 后续先审查稳定 ID、Fade 和 per-R 最终数据所有权，再考虑 shadow-mode 与缓存 Gate 改造。

docs/50_Step记录/STEP-112_V23粒子FullRender与Symbol缓存调查_v1.md

@@ -0,0 +1,56 @@
+# STEP-112 V23 粒子 Full Render 与 Symbol 缓存调查 v1
+
+日期：2026-10-11（JST）。状态：**完成（本轮只读调查交付）；综合判定 PARTIAL（生产逐帧归因、安全修复与性能未验证）**。
+
+## 目标与基线
+
+只读完成任务A—E、全Gate矩阵、R2状态机、Placement/Fade两种配置、S1—S5及A—D提案；不实施Native修复。
+
+- Mac.lan / Darwin 24.6.0 / x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 起点及结束基线：`particle/main@41b416c261fa72bd21171328045036a124694f47`。
+- 模型已从本会话rollout确认 `gpt-6-astra/high`；无切换、无子代理。
+- Integration HEAD `80667d6c` 采用用户提供的RDC核实事实，只读相关契约/决议。
+- V23 Android/RN `13.6.1-particle.23`、iOS `6.29.0-particle.23`。对V23构建源码 `87f3d1c…` 的相关路径diff只有STEP-109两Layer快比较；本调查核心Gate保持一致。
+
+## 必做项与结果
+
+- [x] 按序阅读AGENTS、基线、8份规范、总则README和四份有效总则、当前任务与STEP-102/106/109/110/111。
+- [x] A：Core/Android/iOS请求→Fast/Full→GPU→Observer/Idle调用图，区分forecast与粒子cadence。
+- [x] B：24项Fast Gate，逐项来源、通过条件、首错、Tick影响、Full恢复与现场证据强度。
+- [x] C：R2结构能力、Source/local/global revision、evaluate/BuildPending/资源/成功/失败/合成状态机。
+- [x] D：transitions开关、300ms/30ms/zoom、fade公式、8组合真值表、GL/Metal opacity链。
+- [x] E：S1—S5逐帧/事件推演和布局对照；原RCRR完整边界缺失明确标未知。
+- [x] A—D提案：优先级、首建/scene/C覆盖、正确性、资源代价、候选文件、1—5复杂度、双平台最小验证；D列Interface Blocker。
+- [x] 先创建框架、分阶段追加证据，最终三份交付文档和开发记录追加已落盘。
+- [ ] FZG1同帧全Gate/配置/CPU归因、生产Symbol结果等价、GL/Metal运行验证：本轮禁止执行，留给另行授权阶段。
+- [ ] Native修复、插桩、性能改善：本轮明确未授权，未执行。
+- [x] 指定四文件scoped commit/push及远端HEAD：由RDC在Codex调查后执行，首次提交与Push已核验；实际记录见下文Git收尾补记。
+
+## 主要源码结论
+
+正常Continuous Full中，含结构性Symbol的R要求 `!changed && fade==0 && !transition`；重算分支changed=true，不重算分支setPlacementStale令transition=true，因此首次Build没有准入窗口。即使全体Source静态也成立。`fade==0`不是Fade终态；关闭transitions的正常Full为true/1/false，现场true/0/false与开启配置的稳定重算相容。
+
+R2 invalid令下一次Fast在cache-invalid返回；另有全局prepared scene及PREFIX中普通Symbol/Line C的独立阻塞。Full可以复用R0/R3，不等于全图全部重画。上述不证明安全放宽Gate，也不证明现场每次Placement都改变R2像素。
+
+## 允许范围与必做输出
+
+仅四文件：
+
+1. `docs/20_调查/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_v1.md`
+2. 本阶段记录。
+3. `docs/报告/STEP-112_V23粒子FullRender与Symbol缓存调查_Codex完成报告_v1.md`
+4. `粒子开发记录.md` 仅追加。
+
+两份未跟踪STEP-110/111任务书保持原样。未改源码、测试、Style、脚本、跨项目文件、版本或发行产物，未清理dirty或改变branch/worktree。
+
+## 检查、阻塞与下一步
+
+只执行只读源码/Git比较和文档范围、完整性、空白检查；实际结果详见完成报告。编译/链接/codegen/测试/Jest/Gradle/APK/ADB/设备操作全部未运行，无新制品。
+
+剩余证据：FZG1实际Placement options和24项Gate逐帧序列、原始完整plan、Source/forecast/Annotation来源分摊、Symbol最终GPU输出安全等价。下一步仅建议授权A低开销同帧诊断与B生命周期安全证据设计；不得先删Gate。公共明确Full命令语义由Integration决定。Codex不负责Git收尾；STEP-112任务书要求RDC独立完成仅文档scoped提交、推送和远端验收，结果以Git收尾补记为准。
+
+## RDC Git 收尾补记（2026-10-11）
+
+- RDC独立检查 branch=`particle/main`、起点 HEAD=`41b416c261fa72bd21171328045036a124694f47`；仅stage任务规定的三份STEP-112文档及`粒子开发记录.md`，`git diff --cached --check`通过，恰好四文件，原两份未跟踪STEP-110/111任务书不触碰。
+- 首次文档提交：`abc137ca9637abc18be8c64cd98f2c7f1ed68704`，message=`docs: investigate STEP-112 particle full render and symbol cache`；普通`git push origin particle/main`退出码0；`git ls-remote origin refs/heads/particle/main`返回相同SHA，首次远端验收PASS。
+- 本段是RDC在Codex完成后补写的Git事实；补记自身形成单独文档提交，最终HEAD与远端一致性以RDC最终回读为准，不影响源码调查PARTIAL或禁止运行的设备/构建项目。

docs/50_Step记录/STEP-113_FZG1_PBF_Layer与FastGate诊断_v1.md

@@ -0,0 +1,100 @@
+# STEP-113 FZG1 PBF Layer 与 Fast Gate 诊断 v1
+
+日期：2026-10-11（JST）。状态：**进行中；源码交付PARTIAL，等待RDC独立编译/设备验收，113层完整等价缺证据。**
+
+## 目标、基线与边界
+
+优先B：每次真实Fast尝试可靠保存24 Gate、首错及失败全集；再交付真PBF专项场景、低频UI和机器可读导出。
+
+- Mac `particle/main@c6d13e1059d464d312ac33acac87967300fa5dc4`，仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 已实际核实模型 `gpt-6.1-sol/high`；NavSea只读 `ad9aa043`，Integration本地 `80667d6c`。
+- 当前源码版本 `13.6.1-particle.23` 未改；本次修改未发行。
+- 只修改Shared Core诊断、Android Test App、相关C++测试源码、本Step/报告及开发记录追加。禁止改变Gate/Placement/Fade/Cache安全判定、公开RN方法、NavSea/Integration、构建基线、正式发行或Git提交推送。
+- 既有STEP-110/111/113未跟踪任务书原样保留，无branch/worktree变更。
+
+## 必做项与当前结果
+
+- [x] 同一次已计算input保存24项状态掩码与生产首错，一致性计数明确，不重复副作用函数。
+- [x] 120帧有界环形数据、生命周期及窗口聚合，所有Gate记录；pre/post明确分离。
+- [x] per-R实际pre cache validity/revision和两phase的cache build/reuse/invalidation/fallback/原因/执行状态；每phase最多16R，超限显式。
+- [x] 使用现有Native JSON出口追加可选fastGateTrace；共享锁快照，UI不访问Renderer mutable state。
+- [x] 明确reset位置；普通Full miss不清历史。新增4个C++回归用例，尚未运行。
+- [x] 正式URL专项PBF63/STATIC_RC/PARTICLE_OFF/PARTIAL_RCRR/SOURCE_CHANGE场景源码；保留原场景和STEP-102动态fixture。
+- [x] 运行时原63层完整定义/顺序保存检查，真实Sprite/Glyph/Tile URI检查、Style fingerprint/版本/Layer表/plan接受及最终解析原因导出。
+- [x] 固定camera/forecast请求、30fps目标；禁用手势；静态轮询不改Symbol/Source/forecast。
+- [x] UI每3秒单次query、30秒摘要、手动最近snapshot导出；Logcat标签STEP113Gate，Base64分块防截断。
+- [x] 中文完成报告、精确RDC命令、开发记录末尾追加与静态范围检查。
+- [ ] 113层全量生产Layer/Source/显隐/业务数据与现场四段数字边界：缺同版本完整快照，未复制。
+- [ ] Native/Kotlin编译、定向测试、APK、FZG1-2资源/层/逐帧/性能/开销验收：本轮Codex未执行。
+
+## 证据等级与剩余风险
+
+SOURCE-PROVEN：NavSea URL配置、当前源码RC选择器、shared天气片段ID/type/source。TEST-APP-STRUCTURAL：保序63层和部分RCRR检查代码、额外Source探针、既有canonical风场。DEVICE-MEASURED：本轮无结果。NOT-VERIFIED：正式服务回读（本机域名无法解析）、设备实际Layer表/113层全等价、构建与性能。
+
+原始JSON63层不包含SDK可能追加的Annotation等内部层；必须使用实际Native styleLayers总数与Layer ID解析边界。部分RCRR锚点不同于现场[0,13)/[13,33)/[33,107)/[107,113)，不能把结构测试说成同等画面。NavSea当前RenderSegmentHost源码RC与该历史现场RCRR_PREFIX分别记录。
+
+pre里的changed/fade是上一完成RenderTree快照；当前Controller transition另存preFastPlacementTransition。Fast post不是新Placement结果。Debug simulationAdvance是进程级计数；实际forecast时间未新增Native回读接口，导出null并保存accepted请求。环形覆盖会丢弃最早详情但保留聚合；内存字节/CPU开销未实测。不能从零Fast提升或APK编译成功直接判性能PASS。
+
+## 独立验收填写栏（由RDC追加真实结果）
+
+| 项目 | 本轮状态 / RDC证据待填 |
+|---|---|
+| 源码diff/hash、分支/HEAD/dirty | Codex交付未提交；RDC填写制品对应源码 |
+| 设备serial/主ABI/ABI list | 目标192.168.200.139:5555；未读取 |
+| Native配置/编译/4个新用例与相关回归 | NOT RUN；填写命令/exit/耗时/日志/首错 |
+| APK build-info/ZIP/ABI/字节/SHA/签名/安装 | NOT RUN；标准Validation脚本，禁止复用失败旧APK |
+| PBF63完整资源、实际Layer manifest | NOT VERIFIED；填写SDK回读fingerprint和原/实际层数 |
+| STATIC_RC首错/24Gate/window/mismatch | NOT VERIFIED；mismatch必须0，保存120帧详情 |
+| PARTICLE_OFF/固定预报/camera | NOT VERIFIED；保存对照窗口和请求接受结果 |
+| PARTIAL_RCRR实际四段/Layer ID/缓存状态 | NOT VERIFIED；明确部分等价，不能补写113层PASS |
+| SOURCE_CHANGE基线/单次变化/pre-post | NOT VERIFIED；记录Source mutation和两次导出 |
+| reset/前后台/退出/旧STEP-102回归 | NOT VERIFIED；不能以进程正常退出替代场景检查 |
+| 内存/trace开销/CPU/FPS/截图/crash | NOT VERIFIED；不能用单制品构建成功替代 |
+| 完整113层及原始现场selector | 缺证据；另需真实同版本快照 |
+
+## 构建、检查与必做输出
+
+Codex仅执行只读调查、文本一致性/范围检查、git diff --check与新增文件空白检查；无编译、C++运行、Jest、Gradle/APK、ADB、设备、发行或Git提交推送。
+
+精确macOS Shell构建/ADB/场景/Logcat/私有JSON回读及Native定向命令见：`docs/报告/STEP-113_FZG1_PBF_Layer与FastGate诊断_Codex完成报告_v1.md` 第5节。Android ABI先匹配标准脚本x86_64，所有设备命令固定 `-s 192.168.200.139:5555`，由RDC执行。
+
+交付源码/测试、本记录、上述完成报告、粒子开发记录追加已落盘。下一步仅由RDC独立验收；失败保留首个真实error及完整日志，再按本任务范围修复。不得借此放宽Fast/Placement/Cache安全判定或进入正式发行。
+
+
+## RDC 独立验收补记（2026-10-11，设备证据）
+
+以下是 Codex 退出后 RDC 新执行的证据，不修改上文 Codex 未构建/未实测的历史结论。本次阶段判定：**PARTIAL；Android 构建 PASS；五场景稳定基线采样 PASS；113 层等价与性能 NOT VERIFIED**。
+
+- 环境：Mac、particle/main；构建源码基于 c6d13e1059d464d312ac33acac87967300fa5dc4 加 STEP-113 未提交改动，build-info 明确 git_dirty=true。此 APK 不是 Source Lock / 正式发行。
+- 标准 build_validation_apk.sh 于 2026-10-11 08:35:08 JST 退出码 0；Gradle BUILD SUCCESSFUL in 19m 22s；Java 17.0.20.1；OpenGL/x86_64；ZIP/ABI/体积/SHA 自检通过。
+- APK：artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk；66,587,454 bytes；libmaplibre.so 40,033,976 bytes；SHA-256 0054248bc3872e8670df4e9a10d11f1d65c0912a0482586cd7a247e880a6eaef。记录：同目录 build-info.txt、build.log。
+- 设备：FZG1-2，ADB 192.168.200.139:5555，主 ABI x86_64；明确 -s 的 adb install -r 返回 Success，未卸载数据；设备安装后版本 13.6.1-particle.23。正式 PBF Style 模式运行并加载。启动前数秒 sceneReady=true 但 Native Layer=0 / plan not-configured 是加载暂态；只接受之后的 Native Layers 非零、planValid=true 稳定记录。
+- 五个场景均由 ADB 明确 serial 启动；STEP113Gate Logcat Base64 summary 成功还原。每场景实际设备稳定状态的 decisionMismatch 都是 **0**。Full/Fast/Attempts 为生命周期累计，并非精确 60 秒窗口。
+
+| 场景 | Native Layers | Attempts | Full | Fast | Retained 及关键证据 |
+|---|---:|---:|---:|---:|---|
+| PBF63 | 64（63+内部层） | 106 | 106 | 0 | R[0,64) Build0，unknown-dependency；无粒子持续驱动 |
+| STATIC_RC | 66 | 876 | 875 | 0 | R[0,63) Build0，unknown-dependency；unsupported-continuous-layer、unsupported-scene 各876 |
+| PARTICLE_OFF | 66 | 70 | 70 | 0 | no-particle-repaint=70；非相等时长性能对照 |
+| PARTIAL_RCRR | 66 | 862 | 861 | 0 | R0[0,3) unknown-dependency；R2[39,64) 与 R3[64,66) Build0/static-placement；两个 unsupported Gate 各862 |
+| SOURCE_CHANGE | 67 | 888 | 888 | 0 | 基线已记录；**没有执行菜单手动 Source mutation** |
+
+- STATIC_RC 同帧失败全集汇总 CacheInvalid=870、revision-mismatch=871、placement-or-fade=780；PARTIAL_RCRR CacheInvalid=856。这些失败条件可能在**同一帧**并存，不能累加为帧数。即使修复缓存 Build，也还有 #22/#23 与其它独立 Gate。
+- 设备摘要 JSON（不纳入 Git）：artifacts/maplibre-particle/android-validation/step113/ 下的 pbf63-summary-ready.json、static-rc-summary.json、particle-off-summary.json、partial-rcrr-summary.json、source-change-baseline-summary.json。它们只是低频 summary，不是导出的完整 120 帧。
+- 仍 NOT VERIFIED：原 NavSea 113 层完整 Layer/Source/显隐及真实四段边界；实际 PBF/Sprite/Glyph 画面截图；Source 单次变更后前后对照；120帧手动详情导出；C++ GTest 运行；reset/后台、旧 STEP-102 场景回归；CPU/GPU/诊断开销；生产性能提升、正式发行。不得把部分结构等价当成现场复测或将 STEP-113 判为 CLOSED/PASS。
+- 下一阶段必须分别处理 retained first-build 的安全准入、unsupported continuous layer、unsupported scene；不能直接删除 Gate 放行。
+
+
+## RDC 第二轮设备验收（2026-10-11：完整窗口与Source变更）
+
+**本轮状态：设备逐帧诊断 PASS、单次Source变更链路 PASS，完整113层等价与生产优化仍 PARTIAL。** 本记录追加在原有RDC基线结果之后，旧内容中的“未执行单次Source mutation/120帧导出”是第一轮结束时的历史状态，不代表第二轮。
+
+1. 在设备 FZG1-2、ADB 192.168.200.139:5555、版本 13.6.1-particle.23 上运行 SOURCE_CHANGE；通过屏幕中的 STEP 093 → STEP-113 → EXPORT LAST SNAPSHOT，使用明确serial的 adb exec-out run-as 回读 App 私有JSON；文件字节分别为变更前 277980、变更后约272KiB。精确位置：artifacts/maplibre-particle/android-validation/step113/source-change-before-full.json 和 source-change-after-full.json，均保留在 Mac 本机、未纳入Git。
+2. 变更前 trace：lifecycle 1，attempts 13859，capacity/windowCount 120，最新119个完成的Full帧、0 Fast帧、最后1帧为pending、decisionMismatch=0；变更后 trace：同lifecycle，attempts 17476，windowCount=120，同样119个已完成Full、0 Fast、decisionMismatch=0。相同frame中前置状态 pre 的 placementBasis 标为上一完成RenderTree，post 完成Full才使用当前Full tree；knownMask覆盖24条Gate。
+3. 在 SOURCE_CHANGE 场景操作一次 MUTATE PROBE SOURCE ONCE。Logcat解码的 source-command：mutation=1；变更后导出 commands.sourceMutationCount=1；Native lastMutation.sourceId=step113-source-probe，affectedSegmentIndices=[1]，事件 TileMutation。变更前 lastMutation.sourceId=navsea_delivery，affectedSegmentIndices=[0]。累计 content-mutation Gate failure 从12变为14，但中间同时有正常瓦片更新，**不得把全部增量单独归因为这一次probe**。120帧环形窗口会覆盖发生瞬时变更时的精确帧，故本轮只确认命令/Native依赖定位，不声称捕获到单次Mutation帧的全部过渡时序。
+4. 从变更后120帧中统计119个 completed 样本：首错 cache-invalid=119/119；同一帧 Gate #3 cache-invalid=119、#4 revision-mismatch=119、#12 static-unstable=105、#13 placement-or-fade=105、#22 unsupported-continuous-layer=119、#23 unsupported-scene=119。24Gate shadow 对应生产首错持续吻合，decisionMismatch=0。该统计是窗口而非全应用时间的FPS度量。
+5. PBF同源核验：原始63层按SDK回读生产Style逐层定义保序、baseLayersPreserved=true；spec version=8，源Style名称 NavSea Delivery Full Semantic ExtentFix；productionFingerprintSha256=e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996（SDK回读序列化JSON，不是HTTP包字节）。SOURCE_CHANGE运行时67层，连续段[63,67)依次是 weather-color、raster-particle、测试circle、内建 org.maplibre.annotations.points symbol。STATIC_RC的连续段[63,66)同样包括内建annotation symbol。现有 continuousRangeSupportsParticleFastPath 要求其范围内**每一层**均支持 retained dynamic range；因此这些普通circle/symbol使Gate #22持续失败；这项结论为“源码判定+本机层清单”，未进行绕过Gate的运行实验。
+6. Gate #23 supportedScene 源码逻辑与 retainedSupported、fastContinuousSupported 及单C配置有关，**#22与#23不是根因完全独立的两次失败**；二者虽为不同Gate，却可能共享同一个不支持的C层根因。Retained R[0,63)仍持续 Build0、unknown-dependency；部分RCRR其它R也有static-placement。不能只消除C阻断就承诺Fast会成功。
+7. NavSea只读核对：当前src/map/particle/RenderSegmentHost.tsx 配置 R→C，从 rn-weather-color 开始；旧STEP-112的FZG1 113层RCRR_PREFIX属不同运行配置。同版本113个Layer的完整Source/ID/type/visibility/业务数据清单仍缺，不能把TEST-APP-STRUCTURAL的63/66/67层宣称为113层完整等价。FZG1-2存在debug NavSea安装，但**本轮未启动/修改NavSea用户数据**。
+8. Android设备截图已采集：artifacts/maplibre-particle/android-validation/step113/step113-source-change-screen.png（1920×1200），仅归档，未进行NavSea同版本逐像素比对。Mac Native GTest CMake配置尝试退出码1：缺少libuv（记录/tmp/particle-step113-macos-cmake.log）；未安装依赖，未进入GTest构建与运行，不记PASS。
+9. 后续受保护顺序：先由跨项目负责人获取NavSea同版本113层完整只读snapshot及真实selector；然后在Test App精准构造Layer/Source/顺序并获取120帧一对一同条件比较；分别建立R Build准入、C范围支持、Scene聚合依赖的源码及像素等价证明；通过后才能在Shared Core按受控范围修改Gate逻辑。禁止在证据不足时关闭 fail-closed Gate。RDC未在本轮运行新Android编译、改变渲染逻辑或做正式发行。

docs/50_Step记录/STEP-114_FastPath安全准入与TestApp闭环_v1.md

@@ -0,0 +1,77 @@
+# STEP-114 Fast Path 安全准入与 Test App 闭环 v1
+
+日期：2026-10-11（JST）。状态：**进行中；源码交付 PARTIAL，运行闭环待 RDC/用户，Symbol R 准入 BLOCKED。**
+
+## 目标、基线与范围
+
+- Mac / Darwin 24.6.0 / x86_64；`/Users/tei/dev/MapLibreParticleLab`；`particle/main@b02e54de3d45fcf612126ae8f037cba204f590ea`。
+- 实际 GPT-6.1-Sol（gpt-6.1-sol）/ high 已从本会话执行记录核实。没有模型升级、子代理或另一 Codex 实例。
+- Native/Test App 源码版本 `13.6.1-particle.23` 未改；Integration 契约仅只读，RN/JS公共API/ABI、Source Lock、正式发行不变。
+- 只修改 Shared Core 内部安全子集判定/缺源诊断、现有非 Jest 测试、Android Test App、本Step中文文档和开发记录追加。
+- 禁止 Codex 执行编译/测试/Gradle/ADB/Jest/CMake/Ninja/Bazel、commit/push、发行、跨项目写入或触碰原有 STEP-110/111 文件。
+
+## 按顺序完成的源码工作
+
+- [x] 静态闭环：Test App source类型、R初建失败、mutation/异步布局/资源/Annotation追踪、C/scene复合条件、Placement两分支。
+- [x] 本机旧STEP-113完整JSON回读发现：navsea_delivery是Vector；R依赖tide但Native source表缺tide。缺revision默认unknown-dependency不能作为CustomMVT已出现的证据。
+- [x] R缺失 RenderSource 提前返回missing-source，仍ready/stable=false、revision0；不补假数据，不放行CustomMVT/未知revision。
+- [x] 保守GeoJSON/circle R正向独立场景；source admission/cache GPU算法不改，3个C++用例源码补充结构保护与revision/cache状态机覆盖。
+- [x] 非粒子C继续fail-closed；独立scene只在确认没有Annotation实例时移除空内建层，正式PBF五场景原样保留。
+- [x] 无Symbol全场的controller stale不影响Symbol像素消费者；限定#13只在完整层表有结构性Symbol时阻止。空表/数量不一致仍保守，隐藏或空Symbol不豁免。
+- [x] Symbol R真稳定窗口审查：现有commit/fade证据不足，保留全部Build/scene条件；停止更大结果签名设计，明确BLOCKED。
+- [x] 独立FAST_SMOKE、CIRCLE_C_BLOCKED、ANNOTATION_BLOCKED、SYMBOL_R_BLOCKED；菜单/Intent、低频真实Native UI、单次Source/Image/Camera/Annotation/Cache命令与操作前后文件、Reload/前后台/Teardown取证入口。
+- [x] 调查、场景/定向验收说明、Step、中文完成报告、粒子开发记录实际落盘。
+- [ ] Mac Native配置/编译和3个新用例及指定回归实际运行。
+- [ ] Kotlin/Android一次手工编译、真实NativeFast>0、视觉与反向/生命周期设备闭环。
+- [ ] Symbol R结果证书、CustomMVT完整revision契约、非粒子C复合等价证明：未实现，维持BLOCKED/fail-closed。
+- [ ] iOS Metal实机/性能与生产Fast：NOT VERIFIED，不能由smoke替代。
+
+## 当前结果与限制
+
+没有新的编译、测试、APK、设备、GPU计数或性能结果。SOURCE-PROVEN/IMPLEMENTED与旧RETAINED-EVIDENCE分开；整体PARTIAL，不标Fast Path已修复。旧PBF缺tide诊断修正不代表该R可以Build；即使补源仍受SymbolPlacement保护。
+
+预期FAST_SMOKE的真实Native层序4层、R[0,2)/C[2,4)，必须取得Build/Reuse/Full/Fast与24Gate同帧证据。UIsceneReady只代表加载/命令成功，实际Native结构由导出JSON检查。三个负场景继续阻止Fast。Source等操作自动100/500/1500ms取证仍可能错过瞬态，缺证据如实记NOT VERIFIED。
+
+## 已做检查与精确验收入口
+
+Codex仅源码/文档阅读、已有JSON解析、Git只读状态、静态函数/范围/哈希核对、git diff --check和新增文件空白核对。未执行任何构建/测试/设备/Git写操作。
+
+精确命令：`docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md` 第2节Mac Native配置/target/过滤器/日志/失败停止；第3—5节用户后续手工Android/ADB、JSON检查和反向/生命周期矩阵。完成报告也列出Native最小命令。配置失败保留现场，不能使用旧runner或自行安装依赖伪造通过。
+
+## 独立验收待填写
+
+| 项目 | 当前事实 / RDC或用户证据待填 |
+|---|---|
+| 源码baseline/diff/hash与制品版本 | 未提交工作区源码；用户构建前保存明确diff/hash与dirty状态 |
+| Mac configure/build/新用例3个与回归 | NOT RUN；记录exit/耗时/真实测试数/skipped/日志/首错 |
+| APK/ZIP/ABI/大小/SHA/签名 | NOT RUN；唯一现有Validation脚本由用户手工 |
+| FAST_SMOKE真实层表/plan/cache/Fast | NOT RUN；4层R[0,2)/C[2,4)，decisionMismatch=0，Fast/Reuse delta>0 |
+| Source异步失效/Tile/Image/Camera/Cache恢复 | NOT RUN；保存五phase文件与精确变化帧，不从末态猜Gate |
+| Circle C/Annotation/Symbol R负场景 | NOT RUN；保持阻止并具备可见内容与真实更新 |
+| Reload/前后台/Teardown/重新进入 | NOT RUN；销毁前文件不是销毁完成证据 |
+| 原STEP-113五场景与STEP-102回归 | NOT RUN；保留正式PBF全部定义，缺源改报missing-source |
+| iOS Metal设备/像素/CPU/GPU性能 | NOT VERIFIED；不以Mac状态机测试替代 |
+| Git提交/推送/远端HEAD | NOT RUN且本轮禁止；后续另行授权RDCscoped收尾 |
+
+## 必做输出与下一步
+
+调查：`docs/20_调查/STEP-114_FastPath安全准入与闭环判定_v1.md`。
+
+验收：`docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md`。
+
+报告：`docs/报告/STEP-114_FastPath安全准入与TestApp闭环_Codex完成报告_v1.md`。
+
+以上及本记录、源文件、开发记录已由Codex实际生成。接下来由RDC独立审计并执行MacNative定向验证；用户一次手工Android/设备闭环。若缺libuv、编译失败或真实Fast仍为0，保留首错/24Gate再回交修复；不得继续扩大Symbol/CustomMVT/C放行或进入发行。
+
+
+## RDC 独立审核追加（2026-10-11）
+
+**结论：源码/差异/接口静态审核 PASS；Native 与 Android 编译、Fast 帧 NOT VERIFIED；整体 STEP-114 PARTIAL。**
+
+- RDC 独立阅读本轮 Native diff、C++ 新用例、STEP-114 Android Test App 新场景与菜单、生命周期接线；git diff --check 退出码 0。本轮只有范围内的五个 tracked 改动和新增 Kotlin/中文文档；原 STEP-110/111 未跟踪任务书不修改、不暂存。
+- 新增三项 Step114FastPathSafety 用例存在，覆盖无 Symbol、隐藏/Annotation Symbol 和 Source revision/cache 状态机，但**没有实际运行**。
+- Step113PbfGateScene.kt SHA-256 为 6e7befeb90ae172aaeff4b636a7640274dfb1065d8c97744cbc6af8d22b4ccae，Step102PlacementFixture.kt SHA-256 为 e44912970dd6353787be7a3e5f9924fe1249e2305d495f1e25e707352c97d3c7，均未变化。
+- Java SDK 只读核对实际提供 Style.removeLayer(String) 与 MapLibreMap.getAnnotations()。Kotlin/Gradle 编译未执行。
+- Mac 预检：pkg-config --exists libuv 返回 1，与先前 macos-metal CMake required libuv 失败一致。独立 C++ header -fsyntax-only 试验退出码 1，首错为 Xcode AppleClang 找不到标准 C++ 头文件 array，实际在进入项目源码检查前终止。日志存于 Mac /tmp/step114-header-check.log。两项均是环境阻塞，不是本轮 Native 测试 PASS 或已证明代码错误；未安装/修改依赖。
+- 实际 Fast Path 命中、正反 GPU 渲染、Android 设备、性能、iOS 均未验证。正式 PBF 仍有 tide 缺源、Symbol R Placement、内建 Annotation C 的阻断。STEP-114 独立最小场景属于待用户一次 Android 手工构建集中验收内容，不能用旧 APK。
+- 后续 scoped Git 收尾若执行仅表示 PARTIAL 源码及测试入口已归档，**不代表正式发布或 Fast Path 修复完成**，不打 Tag/Source Lock。

docs/50_Step记录/STEP-115_STEP113原PBF专用App复测准备_v1.md

@@ -0,0 +1,22 @@
+# STEP-115：STEP-113 原 PBF 专用 APP Fast Path 复测准备 v1
+
+日期：2026-10-11（JST）。状态：TEST-PREPARATION COMPLETE / MANUAL ANDROID BUILD REQUIRED / FAST NOT VERIFIED。
+
+## 任务意图
+
+原 STEP-113 专用 Android Test App 的 PBF STATIC_RC 是 Fast Path 正式验证主体，不以 STEP-114 FAST_SMOKE 或删掉原正式图层的测试代替。STEP-113 的五个场景不修改，不要求 NavSea 113 层完整复刻，但每个结果必须基于真实 Native 的 Fast/Full、缓存 Build/Reuse 以及 Gate 记录。
+
+## 本次已核实事实
+
+1. Integration main 已 fetch 并确认 80667d6c343411d03a760425438e3d292f452118。Particle 当前 main 为 21a10816435a82de3471bdb55ed83223101f5689。
+2. 现有 APK 的 build-info 显示构建源码 c6d13e1059d464d312ac33acac87967300fa5dc4；APK SHA-256 为 0054248bc3872e8670df4e9a10d11f1d65c0912a0482586cd7a247e880a6eaef，与设备 192.168.200.139:5555 的当前安装包 SHA 一致。这是 STEP-114 修改以前的旧 APK，不能拿来验收新修复。
+3. STEP-114 未解决原 PBF 缺 tide Source、R Symbol Placement 首次 Build 及 C 内建 Annotation Symbol 拒绝，因此不能提前承诺原 STATIC_RC 会进入 Fast。
+4. 新增工具 tools/particle_android_validation/verify_step113_fast_path.py；不修改原 STEP-113 Test App、Native 渲染逻辑、RN 公共 API。工具对版本/安装包 SHA fail-closed，按当前进程 PID 解码现有 STEP113Gate Base64 低频摘要并比较帧计数。
+5. 使用 python3 -B 解码旧设备 Logcat 的 STEP113 SOURCE_CHANGE 摘要成功，历史累计 Fast=0、decisionMismatch=0。旧 APK 执行 --preflight-only 返回 STALE_APK，exit=3，属于**预期的旧包拒绝**，不是“修复后测试失败”。
+6. 没有执行 Android 编译、安装、启动新 APK、完整 120 帧采集、真实 Fast/性能/像素验收。用户需手工完成最新源码的唯一 Validation APK Pipeline，并手工 install -r，之后才能进行新二进制测试。
+
+## 通过准则与下一步
+
+实际源提交与安装 APK 完全匹配、原 STATIC_RC Native Plan valid、场景 READY、同一进程和场景内 Full/Fast 计数真实变化，FastDelta > 0 方可称 Fast observed。需另外核对 cache Build/Reuse 和 decisionMismatch=0、24 Gate、影像等价及 Source mutation/Annotation fail-closed。若 FastDelta=0，记录具体 Gate/R fallback 后停止将其宣称为 PASS，回到源码定位。原五场景以及 STEP-102 维持保护，非正式发行，不改 Source Lock。
+
+步骤见 tools/particle_android_validation/README.md。没有修复完成或新的 APK 时，保持 STEP-114 PARTIAL，本 STEP 仅测试工具准备完成。

docs/50_Step记录/STEP-116_STEP113原PBF_FastPath实际修复_v1.md

@@ -0,0 +1,57 @@
+# STEP-116 STEP-113 原 PBF Fast Path 实际修复 v1
+
+日期：2026-10-11（JST）。状态：**部分实现（PARTIAL），停止于源码交付，待 RDC 独立审计。**
+
+## 当前基线
+
+- Mac / Darwin 24.6.0 / x86_64；`/Users/tei/dev/MapLibreParticleLab`。
+- branch `particle/main`，起点 HEAD `e2d202b560ad0165101546597c43f2ef0ccf4542`，本轮不提交，HEAD 不变。
+- 实际模型 GPT-6.1-Sol（gpt-6.1-sol）/ high，从当前 rollout 的 turn_context 核实；没有切换或第二实例。
+- Native Android 版本 `13.6.1-particle.23`，没有发版；Integration main 80667d6c 为用户给定 RDC 核验，相关文档只读。
+
+## 交付与未完成
+
+| 工作 | 状态 | 事实 |
+|---|---|---|
+| 强制前置/实际代码/旧完整JSON调查 | 已完成 | 原R缺 tide，navsea_delivery 为 Vector；GPU/source生命周期见审查文档 |
+| 空Annotation生命周期 | 已实现，未验收 | Native add/update/style-loaded 恢复缺失points；Test App仅STATIC_RC一次移除空辅助层，保留Source，退出恢复，后续变更撤销验收条件 |
+| 原63层/PBF资源/五场景 | 已保留源码语义 | 不改公网或tide-spots；SOURCE_CHANGE circle保留；STEP114/102源码冻结 |
+| 缺源empty准入 | BLOCKED | 缺GPU零贡献证书；继续missing-source，不补假源 |
+| Symbol首次Cache Build | BLOCKED | 无绑定成功Build的Placement/GPU最终输入证书，现有Gate全部保留 |
+| 诊断与复测工具 | 已实现，未运行 | JSON缺源ID +独立Placement摘要；75秒实际等待、源码锁定/生命周期/blocked/24Gate拒绝条件 |
+| 非Jest C++测试源码 | 已实现，NOT RUN | 四个Step116Safety、三个Annotations.Step116；真实图像检查交RDC |
+| 四份中文文档/README/开发记录 | 已生成 | 具体路径见完成报告 |
+| 真正Fast/像素/性能 | NOT VERIFIED | 没有新APK、设备计数、截图或FPS/CPU结论 |
+
+## 检查与收尾
+
+Codex仅执行阅读、Git只读状态/diff、旧JSON与冻结文件SHA、Python AST解析、git diff --check及文档静态检查。无 CMake/Ninja/Bazel/Native编译或测试、Gradle/ADB/安装/Jest、commit/push/发布；没有改构建流水线、公开头文件/API/ABI/Host控制协议。
+
+保护 STEP-110/111 未跟踪任务书。下一步 RDC 按 `docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md` 独立审计并锁定提交后的源码，用户集中一次手工 build/install，再执行 STEP115 preflight、原 STATIC_RC ≥75秒、完整120帧和24Gate、SHA及画面。不得使用旧APK或旧测试runner给本轮记PASS。
+
+## RDC 后续结果填写（本轮尚未执行）
+
+- 审计后的源码HEAD/精确diff/SHA：待填写。
+- Native配置/编译/定向测试及首错/日志：NOT RUN。
+- 最新用户构建APK SHA、build-info、设备安装SHA：NOT RUN。
+- STATIC_RC实际层数/空层调整/原63层manifest/Source：NOT VERIFIED。
+- Cache Build/Reuse、Full/Fast增量、120帧/24Gate/mismatch：NOT VERIFIED。
+- Annotation恢复、Source/async/Style/资源/层序/disable/reload回退及用户画面：NOT VERIFIED。
+- 最终阶段结论：当前PARTIAL；缺源与Symbol仍BLOCKED。
+
+
+## RDC 独立核验追加（2026-10-11）
+
+**本轮结论：限定范围源码/接口及操作说明静态审查完成；Mac Native配置 BLOCKED；Android APK/设备Fast NOT RUN，整体PARTIAL。**
+
+- 起点粒子仓库 particle/main=e2d202b560ad0165101546597c43f2ef0ccf4542；Integration origin/main已由RDC fetch并与本地main同步，HEAD=80667d6c343411d03a760425438e3d292f452118。未接触NavSea与Integration正式文件。
+- Codex实际模型 gpt-6.1-sol/high；本轮实现仅原STEP-113 STATIC_RC 的 SDK 空Annotation辅助层、Native AnnotationManager缺层恢复、缺源只读JSON诊断和测试验证器，不改变正式63个PBF layer、原五场景其他分支、Fast Gate/caching的准入或公开控制面。新增7项非Jest C++用例源码，尚未执行。
+- RDC直接核对 Android Style.java 对象removeLayer(Layer)文档明确注明被移除Layer可以重新添加；与STEP116在stop中恢复原wrapper的目的相符。Native AnnotationManager恢复与事件生命周期仍须编译、图像和设备验证，不凭静态阅读标PASS。
+- RDC核对旧SOURCE_CHANGE实际完整JSON：Native FastGate gates每项有order，firstFrame的knownMask等字段存在；STEP116验收脚本的原JSON结构检查有数据来源，但并非本轮运行证据。
+- Mac shell当前无rg可执行，RDC将STEP116手动导出命令中的rg替换为标准grep -E，保留同样的文件筛选表达式。Python验收器ast.parse通过，git diff --check通过。
+- Mac Native按当前标准命令重新执行真正的cmake --preset macos-metal配置（使用/Users/tei/Library/Android/sdk/cmake/3.31.6/bin/cmake），退出码1：Required package libuv缺失，日志保存artifacts/maplibre-particle/step116-native/configure.log。严格串行停止，未执行构建目标、未运行7项C++测试。失败是环境依赖，不应改写成代码编译通过/失败或跳过继续。
+- 未执行Android Gradle、APK安装、ADB启动STEP113、新Fast计数、逐帧画面、iOS Metal回归、发行/tag/Source Lock。正式PBF缺tide以及Symbol R Placement仍保留fail-closed；此任务只是安全部分实现，并不解决原STATIC_RC无法进入Fast的全部原因。
+- 用户在本轮源码scoped Git锁定且push远端核验后，需手工一次集中Android编译与install -r，再执行STEP115同HEAD/安装SHA预检、原STATIC_RC 90秒、完整120帧+24Gate+截图与其它负场景验收。新APK前禁止把旧c6d13e1产物Fast0作为本轮修复验收。若仍Fast0，必须保留缺源、Placement和C实际结果并交跨平台Core负责人确定GPU结果证书。
+
+## RDC实际Android APK/设备验收追记（2026-10-11）
+用户明确授权本次由RDC完成Android编译、安装、测试。源码提交c48a72a9d492ea0d05e4d58464f9643453158d50，标准APK构建PASS，APK SHA=a8b7f4e0f8e026bde8835e18a04876062be84cce3a3749a511cb08605d9f8a35；ADB serial192.168.200.139:5555安装Success，设备SHA相同，预检PASS。原STEP113 STATIC_RC真实90秒FastDelta=0、FullDelta=920，脚本退出2 NO_FAST_OBSERVED。Native65层、C仅WeatherColor+Particle，原63层保留，#22在最后120帧失败数0，说明空Annotation修复局部有效。R[0,63)缺tide Source，Cache Build/Reuse=0、PlacementGate=false；120帧119Full/0Fast/1Pending，#3/#4/#23失败120帧、#12/#13失败105帧，decisionMismatch0。总体Fast目标FAIL，本Step继续PARTIAL。完整报告及证据路径参见docs/60_测试/STEP-116_FZG1_原PBF实机验收结果_20261011.md。

docs/50_Step记录/STEP-117_原PBF_Fast缓存准入_v1.md

@@ -0,0 +1,58 @@
+# STEP-117 原 PBF Fast 缓存准入 v1
+
+日期：2026-10-11（JST）。状态：**阻塞**。调查与七项非Jest C++回归源码已交付；安全准入、真实Build/Reuse/Fast仍未完成。
+
+## 目标与基线
+
+原STEP113 STATIC_RC完整63基础层保持不变，以成功提交的GPU R结果证据解决缺tide和Symbol首次Build，达到Build>0、Reuse>0、FastDelta>0；证据不足保持fail-closed。
+
+Mac.lan，`/Users/tei/dev/MapLibreParticleLab`，`particle/main@43e5f5b91598b9c3d3f1c788052d4bbd2d616668`；实际GPT-6.1-Sol（gpt-6.1-sol）/high已核实。Integration只读HEAD `80667d6c343411d03a760425438e3d292f452118`。VERSION `13.6.1-particle.23`，未改发行坐标。起点tracked clean，STEP110/111及117任务书未跟踪。
+
+## 必做项与结果
+
+- [x] 读取规则、当前任务/基线、STEP112–116关键资料与相关实际依赖源码。
+- [x] 回读原274,693字节JSON并验证SHA，逐帧复算120帧24Gate与Placement状态。
+- [x] 审查sourceDiff/revision/fingerprint、双group注册/停用、prepare/upload/Build/提交生命周期。
+- [x] 分别说明缺源零贡献与Symbol最终GPU结果证书的缺口、反例及协调责任。
+- [x] 保留fail-closed、原63层、STEP116空Annotation修复、原五场景及SOURCE_CHANGE负例。
+- [x] 新增七项Step117Safety C++测试源码，复用已有构建登记。
+- [x] 落盘调查、验收计划、完成报告，末尾追加开发记录。
+- [ ] 建立可核验的缺源零GPU贡献与无旧Renderable数据证书，准入缓存。
+- [ ] 建立Symbol最终GPU结果等价证书，解决首次Build。
+- [ ] RDC独立编译并运行定向C++测试。
+- [ ] 原STATIC_RC新制品≥90秒，Build/Reuse/Fast增长、完整120帧、Mutation回退与用户画面验收。
+
+## 允许与禁止范围
+
+本轮实际只改两个既有C++测试文件，新增四份中文文件并追加开发记录。未改生产src/include、公开API/ABI/RN/JNI/合同、Shader、Android场景、Style/服务器、NavSea、iOS、版本/Source Lock；没有放宽Source readiness/revision、Placement或24Gate，没有造Fast计数。STEP110/111原未跟踪MD保留，不暂存；原设备JSON保持Git忽略。
+
+按用户当前禁止项，没有运行Gradle/ADB/Native编译/CMake/Ninja/Bazel/Jest、安装、commit/push。未启动后台编译或第二Codex，没有子代理。
+
+## 阶段验收与当前结果
+
+保留实测（STEP116，非STEP117）：原STATIC_RC 90秒FastDelta=0、FullDelta=920；Native65层R[0,63)、C[63,65)；R缺tide、Build/Reuse=0；最近120帧119Full/0Fast/1pending，#3/#4/#23失败120、#12/#13失败105、#22失败0、mismatch0。
+
+本轮复算pre为105帧false/非零/true、15帧true/0/false；post为104+15，末帧pending。源码证明：缺源没有新RenderItem不等于无旧GPU数据；停用request未执行前registry仍可遍历旧group；停用不清旧drawables。Symbol重算changed与recent stale使首建条件不可达；layer fingerprint不包含最终GPU opacity/atlas/vertices。
+
+因此两项准入均BLOCKED。七项测试只是可运行源码：真实controller/sourceDiff/registry/observer路径与状态机组合；没有GPU像素等价证据，不能称Native或全任务PASS。静态检查的实际结果在完成报告中记录。
+
+## 构建测试、输出与下一步
+
+RDC命令及失败停止、源/APK/设备SHA、完整JSON/画面、负例矩阵详见 `docs/60_测试/STEP-117_FZG1_原PBF真实Fast验收计划_v1.md`。本轮仅测试代码，Android生产行为无变化，重复构建不能解决B1/B2；先进行独立审计与Shared Core证书设计协调，形成受控实现后再安排一次用户授权的集中Android闭环。
+
+必做输出：`docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md`、本文件、验收计划、`docs/报告/STEP-117_原PBF_Fast缓存准入_Codex完成报告_v1.md`、开发记录末尾追加。Git提交/hash、远端HEAD、Native/设备验收均留RDC在后续授权下回填，本轮未执行。
+
+
+## RDC独立核验附录（2026-10-11）
+
+- RDC先核对Integration main=80667d6c343411d03a760425438e3d292f452118、Particle当前particle/main=43e5f5b91598b9c3d3f1c788052d4bbd2d616668；源码与git已跟踪改动起点为空，仅两个用户保护未跟踪任务书。
+- 用户本轮要求继续真实STEP113 PBF Fast优化，Codex实际GPT-6.1-Sol High。调查原STEP116实机120帧JSON，缺tide Source以及Symbol placement重算/stale循环仍无法安全创建首次GPU缓存；已有证据只能证明无新的LayerRenderItem，不能证明旧GPU drawables/已经应用的双LayerGroup删除。保留既有24Gate/生产Core，安全准入BLOCKED。
+- Codex新增7个Step117Safety C++测试源码，分布于两个既有登记的test/renderer文件；RDC独立对两个最终文件以当前Android OpenGL/x86_64的NDK clang++、真实compile_commands.json C++20 flags和googletest头文件进行-fsyntax-only。retained_underlay_cache.test.cpp exit0（6.3s），render_orchestrator_error.test.cpp exit0（5.3s），RDC检查结果PASS。语法检查日志存Git忽略artifacts/maplibre-particle/step117-native-syntax/*.log。
+- RDC核查原生产src/include/Renderer/Placement/Fast Gate、Android STEP113/114及Source/style均无文件改动，git diff --check通过。故**没有新的运行时改动供Android APK验证**：重复编译/安装STEP116相同行为的APK不能使Build/Reuse/Fast改善，未触发第二次高成本Android周期。GTest链接运行、GPU像素等价、iOS/Metal、真实Fast目标仍NOT RUN/BLOCKED，不能将NDK语法退出0标为GTest PASS。
+- Integration正式现有RFC/ADR/Contract/status/coordination未包含所需R Symbol已提交GPU结果证书。B1缺源零贡献、B2 Symbol跨层结果证书与影子验收、B3真实tide Source身份/宿主动态注入语义须由粒子负责人/Integration按职责协调设计；本执行项目不得自行改变Shared Core公共契约或正式Style。
+- 七项测试当前仍是源码语法检查级别，不等于实测; 下一步应先由粒子负责人协调Shared Core结果证书及合法真实tide来源，受控实现后再使用原STEP113 STATIC_RC APK复测。任意无法安全证明的条件继续fail-closed。
+
+
+### RDC 严格 -Werror 编译参数复核修正（2026-10-11）
+
+第一次NDK -fsyntax-only按项目真实C++20参数编译两个测试文件均exit0，但测试辅助函数遗漏可选retainedUnderlayState字段初始化，产生一条 -Wmissing-designated-field-initializers 警告；第一次探测曾附加 -Wno-error，不能直接标作正式 -Werror 验收。RDC后续对 test/renderer/retained_underlay_cache.test.cpp 增加一行显式 retainedUnderlayState={}，保留原逻辑，然后从临时核验脚本中移除 -Wno-error，严格复用Android NDK OpenGL/x86_64真实compile_commands.json的 -Werror 及C++20参数重新执行两文件 -fsyntax-only：retained_underlay_cache.test.cpp退出0/5.3秒，render_orchestrator_error.test.cpp退出0/5.2秒；对应Git忽略日志均无警告输出。**严格语法检查PASS；GTest链接运行仍NOT RUN，Symbol GPU证书及Fast仍BLOCKED。**修正仅测试辅助字段初始化，不涉及生产src/renderer、Android APK和正式Gate。

docs/50_Step记录/STEP-118_tide失效引用受控排除与Fast真实验证_v1.md

@@ -0,0 +1,29 @@
+# STEP-118 tide 失效引用受控排除与Fast真实验证
+
+日期：2026-10-11 JST。用户授权：tide Source可以删除。最终状态依RDC的实际Android验收更新，不预先标PASS。
+
+## 基线与数据事实
+
+Integration最新已同步main=80667d6c343411d03a760425438e3d292f452118，Particle原main=fb8e78ac1ab65ccafa6fd2b181d038b90d9a00c3。STEP116旧实机原STATIC_RC：生产基础63层；Native65层、R[0,63)、C[63,65)、FastDelta0、FullDelta920，R Build/Reuse0、fallback=missing-source、missingSourceIds=[tide]、PlacementGate=false。STEP117生产Renderer/24Gate无改动，严格Android NDK C++20语法检查已通过。
+
+完整旧设备JSON显示生产sources只有mapple和navsea_delivery，根本没有tide；63基础Layer中只有index2的tide-spots Symbol依赖tide。故删除不存在的Source本身不会改变Fast。
+
+## 本轮受控实现
+
+不修改远端正式PBF服务器Style、不改NavSea、Shared Core、ABI/公共API、iOS或Native Fast Gate。保留原五个STEP113场景及原63层原始定义和productionFingerprint。新增独立STATIC_RC_NO_TIDE：加载同样远端Style，断言生产无tide Source、唯一引用它的Layer必须是tide-spots Symbol；在仅供本机Test App测试的JSON副本中移除这一Layer，保留其他62个原定义/顺序、同样两天气层及相机/30fps/Pause和STEP116空Annotation保护。预期Native总64、R[0,62)、C[62,64)（尚须实际设备确认）。
+
+Parity同时保留原production63清单/fingerprint与有效62清单/test fingerprint；明确baseLayersPreserved=false，删除唯一层id/source/count，禁止将修改后的场景宣称为原63场景。Python verifier新增场景，强制校验原63/有效62/Native64、tide-spots/tide唯一排除、原Source无tide、R[0,62)、空Annotation移除、24Gate和SHA；旧五场景仍严格要求basePreserved=true。
+
+## 验收与风险
+
+RDC先源码检查/scoped Git提交推送，再在用户既有授权下执行Mac标准OpenGL x86_64 Validation APK构建、设备192.168.200.139:5555安装、APK SHA与已安装base.apk SHA一致、preflight、派生场景连续90秒、真实Native Cache Build/Reuse、Fast/Full增量和24Gate及截图。无新设备结果前仅称IMPLEMENTED / WAITING_ANDROID_VALIDATION。
+
+即使消除missing-source，R Symbol Placement changed/stale与#23可能继续阻塞。Fast0仍为目标FAIL；不得通过删其它Symbol、造Source、禁用fade、修改Gate或放宽24Gate得到假Fast。后续正式PBF Style是否永久删除tide-spots由Style/NavSea负责人按跨项目协调确定，本Test App派生结果不能直接替代正式Style发行验收。
+
+## RDC Android 新APK实机验收追加（2026-10-11）
+
+Mac标准Test App build脚本于源码HEAD 3051196054c7b69815c298040dae61d26499d9f2 实际返回BUILD SUCCESS，Kotlin/Native OpenGL x86_64编译与ZIP/strip/ABI校验通过。APK大小66603850字节，SHA-256 44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9；RDC adb -s 192.168.200.139:5555 install -r最终Success，设备base.apk SHA完全相同，Python preflight PASS。安装耗时约267秒，没有重入安装。
+
+原STEP113框架内独立STATIC_RC_NO_TIDE运行90.008秒，PID22825，实际2份同生命周期有效摘要：原正式基础63清单仍保留在manifest，仅测试副本移除唯一tide-spots引用，基础62、天气2、Native64，R[0,62)、planValid=true、decisionMismatch0。R missingSourceIds=[]且原缺源回退从missing-source变为static-placement，说明本项修复在真机真实生效。R Cache Build/Reuse仍为0/0，FastDelta=0、FullDelta=942；120帧窗口Fast0、Full119。PlacementGatePassed=false，24Gate的unsupported-scene等继续失败。验证脚本返回NO_FAST_OBSERVED/exit2；此为目标未达成的明确负结果而非运行器异常。
+
+结论：**tide孤立引用造成的缺源阻塞PASS；原Fast性能目标FAIL；STEP-118 PARTIAL**。剩余独立根因是Symbol Placement的GPU结果安全证书；不能通过放宽gate将其当作成功。完整量化数据、APK绑定和设备截图SHA见docs/60_测试/STEP-118_潮汐清理新APK设备实测结果_20261011.md。本次纯测试记录Git commit若晚于APK HEAD，不得将新文档HEAD冒充APK二进制源码。

docs/50_Step记录/STEP-119_SymbolRetained生命周期修复_v1.md

@@ -0,0 +1,41 @@
+# STEP-119 SymbolRetained 生命周期修复 v1
+
+日期：2026-10-12（JST）。Step 状态：进行中。代码交付：**IMPLEMENTED / WAITING_RDC_VALIDATION**。这是此前中断任务的续作；不关闭整体 STEP-119，不构成编译、GTest、GPU 或设备验收 PASS。
+
+## 目标与基线
+
+按照 `/tmp/fzg1_astra_guidance_20261012.md` 修复内部 Symbol Drawable 的 RenderTile 同源绑定、旧 Drawable 更新及 Bucket/Atlas 更换生命周期；保留原缓存、证书和 Full → Build → 成功 Full Reuse → Fast 顺序。
+
+- 机器：Mac.lan / Darwin 24.6.0 / x86_64；仓库：`/Users/tei/dev/MapLibreParticleLab`。
+- 开工及交付分支：`particle/main`；HEAD：`badb515d590fbdf221751b6677de3da0a5650d7e`。未切换分支/worktree，未提交或操作远端。
+- 接续已有四个源码修改；起点另有受保护 STEP-110/111 两份未跟踪任务书。
+- 用户本轮明确指定模型 `GPT-6.1 Sol High`（`gpt-6.1-sol / high`）。当前工具未提供执行器模型元数据，且本机当日 sessions 目录不存在，无法独立核验实际运行参数；不宣称已从日志核实，没有主动切换模型或启动子代理。
+- 当前发行锁为 Android/RN `13.6.1-particle.25`、iOS `6.29.0-particle.25`，构建冻结源 `f32f6f45fd359007e8b3c77911b66d9e7fc93848`；本修复不改 Source Lock/发行物，不声称已进入 v25 制品。
+
+## 必做项
+
+- [x] 读取 Astra 指导、AGENTS、PARTICLE_BASELINE、规范、四份当前总则、当前 STEP-119 任务/实现/测试资料，核对现有四文件 diff。
+- [x] 同次 source prepare 获取 raw owner 和 Y 排序引用列表；仅比较地址完成同源校验，再复制当前 ID/atlas。
+- [x] 同 Bucket/Atlas 的完整 tile/pass 组先检查，再全部重新绑定当前 owner/RenderTile；不逐帧重建 Drawable/tweaker。
+- [x] Bucket/Atlas/组内成员失配或缺 atlas 时移除整组，走原创建路径；Text/IconRGBA/IconSDF/Halo 使用同一 atlas 与实际 tweaker 配对。
+- [x] Retained 使用内部强引用 atlas 和当前地址映射，不沿旧 Drawable 裸指针读取 atlas/Tile；缺证立即 complete=false。
+- [x] 保活 RenderTile → renderData → LayoutResult 的证据资源，不把每次 prepare 的 owner 地址写入比较字节。
+- [x] 编写并静态核对 13 项 SymbolRetainedLifetime GTest 源码，修正 atlas-only TileRenderData 查询默认 assert 的测试替身缺口。
+- [x] 中文 Step、完成报告及开发记录末尾追加；四源码路径 scoped diff 空白检查 exit0。
+- [ ] RDC 实际编译/链接并发现、运行生命周期与 STEP-119 定向 GTest。
+- [ ] Android OpenGL、Metal 实际路径验证与 Vulkan 编译兼容性证据。
+- [ ] 新源码锁/APK/SO 身份闭环、FZ-G1 动态生命周期、原24Gate、Full/Fast 视觉及释放验收。
+
+## 修改范围与当前结果
+
+生产修改限 `src/mln/gfx/symbol_drawable_data.hpp`、`src/mln/renderer/layers/render_symbol_layer.cpp`、`src/mln/renderer/layers/render_symbol_layer.hpp`；测试限 `test/renderer/retained_underlay_cache.test.cpp`。沿用此前修改，续作只补未知 Symbol 类型拒绝、测试替身空查询覆盖、Text/Icon/SDF/Halo 连续 prepare 稳定性与证书资源释放检查。
+
+未改 RN/JNI 公共 API、原24Gate/证书判据、Placement、缓存开关、发行物、Integration、旧报告或两份保护任务书。未运行 CMake、编译/链接/语法编译、GTest、Gradle/APK、ADB/安装、Jest；没有新制品或设备数据。
+
+## 阻塞与下一步
+
+实现已落盘，可编译性与运行正确性仍待 RDC。现 verifier 会拒绝 tracked dirty，后续 Git 来源锁须在独立审计和另行授权后处理；本轮禁止 Git 收尾，不能绕过 verifier 或借旧 APK。历史 Metal/libuv 缺口未重新验证，不安装升级依赖。
+
+RenderTile 容器不拥有底层 `Tile&`；强引用 atlas/texture 也不能证明原地像素或槽位不变，继续依赖既有 content epoch 和真实绑定复核。原始寄存器 tombstone 缺失，不能断言 `0x8cdc7c` 唯一根因为本缺陷；保留原 SO Build ID `485459ba44f806ef0a0c08633c717bfd5d82ad8f` 与匹配符号交 RDC。
+
+准确命令、测试覆盖限制、停止门槛和交接证据见 [本轮完成报告](../报告/STEP-119_SymbolRetained生命周期修复_Codex完成报告_v1.md)。Codex 到此交接，RDC 独立审计后逐条验证；失败保留首错与现场，不放宽条件。

docs/50_Step记录/STEP-119_Symbol缓存实际实现_v1.md

@@ -0,0 +1,85 @@
+# STEP-119 Symbol缓存实际实现 v1
+
+日期：2026-10-11（JST）。状态：进行中；代码阶段IMPLEMENTED_WAITING_ANDROID，独立验收未完成。
+
+## 目标与基线
+
+实现Shared Core内部最终Symbol结果证书，解决静止真实PBF派生R首次Build逻辑自举死锁，支持后续Reuse/Fast，同时保护所有真实渲染失效与原24Gate。
+
+particle/main@869930046b11dbeb3b147e3be952a2e847316292；Mac.lan/Darwin24.6.0/x86_64。Native13.6.1-particle.23；Integration本地HEAD80667d6c343411d03a760425438e3d292f452118，只读。实际会话rollout 01a1299f-0c2b-78b0-8599-e50812c108dd的turn_context核实gpt-6.1-sol/high，未升级、未启动子代理。
+
+## 必做项
+
+- [x] 读取根规则、规范/总则、当前任务、Integration规则与STEP112–118关键证据，核对实际Renderer/Placement/Bucket/Atlas/GL/Metal。
+- [x] 实现真实上传输入证据、revision/epoch、完成Full/Build/Reuse绑定，global/perSegment/preparedScene同时接线。
+- [x] 分离stale刷新需求与真实fade；保留原Placement算法/原Style/Source/公开API/ABI。
+- [x] 完成13项非Jest C++针对性测试源码，两个文件均已登记。
+- [x] 中文调查、阶段记录、实机联合验收计划、完成报告与开发记录追加。
+- [x] 轻量静态范围/原证据哈希/git diff --check检查。
+- [ ] Native编译与13项GTest实际运行，GL/Metal真实代码路径独立验证。
+- [ ] 同源新APK/设备SHA与>=90秒真实Build>0、Reuse>0、FastDelta>0、24Gate mismatch0。
+- [ ] 原63缺tide负对照、全部失效矩阵、Full/Fast视觉与iOS/Metal独立验收。
+
+## 允许与禁止范围
+
+仅内部Shared Core/原生shader来源薄接入、已登记C++测试与本Step文档。未修改include公开头、RN/JNI/ObjC/Java/Kotlin、正式PBF/URL/Style、天气语义、Core-owned timeline/playback、发行版本或Integration协议。
+
+没有Gradle/ADB/Native构建/Bazel/Jest/codegen/commit/push；没有更改STEP110/111未跟踪任务书或Git忽略原设备证据。没有修改长期项目总则、RDC Runner或后台执行器。
+
+## 当前结果
+
+两次成功Full取证的同一settled GPU输入版本可建立R Build，成功Full Reuse后才允许Fast。真实opacity clamp、动态/paint属性、UBO、索引/排序/tiles、atlas/shader身份、registry ordinal/depth与异步epoch共同参与；缺失证明仍Full。
+
+普通Full销毁旧RenderTree时保留复制证据，真正reset时清理；否则两帧比较仍会自举失败。原24Gate evaluator/掩码/顺序/计数和公开诊断结构没有修改。STEP117历史保守helper与断言保留，生产接线改为最终结果证书。
+
+源码没有运行验证，不宣称当前设备已从STEP118的Build0/Reuse0/Fast0改善。证书明确绑定编码/提交成功，GPU完成与像素仍需独立验收。Vulkan/WebGPU无本轮原生shader来源登记，Symbol证书继续fail-closed，普通Full不变。
+
+## 阻塞与下一步
+
+本工作区未锁定源码；既有验证器会拒绝tracked dirty，不能绕过。历史Mac缺libuv，本轮没有重跑配置。新的Native可编译性、真实PBF输入是否低于16MiB、实际GPU等价、异步竞态与性能均待证。
+
+立即交RDC按本Step联合验收计划独立审计、在其授权范围完成源码锁/定向Native验证，并集中一次APK build/install/真实设备验收。失败保存证据，按固定Codex修复→RDC验证闭环；未通过不得标完成/冻结，不自行执行下一阶段。
+
+## RDC独立编译检查记录（2026-10-11 JST）
+
+用户明确要求编译然后测试，并要求不要因本次功能无新第三方依赖而破坏已存在原生环境。RDC先同步核实Integration origin/main=80667d6c343411d03a760425438e3d292f452118与Particle origin/particle/main=869930046b11dbeb3b147e3be952a2e847316292，且保护的两份STEP110/111未跟踪MD的SHA未变。
+
+Mac Metal原生CMake配置首次因PATH找不到cmake而失败，改用既有/usr/local/opt/cmake/bin/cmake后，配置因早已缺少的libuv失败（不是本轮代码引入的依赖）。Homebrew建议连带升级CMake、Python和OpenSSL，RDC及时中断该安装并复核原CMake仍存在、无libuv新依赖安装。**Mac Metal CMake/GTest仍未运行，不能记PASS。**
+
+改走原项目已存在 Android NDK OpenGL/x86_64 compile_commands.json，保持实际C++20警告/Werror、不加Wno-error、不切宏、不改源数据。编译实际Core生产7文件（placement.cpp、render_symbol_layer.cpp、symbol_layer_tweaker.cpp、render_orchestrator.cpp、renderer_impl.cpp、renderer.cpp、shader_program_gl.cpp）与两个非Jest已注册GTest源码，合计9个编译单元，经过本地定点修复后全部严格 -fsyntax-only exit0（每文件独立日志保存在Git忽略artifacts/maplibre-particle/step119-native-syntax/）。本轮修复3处小编译缺口：SymbolLayer及Retained test各一处toString补上util命名空间，Orchestrator error test将构造结果从const Mutable转换为Immutable，保留测试语义。该结果是**Android NDK语法/类型检查**，非真实链接、GTest运行或Metal构建。
+
+下一关：RDC scoped Git锁定源码后，基于新源码一次集中标准Android Gradle/OpenGL x86_64 APK构建；FZG1-2安装和STATIC_RC_NO_TIDE 90秒验证。任何编译/设备错误继续按原步修复，不能绕过24Gate或声称Fast已通过。
+
+## RDC Android原PBF实机正负对照（2026-10-11）
+
+本轮源码锁 3d989a00a822989339a6d7cb4d23acc04396670e、APK SHA 57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135，Mac标准Android OpenGL x86_64 APK真编译/链接/打包PASS；FZG1-2安装SHA一致、preflight PASS。新STATIC_RC_NO_TIDE 90.010秒：Native64/R[0,62)，missingSourceIds=[]，Cache Build=1 / Reuse=3276（累计）、FastDelta=1819 / FullDelta=0、24Gate mismatch=0。原STATIC_RC 90.010秒：原Native65/R[0,63)，missingSourceIds=[tide]，Build=0、Reuse=0、FastDelta=0、FullDelta=305，fail-closed仍正常。新13项GTest运行/Metal/iOS/动态源变更与像素对比均未完成，保持ANDROID_FAST_CORE_PASS/OVERALL_PARTIAL。详细原始数据和sha见 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。
+
+## RDC STEP-119 RCRR 多配置续验（2026-10-11 JST）
+
+- Integration origin/main 经 RDC 同步核验为 `80667d6c343411d03a760425438e3d292f452118`；Particle 起点 `46c88b0209474376225b54ae0ad701881673743d`，仍在 `particle/main`；两份 STEP110/111 未跟踪任务文档未触碰。
+- 同一已安装 APK 源 `3d989a00a822989339a6d7cb4d23acc04396670e`，SHA `57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135`，真机原 `PARTIAL_RCRR` 80秒：R0 Build0/Reuse0/missing tide；R2/R3 各 Build1/Reuse536；FastDelta0/FullDelta596、decisionMismatch0。即局部复用有效、全帧 Fast 安全拒绝。
+- 真机导出原63层 `styleParity.baseLayerManifest` 确认 tide=2、sea=3、clip-outline=31、special=37；天气实际在原宽 C 中，不在 R0。由此修正早期错误的分段位置推测。
+- Test App 增加三种 `RCRR_*_NO_TIDE` 场景，分别测试窄 C、宽 C 与错误动态 R；基于上述真实 Manifest 校准成 Native64 精确 R/C 区间，未修改正式 PBF/原场景/24 Gate。验证器精确验三段 R 边界；4项 Python unittest PASS、Style Manifest 静态索引核对 PASS、git diff --check PASS。
+- **尚未完成**：新 Kotlin Test App 的用户手工 APK 编译及三场景真机 90秒回归、图像目视、Camera/Source/Style/Tile/Annotation/Context 真机失效和恢复、STEP119 13项 GTest 真跑、Metal/iOS。Mac 原有 libuv 缺失限制保持，不擅自安装或升级工具链。STEP-119 **PARTIAL，不 CLOSED**。
+- 文档：`docs/60_测试/STEP-119_RCRR多配置验收矩阵_v1.md`、`docs/报告/STEP-119_RCRR多场景局限性_阶段验收_v1.md`。原始真机记录位于 ignored `artifacts/maplibre-particle/android-validation/step119-rcrr-observe-20261011_172720/partial_rcrr/`。
+
+## RDC STEP-119 粒子独占 C 与 CPU 效率收敛（2026-10-11 JST）
+
+- 用户确认：RCRR 正常运行的 `CONTINUOUS` 原则上**只含 `RasterParticleLayer`**，`WeatherColorLayer` 与其他非逐帧图层在 R；下一轮验收必须结合 CPU/帧、CPU/秒和实际 FPS，不只观察 FastDelta。
+- RDC 已同步 Integration `main`=`80667d6c343411d03a760425438e3d292f452118`；Particle 以 `1072816740fa69b7b23cd70602a402be19e5be2a` 为起点，现有 `particle/main` 与 STEP110/111 未跟踪文件不变。
+- Native 源码检查确认 `singleContinuousSegment(plan)` 是 Fast 准入条件，Fast 上传/绘制仅访问 C 范围，所有 R 需满足原24 Gate 与真实 Render/Symbol 缓存证书；WeatherColor 放 R 后是否能安全 Build/Reuse 尚待真机验证，不能提前 PASS。
+- 将 `RCRR_C_NARROW_NO_TIDE` 改为粒子独占 C[32,33)（WeatherColor 在 R[0,32)），新增 RCR 两 R、RCRRR 四 R，以及同 Style/Plan 关闭缓存的 Full 对照；保留旧 C 宽、粒子误入 R 两种负例和原63层 `PARTIAL_RCRR`。菜单 ID 改为100～102避免新增enum与操作冲突。
+- 新增严格 SHA/HEAD/设备锁的 CPU 采样器（App进程 utime+stime、6秒采样、35秒warmup、90秒观测）、A-B-A 对照比较器；对照同时列 CPU核秒/秒、CPU估算ms/完成帧、Native FPS、FastFraction≥95%、Build/Reuse/Invalidate。ADB实机只读确认 `CLK_TCK=100`，未以旧APK冒充新测试；未进行Android编译。
+- Python 非Jest结构+CPU测试 12项 PASS。正式测试矩阵 `docs/60_测试/STEP-119_RCRR多配置验收矩阵_v2.md`，本轮阶段报告 `docs/报告/STEP-119_粒子独占C与CPU效率_阶段验收_v1.md`。
+- **待验**：用户手工编译、安装新APK及Full-Fast-Full CPU实测，三种粒子独占C布局的Build/Reuse/Fast、视觉等价、变更后失效与恢复，13项GTest/Metal/iOS。STEP-119继续PARTIAL、不宣称CPU性能提升。
+
+## RDC 2026-10-11 STEP-119 粒子独占 C 与 CPU 实机综合验收（续）
+
+- 用户已明确授权 Mac RDC 执行 Android APK 编译/安装及综合测试。Integration main 已同步到 `80667d6c343411d03a760425438e3d292f452118`；APK 真机源码 Commit 为 `32ac795fc4abd04006673bf644f87a711329e78f`；x86_64 APK SHA-256 为 `2bbd1cb4dc9e03ec56d8404363970e56f76b03819f6f2b50c8aee6dbb6fa43d2`，Mac build exit0、设备压缩下载解压 SHA 同源、`pm install -r` Success exit0、安装 Base APK 同 SHA、严格 preflight exit0。
+- CPU 测量工具首次 `sh -c` 多参数读取阻塞 exit3；随后采用单个 ADB shell 命令并保存 warmup+末尾日志的临时修正测量，第一组 Full 不齐整 exit2排除。最终 9次Benchmark中8次有效：2×Full、3×RCRR（三R）、2×RCR（两R）、1×RCRRR（四R）。全部24 Gate完整、判定失配0、同 APK/Style指纹、固定相机与场、Native最后120帧窗口119 Fast/0 Full（正向组）。
+- 实测进程CPUms/完成帧中位：Full 60.67ms，RCR 3.50ms，RCRR 7.04ms，RCRRR 7.82ms；RCR两次3.30/3.70ms，RCRR三次6.96/7.04/7.37ms。RCRR Full-Fast-Full 基线漂移2.70%，中间 Fast约55FPS、CPUms/帧7.04，相对Full估算降低88.40%。RCR约59.4–59.7FPS、CPU占单核约19.7–22.0%，比RCRR在该固定场景更省 CPU。仅为进程级CPU近似，不证明GPU、耗电。
+- 两种负例独立90秒：宽 C 海图混入 `Fast0/Full+339`、Particle误入R `Fast0/Full+322`，两者均24 Gate完整、`decisionMismatch=0`、`unsupported-continuous-layer`安全拒绝；严格验证器返回2属于预期负例 PASS，并非进程崩溃。
+- 定向验证中每个正向 R 都曾 Build1，稳定采样窗口 BuildDelta/InvalidateDelta=0，Reuse持续增加。天气切换后的 R 刷新、相机/源/Tile/Annotation/Context生命周期、Full与Fast的视觉同等、GPU计时、iOS/Metal、13个GTest仍未证实；STEP119 **PARTIAL**，不将稳态验收写成CLOSED。
+- RDC 将临时已实际运行的 CPU 采样器 `sh -c` 与日志边界修正合入正式Python测试脚本，**不重新构建/修改当前已验APK**；Python 12项 PASS，Git收尾只包含此脚本、阶段报告、Step记录与开发记录。正式结果：`docs/报告/STEP-119_RCRR粒子独占C_CPU真机验证_阶段报告_v2.md`，综合数据 `artifacts/maplibre-particle/android-validation/step119-rcrr-cpu/compare-20261011_193724.json`（本地忽略目录）。

docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v1.md

@@ -0,0 +1,43 @@
+# STEP-120 iOS 原始 Filter 无损 Native 接口 v1
+
+日期：2026-10-21（JST）。状态：**阻塞（BLOCKED）**。
+
+## 目标与基线
+
+为 NavSea JOINT-PBF-001 D4-13 提供通用 iOS Native 原始 Style Layer Filter 读取/设置接口，保留全部条件与 locale，由 NavSea 负责业务及单一 Host Context。
+
+Mac.lan / macOS 15.7.7 / x86_64，原仓库 `/Users/tei/dev/MapLibreParticleLab`；`particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`。原 worktree 唯一，子模块提交正常。预存未跟踪 STEP-120 任务书，tracked 与暂存区开工无差异。既有 iOS 发行版本 `6.29.0-particle.27`，其构建源 `970e3ad606e59873a32e9389e65ef257e1c259bb`，不包含本 Step 接口。
+
+用户指定 `GPT-6.1 Sol High`；执行器实际配置未取得可独立核实元数据，没有主动切换模型或启动子代理。
+
+## 范围与禁止事项
+
+源码只允许 `platform/darwin/src/MLNVectorStyleLayer.h/.mm`。允许新增本 Step、递增完成报告及末尾追加开发记录。禁止修改辅助实现、Layer 生成器、C++ Core、Android、Particle、RenderCore、发行记录及跨项目代码；禁止分支/worktree 变更、stage/commit/push/tag、reset/clean、升级依赖、Bazel/Xcode/Gradle 构建或发布。
+
+## 必做项
+
+- [x] 完整读取仓库规则、现行总则、任务书、V27 README 与相关实际 Darwin/Core 源码。
+- [x] 重新检查主机、branch、HEAD、status、worktree、submodule；保留预存任务书。
+- [x] 静态确认现有 Core Filter 与 Foundation 转换接口及公开 Headers 构建链。
+- [x] 报告严格无损与 detach 条件的源码级阻塞，不自行扩大范围。
+- [x] 在完成报告提供复杂 all/第二属性/locale、一般等号、原为空三组条件及安全反例。
+- [ ] 实现无损 getter / setter 及公开声明。
+- [ ] 完成深度/输入/失效/detach/非 Vector 防护。
+- [ ] RDC 独立语法编译、iOS SDK 构建及样例实际验证。
+- [x] 新增中文报告并仅追加开发记录；落盘后静态检查结果记录在完成报告末尾。
+
+## 当前结果与阻塞
+
+未修改 SDK 源码，公共接口未实现，现有 `predicate` 与 ABI 保持原状。
+
+1. 指定 `MLNJSONObjectFromMBGLValue()` 对字符串与键使用 `c_str()`，当前反向 Foundation 转换同样不传字符串长度；合法 JSON 的嵌入 NUL 会被截断，不能直接包装后承诺完整无损。修复既有辅助实现超出本轮源码范围；另写独立转换则需明确调整指定复用路径。整数转 double 的精度也需纳入后续门槛。
+2. 正常 `removeLayer:` 后 `_pendingLayer` 仍拥有有效 rawLayer；现有失效宏只检查 rawLayer 非空，没有权威 Style 成员关系查询。不能将其写成已拒绝 detach。已发出语义澄清，未答复不视为授权。
+3. 模型/推理参数只有用户指定值，无独立运行元数据证据；如需严格核实，由外部执行器补齐。
+
+## 检查、输出与下一步
+
+本轮仅做只读调查和静态自检，未执行任何编译、链接、codegen、单测、设备或发布操作。不存在 iOS 构建、运行或打包 PASS。
+
+完成报告：`docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md`，含具体源码位置、三组样例、空 Filter 特殊处理、ABI 状态、准确 RDC Bazel 单项命令和独立证据清单。
+
+先冻结 B1/B2 的契约与实现范围，再由 Codex 实现、RDC 独立验证；如通过，另起发行/NavSea Host 集成步骤。本 Step 不进入后续发布阶段，联调唯一业务主责仍 NavSea。

docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v2.md

@@ -0,0 +1,43 @@
+# STEP-120 iOS 原始 Filter 无损 Native 接口 v2
+
+日期：2026-10-21（JST）。Step 状态：**进行中**；Codex 实现交付：**IMPLEMENTED_WAITING_RDC_IOS_BUILD**。
+
+## 目标、基线与授权裁决
+
+NavSea 是 JOINT-PBF-001 D4-13 唯一业务主责。本轮只实现通用 iOS Native Filter 的安全快照/修改能力，原始多源 Provider、唯一 Mapping、原始 Style、四档及 Pickup/Danger/Planning 总目标仍开放。
+
+实际 Mac.lan / macOS 15.7.7 / x86_64；原仓 `/Users/tei/dev/MapLibreParticleLab`，`particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`。原 worktree 唯一，子模块正常；开工已有 v1 开发记录追加及 v1/v2 未跟踪任务书、v1 Step/报告，完整保留。正式 iOS 仍为 `6.29.0-particle.27`，不含新接口。
+
+用户指定外部执行器 `GPT-6.1 Sol High`，当前工具无独立模型/档位元数据，不宣称已核实；没有切模型或启动子代理。
+
+v2 明确：仅支持可证明无损重放的子集，其余 E_FILTER_UNSUPPORTED；Style 成员关系由 Host 校验；Native 只检查有效 rawLayer，正常 pending/detach 可用；空值通过 NSNull 精确恢复 Filter()。
+
+## 范围与禁止事项
+
+源码仅 `platform/darwin/src/MLNVectorStyleLayer.h/.mm`；文档只新增本 v2 Step/报告、末尾追加开发记录。禁止改共享转换器、C++ Core、生成器、Build 配置、Android、Particle、业务与发行记录；禁止 Git stage/commit/push/tag、分支/worktree 变更、reset/clean、依赖升级或发布。Codex 不执行长构建、Native 单测、Jest 或设备操作。
+
+## 必做项与当前结果
+
+- [x] 重新读取规范、总则、路线、v1/v2 任务和 v1 报告；核对实际源码及 Git/主机基线。
+- [x] 在公共头声明 `rawStyleFilterJSONObjectWithError:` 与 `setRawStyleFilterJSONObject:error:`，并提供稳定 NSError 域和五个代码。
+- [x] 在指定 `.mm` 局部实现 Foundation 独立快照、C++ Value 归一/比较、真实桥接及 Core 反向解析；不经 NSPredicate/NSExpression。
+- [x] 预检 NUL、UTF-8、特殊/超范围数值及大小限制；深度 64、节点 4096、UTF-8 字符串/键合计 256 KiB。
+- [x] 明确支持的操作符候选、受限 legacy 域及结构变化拒绝；同时核对实际 Core 表达式，不依赖 Filter 指针相等。
+- [x] 先验证输入及原状态再写入；写后核对，异常/不符时恢复原 Filter 并独立核实，无法确认则要求 Host 废弃 Context。
+- [x] 文档明确主线程、有效 rawLayer 与 Host Style 成员关系的边界；没有另建 Context/generation/revision。
+- [x] 原 predicate/description 实现保持；不修改其他 Layer 属性或移除重建 Layer。
+- [x] 报告交付简单等值、两个属性范围、locale、NUL 拒绝、空 Filter 及 common 组合样例与源码依据。
+- [x] 新增中文 v2 报告并末尾追加开发记录；静态空白、范围和保护检查。
+- [ ] RDC 独立 ObjC++ 编译、iOS Metal SDK 构建与公开 Headers/调用链接验证。
+- [ ] RDC 实际运行样例、输入边界、回滚注入、线程/生命周期及 Host 成员关系联调。
+- [ ] 后续另行授权发行与 NavSea Host 集成。
+
+## 检查、阻塞与下一步
+
+只执行精确源码/文档/Git 静态检查，没有编译、codegen、测试或设备结果。两份 v1 文档、两份任务书、共享转换器及 V27 发行文件保持；开发记录保留开工前全部字节，仅追加。具体检查与保护证据见 v2 完成报告末尾。
+
+v1 的完整 JSON 与 Native detach 契约阻塞已按用户裁决收敛；当前没有已知必须扩围的源码阻塞，但实现尚未编译，不能确认可构建。存在保守拒绝域、Core 初次序列化开销、回滚通知无法撤销与旧 SDK 不含新符号等限制；这些均已在 API 文档及报告说明。
+
+下一步切换 RDC 独立审计，并在同工作区运行 `bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic`；真实失败返回 Codex 修复。成功后另起发行/Host 集成，不在本轮自动推进。
+
+完成报告：`docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md`。状态维持等待 RDC 验证，不宣布本 Step 或原业务总目标最终完成。

docs/50_Step记录/STEP-121_V28统一正式发行_v1.md

@@ -0,0 +1,13 @@
+# STEP-121 V28 统一正式发行记录 v1
+
+日期：2026-10-21 JST；项目 MapLibreParticleLab（NavSea 多源联调专业支持方）。
+
+- 前置 STEP-120 iOS Native Filter 无损或拒绝接口通过 RDC Mac Metal Bazel opt 编译；新增两项通用 ObjC API，不更改既有 NSPredicate 行为。原正式 v27 不覆盖。
+- GSRL 源码提交 1aba9875f07d8e609eb5bf42810a4d8f40d15d3f；统一冻结发行源码 4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8。
+- tools/particle_release_pipeline/release.sh 28 prepare/build/publish/finalize 全部退出 0，完整日志位于 /private/tmp/JOINT-PBF-001-V28-GSRL-{prepare,build,publish,finalize}.log。
+- Android OpenGL 四 ABI（armeabi-v7a/arm64-v8a/x86/x86_64）、Maven Local AAR/POM/module、RN tgz、iOS Metal ios-arm64 XCFramework 均通过统一构建。
+- NAS 原子发布，六个文件公网逐字节回读，SwiftPM 6.29.0-particle.28 Tag 验证 PASS。
+- 版本级 release/maplibre-particle/13.6.1-particle.28/README.md 与 SOURCE_LOCK.json 包含六项文件的 SHA-256 和构建来源。
+- 正式发行最终提交 e48258434e5b9ee40ab1d414c223a4ed809be879；正式 Tag maplibre-particle/rn/13.6.1-particle.28；origin/particle/main 与 Tag push PASS。
+- 状态 CLOSED / GSRL RELEASED。没有在最终发行 AAR/XCFramework 的真实设备上执行原 Filter 查询/应用/恢复，也没有验证 NavSea MLRN iOS Adapter 与完整四档业务。
+- 下一唯一主责 NavSea：确认 SwiftPM .28 / RN .28 / Android Maven .28 接线，完成 iOS MLRN 11.5.0 patch Bridge，进行 Mac iOS 与 Android 回归和 Host E2E。不能把发行成功直接升格为 Provider Mapping 受信证明。

docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md

@@ -0,0 +1,172 @@
+# STEP-114 独立 Fast Smoke 场景与 RDC 验收 v1
+
+日期：2026-10-11。状态：**源码交付；下列编译、测试和设备操作全部 NOT RUN。** Codex 不执行本页命令。Mac Native 由 RDC/普通 Terminal 独立执行；Android 构建、安装、ADB 与实体机步骤由用户在后续授权条件下手工统一执行。
+
+## 1. 场景入口和范围
+
+Test App：`STEP 093 → STEP-114 独立 FAST_SMOKE（非正式 PBF）`。正式网络 PBF 仍在 `STEP 093 → STEP-113 FZG1-PBF GATE`，保留 PBF63、STATIC_RC、PARTICLE_OFF、PARTIAL_RCRR、SOURCE_CHANGE 原实现。
+
+| 独立场景 | 预期层序/保护 | 待验收结果 |
+|---|---|---|
+| FAST_SMOKE | R=background + 非空本地 GeoJSON/circle；C=WeatherColor + RasterParticle。无 Annotation 实例时删除空内建 Annotation layer，保留 source | Native 实际4层；R Build/Reuse 和 Full/Fast 必须真实增长 |
+| CIRCLE_C_BLOCKED | baseline 后追加普通 circle C；Annotation 层仍按独立空场景移除 | 实际5层，#22/#23 阻止 Fast；R 可正常 Build/Reuse，不等于整个 scene 可 Fast |
+| ANNOTATION_BLOCKED | baseline 加正常自动内建 Annotation Symbol C，并创建真实 marker；不删该层 | 实际5层；#22/#23 阻止 Fast；marker 可见、可单次 position 更新 |
+| SYMBOL_R_BLOCKED | baseline 的 R 内加本地16×16图标 Symbol；无需网络 glyph/sprite | 实际5层；Symbol R 首建仍被 Placement gate 阻止；不能把关闭 transitions 当修复 |
+
+全部使用既有离线 ECMWF canonical 双帧资产、固定预报 `1786060800000` ms、PAUSE、30fps目标和1024粒子，SDK camera 初始33.45/129.97、zoom10.5、bearing/pitch0；手势禁用且退出恢复。30fps目标不是实际帧率测量。actualForecastTimeObservedMs 保持 null，不能当成 Native 已回读请求时间。sceneReady 只表示加载回调与控制命令成功，不替代 Native 层表/valid/实际渲染核验。
+
+不要在旧正式 V23 APK 上验收本轮新入口；版本号未变，必须保存本轮源码 diff/hash、build-info 的 dirty 状态与 APK SHA。不得发行或覆盖已有版本。
+
+## 2. Mac Native 精确定向命令（仅 RDC 执行）
+
+基于现有 `macos-metal` preset 和实际 `mbgl-test-runner` target，无全仓测试、无 Jest。STEP-113 曾缺 libuv；本轮没有安装依赖。配置失败则停止，不运行旧 runner。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+bash <<'SH'
+set -eu
+mkdir -p artifacts/maplibre-particle/step114-native
+if cmake --preset macos-metal > artifacts/maplibre-particle/step114-native/configure.log 2>&1; then
+  echo 'configure exit=0'
+else
+  step114_rc=$?
+  tail -n 80 artifacts/maplibre-particle/step114-native/configure.log
+  exit "$step114_rc"
+fi
+if cmake --build build-macos-metal --target mbgl-test-runner --parallel 3 > artifacts/maplibre-particle/step114-native/build.log 2>&1; then
+  echo 'build exit=0'
+else
+  step114_rc=$?
+  tail -n 80 artifacts/maplibre-particle/step114-native/build.log
+  exit "$step114_rc"
+fi
+if build-macos-metal/mbgl-test-runner --gtest_filter='Step114FastPathSafety.*:FastGateTrace.*:ParticleFastPath.*:RetainedUnderlayCache.*:RetainedUnderlayRevision.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*:RenderSegmentDiagnostics.*:RenderOrchestratorError.*:RenderOrchestratorTeardown.*:ImageManager.*:GlyphPBF.*' --gtest_color=no --gtest_output=xml:artifacts/maplibre-particle/step114-native/tests.xml > artifacts/maplibre-particle/step114-native/tests.log 2>&1; then
+  tail -n 20 artifacts/maplibre-particle/step114-native/tests.log
+else
+  step114_rc=$?
+  tail -n 80 artifacts/maplibre-particle/step114-native/tests.log
+  exit "$step114_rc"
+fi
+SH
+```
+
+记录 configure/build/tests 各退出码、耗时、实际测试数量与是否 skipped；失败回传首个真实 error、target、必要上下文与日志路径。新增测试应实际发现3个 `Step114FastPathSafety` 用例，否则不能把空过滤器执行成功作为 PASS。这些主要是纯状态机/结构判定测试，**不能证明 Android GPU Fast 命中、帧像素一致或 iOS 设备通过**。
+
+## 3. Android 后续一次集中手工验收
+
+由用户手工，在设备 ABI=x86_64 且 Java17/SDK 环境满足现有规范时，运行唯一既有 Validation Pipeline；不自行改 ABI、build 参数或依赖，不全量 clean。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+./tools/particle_android_validation/build_validation_apk.sh
+```
+
+失败保留 build.log，禁止复用旧 APK。用户手工核对同包签名和数据后再安装；本页不授权卸载用户数据。下面 ADB 全部固定既有 FZG1-2 serial，仅作为用户后续手工命令：
+
+```bash
+adb -s 192.168.200.139:5555 shell getprop ro.product.cpu.abi
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step114_scenario FAST_SMOKE
+```
+
+启动后预热10秒，再观察60秒。在开始和结束分别点击“导出当前 Native 快照”。标签 `STEP114Gate` 每30秒只输出真实 Native 摘要，完整JSON写 App 私有 files。生命周期计数可以含预热，必须比较同 lifecycle/sceneGeneration 的两次计数 delta；不要称整个累计为60秒帧率。
+
+菜单“单次更新 R GeoJSON”“Pan/Zoom 往返”“单次 Image 变更”“禁用/恢复缓存”保存 before/submitted/100/500/1500ms 的5份快照。一次只做一项，等恢复稳定并手动导出后再做下一项。自动文件有 actionSequence 和 phase，不追加 candidate 输入或人工 frame 结果。
+
+每个负场景单独启动、预热、观察、导出，不把以下命令连续执行当验收：
+
+```bash
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step114_scenario CIRCLE_C_BLOCKED
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step114_scenario ANNOTATION_BLOCKED
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step114_scenario SYMBOL_R_BLOCKED
+```
+
+ANNOTATION_BLOCKED 点击“单次更新真实 Annotation”，截图应见位置变化，Native 保持 fail-closed。FAST_SMOKE 中点击该操作会明确 BLOCKED（没有 marker），不创建隐藏 Annotation 或假事件。
+
+## 4. 回读完整快照（用户手工）
+
+在普通 bash Terminal 保存全部 step114 JSON，不通过 Logcat 分块拼接。路径来自当前 Debug App：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+bash <<'SH'
+set -eu
+mkdir -p artifacts/maplibre-particle/android-validation/step114
+adb -s 192.168.200.139:5555 shell run-as org.maplibre.android.testapp ls files > /tmp/step114-files.txt
+tr -d '\r' < /tmp/step114-files.txt > /tmp/step114-files-normalized.txt
+while IFS= read -r step114_file; do
+  case "$step114_file" in
+    step114-*.json)
+      adb -s 192.168.200.139:5555 exec-out run-as org.maplibre.android.testapp cat "files/$step114_file" > "artifacts/maplibre-particle/android-validation/step114/$step114_file"
+      ;;
+  esac
+done < /tmp/step114-files-normalized.txt
+SH
+adb -s 192.168.200.139:5555 logcat -d -v time -s STEP114Gate:I '*:S' > artifacts/maplibre-particle/android-validation/step114/device.log
+adb -s 192.168.200.139:5555 logcat -b crash -d > artifacts/maplibre-particle/android-validation/step114/crash.log
+adb -s 192.168.200.139:5555 exec-out screencap -p > artifacts/maplibre-particle/android-validation/step114/screen.png
+```
+
+每阶段独立命名截图/日志；同名覆盖前先归档。App files 自动快照只在显式操作和生命周期变化时创建，数量无硬上限；验收后由用户管理归档，Codex 不删文件。100ms采样也可能错过一帧的变更窗口，未捕获不能标反向 Gate PASS，需保留日志再复核。
+
+下面是读取**实际导出文件**的正向检查；把路径替换为稳定 FAST_SMOKE 手动快照的明确文件名（不要随意用最后的 teardown/旧场景文件）：
+
+```bash
+python3 - 'artifacts/maplibre-particle/android-validation/step114/替换为稳定FAST_SMOKE文件.json' <<'PY'
+import json, sys
+from pathlib import Path
+d = json.loads(Path(sys.argv[1]).read_text())
+assert d['scenario'] == 'FAST_SMOKE' and d['sceneReady'] and d['blockedReason'] is None
+n = d['native']; t = n['fastGateTrace']
+assert n['valid'] and n['styleLayerCount'] == 4
+assert [l['layerType'] for l in n['styleLayers']] == ['background', 'circle', 'weather-color', 'raster-particle']
+assert [s['strategy'] for s in n['segments']] == ['RETAINED', 'CONTINUOUS']
+r, c = n['segments']
+assert (r['beginIndex'], r['endExclusive'], c['beginIndex'], c['endExclusive']) == (0, 2, 2, 4)
+assert not r['placementCapable'] and r['placementGatePassed']
+assert r['cache']['sourceReady'] and r['cache']['sourceStable'] and r['cache']['supported']
+assert r['cache']['build'] > 0 and r['cache']['reuse'] > 0
+assert t['fullRendered'] > 0 and t['fastRendered'] > 0 and t['decisionMismatch'] == 0
+assert len(t['gates']) == 24
+fs = [f for f in t['frames'] if f['completed'] and f['outcome'] == 'fast-rendered'
+      and f['post']['configRevision'] == n['configRevision']
+      and f['post']['topologyRevision'] == n['topologyRevision']
+      and f['post']['contentRevision'] == n['contentRevision']]
+assert fs, '完整窗口没有真实完成的 Fast 帧'
+for f in fs:
+    assert f['candidate'] and f['decisionConsistent'] and f['knownMask'] == 0xffffff and f['failMask'] == 0
+    assert f['gateStatus'] == ['PASS'] * 24
+    assert not f['cacheInputsTruncated'] and f['cacheInputs']
+    assert all(x['valid'] and x['buildRevision'] == x['staticRevision'] for x in f['cacheInputs'])
+    assert f['post']['fullCpuFrame'] == f['pre']['fullCpuFrame']
+    assert any(x['actualExecution'] == 'composite' for x in f['post']['retained'])
+print('仅此快照 Native 正向证据通过；反向/生命周期/视觉/双平台仍需独立验收')
+PY
+```
+
+不能通过修改导出的 JSON、补造 frame、重命名旧文件或放宽断言制造结果。
+
+## 5. 定向反向、生命周期与回归矩阵
+
+| 项目 | 必需证据/接受条件 |
+|---|---|
+| 稳定 baseline | 两次同生命周期快照 Fast/Reuse delta>0；至少一个 completed Fast 的24 Gate全通过；Build>0；orange R circle可见，天气/粒子正常；decisionMismatch=0 |
+| Source mutation/异步 Tile | 单次sourceMutationCount增长；sources 表及 lastMutation 定位 step114-r-geojson；content/source revision变化；#8/#5/ready/pending 等真实拒绝证据、成功布局后 Full/Build 增长再恢复 Fast。tombstone/失败布局用Native状态机用例补充，不冒充GPU验证 |
+| Image 更新 | images signature/content/global revision 导致 Full；重建后恢复。baseline图标未引用也保守失效；不能宣称已验证 glyph atlas像素 |
+| Glyph | baseline完全无文字；本轮未新增 glyph mutation Test App控制。已有 GlyphPBF/ImageManager 测试仅资源回归；真实 Symbol glyph URL/font/atlas变化属于 Symbol结果证书阻塞，NOT VERIFIED，不能以image替代 |
+| Pan/Zoom 往返 | SDK cameraObservedFromSdk与Native gate/key对应，Full/Build增量；恢复相机后不能直接复用旧key；截图无陈旧circle/错位 |
+| 缓存禁用/恢复 | 禁用时#2失败、实际Full/live，无completed Fast增长；恢复后合法Build与Fast恢复；比较截图确认R内容/层序一致 |
+| Reload | 保存reload-before与加载后快照；sceneGeneration变更、Native当前层表/plan正确，重新Build；trace lifecycle仅在实际Native reset时变，不要求UI generation=Native lifecycle |
+| 非粒子C/真实Annotation | CIRCLE_C_BLOCKED/ANNOTATION_BLOCKED稳定窗口#22/#23失败、无completed Fast；真实marker可见/位置变化；#24是短暂pending保护，不要求在3秒末态仍FAIL |
+| Symbol R | 本地icon可见；R placementCapable=true，正常Full placementGatePassed=false/Build0或对应安全fallback；Fast不放行，scene #23可能另挡；无证书不改判定 |
+| 前后台 | baseline导出、手工Home后台10秒、回前台观察/导出；pause-before文件、恢复后Native增长、无死循环/错层/crash。此处未强制改变WeatherRuntime播放语义 |
+| Teardown/重建 | 退出场景/关闭Activity产生teardown-before，dispose与callback取消；用户确认MapView销毁返回/无crash，重新启动baseline。teardown-before不是销毁完成证明 |
+| 原PBF5场景 | 分别采集STEP-113五场景；仍保留全部基础63层定义/顺序及Annotation；缺tide时应明确missing-source，CustomMVT若实际出现仍unknown；不要求生产Fast>0、不篡改旧统计 |
+| 原STEP-102 | T1/T2/T3/T4 fixture和既有动态poll回归；尤其含Symbol路径不因本轮无Symbol优化被放行 |
+| iOS/Metal | 同Shared Core源码的Mac Metal定向测试先执行；iOS实机与GPU像素/性能未验收。Android Fast成功不能替代此项 |
+
+## 6. 收口规则
+
+记录各场景来源commit/dirty diff、APK SHA/版本、device serial/ABI、真实Native层表/plan、before/after文件与SHA、24Gate、Full/Fast/Build/Reuse增量、截图、首错及crash日志。processSimulationAdvance是进程级，不作为单Map Fast证据。post的原始 placementTransitionActive仍可能true，但无Symbol的preFastPlacementTransition=false是本轮受控变化，decisionMismatch应仍0。
+
+没有真实Fast或反向证据不足，保持 PARTIAL；Symbol证书/CustomMVT/C放行分别继续 BLOCKED/fail-closed。不得根据静态检查、runner退出0或APK成功宣称整个Fast Path修复/性能PASS。Codex未commit/push，RDC后续Git收尾另需明确授权与scoped路径，不包括STEP-110/111或正式发行。

docs/60_测试/STEP-116_FZG1_原PBF实机验收结果_20261011.md

@@ -0,0 +1,57 @@
+# STEP-116 原 STEP-113 PBF 专用 APP 实机测试报告
+
+日期：2026-10-11 JST；结论：**PARTIAL。空 Annotation / C 段结构修复确实有效；原 STATIC_RC 进入 Fast Path 的目标未达成（FAIL）。**
+
+## 1. 用户授权与源码/设备闭环
+
+用户明确授权本次由 RDC 执行标准 Android APK 编译、安装和专用 APP 测试。环境：Mac.lan，仓库 /Users/tei/dev/MapLibreParticleLab，Particle源码commit c48a72a9d492ea0d05e4d58464f9643453158d50；Integration main 80667d6c343411d03a760425438e3d292f452118。Git tracked clean；两个STEP110/111用户文件仍未跟踪且不改动。Android Test App版本字符串13.6.1-particle.23，本轮真实二进制以commit和SHA而不是版本名辨识。
+
+RDC执行标准 tools/particle_android_validation/build_validation_apk.sh，进程退出0，Gradle与APK pipeline回报BUILD SUCCESS，构建Native OpenGL/x86_64、Kotlin、ZIP/strip/体积检查通过。Java17；APK文件66,603,829字节，libmaplibre.so未压缩40,035,512字节。APK SHA-256：
+
+a8b7f4e0f8e026bde8835e18a04876062be84cce3a3749a511cb08605d9f8a35
+
+设备FZG1-2，ADB serial 192.168.200.139:5555。实际adb install -r返回Performing Streamed Install / Success，没有卸载应用或清空数据；pm path得到新安装base.apk，设备sha256sum与上述新APK完全一致。STEP115 Python工具的preflight-only返回PREFLIGHT_PASS，确认当前源HEAD、build-info、APK、设备ABI和安装包SHA完全匹配。build-info中的git_dirty=true来自构建前保护的两份未跟踪任务书，不是tracked源码变更。
+
+## 2. STEP-113原STATIC_RC的90秒结果
+
+RDC实际启动原 STEP-113 正式PBF STATIC_RC（非STEP114简化FAST_SMOKE），进程PID19771，同sceneGeneration=2/lifecycle=1，观察90.008秒。两份完整运行摘要一致且单调：
+
+- STATUS=NO_FAST_OBSERVED，工具exit=2（真实Fast目标未达成）
+- FastDelta=0，FullDelta=920
+- sceneReady=true，planValid=true，baseLayersPreserved=true
+- 原正式PBF基础63层定义/顺序保留；正式Style fingerprint e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996
+- Native实际层数65，R[0,63)、C[63,65)；C只包含rn-weather-color和rn-weather-particles
+- emptyBuiltinAnnotationLayerRemoved=true、annotationInstancesAtRemoval=0、annotationSourcePreserved=true；原内建Annotation Source仍在Native列表并Loaded
+- 实际Native Sources为mapple:raster、navsea_delivery:vector、org.maplibre.annotations:annotations、rn-weather-fields:raster-array；tide Source确实缺失
+- R Cache Build=0、Reuse=0；lastFallbackReason=missing-source、missingSourceIds包含tide；placementCapable=true、placementGatePassed=false
+
+RDC经设备菜单STEP093→STEP113→EXPORT LAST SNAPSHOT，回读真实Native完整JSON，大小274,693字节，SHA-256：
+
+cd491d2acca97119f1d4f2d6f77eb7b229c17b90d4be1181a59202308429b219
+
+完整120帧窗口验证：120帧、24项Gate、每帧knownMask=0xffffff、120/120 decisionConsistent=true、decisionMismatch=0；完成帧为119 Full、0 Fast；另1帧pending。
+
+| Gate | 最近120帧失败数 |
+|---|---:|
+| #3 cache-invalid | 120 |
+| #4 revision-mismatch | 120 |
+| #12 static-unstable | 105 |
+| #13 placement-or-fade | 105 |
+| #22 unsupported-continuous-layer | 0 |
+| #23 unsupported-scene | 120 |
+
+其他Gate当前窗口失败数为0。#22生命周期初期累计6次，不能称启动全程均无失败。#23仍因R不满足整体准入而持续失败。diagnostic decisionMismatch=0仅说明当前决策与trace一致，不代表Fast有效。
+
+## 3. 与旧STEP-113相对照及有效性判断
+
+原STEP-113旧APK的STATIC_RC Native层数66，多出内建org.maplibre.annotations.points Symbol落在C中，Gate #22/#23曾每帧失败，R Build=0、Fast=0。旧场景累计Full875，和新测试FullDelta920不是相同窗口/时长，不可据此计算帧率或性能提升。
+
+新APK实际65层、C仅两张天气层，最近120帧#22为零，证实STEP116针对空Annotation/C准入的**局部修复有效**。然而真实R中缺tide、Placement/Fade条件未稳定、R Build/Reuse仍为0，#3/#4/#12/#13/#23持续失败；**Fast仍为0，没有任何性能收益证据**。没有改动或删除原63层，不以STEP114烟测替代。
+
+## 4. 保存的证据和未覆盖的边界
+
+本机Git忽略路径：artifacts/maplibre-particle/android-validation/step113-retest-20261011_121308/static_rc/，包括result.json、launch.txt、logcat.txt、native-full.json、screen.png、ui.xml。本轮截图仅存档，尚未人工验收像素/航标显示；没有执行五场景全部回归、Annotation真实增删、缺源恢复、Camera/Tile/Image负例、iOS或Native GTest（Mac先前CMake缺libuv）。本轮当前正式PBF用户目标已获得明确失败结论，不得标CLOSED/PASS。
+
+后续必须由Particle Shared Core跨平台负责人确定R缺源零像素证明、Source同名重建的Full失效保证及Symbol Placement已提交GPU结果证书；不得伪造tide、删正式图层、禁用安全Gate或声称已有Fast性能改善。
+
+注意：若本结果文档随后产生新的纯文档Git commit，APK仍绑定上述c48a72a9源码。后续使用STEP115严格HEAD预检时，不能拿新文档HEAD冒充该APK源码，也不得为修改审计证据而重新标记APK编译来源。未执行GSRL正式发行、Source Lock或Tag。

docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md

@@ -0,0 +1,151 @@
+# STEP-116 STEP-113 原 PBF 专用 APP 验收 v1
+
+日期：2026-10-11（JST）。**以下命令交 RDC / 用户执行，Codex 本轮全部未运行。** 本轮源码状态 PARTIAL；缺 tide 与 Symbol R 准入仍阻塞，预期仍可能 Fast=0。不得拿 STEP114 Smoke 或旧 V23 APK 替代原 STATIC_RC。
+
+## 1. RDC 源码锁定和 Native 定向验证
+
+先重新读取 AGENTS、当前基线、STEP-116 审查/报告与 diff。审计包含 Native Annotation 修复的线程/生命周期、原63层逐层定义/顺序、移除对象重载、stop恢复、后续marker/style添加、五场景分支、生产Gate未变和七项新测试。执行只读命令：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+git branch --show-current
+git rev-parse HEAD
+git status --short
+git diff --check
+git diff -- src/mln/annotation/annotation_manager.cpp src/mln/annotation/annotation_manager.hpp src/mln/renderer/render_segment_json.hpp test/api/annotations.test.cpp test/renderer/retained_underlay_cache.test.cpp platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step113PbfGateScene.kt tools/particle_android_validation/verify_step113_fast_path.py tools/particle_android_validation/README.md 粒子开发记录.md
+shasum -a 256 docs/40_任务/STEP-110_R0_Placement跨段归因只读调查_Codex任务_v1.md docs/40_任务/STEP-111_R段Placement结果等价与独立刷新可行性只读调查_Codex任务_v1.md
+```
+
+两任务书 SHA 应分别为 `33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`、`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。不要暂存它们。RDC按获授权的scoped流程收尾后，记录真正的最新HEAD；本报告起点 e2d202b 并不包含本轮修改。构建前 tracked 必须 clean；原未跟踪任务书可保留，build-info 的 git_dirty 不能单独用来推断源码不一致。
+
+Native 定向命令逐项执行，上一项失败立即停止，保存完整 stdout/stderr 与首个真实 error；历史缺 libuv 不当成新结果，不运行旧runner：
+
+```bash
+cmake --preset macos-metal
+```
+
+```bash
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+```
+
+```bash
+build-macos-metal/mbgl-test-runner --gtest_filter='Step116Safety.*:Annotations.*:FastGateTrace.*:ParticleFastPath.*:RenderSegmentDiagnostics.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*' --gtest_color=no
+```
+
+Annotations.Step116 三用例使用现有 point_annotation 图像做实际渲染比较；不能仅检查 getLayer 指针就声称像素 PASS。账本/谓词用例不构成 GPU rendered Fast，Metal host 成功也不代替 Android OpenGL/设备回退。若依赖/编译阻塞，保持现场并在报告标 BLOCKED/NOT RUN，Android集中构建是否继续由用户安排。
+
+## 2. 用户一次手工 Android 构建与安装
+
+在锁定的最新 HEAD 上，用户手工依序执行，Codex/RDC不得代用户启动 Android 构建或安装：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+git rev-parse HEAD
+git status --short
+./tools/particle_android_validation/build_validation_apk.sh
+```
+
+标准脚本使用 Java17、OpenGL/x86_64、strip native debug symbols，保存 build-info/build.log，检查 ZIP/ABI/体积/SHA。失败不得续用原路径旧 APK。
+
+```bash
+cat artifacts/maplibre-particle/android-validation/build-info.txt
+shasum -a 256 artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+```
+
+记录源码HEAD、branch、精确修改文件/SHA、构建日志、APK大小/ABI/SHA、设备序号及型号。不能仅凭 `13.6.1-particle.23` 或安装 Success 认定是新源码。
+
+## 3. STEP115 preflight → 原 STATIC_RC ≥75秒
+
+用户安装成功后，由 RDC / 用户执行，serial/adb路径明确：
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --preflight-only
+```
+
+preflight 检查当前 tracked clean、build-info.commit==HEAD、APK SHA==build-info.sha256、设备 ABI x86_64、安装包 SHA==本地 APK。STALE_APK / SOURCE_NOT_LOCKED / SHA失败时停止，必须先纠正版本。PREFLIGHT_PASS只代表版本一致。
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario STATIC_RC --seconds 90
+```
+
+使用90秒，脚本在取得 PID 后实际等待完整90秒（≥75秒）；加载太慢导致摘要不足则 INSUFFICIENT_SAMPLES / NO_READY_SUMMARY，不推断Fast。保留 result.json、logcat.txt、launch.txt、实际观察秒数。摘要须同sceneGeneration/lifecycle、planValid/basePreserved、24项、mismatch=0、累计计数单调；独立blocked日志和摘要撤销不能被早先Fast盖过。退出2为没有可接受Fast证据，退出3为版本/环境等阻塞，不能改成0制造PASS。
+
+`FAST_OBSERVED`仅指真实 Native fastRendered 增量>0，不是安全/像素/性能终验。要求原63层manifest、NavSea原PBF/Sprite/Glyph/Vector URI及定义/顺序不变，仅声明SDK空辅助层调整；正常静态预期Native65层/C仅weather-color和raster-particle，实际以新导出为准。PUBLIC PBF若变成非63层，场景保留现场并 BLOCKED，不更换简化Style来通过。
+
+## 4. 手动导出完整120帧及设备画面
+
+保持同次 STATIC_RC 运行，用户在 STEP093 → STEP113 菜单选择 EXPORT LAST SNAPSHOT。这是最近一次3秒共享采样，不额外渲染。以下由 RDC / 用户回读，必须核对所选文件确属本次新运行：
+
+```bash
+mkdir -p artifacts/maplibre-particle/android-validation/step116
+step116_file="$(/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 shell run-as org.maplibre.android.testapp ls -t files | tr -d '\r' | grep -E '^step113-STATIC_RC-.*[.]json$' | head -n 1)"
+test -n "$step116_file"
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 exec-out run-as org.maplibre.android.testapp cat "files/$step116_file" > artifacts/maplibre-particle/android-validation/step116/static-rc-full.json
+shasum -a 256 artifacts/maplibre-particle/android-validation/step116/static-rc-full.json
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 exec-out screencap -p > artifacts/maplibre-particle/android-validation/step116/static-rc-screen.png
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 logcat -b crash -d > artifacts/maplibre-particle/android-validation/step116/crash.log
+```
+
+`test -n`失败立即停止后续命令。同一个Full JSON先做离线证据结构检查（不是安全测试）：
+
+```bash
+python3 -B - <<'PY'
+import json
+from pathlib import Path
+p = Path('artifacts/maplibre-particle/android-validation/step116/static-rc-full.json')
+v = json.loads(p.read_text())
+assert v['scenario'] == 'STATIC_RC' and v['sceneReady'] and not v['blockedReason']
+assert v['commands']['emptyBuiltinAnnotationLayerRemoved'] is True
+assert v['commands']['annotationInstancesAtRemoval'] == 0
+assert v['commands']['annotationSourcePreserved'] is True
+assert v['styleParity']['baseLayerCount'] == 63 and v['styleParity']['baseLayersPreserved']
+assert not v['styleParity']['full113Equivalent']
+n = v['native']; t = n['fastGateTrace']; frames = t['frames']
+assert n['valid'] and len(frames) == t['windowCount'] == 120
+assert len(t['gates']) == 24 and t['decisionMismatch'] == 0
+assert [g['order'] for g in t['gates']] == list(range(1, 25))
+assert all(f['knownMask'] == 0xffffff and f['decisionConsistent'] and len(f['gateStatus']) == 24 for f in frames)
+assert all(a['sequence'] < b['sequence'] for a, b in zip(frames, frames[1:]))
+complete = [f for f in frames if f['completed']]
+assert complete and all(f['post'] is not None for f in complete)
+print('结构完整；仍须独立核对源码/制品SHA、同次generation/lifecycle及用户画面')
+print('生命周期 Full/Fast:', t['fullRendered'], t['fastRendered'])
+print('窗口 completed/Full/Fast:', len(complete), t['windowFullRendered'], t['windowFastRendered'])
+for s in n['segments']:
+    if s['strategy'] == 'RETAINED':
+        print('R', s['beginIndex'], s['endExclusive'], s['missingSourceIds'],
+              s['placementGatePassed'], s['cache'])
+print('窗口失败项:', [(g['order'], g['reason'], g['windowFailures']) for g in t['gates'] if g['windowFailures']])
+PY
+```
+
+允许最后一帧 pending，但不能把其post作为当前Full。pre为上次完成树、post/full为本次完成树，避免跨帧拼状态。环形窗口可能覆盖Mutation瞬间，必须变更前/后分别及时手动导出，若没捕获则如实 NOT VERIFIED。120条帧不等于120条completed。
+
+用户确认基础PBF/标注/天气色带/粒子可见、无漏内容/闪烁/层序错误；截图归档及用户判断不能代替同条件Full/Fast像素比较。当前缺源/Placement未解时应记录 Fast0 和每项失败，不宣布性能提升。
+
+## 5. 失败定位与受保护回归
+
+| 结果 | 判断与下一步 |
+|---|---|
+| missingSourceIds含tide，R Build0 | 正式Style缺源仍fail-closed；不补假源、不删tide-spots，记录Source类型/缺失层ID |
+| 缺源消失但Symbol placementGatePassed=false | 独立Symbol准入阻塞，检查Full changed/stale/fade与pre/post；不要用等候时间放行 |
+| #22仍失败 | 查Native C范围实际层清单；空层调整是否被撤销/失败，普通circle或真实Annotation仍应阻挡 |
+| #23仍失败 | 查retainedSupported和preparedScene聚合，消除#22不保证#23通过 |
+| mismatch>0 / unknown Gate /版本不符 | 停止记录通过，保留首错和完整证据 |
+| Fast>0 | 先核查没有缺源/场景撤销、原Style完整，继续资源变化/回退/画面对照；仅记FAST_OBSERVED |
+
+原五场景仍在。每项独立运行并保留导出，不连续启动冒充采样：
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario PBF63 --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario PARTICLE_OFF --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario PARTIAL_RCRR --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario SOURCE_CHANGE --seconds 90
+```
+
+这些场景可能预期Fast0，脚本退出2是受保护负例结果，不自动视为回归失败或改预期。SOURCE_CHANGE保留circle与Annotation；用户执行一次原 MUTATE PROBE SOURCE ONCE，导出前后commands和native lastMutation/affectedSegmentIndices，区分同时发生的真实瓦片更新。
+
+Native七项新测试之外，还需 RDC/用户记录：遗留Annotation拒绝移除；STATIC_RC后添加真实Marker（同步恢复points再Full、像素可见），no-op更新；额外Style.addLayer/重排不删除新内容；disable、退出到STEP102、Style reload及后台恢复；Source创建/同名更新/async Tile、Glyph/Image变化必定invalid/Full。Test App没有新增自动Mutation来假装覆盖这些事件；若当前UI无法触发，标该项设备NOT VERIFIED并使用对应Native真实测试/另行授权的操作。STEP114四场景回归使用其既有命令；Smoke结果只归其独立场景。
+
+最终提交证据应包含最新HEAD/精确源码diff、Native日志/首错、用户build-info/build.log/APK及安装SHA、设备信息、原STATIC_RC摘要和完整JSON、manifest、24Gate/真实Build/Reuse/Full/Fast增量、回退与画面。编译成功、preflight成功或静态检查都不把STEP-116判为CLOSED/PASS。

docs/60_测试/STEP-117_FZG1_原PBF真实Fast验收计划_v1.md

@@ -0,0 +1,165 @@
+# STEP-117 FZG1 原 PBF 真实 Fast 验收计划 v1
+
+日期：2026-10-11（JST）。**本计划全部运行命令交RDC/普通Terminal；Codex本轮未执行。当前安全准入BLOCKED，测试源码交付不表示真实Fast已修复。**
+
+## 1. 执行顺序与停止条件
+
+先独立审计STEP117调查、diff和七项测试，确认B1缺源零贡献与B2 Symbol结果证书仍未实现。本轮只有测试/文档，不应期待重新打APK获得不同Fast行为。RDC可先验证C++回归；粒子负责人协调Shared Core证书设计及正式tide语义，再授权具体实现。完成可证明的实现并复核后，安排一次完整Android build/install/原STATIC_RC集中验收。
+
+本任务不授权Codex执行任何Native编译/测试、Gradle/ADB/安装、Jest、commit/push。RDC后续Git收尾须按独立授权scoped提交，核对origin远端HEAD，保护STEP110/111。Android与设备命令只能在用户明确授权的对应阶段执行。当前缺libuv历史记录只用于排查；不跳过失败、不改门槛、不运行旧runner、不改build-info使旧包冒充新源码。
+
+遇到编译/测试失败、Source/Style版本不符、mismatch>0、未知Gate、错误恢复/漏内容或Fast仍为0，保存首个真实error/target及完整日志路径，停止相应通过判定。不要换STEP114烟测、删原层或补假tide来继续。
+
+## 2. 独立源码与定向Native验收
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+git branch --show-current
+git rev-parse HEAD
+git status --short
+git diff --check
+git diff -- test/renderer/retained_underlay_cache.test.cpp test/renderer/render_orchestrator_error.test.cpp 粒子开发记录.md
+shasum -a 256 docs/40_任务/STEP-110_R0_Placement跨段归因只读调查_Codex任务_v1.md docs/40_任务/STEP-111_R段Placement结果等价与独立刷新可行性只读调查_Codex任务_v1.md
+```
+
+STEP110/111预期SHA分别为 `33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`、`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。查看新增四份文档及报告静态核查章节。生产src/include/Shader/TestApp/旧测试断言应与起点保持一致；不得把test fixture的markBuildSucceeded或测试线程注入事件当作实际GPU/并发完成。
+
+以下逐项串行运行，上一项失败立即停止。使用当前Mac配置的CMake；如果PATH没有cmake，可用已配置的 `/Users/tei/Library/Android/sdk/cmake/3.31.6/bin/cmake`，不得自行升级依赖。
+
+```bash
+cmake --preset macos-metal
+```
+
+```bash
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+```
+
+```bash
+build-macos-metal/mbgl-test-runner --gtest_filter='Step117Safety.*:Step116Safety.*:Annotations.*:RenderOrchestratorError.*:RenderOrchestratorTeardown.*:FastGateTrace.*:ParticleFastPath.*:RetainedUnderlayCache.*:RetainedUnderlayRevision.*:RenderSegmentDiagnostics.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*' --gtest_color=no
+```
+
+新增Step117Safety必须实际运行7项，不能以filter未匹配的exit0通过。test/CMakeLists.txt已登记两个源文件，不需要绕过原target。记录当前HEAD、runner构建来源、命令、exit/耗时、用例数量、完整日志路径。Annotations.Step116是实际出图比较；其通过也不替代原PBF的Symbol结果证明。Mac Metal runner成功不代表Android OpenGL或iOS设备PASS。
+
+## 3. 一次未来授权的Android制品闭环
+
+在B1/B2受控实现完成、源码已锁定且tracked clean后，用户授权RDC/普通Terminal逐项执行标准Pipeline。保护未跟踪MD保留，git_dirty=true需结合tracked状态判断。记录真正的源HEAD，不能拿本轮起点43e5f5b当作包含未来实现的提交。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+git rev-parse HEAD
+git status --short
+./tools/particle_android_validation/build_validation_apk.sh
+```
+
+Pipeline必须Java17、OpenGL/x86_64、strip，成功后核对ZIP、唯一ABI、libmaplibre.so、体积、完整build.log/build-info与SHA；失败不复用旧APK。版本名13.6.1-particle.23本身不能标识源码。
+
+```bash
+cat artifacts/maplibre-particle/android-validation/build-info.txt
+shasum -a 256 artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+```
+
+不得卸载/清数据。设备serial须重新核实为FZG1-2；变化时显式记录并修改后续参数。回读已安装base.apk SHA，由以下现有工具复核同HEAD/本地APK/设备安装包：
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --preflight-only
+```
+
+STALE_APK、SOURCE_NOT_LOCKED、ABI/SHA不符立即停止。PREFLIGHT_PASS仅说明版本闭环；旧c48a72a9 APK与本轮源码HEAD不同，即使生产文件未改也不能修改来源记录。
+
+## 4. 原STATIC_RC≥90秒正式验收
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario STATIC_RC --seconds 90
+```
+
+从取得同PID起实际观察至少90秒，取得前后同sceneGeneration/lifecycle的摘要，计数单调、不撤销、不重置。保存result.json/logcat/launch、实际观察秒数。exit2/NO_FAST_OBSERVED如实失败；exit3为版本/环境阻塞。FAST_OBSERVED只是必要条件。
+
+正式通过同时要求：
+
+- 原Style的63基础层定义/顺序保留，记录productionFingerprint与baseLayerManifest、productionSources；原Style/Sprite/Glyph/Vector URI一致。若服务器内容改变导致fingerprint或层数不同，停止跨版本比较，交Style所有者协调。
+- STEP116空SDK Annotation规则保留：零实例后一次受控移除points，Source保留；原C正常只有WeatherColor+Particle，Native65层/R[0,63)/C[63,65)。后续真实Annotation/Style改变不得被再次删除。
+- 实际每个R Cache Build>0、Reuse>0，同生命周期FastDelta>0；completed fast-rendered帧必须cacheValid/revision一致、24Gate已知且全部PASS、mismatch=0。pending帧不计成功。
+- 缺源准入若未来获证书，必须能回读该absent source的零绘制/旧数据排除及同名恢复失效证据；missingSourceIds非空不能自动通过，也不能简单规定非空一律失败而回避新证书审查。
+- Symbol缓存绑定成功提交的R结果证书，列出受影响bucket/atlas/collision/opacity/动态属性/camera/context和变更代次；源码/设备证据中不得强制清三字段或改Gate。
+- 用户验收底图、海岸/等深线、航标、文字、天气色带与粒子，无漏内容/闪烁/层序错误；同条件Full/Fast像素对照及资源变化回退分别取证。性能提升需额外相同条件测量，不能从Full减少单独推断。
+
+## 5. 完整120帧与用户画面
+
+同次运行在STEP093→STEP113菜单手动EXPORT LAST SNAPSHOT。导出由用户触发，RDC回读同次generation/lifecycle的文件；确认文件名/时间不属于旧运行。以下shell命令逐项执行，任何失败立即停；变量只用于本次任务：
+
+```bash
+mkdir -p artifacts/maplibre-particle/android-validation/step117
+step117_file="$(/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 shell run-as org.maplibre.android.testapp ls -t files | tr -d '\r' | grep -E '^step113-STATIC_RC-.*[.]json$' | head -n 1)"
+test -n "$step117_file"
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 exec-out run-as org.maplibre.android.testapp cat "files/$step117_file" > artifacts/maplibre-particle/android-validation/step117/static-rc-full.json
+shasum -a 256 artifacts/maplibre-particle/android-validation/step117/static-rc-full.json
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 exec-out screencap -p > artifacts/maplibre-particle/android-validation/step117/static-rc-screen.png
+/Users/tei/Library/Android/sdk/platform-tools/adb -s 192.168.200.139:5555 logcat -b crash -d > artifacts/maplibre-particle/android-validation/step117/crash.log
+```
+
+完整JSON离线结构核对示例（不是新安全证书/性能验收）：
+
+```bash
+python3 -B - <<'PY'
+import json
+from pathlib import Path
+v = json.loads(Path('artifacts/maplibre-particle/android-validation/step117/static-rc-full.json').read_text())
+assert v['scenario'] == 'STATIC_RC' and v['sceneReady'] and not v['blockedReason']
+assert v['styleParity']['baseLayerCount'] == 63 and v['styleParity']['baseLayersPreserved']
+assert v['commands']['emptyBuiltinAnnotationLayerRemoved']
+assert v['commands']['annotationInstancesAtRemoval'] == 0
+assert v['commands']['annotationSourcePreserved']
+n = v['native']; t = n['fastGateTrace']; fs = t['frames']
+assert n['valid'] and n['styleLayerCount'] == 65
+assert len(fs) == t['windowCount'] == 120
+assert len(t['gates']) == 24 and t['decisionMismatch'] == 0
+assert [g['order'] for g in t['gates']] == list(range(1, 25))
+assert all(f['knownMask'] == 0xffffff and f['decisionConsistent'] and len(f['gateStatus']) == 24 for f in fs)
+assert all(a['sequence'] < b['sequence'] for a, b in zip(fs, fs[1:]))
+assert all(f['post'] is not None for f in fs if f['completed'])
+assert all(f['post'] is None for f in fs if not f['completed'])
+assert [(s['strategy'], s['beginIndex'], s['endExclusive']) for s in n['segments']] == [
+    ('RETAINED', 0, 63), ('CONTINUOUS', 63, 65)]
+fast = [f for f in fs if f['completed'] and f['outcome'] == 'fast-rendered']
+assert fast, '原PBF当前窗口没有完成Fast帧；保持FAIL/BLOCKED'
+assert all(f['failMask'] == 0 and all(c['exists'] and c['valid'] and
+    c['buildRevision'] == c['staticRevision'] for c in f['cacheInputs']) for f in fast)
+assert all(s['cache']['build'] > 0 and s['cache']['reuse'] > 0 for s in n['segments'] if s['strategy'] == 'RETAINED')
+print('必要结构/计数成立；继续检查证书、同次SHA/manifest、变更前后帧与用户画面')
+PY
+```
+
+在当前STEP117无准入实现的代码上，Fast/Build断言预期不能通过；不得删除这些断言制造PASS。pre为上一完成树，post/full为本次完成树；#13另取当前controller，不能混为同帧。环形窗口可能覆盖变更瞬间，必须每项操作前/后及时导出；未捕获则NOT VERIFIED。
+
+## 6. 安全反例与旧五场景
+
+| 操作 | 必须取证的正确行为 | 当前入口/限制 |
+|---|---|---|
+| 初始缺源 | 没有证书时missing-source、Build/Fast0；未来证书需证明双group零贡献和无旧数据 | 原STATIC_RC真实缺tide；不补造source |
+| 同名source创建/重建/数据到达 | 下一次尝试Full，旧证书和cache失效；真实内容可见后才重建 | 新C++真实sourceDiff用例及状态机；当前App没有生产tide注入入口，需Integration/真实来源协调，设备项NOT VERIFIED |
+| 已有旧Symbol后缺源/合法Style替换 | 两类group停用请求执行，旧drawables/buckets排除；不得复用旧R | 当前测试只有registry生命周期，无实际GPU旧数据证书；必须追加真正渲染用例后验收 |
+| Tile/Glyph/Image异步更新 | #5/#8/#14或对应稳定性Gate拒绝旧Fast，受影响R重建；未加载/fading继续fail-closed | C++回调注入不等同网络并发；实际资源延迟与事件顺序需独立工具/测试授权 |
+| Symbol collision/fade/anchor/orientation/沿线 | Full/Fast最终像素等价；所有碰撞受害R失效；时间相关opacity不能冻结 | 结果证书当前不存在；不能用默认空桶测试代替 |
+| Source mutation | 保留原SOURCE_CHANGE circle负例和手动MUTATE PROBE SOURCE ONCE；记录sourceId/affectedSegmentIndices与真实Full | 当前probe属C，不能冒充R的tide恢复 |
+| Style mutation/重排/添加 | non-camera/topology/fingerprint拒绝旧树；内容不删除 | 原入口无自动全矩阵；没有触发能力则NOT VERIFIED |
+| 真实Annotation add/no-op update/reload | STEP116同步恢复points并可见；#24/层表拒绝旧Fast；空层验收条件撤销 | Annotations.Step116图像回归和用户合法操作；不可周期删真实层 |
+| Camera/viewport/pixelRatio/projection | #6/#7/#8、cache key/context失效，Full后正确重建，无拖影或错位 | 用户pan/zoom/rotate/pitch/resize；逐事件导出 |
+| context/后台/恢复/disable/退出场景 | PreparedTree/资源正确失效释放，无旧GPU数据复活 | 用户设备生命周期及Native实际Renderer测试；现有callback用例不替代 |
+
+原五场景依次独立运行、分别保存日志/导出/画面。以下复测工具命令由RDC在同SHA预检后执行，SOURCE_CHANGE保留普通circle与Annotation负例：
+
+```bash
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario PBF63 --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario PARTICLE_OFF --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario PARTIAL_RCRR --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --adb /Users/tei/Library/Android/sdk/platform-tools/adb --serial 192.168.200.139:5555 --scenario SOURCE_CHANGE --seconds 90
+```
+
+受保护负例可能预期Fast0，exit2应按场景语义记录，不能调整工具返回码或删除负例。STATIC_RC正式正例仍要求真实Fast，不接受STEP114 FAST_SMOKE替代。
+
+## 7. 最终证据包
+
+RDC回填：锁定源HEAD与精确diff/相关源码SHA、scoped提交与远端HEAD（若获授权执行）、Native配置/构建/七测试日志、首错/阻塞；build-info/build.log/APK与安装包SHA、设备型号/serial；原Style fingerprint/63层manifest/C层表；同次90秒摘要、120帧完整JSON及SHA、每项24Gate/cache/Full/Fast/pre/post；Mutation前后/异步/碰撞/GPU生命周期证书；用户画面及同条件Full/Fast对照。
+
+没有证书保持BLOCKED；编译成功、静态检查、PREFLIGHT_PASS或测试进程exit0不能代替原PBF真实Fast安全验收。

docs/60_测试/STEP-118_tide移除Android实机验收_v1.md

@@ -0,0 +1,12 @@
+# STEP-118 FZG1-2 tide移除专用TestApp验收
+
+使用Mac仓库/现有标准build_validation_apk.sh和明确Android ADB serial 192.168.200.139:5555。严格串行，每一步退出值和实际产物均需PASS才能推进。完整证据存Git忽略artifacts目录。
+
+1. Git源HEAD锁/Integration当前main，确认只改TestApp Kotlin、Python verifier、说明及报告，两份STEP110/111未跟踪用户任务书不动。
+2. 标准 ./tools/particle_android_validation/build_validation_apk.sh。核验Gradle build SUCCESS、ZIP/strip/native x86_64、APK/source commit及sha256。
+3. ADB -s 192.168.200.139:5555 install -r新APK，Success后pm path/设备base.apk SHA与本地APK一致。
+4. python3 -B tools/particle_android_validation/verify_step113_fast_path.py --preflight-only。必须PREFLIGHT_PASS。
+5. python3 -B tools/particle_android_validation/verify_step113_fast_path.py --scenario STATIC_RC_NO_TIDE --seconds 90。验证新scene的实际Native Layer64、原生产63层manifest及同旧fingerprint、有效62基础层、C天气2层、R[0,62)、tide Source确实不存在、missingSourceIds不再包含tide。
+6. 读取result.json的真实FastDelta/FullDelta、R Build/Reuse/lastFallbackReason、Gate #3/#4/#12/#13/#22/#23、decisionMismatch。退出码2 NO_FAST_OBSERVED是负结论，不允许跳过。
+7. 必要时通过设备菜单EXPORT LAST SNAPSHOT并用ADB run-as取原生JSON、截屏；Native120帧24Gate的各窗口失败计数和原动画/像素效果分开验收。
+8. 新场景不等于原63层：原STATIC_RC仍保留严格basePreserved=true与真实missing-source负基线。若Fast仍为0且placementGatePassed=false，结论只能是缺源局部已解除、Fast仍BLOCKED；不能冒称已获得性能收益。真正Fast>0仍需要资源/Source/Style变更回退Full及用户实际画面验收。

docs/60_测试/STEP-118_潮汐清理新APK设备实测结果_20261011.md

@@ -0,0 +1,62 @@
+# STEP-118 潮汐引用排除版：新 APK 真实设备验收报告
+
+日期：2026-10-11 JST。**最终状态：PARTIAL；tide 缺源阻塞修复PASS、首次R缓存/Fast目标FAIL。**
+
+## 二进制闭环
+
+- 源码 HEAD（测试副本实现，正式PBF未改）：3051196054c7b69815c298040dae61d26499d9f2
+- 标准 Android OpenGL Debug/x86_64 BUILD SUCCESS；Java17，APK66,603,850字节，libmaplibre.so40,035,512字节。
+- 新APK SHA-256：44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9
+- RDC Android FZG1-2 (ADB明确 serial 192.168.200.139:5555)：adb install -r返回Success，设备base.apk SHA与本地完全一致。Python preflight为PREFLIGHT_PASS。
+- 启动专用 STEP-113 的新增STATIC_RC_NO_TIDE，实际进程PID=22825；没有使用STEP-114烟测、旧APK或修改Gate。
+
+## 90秒真实运行结果
+
+| 指标 | 结果 |
+|---|---|
+| 当前场景 | STATIC_RC_NO_TIDE（测试副本，非正式63层原样） |
+| 请求/实际观察时间 | 90 / 90.008秒 |
+| 场景Ready / Native计划 | True / True |
+| 原生产基础Layer / 有效基础Layer | 63 / 62 |
+| 唯一被排除引用 | tide-spots → tide（1层） |
+| 原始basePreserved | False（正确，派生实验不是原样63层） |
+| Native实际Layer总数 | 64 |
+| R段范围 | [0,62) |
+| 失效/缺失Source IDs | [] |
+| R fallback reason | static-placement |
+| PlacementCapable / PlacementGatePassed | True / False |
+| R Cache Build / Reuse | 0 / 0 |
+| FastDelta / FullDelta | 0 / 942 |
+| 完整摘要个数 / windowCount | 2 / 120 |
+| FastWindow / FullWindow | 0 / 119 |
+| decisionMismatch | 0 |
+| 自动验证最终 | NO_FAST_OBSERVED，退出码2 |
+
+## 当前Gate累计诊断
+
+注意：下面为APP当前生命周期累计失败次数，不是最近120帧窗口的精确失败数；同一帧可能命中多项Gate。
+
+| Gate | 累计失败次数 |
+|---|---:|
+| unsupported-scene | 1778 |
+| revision-mismatch | 1773 |
+| cache-invalid | 1772 |
+| placement-or-fade | 1587 |
+| static-unstable | 1583 |
+| content-mutation | 11 |
+| unsupported-continuous-layer | 6 |
+| style-not-loaded | 5 |
+| no-particle-repaint | 5 |
+| camera-changed | 3 |
+| update-parameters-changed | 3 |
+| no-prepared-tree | 1 |
+| viewport-changed | 1 |
+
+## 证据、限制与下一步
+
+- 原始result.json保存于Git忽略路径 artifacts/maplibre-particle/android-validation/step113-retest-20261011_140448/static_rc_no_tide/result.json，SHA-256 d3d20fc35bbd17e9f0ea0dd014ca4af8e0c5c5284d9f0c009bc20981d876ff10。
+- 设备截图screen.png保存于同目录（SHA-256 c8b57a8432626c9209ca9a614a747728d4256bd09273b28c26a793a75a6d44d4），保留参考但尚未做人工图像与航标视觉PASS。
+- STEP-116同设备原STATIC_RC（原63基础Layer）R Build/Reuse=0，fallback=missing-source，缺tide。新测试副本R Build/Reuse仍0、Fast0，但fallback真实改变为static-placement且missingSourceIds为空，故**缺失tide阻塞已解除**；没有性能收益。
+- 原PBF生产Style与Sprite/Glyph/Tile URI、Server、NavSea并未修改；正式生产若决定永久去潮汐，应由Style所有者按跨项目流程移除tide-spots或修正正式数据。当前实验不能冒充已修改正式PBF。
+- 本轮没有放宽Symbol Placement、fade、24 Gate或改变Shared Core。剩余原因是R中其它Symbol Layer的Placement/Transition首次GPU缓存安全证书未建立；需要Shared Core受控设计与双平台验证。
+- 尚未进行新R>0后的Source/Style负例、原63五场景批量回归、GTest、Metal、用户人工像素验收；因此整体保持PARTIAL而非CLOSED/PASS。

docs/60_测试/STEP-119_FZG1_原PBF真实Fast验收结果_20261011.md

@@ -0,0 +1,42 @@
+# STEP-119 Android STEP-119 原PBF真实Fast实机验收结果
+
+日期：2026-10-11 JST。执行者：GPT指挥RDC，Mac/Android FZG1-2。**阶段结论：ANDROID_FAST_CORE_PASS / OVERALL_PARTIAL（仅完成本页证据覆盖范围，不能宣称所有失效与双平台PASS）。**
+
+## 0. 源码和设备版本锁
+- Integration origin/main 与本地一致：80667d6c343411d03a760425438e3d292f452118。
+- Particle本次APK源码commit：3d989a00a822989339a6d7cb4d23acc04396670e；已由RDC限定文件提交并push origin/particle/main成功、本地远端HEAD一致。
+- APK标准OpenGL/x86_64 build_validation_apk.sh：Gradle BUILD SUCCESSFUL in 3m 40s；86 tasks（22 executed，64 up-to-date）；APK 66,702,125字节，libmaplibre.so 40,138,024字节；SHA-256 57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135。
+- 设备：192.168.200.139:5555，ABI x86_64。ADB install -r返回Success，设备base.apk SHA-256与本地新APK完全相同。Python --preflight-only返回PREFLIGHT_PASS。
+- 不是正式release；没有修改原PBF服务器Style、业务API、iOS/Metal发行版本、SOURCE_LOCK或GSRL Tag。
+
+## 1. Mac与C++编译范围
+- Mac Metal CMake首次PATH中找不到cmake；用已有绝对路径重试后CMake配置因**原有libuv环境缺失**终止。Homebrew尝试安装libuv时提示将连带升级CMake/Python/OpenSSL，RDC中止安装，未改变项目第三方依赖和Android构建工具链。**Mac原生mbgl-test-runner未编译/运行，13项Step119SymbolResults非Jest测试没有实际执行；不能列为GTest PASS。**
+- Android NDK28.2 OpenGL/x86_64真实compile_commands.json，C++20 + 原项目严格-Werror逐个-fsyntax-only检查：7个生产编译单元和2个已登记GTest单元，共9个全部PASS。修复2处util::toString命名空间和测试Immutable所有权类型问题。
+- Android真实Gradle编译链接、符号打包、APK安装已PASS，证明当前Android源码不仅能语法检查还可以全链构建。
+
+## 2. 正向：STATIC_RC_NO_TIDE派生62基础图层+两天气图层
+- 在同一正式PBF URL读取原始63基础层；**测试副本只移除唯一tide-spots引用**，远端真实Style未改。
+- 实测原基础63 / 有效基础62 / Native64，R=[0,62)，C=[62,64)，Source: mapple/navsea_delivery/org.maplibre.annotations/rn-weather-fields，missingSourceIds=[]，planValid=true。
+- 设备App PID 27241，观察 90.010秒，CompleteSummary=2，windowCount=120。
+- 当前最后Snapshot R cache：Build=1、Reuse=3276（累计），state=reuse，placementCapable=True，placementGatePassed=True。
+- 实际观察期FastDelta=1819，FullDelta=0，最近120帧Fast=119/Full=0（第120条可能pending），decisionMismatch=0。
+- Gate历史累计的static-unstable/cache-invalid等失败包含**App启动阶段**，不能解读为当前120帧仍失败；当前120帧是完整119Fast/0Full/1pending，决定匹配为0。最终R.reason字段中的静态字符串保留最后历史fallbackReason，不等于当前frame fallback。
+- 验证器状态FAST_OBSERVED/exit0；它本身只验计数，R Build/Reuse、Gate由独立解析真实Native摘要后确认。
+
+## 3. 负向：原STATIC_RC完整63基础+两天气图层
+- 同一APK另起App PID 27492，观察 90.010秒。
+- 原始basePreserved=true，Native65，R=[0,63)，C=[63,65)，sources仍没有tide，missingSourceIds=['tide']，reason=missing-source。
+- R Build=0 / Reuse=0，FastDelta=0 / FullDelta=305，最近120帧Fast=0、Full=119，decisionMismatch=0。
+- 验证器返回NO_FAST_OBSERVED/exit2：**这是负对照的预期安全拒绝（该测试目的PASS），不是STEP119正向失败；也不是原63正常可用Fast的证据。**
+
+## 4. 原始证据
+- 正向 result.json：artifacts/maplibre-particle/android-validation/step113-retest-20261011_170012/static_rc_no_tide/result.json；SHA-256=8718ce113820e7cc0cc2b4d5b801e6847c92e9ced79cd4fecbee58bfeef1c27c。
+- 正向设备截图 PNG 1920x1200：artifacts/maplibre-particle/android-validation/step113-retest-20261011_170012/static_rc_no_tide/screen.png；SHA-256=ce3480d7ee934dc871c1035cbcaf84e61bbcefe680717001f05751dc0e16fd23。该截图是设备取证，**未开展人工作业图像对比或Symbol无重影验收**。
+- 负向 result.json：artifacts/maplibre-particle/android-validation/step113-retest-20261011_170359/static_rc/result.json；SHA-256=0cc425ca138188af38aa04919631f2374257d2888630473fc93b4bff120ce128。
+- APK build-info.txt、build.log、严格C++定向语法日志均在原Git忽略artifacts目录。两份保护的STEP110/111 MD不提交、哈希不变。
+
+## 5. 没有验证的边界
+- 缺少Mac libuv导致本次**未真正运行13项新GTest、Metal/iOS二进制或iOS实体机**；Android GL PASS不等于Metal PASS。
+- 未逐项做Source/Style/glyph/atlas/Annotation、相机Pan/Zoom/Rotate、viewport/pixelRatio、context恢复后的证书失效和重Build/Reuse真机负例。
+- 未进行同相机强制Full截图与Fast静态Symbol像素对比，也没有用户实际航标/文字/图标层序验收。
+- 因此本阶段判定**核心功能Android真机Build/Reuse/Fast成功且缺源fail-closed成功，整体仍PARTIAL**。后续应优先在同一APK上完成状态变化负例与人工像素，再由Mac Metal独立路径验证；不得重启不必要工具链或因此声称正式GSRL发版。

docs/60_测试/STEP-119_RCRR多配置验收矩阵_v1.md

@@ -0,0 +1,68 @@
+# STEP-119 RCRR 多配置实机与验证矩阵 v1
+
+日期：2026-10-11（JST）。执行入口：Mac.lan RDC，Particle `particle/main`。状态：**一组真机完成；三组新配置已实现、静态核对通过但未构建/上机**。非最终验收。
+
+## 1. 场景与边界
+
+本轮沿用 STEP-119 源码 APK（commit `3d989a00a822989339a6d7cb4d23acc04396670e`，SHA-256 `57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135`），不重复已通过的 Android 原生完整编译。设备 `192.168.200.139:5555`，x86_64。当前远端 HEAD 起点为 `46c88b0209474376225b54ae0ad701881673743d`，其与 APK commit 的后续差异为已有报告/Step 文档，而非新 Android 源码。
+
+不改正式 PBF/Sprite/Glyph、Source 接口、Shared Core、24 Gate、发布版本，不清理 STEP-110/111 两份未跟踪任务书。保留原 `PARTIAL_RCRR`、原 `STATIC_RC` 与 `STATIC_RC_NO_TIDE`，后续新场景只在测试副本中排除唯一 `tide-spots→tide` 孤立 Symbol 层，并恢复空 Annotation 辅助层的正常生命周期。
+
+## 2. 已执行：原 PARTIAL_RCRR
+
+- 80.007 秒实机，PID `28169`，完整摘要 3 份，同源 APK/设备 SHA 一致。
+- 原始 Native 图层 66，原 63 PBF + 2 天气 + 1 SDK Annotation；R[0,3)、C[3,39)、R[39,64)、R[64,66)。
+- R0：Build 0、Reuse 0、Fallback 595、missingSourceIds=[tide]；R2：Build 1、Reuse 536；R3：Build 1、Reuse 536。
+- 观测区间：FastDelta=0、FullDelta=596，最后 120 帧 Full=119、Fast=0，decisionMismatch=0。
+- Native 24 Gate 累计 `unsupported-continuous-layer=599`、`unsupported-scene=599`、`cache-invalid=595`；这些是场景累计，**不是**对应原因的独立帧数。
+- 结论：**全帧 Fast 安全拒绝通过；局部 R2/R3 的 Build/Reuse 已实际观察到**。这不构成 RCRR 加速性能通过。
+
+原证据：
+`artifacts/maplibre-particle/android-validation/step119-rcrr-observe-20261011_172720/partial_rcrr/result.json`，同目录有 `logcat.txt` 与 `screen.png`。
+
+## 3. 基于真实设备 Style Manifest 校准分段
+
+从设备 `run-as` 只读提取的 `step113-STATIC_RC-324220201.json`，包含当前实际 63 层 `baseLayerManifest`；其 PBF 指纹 `e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996` 与已通过 Fast 的场景一致。
+
+原基础层：background=0、base-raster=1、tide-spots=2、sea-area-fill=3、clip-outline=31、special-pattern-line-754=37、最后的 place-labels-land-ja=62。天气插在 clip-outline **之后**。因此原 R0 是前三层（包括 tide），天气并未落入 R0；原 C1 是宽 C，包含天气与普通静态 PBF 层。禁止再用此前错误的“天气在 R0”解释原负例。
+
+新增 Test App 变体（全部保留其余 62 原图层、天气数据与顺序；移除 SDK 空 Annotation 辅助层；Native 总层数预期 64）：
+
+| 场景 | 期望 R/C 索引 | 主要目标 |
+|---|---|---|
+| `RCRR_C_NARROW_NO_TIDE` | R[0,31)、C[31,33)、R[33,63)、R[63,64) | C 仅含 WeatherColor/Particle；检验所有 R 缓存与整帧 Fast 能否真实通过 |
+| `RCRR_C_WIDE_NO_TIDE` | R[0,2)、C[2,38)、R[38,63)、R[63,64) | C 混入普通 PBF；验证不支持的连续图层是否安全拒绝整帧 Fast |
+| `RCRR_R_DYNAMIC_NO_TIDE` | R[0,33)、C[33,38)、R[38,63)、R[63,64) | 故意将动态天气放入 R；检验版本/连续输入不允许错误静态复用 |
+
+源级校准证据：
+`artifacts/maplibre-particle/android-validation/step119_rcrr_style_structure.json`。该结果是**实际设备导出数据上的静态切分核对，不是新 APK GPU 验证**。Mac 通过 Python 直接 GET 正式 Style 曾收到 HTTP 403，因此优先复用了相同 Style 指纹的设备导出 Manifest；没有修改服务器资源。
+
+## 4. 静态测试与当前缺口
+
+新增 `tools/particle_android_validation/test_step119_rcrr_scenarios.py`，四项 Python unittest 全部 PASS：三种索引互相排斥、缺 tide/缺 Annotation 清理不得通过、范围尾部和段数不对必须拒绝、原 STATIC_RC_NO_TIDE 不回退为错误结构。验证器 `scene_parity_valid` 对 64 层 RCRR 三 R 段改用精确区间校验；原 63 层判断、90 秒观察、24 Gate 和 Fast 判据不放宽。`git diff --check` PASS。
+
+**没有对新 Kotlin 场景做 Android 编译/安装**（遵守用户手工 Android 编译及本轮不重复已有完整编译限制）。新增三场景的 Kotlin 可编译性与 Native 真机结果必须记 `NOT VERIFIED`。新增 13 项 STEP-119 GTest 仍未运行；Mac Metal CMake 被既有 libuv 缺失阻塞，本轮不安装或升级工具链；iOS Metal/实体机亦未验证。
+
+## 5. 下次同一次人工 APK 构建后的串行设备验收
+
+源码 scoped commit/push 完成后，由用户按已有标准在 Mac 手工构建**新 HEAD** 的 x86_64 Android OpenGL Test APK，不得使用旧 `3d989a` APK冒充新场景；验证 build-info commit、APK SHA、设备 base.apk SHA 一致后，逐一运行：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+./tools/particle_android_validation/build_validation_apk.sh
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --preflight-only
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario RCRR_C_NARROW_NO_TIDE --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario RCRR_C_WIDE_NO_TIDE --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario RCRR_R_DYNAMIC_NO_TIDE --seconds 90
+```
+
+每步独立读取退出码与 result.json：完整 R/C、Source/Tile、R0/R2/R3 Build/Reuse/Invalidate、Fast/Full 差分、24 Gate、120 帧、生命周期/判定一致性。正向窄 C 必须先 Full 建立证书，再 Build 和成功 Reuse 后 Fast；若失败记录真实 gate，而不是降阈值。宽 C 和动态 R 是安全负例，`NO_FAST_OBSERVED/exit2` 若符合完整原因和分段预期属于负例通过，而非直接整体失败。禁止直接用这些负例宣称 Fast 不可用。
+
+之后须补：静止视觉 Full/RCRR 同资源同视角人工航标、文字、Symbol、层序对照；Camera/Source/Style/Tile/Annotation/Context/cache toggle 的瞬时失效、Full 回退、重新稳定后的 Build/Reuse；13 GTest 真实执行和 Mac Metal/iOS 独立验证。视觉比对时动态粒子会造成像素差异，不能简单拿整屏逐像素一致作为静态 Symbol 结论。
+
+## 6. 当前判定
+
+`ANDROID_RCRR_FAIL_CLOSED_OBSERVED / NEW_VARIANTS_SOURCE_READY / STEP119_PARTIAL`。
+
+主要已确认局限：多 R 缓存复用并不代表全帧 Fast；含缺源 R 会阻断、过宽 C 中非支持类型的连续层触发拒绝；未实测新窄 C 前，不能推断 RCRR 性能收益。待验证风险：多 RenderTarget/Composite 成本、全局 Symbol Placement/Atlas 证书联动、局部更新导致跨 R 全局失效、上层标记/文字的层序与图像等价、iOS/Metal 一致性。

docs/60_测试/STEP-119_RCRR多配置验收矩阵_v2.md

@@ -0,0 +1,93 @@
+# STEP-119 RCRR 粒子独占 C 与 CPU 效率测试矩阵 v2
+
+日期：2026-10-11 JST。状态：**TEST SOURCE PREPARED / ANDROID NOT RUN / STEP-119 PARTIAL**。本 v2 取代 v1 对“窄 C 包含 WeatherColor+Particle”的测试建议；v1 保留为历史证据，不改写当时实机事实。
+
+## 一、目标与核心原则
+
+原则：**一个 Continuous 段只放 RasterParticleLayer**。WeatherColorLayer 不是逐帧运动图层，正常预测/颜色不变化期间可作为 R 候选，但数据提交、forecast time、色阶、Opacity、Style、Camera、Source/Tile/Atlas 等发生实际结果变化时必须安全撤销旧缓存并 Full，再重 Build/Reuse。这些具体动态失效条件仍需真机证明，不能因为分段配置正确而提前视为 PASS。
+
+Native 当前代码以 `singleContinuousSegment(plan)` 选择唯一 C；快路只在这个 C 范围执行 tweaker/upload/postRender，全部 R 需具备有效缓存、Revision 与 Symbol 结果证书；现有 24 Gate 不能放宽。因而“一个 C + 多个 R”符合技术实现边界，但不是任意 R 划分都必然适合 Fast。
+
+## 二、可比 Style 与真实图层顺序
+
+正式原 PBF Style 63 层、测试副本只排除无源 `tide-spots`，其余 62 层定义和次序完全保留，WeatherColor / Particle **按原插入点顺序**位于 `clip-outline` 之后，Native 预计总 64 层。基于设备导出与原正向成功相同指纹的 Style Manifest：
+
+- R 下部 [0,32)：含基础海图 [0,31)，并在索引31绘制 `rn-weather-color`；WeatherColor 留在 R 中。
+- Particle C 唯一图层 [32,33)：`rn-weather-particles`。
+- 上部 R [33,64)：各类静态海图、Symbol 和文字。按测试目的拆成 1/2/3 个 R 片段，不改实际图层顺序。
+
+**不要在 NavSea 产品中按本测试索引硬编码**；生产实际 Style 上应按图层 ID 验证真实边界。
+
+## 三、新一轮候选与负对照
+
+| 场景 | 预期分段 | 目的 |
+|---|---|---|
+| `RCRR_FULL_CONTROL_NO_TIDE` | R[0,32) C[32,33) R[33,63) R[63,64) | 与主 RCRR 相同 Style/Plan/Field，但关闭 Retained 缓存，取得 Full CPU 基线 |
+| `RCRR_C_NARROW_NO_TIDE` | R[0,32) C[32,33) R[33,63) R[63,64) | 主 RCRR 正向，仅粒子进入 C；3 个 R |
+| `RCR_PARTICLE_ONLY_NO_TIDE` | R[0,32) C[32,33) R[33,64) | 仅 2 个 R，测缓存片段数量收益/开销 |
+| `RCRRR_PARTICLE_ONLY_NO_TIDE` | R[0,32) C[32,33) R[33,38) R[38,63) R[63,64) | 4 个 R，测额外 RenderTarget/Composite/缓存生命周期成本 |
+| `RCRR_C_WIDE_NO_TIDE` | R[0,2) C[2,38) R[38,63) R[63,64) | 历史宽 C 错误配置，继续作为负对照，不作为性能候选 |
+| `RCRR_R_DYNAMIC_NO_TIDE` | R[0,33) C[33,38) R[38,63) R[63,64) | Particle 在 R 内的错误配置，必须 Fail-Closed |
+| 原 `PARTIAL_RCRR` | R[0,3) C[3,39) R[39,64) R[64,66) | **已经实测**：R0 缺 tide、R2/R3 各 Build1/Reuse536、FastDelta0/FullDelta596、decisionMismatch0 |
+
+旧正向 `STATIC_RC_NO_TIDE` 用于证明原有 FastPath（FastDelta1819），但天气层位置与粒子独占 C 的四个 A/B 场景不相同，**不能直接拿其 CPU 数据得出 RCRR 快慢结论**。
+
+## 四、CPU 指标及可比性
+
+使用 Android `/proc/<PID>/stat` 同一进程的 `utime+stime`（含 App 主线程与原生工作线程），以设备实际 `getconf CLK_TCK` 转换为 CPU 秒。记录该进程在观察期内消耗的累计 CPU 核秒。设备实测此接口可访问且 `CLK_TCK=100`，此预检不是新 APK 实测。
+
+每场景冷启动不同 PID，固定设备、x86_64 OpenGL APK、Style URL/PBF fingerprint、中心/zoom/rotation、1920×1200 设备条件、Weather 数据、forecast pause、1024 粒子和目标 FPS30。先 Warmup35 秒（等待载入/Placement/Cache settle），再观察至少 90 秒；每 6 秒读取一次 CPU 累计值，场景 Native summary 同样按 6 秒采样，最多允许 CPU/Native 边界时间差 9 秒，否则记测量不完整。
+
+同时必须记录：
+
+- `CPU 核秒/秒 = Δ(utime+stime)/CLK_TCK/观察秒数`；乘100为**相对单核的进程 CPU%**，多线程时可超过100%。
+- `Native FPS = (ΔFast+ΔFull)/Native摘要实际区间秒数`。
+- `估算 CPU ms/完成帧 = (CPU核秒/秒) × 1000 / Native FPS`；这是进程级近似值，不是 C++ 单次 render 函数的精确 CPU 耗时。
+- FastFraction、Full/Fast 增量、R Build/Reuse/Invalidate、24 Gate mismatch、源指纹、生命周期、帧率、帧率波动及进程 PID。
+- Full→Fast→Full（A-B-A）控制热机/网络缓存时序偏差；Full 前后的 CPU 核秒/秒漂移超过15%则需要复测，不凭一次高速帧数下性能结论。
+- 如果 Fast FPS 比 Full 高而 CPU/秒也提高，必须同时呈报“每帧成本下降”和“整机持续负载未必下降”。`CPUms/frame`改善不等于省电或 GPU time 已改善。
+
+## 五、顺序执行（用户手工编译一次，其余通过 RDC）
+
+必须先将本轮 Test App 修正提交/Push，**由用户手工使用当前 HEAD** 进行 Android APK 构建/安装；禁止用旧 `3d989a...` APK 冒充新场景。完成后 RDC 检查 build-info commit、SHA-256、设备 base.apk SHA 和目标 ABI。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+./tools/particle_android_validation/build_validation_apk.sh
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --preflight-only
+
+# 每条命令执行完读取状态/result.json，再进入下一条；A-B-A:
+python3 -B tools/particle_android_validation/benchmark_step119_cpu.py --scenario RCRR_FULL_CONTROL_NO_TIDE --seconds 90 --warmup 35
+python3 -B tools/particle_android_validation/benchmark_step119_cpu.py --scenario RCRR_C_NARROW_NO_TIDE --seconds 90 --warmup 35
+python3 -B tools/particle_android_validation/benchmark_step119_cpu.py --scenario RCRR_FULL_CONTROL_NO_TIDE --seconds 90 --warmup 35
+python3 -B tools/particle_android_validation/benchmark_step119_cpu.py --scenario RCR_PARTICLE_ONLY_NO_TIDE --seconds 90 --warmup 35
+python3 -B tools/particle_android_validation/benchmark_step119_cpu.py --scenario RCRRR_PARTICLE_ONLY_NO_TIDE --seconds 90 --warmup 35
+```
+
+每次自动写入 Git 忽略目录：
+`artifacts/maplibre-particle/android-validation/step119-rcrr-cpu/<时间>-<场景>/result.json`；同目录保存日志和启动记录。脚本全程真实读取现有 Native 摘要，不改 Gate、不执行 Gradle。验证器 Fast 场景须稳定 Fast 比例≥95%，Full 对照须 FastDelta=0、FullDelta>0。未满足时标记 `MIXED_OR_NO_FAST` 或 `NO_EXPECTED_FRAMES`，**不把回退帧混入 Fast 成本声称速度提升**。
+
+在取得相应结果路径后使用：
+
+```bash
+python3 -B tools/particle_android_validation/compare_step119_cpu.py \
+  --full-before '<第1次Full/result.json>' \
+  --fast '<RCRR正向/result.json>' \
+  --full-after '<第2次Full/result.json>' \
+  --rcr '<RCR/result.json>' \
+  --rcrrr '<RCRRR/result.json>'
+```
+
+结果自动核验同 SHA/设备/Style 指纹、Native窗口、失配、Full控制与顺序漂移，输出 CPU per frame 节省比例、CPU 核秒/秒和 FPS 对照。若主 RCRR 尚不能稳定 Fast，不执行“有性能提升”的结论，只报告准确的 Gate 和成本。
+
+## 六、其他 STEP-119 待验
+
+相同视角的 Full/Fast 截图与 Symbol/文字/航标图层层序人工对比；Camera pan/zoom/rotate、Source/Style/Tile/Annotation/context/forecast 变更导致的证书失效和 Full → Build → Reuse 恢复；13 项新增 C++ GTest 真实运行和 macOS Metal/iOS 独立验证，均保持 NOT VERIFIED。Mac 现存 libuv CMake 配置缺口不授权升级第三方系统工具。全任务 STEP119 仍是 `PARTIAL`，本批仅准备测试能力，没有 Android 编译或新数据。
+
+## 七、保护
+
+- 不改变 Shared Core 公开 API、24 Gate、Renderer 行为、正式远端 PBF Style、发行 Tag/SOURCE_LOCK。
+- 原 `STATIC_RC` 63 层与历史 RCRR/负对照保留。
+- 不清理两份 STEP110/111 未跟踪文档。
+- 本阶段只把 Test App/CPU 工具/中文报告/Step/开发记录按 Git 任务范围提交到已有 `particle/main`，Push后回读远端 HEAD。

docs/60_测试/STEP-119_原PBF_FAST实机联合验收计划_v1.md

@@ -0,0 +1,89 @@
+# STEP-119 原PBF FAST实机联合验收计划 v1
+
+日期：2026-10-11（JST）。执行者：RDC/用户，Codex本轮仅交源码和命令。状态：NOT RUN；没有新的Native、Android、Metal或视觉PASS。
+
+## 1. 先独立审计，再锁定源码
+
+读取AGENTS、STEP119任务、调查、Step、完成报告及实际diff，检查原Style/API/ABI/24Gate/SourceRevisionBook、原STEP117/118证据与两个保护任务书。重点核对：普通Full不清结果证据、证书在upload之后采集、成功present之后完成、Build不能借Reuse自举、Reuse成功后才Fast、所有缺证/变更/错误仍拒绝。
+
+此工作区尚有本轮未提交源码。现有verify_step113_fast_path.py严格要求tracked clean与APK来源HEAD一致，会报SOURCE_NOT_LOCKED；本轮保留该保护，不能添加dirty bypass、借旧APK或只提交报告来通过预检。源码锁定由RDC按其阶段明确授权scoped处理；Codex没有commit/push。任何Git收尾不得包含STEP110/111、无关dirty或旧ignored artifacts；若push已获授权，必须回读远端HEAD。
+
+如果仍无法审计实际GPU输入覆盖、shader provenance、提交/恢复或异步线程边界，保持BLOCKED，不进入APK周期。
+
+## 2. Native定向验证（仅交RDC执行）
+
+在本轮最终锁定源码上，逐条执行；任一步失败立即停止后续命令并保存首个真实error、target、exit、耗时、完整日志路径。旧Mac缺libuv是历史环境证据，本轮未重试/未安装依赖，不能推断当前结果。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+cmake --preset macos-metal
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+build-macos-metal/mbgl-test-runner --gtest_filter='Step119SymbolResults.*' --gtest_list_tests
+build-macos-metal/mbgl-test-runner --gtest_filter='Step119SymbolResults.*:Step117Safety.*:Step116Safety.*:Step114FastPathSafety.*:Annotations.*:CrossTileSymbolLayerIndex.*:RenderOrchestratorError.*:RenderOrchestratorTeardown.*:RetainedUnderlayCache.*:RetainedUnderlayRevision.*:FastGateTrace.*:ParticleFastPath.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*:RenderSegmentDiagnostics.*' --gtest_color=no
+```
+
+必须发现并运行13个新增Step119SymbolResults；不得用零匹配/旧runner/仅fsyntax-only称GTest PASS。renderer=Metal、target=mbgl-test-runner、并行3；Host Native测试不能替代iOS真机或Android OpenGL。本轮没有Jest，没有Bazel/codegen授权。
+
+RDC还须按已有Android OpenGL/x86_64真实compile_commands.json独立核查修改的Core/GL及两个测试文件，保持-Werror，不附加-Wno-error；语法结果单独记录。Metal context/provenance/UBO consolidation和原生source组合须编译实际路径，不能靠宏关闭绕过。
+
+## 3. 一次集中APK build/install与严格来源闭环
+
+独立审计及源码锁通过后，由RDC/用户按本阶段授权执行一次标准流水线；任何失败不得安装旧文件，不重复启动并发构建。本轮不是正式发行，不改VERSION/Source Lock/公开坐标。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+./tools/particle_android_validation/build_validation_apk.sh
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --preflight-only
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario STATIC_RC_NO_TIDE --seconds 90
+```
+
+固定FZG1-2、x86_64、OpenGL Debug、Java17。ADB每条显式-s，包括人工补采样命令。流水线记录build-info、branch/HEAD/dirty、完整build.log、APK大小/ZIP/ABI/strip及SHA；设备base.apk SHA必须与本次本地APK相同。版本号仍.23不足以判定新源码，旧3051196054/44afcfabe… APK不得冒充本轮。
+
+原STEP118 result.json与screen.png只读保留，不覆盖、移动或加入Git。现有verifier固定生成新的step113-retest-<timestamp>/<scenario>目录（Git忽略）；保留此真实输出路径，在RDC交付报告标记为STEP119本轮证据，不改脚本或覆盖旧目录。
+
+## 4. 静止真实PBF正向验收
+
+| 项目 | 必须取得的真实结果 |
+|---|---|
+| 原始资源 | 相同正式PBF/Sprite/Glyph/Tile URI，不修改服务器或造tide；manifest保留原63基础层 |
+| 派生场景 | STATIC_RC_NO_TIDE，唯一排除tide-spots/tide；有效基础62+天气2，Native64，R[0,62)、C[62,64)，missingSourceIds=[] |
+| 启动/settle | 正常Full完成原生Placement/vertices/opacity/atlas/UBO；fade未完成拒绝；不得预置Cache有效 |
+| 首次Build | R真实Build>0，texture/composite创建与Build后的static/build revision匹配，placementGatePassed=true，截图仍包含其余Symbol |
+| Reuse | R真实Reuse>0；成功Full Reuse先于Fast完成，不能只在状态机测试手工mark |
+| Fast | PID确认之后持续观察>=90秒，FastDelta>0；FullDelta、真实窗口和生命周期分别记录，不把生命周期累计当区间增量 |
+| 24Gate | 完整120帧knownMask=0xffffff，decisionMismatch=0；candidate帧24项全部通过、completed fast-rendered；失败帧保留全部失败位 |
+| 像素/层序 | 同相机和资源对照强制Full与开启retained后的截图；用户核对航标/文字/图标/重叠/方向/沿线/variable anchors及WeatherColor/Particle层序，无缺失或ghost |
+
+自动验证器已有真实Build/Reuse/Fast检查，不改判据；完整120帧通过现有EXPORT LAST SNAPSHOT取得。保存场景开始、Build后、Reuse后及Fast稳定的快照/日志，pre是上一完成树、post是当前完成树，不能跨帧拼接条件。没有图像证据时即使计数增长仍为PARTIAL。
+
+## 5. 原63层负对照与变更矩阵
+
+在同一个新APK中运行原STATIC_RC至少90秒，原63基础层+天气2保持；missingSourceIds=[tide]、missing-source、R不Build、不Reuse、不Fast。这是缺源负对照，不是需要被此次证书放行的正向目标。PBF63/PARTICLE_OFF/PARTIAL_RCRR/SOURCE_CHANGE原入口与定义保留，不能用STEP114烟测替代。
+
+每项动作保存操作前、动作提交时和稳定后证据；至少保留一次真实失效后的Full与新Build/Reuse。500ms之后的摘要不足以证明瞬态，必要时现有完整环形快照与平台trace补证。
+
+| 负例 | 安全预期与证据 |
+|---|---|
+| Source数据/同名Source替换/恢复 | Native source/global revision与lastMutation变化；旧证书失配、Full先执行；不能复用同名旧GPU结果 |
+| Style布局/paint/显隐/层序、glyphURL/fontFaces | signature或结果/segment revision变化；真实颜色/透明度/位置正确；恢复仍重新取证 |
+| pan/zoom/rotate/pitch、手势/动画 | #7/#8或动态保护失效，旧camera结果不composite；停稳重新Build，Symbol没有跳位/碰撞残影 |
+| viewport/pixelRatio | #6/#8及新binding，缓存按新尺寸重建，没有拉伸或旧FBO |
+| Glyph/Icon/Atlas延迟加载与替换 | requested/error/loaded/image epoch实际更新；opacity/vertex/atlas已上传才取证，旧纹理不可凭指针复用 |
+| text/icon fade、variable anchor/方向/沿线 | fade过程中拒绝，settled不靠fade==0；新顶点/UBO或排序改变时旧证书无效 |
+| tile边界/world wrap/crossTile碰撞/跨Source | 正常全场Placement不拆段，异步tile epoch和最终多段结果对应；碰撞受影响的另一R也正确重建 |
+| 跨段LayerGroup添加/移除/隐藏Symbol | pending先拒绝；processChanges后全局数量/ordinal/深度和注册关系更新，不能使用旧上方R |
+| 真实Annotation添加/更新/删除 | #24或Source/update输入失效，先Full；原SDK helper恢复正确、没有遗漏Annotation。执行既有Annotations.Step116图像测试 |
+| context丢失/后台恢复、缓存关闭再开、Style clear/reload | GPU资源与prepared结果重置，旧证书不能跨代；退出没有旧Drawables/资源悬挂 |
+| shader替换/未知placement-capable类型/不可读或超限输入 | strict拒绝证书，普通Full继续；不能用相同shader名或空数据取得证明 |
+| 上传/绘制/提交错误 | error/content revision变化，失败Full不记已完成证明，保存失败现场 |
+
+设备缺少某个可控入口时写NOT VERIFIED并给出具体限制，不新增业务数据、不修改正式Style或公开接口。完整测试源码的predicate/模拟buffer只验证局部不变量，不能替代这张设备矩阵。
+
+## 6. 结果判定、修复闭环与交付证据
+
+实现审计、Native构建、GTest、APK自验、来源/设备SHA、90秒正向、原63负对照、各负例、视觉、Metal/iOS分别记录。全部必需项实际通过之前不写全任务PASS。
+
+FastDelta=0、Build=0、Reuse=0、24Gate mismatch非零或可见Symbol异常：保存新的result.json、完整120帧、screenshots、crash log、source HEAD/APK与设备SHA，报告FAIL/PARTIAL/BLOCKED，不降低阈值。最多5轮当前阶段明确修复；编译/测试首次真error保留，架构或公共协议问题交Integration，不能跳下一阶段或改Contract。
+
+RDC回传必要信息：命令、exit、耗时、首错/target及日志路径、实际用例数量、正负场景Layer/Source/R/C清单、Build/Reuse/Full/Fast增量、24Gate window、frame输入来源、视觉判定与未验项目。本计划命令全部尚未由Codex运行。

docs/报告/STEP-108_V23统一正式发行_RDC完成报告_v1.md

@@ -0,0 +1,34 @@
+# STEP-108 V23 统一正式发行 RDC 完成报告 v1
+
+日期：2026-10-09（日本时间）
+结论：GSRL PASS / RELEASED；设备实测独立待验收。
+仓库：Mac /Users/tei/dev/MapLibreParticleLab，particle/main，未新建 worktree。
+
+## 源码及正式身份
+
+- V23 构建源码提交：87f3d1c59a52581fb8339f0ea7d106b9f4b94fef。
+- Android / RN：13.6.1-particle.23；iOS SwiftPM：6.29.0-particle.23。
+- 正式源码 Tag：maplibre-particle/rn/13.6.1-particle.23。
+- 正式 Tag 指向：a0a4787b4379ab2819943d20ce05a7ae760a88c3。
+- Source Lock：release/maplibre-particle/13.6.1-particle.23/SOURCE_LOCK.json，记录六项文件、哈希、依赖、状态及下载地址。
+
+## 严格串行结果
+
+1. Prepare：V23 冻结版本，源码提交 87f3d1c59a，已 push origin/particle/main。
+2. Build：release.sh 23 build，exit 0，Android 四 ABI OpenGL Release、Maven Local、iOS Metal Bazel opt XCFramework、RN tgz 全 PASS。日志 /tmp/maplibre_v23_unified_release_build_20261009.log。
+3. Publish：release.sh 23 publish，exit 0；NAS 原子发布，六个文件公网读回与本地逐字节一致；SwiftPM Tag 6.29.0-particle.23 远端可获取。日志 /tmp/maplibre_v23_unified_release_publish_20261009.log。
+4. GSRL：正式 Source Lock 六项 SHA-256 与本地构建产物全部匹配；release/README.md 和 V23 使用说明已经入 Git。
+5. Finalize：release.sh 23 finalize，exit 0，提交 a0a4787b43；push particle/main 和不可变 V23 Tag，远端 Git 回读 PASS。日志 /tmp/maplibre_v23_unified_release_finalize_20261009.log。
+6. 独立复核：六项公网下载均为 HTTP 200、size/SHA-256 与 Source Lock 一致；SwiftPM Package.swift checksum 与 iOS ZIP 一致；GSRL 最终 TASK_PASS_V23_GSRL_FINAL_VERIFY。
+
+## 三个主要文件 SHA-256
+
+- Android AAR：263821b686a569110ad704f817b288522eb2a153f49bf4162ace2226b28220b7
+- RN tgz：6d8d2fa2312deee97fe9304c62887cd11490a70bc08e4a90f4ee8cf7ec83ed87
+- iOS Metal ZIP：9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a
+
+## 运行时验证边界
+
+STEP-107 XCTest、iPad 唐津ヨット ハーバ直接点击、多 Source 重叠、粒子/天气回归尚未执行。V23 Android 设备测试、RN 宿主整体集成、iOS Metal 真机也均 NOT_TESTED。这些不是 GSRL 发行身份核验的组成部分，严禁写为设备 PASS。
+
+正式 V22 Tag、制品与 V23 已发布 Source Lock 不覆盖、不改写。本报告作为 V23 Tag 之后的审计追加提交。

docs/报告/STEP-109_V23_CPU_FieldSnapshot深比较快路_RDC阶段报告_v1.md

@@ -0,0 +1,44 @@
+# STEP-109 V23 CPU FieldSnapshot 深比较快路 — RDC 阶段报告 v1
+
+日期：2026-10-10（JST）
+结论：**PARTIAL / 开发态**。已针对 V23 源码热点实施局部修正；尚无 V23 真机 CPU 改善证据。
+
+## 1. 基线
+- 仓库：Mac /Users/tei/dev/MapLibreParticleLab，particle/main。
+- 起点：5b8bdfbfbb4263fe12a060e77bc310cf77f27d61，起点工作区干净。
+- 正式已发布 V23：13.6.1-particle.23（Android/RN）、6.29.0-particle.23（iOS）；发行 Tag、Source Lock、制品均未变更。
+- NavSea Mac V23 集成 checkout 为 /Users/tei/dev/NavSea-Build；Windows D:\React\NavSea 当前仍引用 13.4.1-particle.21，且有多项其他工作区修改。本轮未改 NavSea。
+
+## 2. V23 实际源码发现
+- render_particle_validation_layer.cpp 每帧调用 sameFieldGpuEndpoint() 校验既有 T0/T1，内部逐项比较 vector 和 valid。
+- render_weather_color_layer.cpp 每帧调用 sameFieldGpuContent()，内部比较 scalar/vector/valid。
+- 两条判断在 immutable T0/T1 未改变时仍可执行 O(N) 深比较。
+- STEP-090 Fast Path 存在；STEP-102/106 RenderSegment Placement 局部修复已有 FZG 定向证据，因此不能直接照搬 V21 cache-invalid 诊断。
+- V21 93.8% CPU 与 simpleperf 浮点数组采样仅为历史方向提示，不能归因于此次代码或称为 V23 基线。
+
+## 3. 已实施代码
+- src/mln/renderer/layers/render_particle_validation_layer.cpp：资源绑定持有 T0/T1 不可变快照 shared_ptr；当前资源已验证同一快照时 O(1) 判等，新对象仍严格核对内容。
+- src/mln/renderer/layers/render_weather_color_layer.cpp：WeatherColor 纹理同样记录 Source 快照身份；相同内容的新对象仍使用原严格比较及资源复用。
+- 全部身份绑定只在纹理准备成功或内容等价验证后建立；资源销毁、重新创建与 context loss 均自然清除。
+- 未改 RN 对外 API、风场 canonical contract、T0/T1 mix、Runtime Field Window、粒子数量、GPU 纹理算法及 RenderSegment 安全回退。
+
+## 4. 验证与限制
+- scoped git diff --check：**PASS**。
+- Mac Metal Core：**INTERRUPTED / NOT COMPLETED / NOT PASS**。执行 `bazel build -c opt --//:renderer=metal //:mbgl-core` 触发 649 actions 的通用 Native 重编译；基于本轮仅两文件微调、尚未安排设备验收，主动中止以控制开发成本。原远程 session 8049 和 Bazel PID 8350 均已停止；未取得构建最终通过或编译错误结论。日志：`/tmp/maplibre_step109_cpu_field_identity_bazel_20261010.log`。
+- Android 用户手工编译/安装、OpenGL 实机、iOS 实机、性能同屏 A/B、全量定向测试：**NOT RUN**。
+- 没有测得实际 CPU 下降百分比；本次不生成正式发行版，不覆盖 V23 Tag 或 Source Lock。
+
+## 5. 后续验收门槛
+1. Native 编译通过并定向执行现有 Field GPU / Timeline / Source 测试。
+2. Android FZG1-2 以相同天气输入和粒子设置、相同 Layer stack、同一 BuildType 做 V23 原版与修正版 A/B，采样进程、RenderThread、JS，并检查 FieldTextureUpload/SimulationReset。
+3. 时间切换、T0/T1 重叠窗口、clear/reload/context loss、切层、地图平移与关闭天气后恢复，在 Android/iOS 分别核对画面正确、无旧场、无多余纹理重建。
+4. 用户验收后，再新建发行版本，按 GSRL 发布不可变制品与 SOURCE_LOCK.json。
+
+## 6. Git
+本次开发提交与远端回读事实见下一节。提交只意味着代码可追溯，不意味着已编译、通过真机或正式发行。
+
+## 7. Git 开发提交与远端回读（2026-10-10）
+- 本次仅提交两份 Renderer C++ 源码、STEP-109、RDC 阶段报告、粒子开发记录共五个相关文件，未执行 `git add -A` 或触碰正式发行文件。
+- 首个开发提交：`2aae38f4023f2ef682c9039c93dfa1e96b0e6e1b`；`perf(particle): skip repeated field snapshot deep comparisons`。
+- `git push origin HEAD:refs/heads/particle/main`：**PASS**，fast-forward；远端 `git ls-remote` 回读同一 SHA：**PASS**。
+- 本次只是开发态代码与记录推送；Mac Metal build 中断、Android/iOS 真实 CPU A/B NOT RUN，STEP-109 保持 **PARTIAL**。正式 V23 GSRL Tag 和制品仍完全不变。

docs/报告/STEP-110_R0_Placement跨段归因只读调查_Codex完成报告_v1.md

@@ -0,0 +1,46 @@
+# STEP-110 R0 Placement 跨段归因只读调查 — Codex 调查 / RDC 收尾报告 v1
+
+**2026-10-10｜状态：PARTIAL（调查）；Git 交付另行核验。**
+
+## 1. 真实执行边界
+
+- Mac：Mac.lan，仓库 /Users/tei/dev/MapLibreParticleLab，分支 particle/main；起点 2df504cdc0403bdad85d3f31f16fd54a8744abac。
+- Codex CLI v0.161.0，实际启动输出确认模型 **gpt-6-astra**、推理 **high**，会话 01a12495-eb1a-78e3-ab8d-25554c6c207b。
+- Codex 完成只读调查与关键结论输出；但生成文档阶段两次长期无进展，由 RDC 终止并确认会话退出。因此**不能将 Codex 调查进程记为自然完成或将其声称为直接写出了文档**。
+- GPT 指挥 RDC 独立核查代码路径与 Git 状态、编写报告、Step 和追加开发记录，负责后续 scoped Git/Push 验收。
+- 原有未跟踪任务书 docs/40_任务/STEP-110_R0_Placement跨段归因只读调查_Codex任务_v1.md 保持原样、不提交。
+- 严守调查边界：没有编译、链接、测试、Jest、Gradle、ADB、设备操作；未修改 Native/JS/Kotlin、NavSea、Integration 或正式发行 Tag/Source Lock。
+
+## 2. 任务项逐项验收
+
+| 事项 | 状态 | 证据 / 限制 |
+|---|---|---|
+| 任务书与项目规定、既有 STEP 阅读 | 已完成 | Codex 会话逐项读取；本机原始日志和必要历史记录已交叉对照 |
+| V23 Tag、构建源码、main 对照 | 已完成 | GSRL 源码 87f3d1c，Tag 提交 a0a4787，调查起点 2df504c；六份关键代码 Blob 一致 |
+| Q1 Placement Controller/Collision/Transition | 已完成（源码调查） | 主报告第 2 章，文件、函数与行号；非 NavSea 实时归因实验 |
+| Q2 per-segment Gate/Cache/Reason | 已完成（源码调查） | 主报告第 3 章；global gate 与 source-local revision 区分 |
+| Q3 七种反事实场景安全判断 | 已完成（安全边界判定） | 主报告第 4 章；无法证明者明确 fail-closed |
+| Q4 Fast Path 独立前置依赖 | 已完成（源码调查） | 主报告第 5 章；R0 缓存不是 Fast Path 充分条件 |
+| STEP-106 T1/T2 历史验证重读 | 已完成 | 已保存设备 stream.log，仅用历史证据，不做新设备测试 |
+| NavSea R0 per-Symbol 视觉等价 | **无法验证** | 无生产 Placement/Collision/Opacity 逐帧签名，不得静态猜测 |
+| 真机 CPU 降低、R0 缓存命中 | **未完成（本 Step 禁止执行）** | 当前只有任务书提供的症状，不能声称改善 |
+| Native Gate/公共 API 修改 | **未完成（本 Step 禁止）** | 本任务只读 |
+| 任务文档及简短开发记录 | **已完成（RDC 补充落盘）** | 指定三份本 Step 报告/记录和开发记录追加 |
+| scoped commit、普通 push、远端核验 | **以报告的 Git 收尾补记为准** | 首次 Mac 远端通信出现 DNS 解析异常，不允许提前宣称 Push PASS |
+
+## 3. 核心调查结论
+
+现有 Source/Layer 事件可有条件地追踪，但 PlacementController 更新在整图语义下执行，V23 缺少可直接供 R0 复用的逐段视觉结果等价证明。跨 Source Collision 开启时，C1 Symbol 可能影响 R0 地名/图标；关闭时仍必须检查 Source 归属、Fade、Tile、Camera、层序。含 Symbol 的 R0 采用全局 Placement/Fade/Transition Gate 属于**正确保守限制**，目前未找到现有契约或不变量被违背的明确 Bug。
+
+推荐顺序：Native 内部来源与逐段结果诊断 → 可证明安全的 Placement 等价判据 → 单独授权实现和 FZG1-2 对照 → 再审查 Fast Path 其他 Gate。不得先取消保护，也不在本任务更改 C-001/C-002。
+
+## 4. Git 收尾字段
+
+- 调查起点 branch：particle/main。
+- 调查起点 HEAD：2df504cdc0403bdad85d3f31f16fd54a8744abac。
+- 待提交路径：docs/20_调查/R0_Placement跨段归因与缓存安全边界调查_v1.md、docs/50_Step记录/STEP-110_R0_Placement跨段归因只读调查_v1.md、docs/报告/STEP-110_R0_Placement跨段归因只读调查_Codex完成报告_v1.md、粒子开发记录.md。
+- **第一份文档提交**：`cdb45c023b86898117a6bd2b83b24719dd68f5fd`，message：`docs: investigate STEP-110 R0 placement attribution`；4 个且仅 4 个授权路径，`git diff --cached --check` PASS。
+- **第一次 Push 结果**：`git push origin particle/main`，exit code 0；远端响应 `2df504cdc0..cdb45c023b particle/main -> particle/main`。
+- **第一次远端回读**：`git ls-remote origin refs/heads/particle/main` 返回 `cdb45c023b86898117a6bd2b83b24719dd68f5fd`；此时本地 HEAD、origin/particle/main、远端 HEAD 三者一致。
+- **远端分支**：`origin/particle/main`，普通 Push，未 force；仍只有原先未跟踪任务书保留在工作区。
+- 本条 Git 证据写入报告属于**随后独立的文档补记提交**，该补记提交会使 Final HEAD 再前进一版。最终收尾提交 SHA 和最终远端回读由 GPT/RDC 的逐步骤验收记录提供，不能把上面的第一份提交 SHA 冒充补记后的最终 SHA。

docs/报告/STEP-111_R段Placement结果等价调查_Codex完成报告_v1.md

@@ -0,0 +1,44 @@
+# STEP-111 R 段 Placement 结果等价调查 — Codex 执行状态 / RDC 阶段报告 v1
+
+**2026-10-10｜PARTIAL，Codex 未完成任务，不是 Native 优化通过报告。**
+
+## 1. 执行来源
+- 设备：Mac.lan；仓库 `/Users/tei/dev/MapLibreParticleLab`；`particle/main`；起点 HEAD `7ec9ac8c1635c7a3b607abc2ed4be4fd764e7b6d`。
+- Integration `/Users/tei/dev/navsea-particle-integration` 同步核对：本地 `main` 与 `origin/main` 相同，HEAD `80667d6c343411d03a760425438e3d292f452118`。
+- Codex CLI `0.161.0`，用户可见 GNU Screen `20825.7445.codex` 新窗口 STEP111；启动参数 `-m gpt-6-astra -c model_reasoning_effort=high -s workspace-write -a never`；屏幕实际显示 `GPT-6 Astra high`。
+- 原始会话：`~/.codex/sessions/2026/10/10/rollout-2026-10-10T16-51-37-01a124cb-c9ae-75e3-afd8-c15a75815d1b.jsonl`（本机取证路径）；脚本记录 `/tmp/particle_step111_codex_tui.log`。
+- 17:00 前原始会话源码探索多次执行；最后连续完整事件停留于约 16:54:51；因长时间无新增结果，RDC 发送 ESC 中断并在同会话要求直接落盘报告。再次长时间没有输出，随后中断并退出 TUI。启动脚本没有可靠写出退出码；进程已消失，**不可声称自然成功退出**。
+
+## 2. 任务验收矩阵
+| 任务 | 判定 |
+|---|---|
+| STEP-111 只读任务书创建 | 已完成，原样保留未跟踪 |
+| Integration main/规则核验 | 已完成（RDC） |
+| GPT-6 Astra High 实际启动 | 已完成（TUI 确认） |
+| Codex 源码搜索与浏览 | 有部分实际轨迹；非完整调查交付 |
+| Codex 字段级 per-R Result Signature 论证 | **未完成** |
+| Codex RCRCRC 完整场景、A-D 难度证明 | **未完成** |
+| Codex 生成主报告、Step、完成报告、记录 | **未完成** |
+| GPT/RDC 独立核对当前 Gate/Cache 调用点 | 已完成 |
+| GPT/RDC 编写初步难度与后续候选方案 | 已完成，标为 PARTIAL |
+| Native 功能改动或设备性能改善 | **未执行/未验证** |
+| 构建、测试、Jest、Gradle、ADB、Bazel、CMake | **未执行** |
+| Source Lock、发行 Tag、正式交付 | **未执行** |
+
+## 3. 实际修改范围
+- **没有改动 Native/JS/Swift/Kotlin/Tests**。
+- GPT/RDC 依据 STEP-110 与本次只读核对，补充以下 PARTIAL 文档：
+  1. `docs/20_调查/STEP-111_R段Placement结果等价与独立刷新可行性调查_v1.md`
+  2. `docs/50_Step记录/STEP-111_R段Placement结果等价调查_v1.md`
+  3. `docs/报告/STEP-111_R段Placement结果等价调查_Codex完成报告_v1.md`
+  4. `粒子开发记录.md` 追加 STEP-111。
+- 不得把这三份文档称为 Codex 独立完成；实际作者为 GPT/RDC。
+- 已存在未跟踪 `STEP-110` 任务书及本次新建未跟踪 `STEP-111` 任务书不提交、不清理。
+
+## 4. 已核验的源码与部分结论
+`include/mln/renderer/render_segment.hpp:85-90` 含 Symbol R 使用全局 placementChanged/symbolFadeChange/placementTransitionActive Gate。源代码中 `src/mln/renderer/render_orchestrator.cpp:792-809` 是全局 Placement 更新；`src/mln/renderer/renderer_impl.cpp:638-686` 已有逐 Retained Segment Cache 的 fingerprint/source state/evaluate。由此可以合理提出“保留全局 Placement、后续逐 R 判断已完成结果是否等价”的设计调查方向，**但没有完成可以用于修改 Gate 的安全判据证明**。
+
+## 5. Git 与报告状态
+- 代码和正式发行状态未变化；本次只是调查阶段 PARTIAL。
+- Codex 不承担本轮 Git 收尾；RDC 后续 Git 实际 Commit/Push/远端 HEAD 以独立工具返回为准。当前撰写时**尚未验证提交与远端**，不得把文档写入视为 Push PASS。
+- 后续可以在可用模型/运行环境中重新开展限界的结果数据所有权审计和 shadow-mode 方案设计，但**不能将本轮 PARTIAL 当成允许直接修改 Gate 的授权**。

docs/报告/STEP-112_V23粒子FullRender与Symbol缓存调查_Codex完成报告_v1.md

@@ -0,0 +1,93 @@
+# STEP-112 V23 粒子 Full Render 与 Symbol 缓存调查 Codex 完成报告 v1
+
+日期：2026-10-11（JST）。
+
+## 1. 执行结论
+
+**A—E只读源码调查和四文件交付已完成；综合判定 PARTIAL。** 正常Continuous Full的Symbol R首次缓存准入不可达已有决定性源码证明；生产逐帧原因、原RCRR完整布局、可安全替代的准入证据和真实性能仍不完整，不标全任务/实现/性能PASS。
+
+关键证据：`render_orchestrator.cpp:792-807` 的重算/不重算分支，`placement.cpp:160-175` 的recent/stale语义，与 `render_segment.hpp:85-90` 的三条件组合。重算则changed=true，不重算则Controller stale使transition=true，Symbol R均不能首次Build。`symbolFadeChange==0`不是终态条件；transitions关闭时正常Full返回fade=1。全局prepared scene和PREFIX普通Symbol/Line C仍独立阻塞Fast。
+
+主报告第4—10章包含完整调用图、24项矩阵、缓存状态机、两种配置与真值表、S1—S5、A—D成本风险提案、最小采样方案；第11章区分源码证明、现场输入、条件推断和设备待验。
+
+## 2. 实际模型、机器与Git基线
+
+- 机器：Mac.lan，Darwin 24.6.0，x86_64；未连接或操作Android/iOS设备。
+- 仓库：`/Users/tei/dev/MapLibreParticleLab`；branch起终均 `particle/main`。
+- start HEAD：`41b416c261fa72bd21171328045036a124694f47`；end HEAD同此，未commit。
+- **模型 `gpt-6-astra`，reasoning effort `high`**。环境会话ID `01a12686-49ee-70b1-953e-f95f8a4bd9ca`；实际读取本地 `~/.codex/sessions/2026/10/11/rollout-2026-10-11T00-54-57-01a12686-49ee-70b1-953e-f95f8a4bd9ca.jsonl` 的 `turn_context.model/effort` 确认；没有自行切换或升级，没有启动第二实例/子代理。
+- 起点tracked clean；只有两份未跟踪STEP-110/111任务书。`git submodule status` 全为空格前缀，无未初始化/偏移标记；未操作子模块。
+- 终态预期且经收尾检查核对：新增本Step三文档、开发记录修改，加上原有两份未跟踪任务书，无其它变化。
+- V23构建源码 `87f3d1c59a52581fb8339f0ea7d106b9f4b94fef`；相关路径与HEAD只差STEP-109的两Layer snapshot快比较，核心Gate行为一致。V23正式制品不含这项开发快路，本轮未发行。
+- Integration main `80667d6c` 是用户提供的RDC核验事实；本轮未fetch/pull/远端回读，只读相关contract/coordination。
+
+## 3. 任务逐项：已完成 / 未完成 / 无法验证
+
+| 项目 | 结果 | 证据与限制 |
+|---|---|---|
+| 前置阅读、实际模型、工作区核对 | 已完成 | 根AGENTS、PARTICLE_BASELINE、8份规范、现行总则README+4份、STEP-112、STEP-102/106/109/110/111任务/记录/报告 |
+| A 调度/Idle/cadence/CPU-GPU区别 | 已完成 | 主报告4；SDK Handler/NSTimer唤醒、Core cadence、Observer和prepared-tree链；实测30FPS来源仍未知 |
+| B 全部Fast Gate | 已完成 | 主报告5；24项按首错顺序，完整non-camera signature及prepared scene二重锁 |
+| C R2缓存状态机 | 已完成 | 主报告6；首次未建、反复无条件invalidate、revision/key变化、资源/Build失败分开 |
+| D Placement开关/Fade真义 | 已完成 | 主报告3、7；无窗口的分支证明，300/30ms/zoom和8组合表，GL/Metal shader依据 |
+| E S1—S5及布局 | 已完成（缺证据明确标未知） | 主报告8；原RC/PREFIX和理想保序布局；原RCRR完整边界未获得，不伪造 |
+| A—D工程提案与最小验证 | 已完成 | 主报告9—10；首次Build/scene/C分别评估，候选文件/成本/风险/1—5复杂度、双后端、Interface Blocker |
+| 任务书四项落盘 | 已完成 | Codex本轮直接写入，早期框架与后续章节分阶段保存；不是由RDC补写 |
+| FZG1每帧options、请求来源、所有Gate、CPU分摊 | 无法验证 | 只有任务/历史现场计数与末态；本轮禁止插桩和设备操作 |
+| Symbol结果等价/安全新Gate充分性 | 无法验证 | 当前无与成功Build版本绑定的最终GPU输入证书；提案需shadow和运行对照 |
+| Native修复、首建成功、Fast hit提升、CPU改善 | 未完成（本轮不授权） | 未改实现，不能将只读控制流证明当修复PASS |
+| 编译/测试/设备/制品 | 未执行（本轮禁止） | 无新build log、APK/AAR/XCFramework、运行结果或SHA |
+| commit/push/远端HEAD | 未执行（用户交RDC） | 无新commit/hash/message/push结果，不冒称Git收尾完成 |
+
+## 4. 实际写入文件
+
+新增：
+
+1. `docs/20_调查/STEP-112_V23粒子FullRender循环与Symbol缓存准入全面源码调查_v1.md`
+2. `docs/50_Step记录/STEP-112_V23粒子FullRender与Symbol缓存调查_v1.md`
+3. 本报告 `docs/报告/STEP-112_V23粒子FullRender与Symbol缓存调查_Codex完成报告_v1.md`
+
+修改：`粒子开发记录.md`，仅在末尾追加STEP-112短条，不重写历史。
+
+无Native/C++/Kotlin/Java/Swift/ObjC/JS/TS/Shader/测试/Style/脚本改动；无NavSea/Integration跨项目写入；无分支/worktree变更或dirty清理。
+
+## 5. 检查与禁止操作
+
+已执行：`pwd`、`uname -a`、branch/HEAD/status/submodule只读核对；`rg`、带行号源码读取；V23相关路径`git diff`；文档内容和变更范围检查。收尾的文档空白、原文件哈希、开发记录前缀检查结果见第8节。
+
+**全部NOT RUN**：CMake/Ninja/Bazel、编译/链接、codegen、C++测试、Jest、Gradle、APK/AAR/XCFramework打包、ADB/安装/设备/logcat/截图、新性能测量、发布、commit、push。没有已观察到的编译或测试失败；因为没有执行，不能推断会通过。
+
+少数初始按类名探测的路径不存在，随后按实际文件定位，例如RenderRasterParticleLayer实际实现位于 `render_particle_validation_layer.cpp`，RenderTreeImpl位于 `render_orchestrator.cpp`；未用缺失路径作为证据，也没有为此创建源码文件。
+
+## 6. 与任务书差异和阻塞
+
+- 用户当前明确指定gpt-6-astra/high，覆盖任务书旧建议，已实际核实。
+- 本轮Codex执行指令明确不由Codex提交/推送，遵循AGENTS的Codex→RDC职责分工；STEP-112任务书第十一节要求RDC独立完成scoped Git提交、推送及远端验收。用户并未禁止本任务的Git收尾。
+- 用户已给Integration同步事实，本轮只读相关contract/coordination，不重新做全仓同步。
+- 完整原RCRR plan、现场options/逐帧日志和CPU阶段分摊缺失；限制在主报告单独标记，不将条件推断升格为FZG1实测。
+- 公共“外部明确Full且不按相同数据去重/延迟”目前没有相应force-Full/序号字段。Interface Blocker仅约束未来D提案，需Integration决议，未新增API或改责任边界。
+
+## 7. 独立验收与下一步
+
+RDC依据STEP-112任务书第十一节，独立复核主报告第3章的两分支证明和第5章24项来源，核对四份交付文件、两份未跟踪任务书及HEAD，然后做scoped Git提交/推送及远端HEAD核验；以独立Git收尾补记为最终证据。
+
+下一代码阶段先授权A低开销同帧gate/Placement/R状态诊断，再审查B的Full后安全Build证书；需要per-R结果时用C shadow比较。保护跨Source/跨段Collision、text/icon Fade、camera、资源、层序与GL/Metal一致性。独立验收必须取得源码/制品版本、plan/Style表、逐帧gate及计数、trace成本、CPU阶段耗时和视觉证据。未经新任务授权，不实施Native修复，不降低FPS、不删除Symbol、不放宽fail-closed。
+
+## 8. 实际收尾检查结果
+
+- `git diff --check -- 粒子开发记录.md`：无空白错误；diff统计仅 **8行追加、0行删除**。
+- 三份新增文档分别执行 `git diff --no-index --check /dev/null <明确路径>`：均无诊断输出；退出码1表示与空文件存在差异，不作为构建或测试结果。正文代码围栏成对，Fast矩阵已人工核对包含顺序1—24，S1—S5齐全。
+- 开发记录与 `git show HEAD:粒子开发记录.md` 的原始 **159061字节前缀完全相同**，原SHA-256=`9a1690188a9c283024c74fa275ec68d7442459c73008126087e0d9ec9704910a`；本轮追加1381字节。
+- STEP-110未跟踪任务书SHA-256仍为 `33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`。
+- STEP-111未跟踪任务书SHA-256仍为 `f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。
+- 最终 `git status --short` 只显示：开发记录M、本Step三文档??、原有两份任务书??。`git diff --cached --name-only` 无输出，未暂存任何文件。
+- `git branch --show-current`=`particle/main`；`git rev-parse HEAD`=`41b416c261fa72bd21171328045036a124694f47`，与起点一致。
+- Codex调查阶段没有执行commit/push，commit message不适用且当时未回读远端。这不是用户禁止Git收尾；其后RDC按STEP-112任务书要求独立执行的实际结果见第9节。
+
+这些仅是源码/文档取证与范围完整性结果，不是编译、设备、性能或安全新Gate的PASS证据。
+
+## 9. RDC 独立 Git 验收补记（非Codex操作，2026-10-11）
+
+- RDC独立核对Mac `particle/main` 起点HEAD=`41b416c261fa72bd21171328045036a124694f47`；起始远端SHA相同，Integration仍在main=`80667d6c343411d03a760425438e3d292f452118`。仅stage本任务三份报告及开发记录追加；`git diff --cached --check`通过，四文件且只有四文件。两份原未跟踪STEP-110/111任务书仍保留。
+- 文档成果首次commit=`abc137ca9637abc18be8c64cd98f2c7f1ed68704`，message=`docs: investigate STEP-112 particle full render and symbol cache`，四文件共570行新增。普通`git push origin particle/main`退出码0，远端返回`41b416c261..abc137ca96`；`git ls-remote origin refs/heads/particle/main`回读`abc137ca9637abc18be8c64cd98f2c7f1ed68704`，与当时本地HEAD完全一致，首次Git收尾PASS。
+- 本节由RDC在Codex任务完成后追加，不应归为Codex调查成果；补记形成后续文档提交，最终HEAD及远端核验另以该后续提交的实际命令返回为准。Native实现、编译、设备及性能依然未执行，综合研究判定保持PARTIAL。

docs/报告/STEP-113_FZG1_PBF_Layer与FastGate诊断_Codex完成报告_v1.md

@@ -0,0 +1,265 @@
+# STEP-113 FZG1 PBF Layer 与 Fast Gate 诊断 Codex 完成报告 v1
+
+日期：2026-10-11（JST）。结论：**PARTIAL：诊断和专项测试场景源码已交付；构建、设备及生产113层完整等价未验收。**
+
+## 1. 基线、模型与授权
+
+- Mac.lan / Darwin 24.6.0 / x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 起点及交付 HEAD：`particle/main@c6d13e1059d464d312ac33acac87967300fa5dc4`；无 commit/push、无新 branch/worktree、无发行。
+- 实际模型 **GPT-6.1-Sol（`gpt-6.1-sol`）/ high**，从本会话 `01a12808-4436-7d33-bc56-9135722348b1` rollout 的 `turn_context.model/effort` 核实。未切换模型、未启动其他 Codex/子代理。
+- Native/Test App 的源码版本 `platform/android/VERSION=13.6.1-particle.23`，RN package 同为 `.23`；没有改版本或覆盖正式制品。新诊断只存在于本次未提交源码，不能把现有正式 V23 APK 当本次制品。
+- NavSea 只读 HEAD `ad9aa043fde37f87462f31de3fbd8ce008f8424b`，读取时 tracked/untracked status 均无输出；Integration 本地 HEAD `80667d6c343411d03a760425438e3d292f452118`。没有 fetch/pull、跨项目写入或消息发送；Integration 远端核验采用用户提供的 RDC 事实。
+- 起点 tracked clean；已有 STEP-110/111/113 三份未跟踪任务书均保留。子模块状态均为空格前缀，没有操作子模块。
+- 已读根 AGENTS、PARTICLE_BASELINE、项目规范全部文件、总则 README 和四份有效总则、STEP-113 任务书、STEP-112 调查/记录/报告，以及 STEP-102/106 的相关实现与记录。
+- 本轮不执行 CMake/Ninja/Bazel、Native 测试、Gradle/APK、ADB/安装/Logcat、Jest、发布、提交或 push。以下命令仅交 RDC 执行。
+
+## 2. 实际修改与新增文件
+
+| 文件 | 变更目的 |
+|---|---|
+| `src/mln/renderer/particle_fast_path.hpp` | 24项固定顺序表、无副作用失败掩码；生产 evaluator 原样保留 |
+| `include/mln/renderer/render_segment.hpp` | 平台无关帧/phase/cache诊断值结构，现有 snapshot 可选 `fastGateTrace` |
+| `src/mln/renderer/retained_underlay_runtime_state.hpp` | 120帧环形缓冲、生命周期聚合、受锁保护的快照/reset/完成记录 |
+| `src/mln/renderer/render_segment_json.hpp` | 现有 JSON 出口增加可选 trace，24项状态、窗口与生命周期计数、pre/post |
+| `src/mln/renderer/renderer_impl.cpp` | 原始 input/decision 采集点、实际 pre cache validity/revision、渲染后完成记录 |
+| `src/mln/renderer/renderer.cpp` | 生命周期 reset 与没有 RenderTree 时的明确 outcome |
+| `src/mln/map/map.cpp` | 外部诊断读取携带 trace；renderer 内部读不复制历史环形数据 |
+| `test/renderer/retained_underlay_cache.test.cpp` | 新增4个 `FastGateTrace.*` C++ 回归用例；未运行 |
+| `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step113PbfGateScene.kt`（新增） | 真 PBF、五个场景、parity证明/限制、固定预报、低频UI与分块导出 |
+| 同目录 `ParticleCoreLayerValidationActivity.kt` | 菜单/Intent、scene生命周期与旧场景隔离，诊断区域临时扩展 |
+| `docs/50_Step记录/STEP-113_FZG1_PBF_Layer与FastGate诊断_v1.md`（新增） | 当前状态、RDC验收填写栏 |
+| 本完成报告（新增） | 源码交付事实、命令、证据与限制 |
+| `粒子开发记录.md` | 仅末尾追加本次短记录 |
+
+没有修改 Shader、Placement、Retained Cache 的准入/等价/回退算法、RN 类型或方法、JNI 方法签名、NavSea、Integration、构建流水线和发行版本。扩展的是任务明确授权的可选诊断 JSON 与其内部值结构，不新增公共控制 API/Host 契约。若后续需要新的公共控制面，应先走 Integration RFC。本任务不为未来接口变更提供授权。
+
+## 3. B：24 Gate 同帧记录与真实性边界
+
+每次真实 `tryRenderParticleFastFrame` 用**已经计算好的同一个 input**调用原 evaluator 一次，再独立计算掩码。没有再次调用 `particleFastPathDynamicState`、needsRepaint、Placement 计算或 cadence 推进。新增 Cache getter 是 `const noexcept` 的纯字段读取；用于观察已被 aggregate 短路掩盖的 R 状态。
+
+`knownMask=0x00ffffff`：当前24条 evaluator 布尔输入全部已知；`gateStatus` 逐项给出 PASS/FAIL。若以后缺少输入，可通过 knownMask 显式输出 UNKNOWN。**这里观测的是实际 Gate 输入；如没有 prepared scene，其已有 false 标志导致 Gate FAIL，不表示调查过一个尚不存在的 scene。**
+
+`firstFailure` 保存生产 evaluator 真正返回的首错；`failMask` 保存同一 input 的失败全集。`decisionConsistent` 比较首位失败与生产决定，`decisionMismatch` 累计不一致；任何非零值均需要保留现场，不能接受归因结果，也不会放宽生产 Gate。位0对应顺序1；enum 的 camera/viewport 数值顺序不能用作掩码顺序。
+
+| 顺序 | 失败名 | FAIL 谓词 |
+|---:|---|---|
+| 1 | no-prepared-tree | `!hasPreparedTree` |
+| 2 | retained-disabled | `!retainedEnabled` |
+| 3 | cache-invalid | `!cacheValid` |
+| 4 | revision-mismatch | `!revisionMatches` |
+| 5 | content-mutation | `!contentRevisionMatches` |
+| 6 | viewport-changed | `!viewportMatches` |
+| 7 | camera-changed | `!cameraMatches` |
+| 8 | update-parameters-changed | `!updateParametersMatch` |
+| 9 | style-not-loaded | `!styleLoaded` |
+| 10 | boundary-changed | `!boundaryMatches` |
+| 11 | topology-changed | `!topologyMatches` |
+| 12 | static-unstable | `!staticStable` |
+| 13 | placement-or-fade | `hasPlacementTransition` |
+| 14 | pending-changes | `hasPendingChanges` |
+| 15 | non-particle-transition | `hasNonParticleTransition` |
+| 16 | non-particle-repaint | `hasNonParticleRepaint` |
+| 17 | fading-tiles | `hasFadingTiles` |
+| 18 | no-particle-repaint | `!particleNeedsRepaint` |
+| 19 | still-image-request | `stillImageRequest` |
+| 20 | unsupported-mode | `!continuousMode` |
+| 21 | debug-options | `!debugDisabled` |
+| 22 | unsupported-continuous-layer | `unsupportedContinuousLayer` |
+| 23 | unsupported-scene | `!supportedScene` |
+| 24 | annotation-mutation | `annotationMutation` |
+
+因此 CacheInvalid 同帧也会保留 #22、#23 的真假，不再通过后续Full快照推测此前Gate。
+
+每帧有 lifecycle 内唯一 `sequence`、renderer `frame`、steady-clock 的 `updateTimeNs`；没有树时多个尝试可以共用一个尚未完成的 renderer frame，**关联主键是 lifecycle+sequence**。不把 updateTimeNs 当 UTC/forecast。外层原有fastPathHit/Miss/Full atomics沿用原快照语义，可能与正在写入的trace末帧相差一个调用阶段；逐帧归因以frame记录为准，不把外层字段拼成额外原子帧。
+
+- `cacheInputs` 是实际 pre-fast cache exists/valid/buildRevision/staticRevision；最多16个 R，超限明确 `cacheInputsTruncated=true`，所有 aggregate Gate 仍完整。
+- `pre` 保存判定阶段的缓存计数/失效/回退原因与上一已完成 RenderTree 诊断快照。`preFastPlacementTransition` 才是本次 Gate #13 的当前 Controller 值；`placementTransitionsEnabled` 来自本次 UpdateParameters。
+- `post` 在渲染末尾取得同帧 R build/reuse/invalidation/fallback、sourceReady/stable、decision、actualExecution、Placement changed/transition/fade与Full计数。Full、Fast、无树分别有明确 outcome；中途异常或尚未结束时 `completed=false/post=null`。
+- `placementBasis` 区分历史 RenderTree、当前 Full tree、当前 Fast tree（未重新计算Placement）；没有完成过的诊断快照标 UNKNOWN。没有将 post Full 数据回填 pre Gate。
+- 每phase最多16个R；`retainedSamplesTruncated` 明示超限。无同帧每Symbol输出签名、旧Placement options/duration/commitTime/fadeStartTime、CPU/GPU阶段计时，这些不在本次实现中伪造。
+- Debug 的 `processSimulationAdvance` 复用现有进程级 atomic 计数；Release为null。它不是单Map的计数，也不等于Fast尝试或FPS。
+
+120帧全部Gate每次尝试都记录；容量满时覆盖最早帧，`overwritten` 累计。生命周期 `gates[].failures/firstFailures` 保留聚合；`windowFailures`、窗口首末序号、窗口 Full/Fast/无树计数另行导出。默认30fps时120帧约4秒，真实渲染频率可能更高，不能承诺完整60秒逐帧档案。
+
+环形记录在 render thread 更新；写入、完成、reset和外部copy沿用 `rangeMutex`。Android UI只读现有共享snapshot，不操作Renderer可变对象。内部render snapshot默认不复制trace；只有外部 `Map::getRenderSegmentDiagnostics()` 包含历史。reset发生于绑定新的 runtime state、观测到 styleLoaded true→false、context lost、Renderer.clearData；每次普通 Full miss清prepared tree**不会**清trace。sceneGeneration/configRevision另用于区分UI场景切换；同步加载没有暴露false帧时，不能假定trace epoch必然随UI场景切换。
+
+新增CPU工作为O(24+R)、固定容量历史；没有额外GPU pass。每帧仍有小型vector/string副本与短mutex临界区，外部读取序列化120帧也有成本。**内存字节数和CPU成本没有实测，不声明低于某一百分比**；RDC需量测。没有诊断开关的新RN API；如需成本对照，应使用同环境基线源码制品与本次制品并记录差异。
+
+## 4. A：Style、Layer 与场景等价度证据
+
+| 项目 | 证据等级与当前结论 |
+|---|---|
+| 正式Style/Sprite/Glyph/VectorTile URI | **SOURCE-PROVEN**：NavSea `src/config/builtinRuntimeUrlConfig.ts` 与新场景常量相同 |
+| NavSea当前分段选择器 | **SOURCE-PROVEN**：`RenderSegmentHost.tsx` 为R→C，C从 `rn-weather-color` 开始；不是现场四段计划 |
+| 天气片段 ID/type/source | **SOURCE-PROVEN**：`particleStyle.ts` 调用shared fragment，追加到顶；shared `packages/maplibre-particle-rn/src/index.ts` 定义 `rn-weather-fields`、`rn-weather-color`、`rn-weather-particles` |
+| 正式63层保序/显隐/完整定义 | **TEST-APP-STRUCTURAL**：运行时从正式URL加载，要求63层和实际锚点ID；完整原始定义逐层不变、顺序不变，并导出生产manifest与实际Native styleLayers。**尚未在设备执行该证明** |
+| Sprite/Glyph/VectorTile访问成功 | **NOT-VERIFIED**：本机web open失败；urllib回读失败于域名无法解析，没有服务器JSON/SHA或瓦片访问成功证据 |
+| 113层及[0,13)/[13,33)/[33,107)/[107,113) | 用户STEP-112历史现场输入；本轮没有同版本完整Layer/Source/visibility/业务数据快照，**NOT-VERIFIED，未完整复制** |
+| 旧NavSea FZG采样 | 只读找到V15报告与129层采样；年代/版本/层数均不同，不用于补造当前113层 |
+| 本轮真机/性能 | **DEVICE-MEASURED：无本轮结果** |
+
+生产URI分别为：
+
+- Style：`https://pbf.jpcn.ccwu.cc/style/style.navsea-delivery-full-semantic-extentfix.json`
+- Sprite：`https://pbf.jpcn.ccwu.cc/sprite/sprite`
+- Glyph：`https://pbf.jpcn.ccwu.cc/fonts/{fontstack}/{range}.pbf`
+- VectorTile：`https://pbf.jpcn.ccwu.cc/pbf/pbf-delivery-full-20260418-rebuild/{z}/{x}/{y}.pbf`，source=`navsea_delivery`。
+
+场景会检查真实回读的资源URI；变更或缺失则显示BLOCKED并导出原因，不切换假地图。`productionFingerprintSha256` 是SDK回读序列化JSON的UTF-8 SHA-256，**不是HTTP原始字节SHA**，且URL本身可变。导出styleVersion/name/metadata（styleVersion是Style规格版本，包版本未知时为null）、生产/增强fingerprint、basemanifest、请求plan、最终Native所有Layer的index/id/type/source/visibility，以及段边界与层名。Native可能追加Annotation等内部层，不能把JSON基础63层等同实际总层数。
+
+| 场景 | 行为与等价限制 |
+|---|---|
+| PBF63 | 正式63层原定义；无测试天气片段；全RETAINED，实际总层数以Native为准 |
+| STATIC_RC | 原63层+正式类型的天气/粒子片段（JSON65层）；保序append；当前NavSea源码RC选择器；不等价NavSea全部动态业务层 |
+| PARTICLE_OFF | 与STATIC_RC同样层序，粒子visibility=none；WeatherColor/forecast/camera保持对照 |
+| PARTIAL_RCRR | 原63层+天气片段，片段放在实际 `clip-outline` 后；四段锚点为 `sea-area-fill`、`special-pattern-line-754`、**实际回读的最后生产层ID**；明示结构RCRR，与现场113层/数字边界不同 |
+| SOURCE_CHANGE | STATIC_RC加一个独立GeoJSON/circle测试Source；显式菜单单次更新；结构探针，不冒充AIS/Radar/航线等生产数据 |
+
+所有带天气场景使用既有ECMWF canonical两个时间片（2026080700/06），forecast请求 `1786060800000` ms，PAUSE，targetFps=30，粒子1024。与NavSea当前QBIN/预报业务输入不等价。命令接受结果逐项保存；实际Native预报时间没有新增查询API，`actualForecastTimeObservedMs=null`，不把Host请求值当Native独立回读结果。camera请求33.45/129.97、zoom10.5、bearing/pitch0；场景禁用手势，退出恢复原手势设置。静态轮询不改Source/Symbol/forecast/camera。
+
+Native准入限制保持原样；RCRR结构模式预期可以暴露不支持的C层和Symbol R阻塞，但这只是源码预期，不是已经在FZG测到的结果。
+
+## 5. C：UI、导出及精确RDC命令
+
+入口：Test App `STEP 093 → STEP-113 FZG1-PBF GATE`。五个场景、`EXPORT LAST SNAPSHOT`、`MUTATE PROBE SOURCE ONCE`、退出。加载中或失败时也保留低频诊断读取，sceneReady=false/blockedReason明确标注，不能把可能仍在加载的旧Native层表当已完成场景。每3秒只有一次Native诊断查询；UI首错来自trace末帧，失败排名来自同copy聚合，各段显示范围/state/build/reuse/invalidation。仅STEP-113期间增大诊断区域，退出恢复。
+
+每30秒一条逻辑summary（通常少量物理Logcat分块）；不是每33ms输出JSON。完整120帧和Layer表仅手动导出最近一次copy，写App私有 `files/step113-<SCENARIO>-<elapsed>.json` 并使用标签 **STEP113Gate** 输出Base64分块。每块payload≤2400 ASCII字符，携带schemaVersion/kind/exportId/chunkIndex/chunkCount/encoding；按exportId和chunkIndex完整拼接后Base64解码，缺块不能当完整证据。手动完整导出会产生较多块，优先直接回读私有JSON文件。
+
+以下仅RDC执行，本轮Codex没有执行。先在macOS普通Terminal核对设备主ABI与标准脚本的x86_64一致；不同则停止本构建流程并记录，不自行改脚本/环境：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+step113_abi="$(adb -s 192.168.200.139:5555 shell getprop ro.product.cpu.abi | tr -d '\r')"
+step113_abilist="$(adb -s 192.168.200.139:5555 shell getprop ro.product.cpu.abilist | tr -d '\r')"
+printf 'FZG1-2 primary ABI=%s; ABI list=%s\n' "$step113_abi" "$step113_abilist"
+test "$step113_abi" = x86_64 || { echo 'ABI不一致，停止'; return 1 2>/dev/null || exit 1; }
+./tools/particle_android_validation/build_validation_apk.sh
+```
+
+标准产物：`artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk`、`build.log`、`build-info.txt`；脚本记录commit/branch/dirty/SHA/体积并自验ZIP与Native ABI，失败不得复用旧APK。本轮源码未提交，build-info里的dirty必须真实，另保留任务文件diff/hash以证明制品来自本次修改。
+
+安装前RDC核对现存同包签名，签名不匹配不得自动卸载用户数据；保留INSTALL_FAILED错误。安装与静态场景启动：
+
+```bash
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step113_scenario STATIC_RC
+adb -s 192.168.200.139:5555 logcat -v raw -s STEP113Gate:I '*:S' > artifacts/maplibre-particle/android-validation/step113-static-rc.log
+```
+
+最后一条在RDC普通前台Terminal采集，窗口完成后Ctrl-C。其他场景各用一条明确启动命令，并独立保留日志：
+
+```bash
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step113_scenario PBF63
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step113_scenario PARTICLE_OFF
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step113_scenario PARTIAL_RCRR
+adb -s 192.168.200.139:5555 shell am start -S -n org.maplibre.android.testapp/org.maplibre.android.testapp.activity.particle.ParticleCoreLayerValidationActivity --es step113_scenario SOURCE_CHANGE
+```
+
+不要把这些命令连续执行当场景测试；每个场景至少预热10秒、观察60秒、手动导出窗口，再切下一场景。SOURCE_CHANGE先导出baseline，单击手动探针变化，等一次3秒刷新后再次导出；不添加周期Symbol更新。
+
+点击 `EXPORT LAST SNAPSHOT` 后回读最近文件（run-as仅适用于该Debug App）：
+
+```bash
+step113_file="$(adb -s 192.168.200.139:5555 shell run-as org.maplibre.android.testapp ls -t files | tr -d '\r' | rg '^step113-.*[.]json$' | head -n 1)"
+test -n "$step113_file" || { echo '未找到手动导出文件'; return 1 2>/dev/null || exit 1; }
+adb -s 192.168.200.139:5555 exec-out run-as org.maplibre.android.testapp cat "files/$step113_file" > "artifacts/maplibre-particle/android-validation/$step113_file"
+shasum -a 256 "artifacts/maplibre-particle/android-validation/$step113_file"
+adb -s 192.168.200.139:5555 exec-out screencap -p > artifacts/maplibre-particle/android-validation/step113-screen.png
+adb -s 192.168.200.139:5555 logcat -b crash -d > artifacts/maplibre-particle/android-validation/step113-crash.log
+```
+
+如果只保留Logcat，使用下面的离线重组命令；每个导出必须收齐chunkCount，否则直接报错：
+
+```bash
+python3 - <<'PY'
+import base64, json
+from pathlib import Path
+root = Path('artifacts/maplibre-particle/android-validation')
+groups = {}
+for line in (root / 'step113-static-rc.log').read_text().splitlines():
+    try:
+        c = json.loads(line)
+    except json.JSONDecodeError:
+        continue
+    if c.get('encoding') != 'base64-utf8':
+        continue
+    key = (c['exportId'], c['kind'])
+    count, parts = groups.setdefault(key, (c['chunkCount'], {}))
+    assert count == c['chunkCount'], key
+    parts[c['chunkIndex']] = c['payload']
+for (export_id, kind), (count, parts) in groups.items():
+    assert set(parts) == set(range(count)), ('缺块', export_id)
+    raw = base64.b64decode(''.join(parts[i] for i in range(count)), validate=True)
+    json.loads(raw)
+    (root / f'step113-{export_id}-{kind}.json').write_bytes(raw)
+PY
+```
+
+RDC的macOS Native定向检查可按当前preset执行（历史缺libuv阻塞不代表当前环境仍相同；若失败保留首错，不扩大改依赖）：
+
+```bash
+cmake --preset macos-metal
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+build-macos-metal/mbgl-test-runner --gtest_filter='FastGateTrace.*:ParticleFastPath.*:RenderSegmentDiagnostics.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*' --gtest_color=no
+```
+
+配置失败就停止该链；不运行旧runner冒充新源码通过。Metal host测试不能替代Android OpenGL/实体机/iOS验收。
+
+## 6. 已执行静态检查与未做项
+
+已执行：只读Git/源码/文档调查、diff范围检查、`git diff --check`（退出0）；新增文件另用no-index whitespace检查。静态文本核对24条谓词及极性/顺序一致；生产 evaluator 与HEAD逐字相同；STEP-102 fixture与500ms poll逐字未变。最终hash与append-only核对见第7节。
+
+4个测试源码覆盖：全部24独立失败位/生产首错顺序；CacheInvalid与#22/#23同帧并存、137次记录后120条有序窗口与reset；pending/null post/错误shadow显式计数和完成幂等；18个R截断及pre/post独立缓存计数。**没有运行这些测试，没有C++/Kotlin编译或语法编译PASS结论。**
+
+本轮无APK/AAR、体积或SHA，无设备运行日志、截图、FPS、CPU、trace开销或性能改善数字。没有已观察到的构建/测试失败；未执行不表示会通过。
+
+剩余RDC事项：Native/Kotlin编译和上述定向测试；设备ABI/制品SHA/版本证据；正式资源加载、原63层manifest/实际层序；plan接受与最终valid原因；所有24状态与首错一致性；cache-invalid同帧后续失败；Full/post和pre分离、Source变更前后、粒子关闭对照；reset/退出/恢复与旧场景回归；开销/CPU和截图。**APK成功仅是构建证据。**
+
+113层完整等价仍需同版本真实Layer/Source/业务数据/显隐/选择器快照后才能扩展；本任务交付的部分模式不为生产Full循环提供完整因果或性能验收结论。
+
+## 7. 收尾证据
+
+- STEP-110任务书SHA-256：`33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`。
+- STEP-111任务书SHA-256：`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。
+- STEP-113任务书原样SHA-256：`4e3fef391dc3addef2702b3d588c1fcc8f79b898b5d9004bfc1410070533e0b4`。
+- HEAD保持起点，暂存区为空；仅任务源码/测试、两个新交付文档和开发记录追加，既有三任务书未暂存。没有远端HEAD回读、commit/push或制品发布行为。
+- 开发记录的HEAD原始160442字节前缀完全保留，原SHA-256=`070aaeaf85aa8fdbe8b15a899f74fd492a0e3eb2b6442b37cb3d5ee9724dbd24`；本次仅末尾追加1120字节（7行）。静态检查是范围与一致性证据，不是全任务PASS。
+
+
+## RDC 独立验收补记（2026-10-11，设备证据）
+
+以下是 Codex 退出后 RDC 新执行的证据，不修改上文 Codex 未构建/未实测的历史结论。本次阶段判定：**PARTIAL；Android 构建 PASS；五场景稳定基线采样 PASS；113 层等价与性能 NOT VERIFIED**。
+
+- 环境：Mac、particle/main；构建源码基于 c6d13e1059d464d312ac33acac87967300fa5dc4 加 STEP-113 未提交改动，build-info 明确 git_dirty=true。此 APK 不是 Source Lock / 正式发行。
+- 标准 build_validation_apk.sh 于 2026-10-11 08:35:08 JST 退出码 0；Gradle BUILD SUCCESSFUL in 19m 22s；Java 17.0.20.1；OpenGL/x86_64；ZIP/ABI/体积/SHA 自检通过。
+- APK：artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk；66,587,454 bytes；libmaplibre.so 40,033,976 bytes；SHA-256 0054248bc3872e8670df4e9a10d11f1d65c0912a0482586cd7a247e880a6eaef。记录：同目录 build-info.txt、build.log。
+- 设备：FZG1-2，ADB 192.168.200.139:5555，主 ABI x86_64；明确 -s 的 adb install -r 返回 Success，未卸载数据；设备安装后版本 13.6.1-particle.23。正式 PBF Style 模式运行并加载。启动前数秒 sceneReady=true 但 Native Layer=0 / plan not-configured 是加载暂态；只接受之后的 Native Layers 非零、planValid=true 稳定记录。
+- 五个场景均由 ADB 明确 serial 启动；STEP113Gate Logcat Base64 summary 成功还原。每场景实际设备稳定状态的 decisionMismatch 都是 **0**。Full/Fast/Attempts 为生命周期累计，并非精确 60 秒窗口。
+
+| 场景 | Native Layers | Attempts | Full | Fast | Retained 及关键证据 |
+|---|---:|---:|---:|---:|---|
+| PBF63 | 64（63+内部层） | 106 | 106 | 0 | R[0,64) Build0，unknown-dependency；无粒子持续驱动 |
+| STATIC_RC | 66 | 876 | 875 | 0 | R[0,63) Build0，unknown-dependency；unsupported-continuous-layer、unsupported-scene 各876 |
+| PARTICLE_OFF | 66 | 70 | 70 | 0 | no-particle-repaint=70；非相等时长性能对照 |
+| PARTIAL_RCRR | 66 | 862 | 861 | 0 | R0[0,3) unknown-dependency；R2[39,64) 与 R3[64,66) Build0/static-placement；两个 unsupported Gate 各862 |
+| SOURCE_CHANGE | 67 | 888 | 888 | 0 | 基线已记录；**没有执行菜单手动 Source mutation** |
+
+- STATIC_RC 同帧失败全集汇总 CacheInvalid=870、revision-mismatch=871、placement-or-fade=780；PARTIAL_RCRR CacheInvalid=856。这些失败条件可能在**同一帧**并存，不能累加为帧数。即使修复缓存 Build，也还有 #22/#23 与其它独立 Gate。
+- 设备摘要 JSON（不纳入 Git）：artifacts/maplibre-particle/android-validation/step113/ 下的 pbf63-summary-ready.json、static-rc-summary.json、particle-off-summary.json、partial-rcrr-summary.json、source-change-baseline-summary.json。它们只是低频 summary，不是导出的完整 120 帧。
+- 仍 NOT VERIFIED：原 NavSea 113 层完整 Layer/Source/显隐及真实四段边界；实际 PBF/Sprite/Glyph 画面截图；Source 单次变更后前后对照；120帧手动详情导出；C++ GTest 运行；reset/后台、旧 STEP-102 场景回归；CPU/GPU/诊断开销；生产性能提升、正式发行。不得把部分结构等价当成现场复测或将 STEP-113 判为 CLOSED/PASS。
+- 下一阶段必须分别处理 retained first-build 的安全准入、unsupported continuous layer、unsupported scene；不能直接删除 Gate 放行。
+
+
+## RDC 第二轮设备验收（2026-10-11：完整窗口与Source变更）
+
+**本轮状态：设备逐帧诊断 PASS、单次Source变更链路 PASS，完整113层等价与生产优化仍 PARTIAL。** 本记录追加在原有RDC基线结果之后，旧内容中的“未执行单次Source mutation/120帧导出”是第一轮结束时的历史状态，不代表第二轮。
+
+1. 在设备 FZG1-2、ADB 192.168.200.139:5555、版本 13.6.1-particle.23 上运行 SOURCE_CHANGE；通过屏幕中的 STEP 093 → STEP-113 → EXPORT LAST SNAPSHOT，使用明确serial的 adb exec-out run-as 回读 App 私有JSON；文件字节分别为变更前 277980、变更后约272KiB。精确位置：artifacts/maplibre-particle/android-validation/step113/source-change-before-full.json 和 source-change-after-full.json，均保留在 Mac 本机、未纳入Git。
+2. 变更前 trace：lifecycle 1，attempts 13859，capacity/windowCount 120，最新119个完成的Full帧、0 Fast帧、最后1帧为pending、decisionMismatch=0；变更后 trace：同lifecycle，attempts 17476，windowCount=120，同样119个已完成Full、0 Fast、decisionMismatch=0。相同frame中前置状态 pre 的 placementBasis 标为上一完成RenderTree，post 完成Full才使用当前Full tree；knownMask覆盖24条Gate。
+3. 在 SOURCE_CHANGE 场景操作一次 MUTATE PROBE SOURCE ONCE。Logcat解码的 source-command：mutation=1；变更后导出 commands.sourceMutationCount=1；Native lastMutation.sourceId=step113-source-probe，affectedSegmentIndices=[1]，事件 TileMutation。变更前 lastMutation.sourceId=navsea_delivery，affectedSegmentIndices=[0]。累计 content-mutation Gate failure 从12变为14，但中间同时有正常瓦片更新，**不得把全部增量单独归因为这一次probe**。120帧环形窗口会覆盖发生瞬时变更时的精确帧，故本轮只确认命令/Native依赖定位，不声称捕获到单次Mutation帧的全部过渡时序。
+4. 从变更后120帧中统计119个 completed 样本：首错 cache-invalid=119/119；同一帧 Gate #3 cache-invalid=119、#4 revision-mismatch=119、#12 static-unstable=105、#13 placement-or-fade=105、#22 unsupported-continuous-layer=119、#23 unsupported-scene=119。24Gate shadow 对应生产首错持续吻合，decisionMismatch=0。该统计是窗口而非全应用时间的FPS度量。
+5. PBF同源核验：原始63层按SDK回读生产Style逐层定义保序、baseLayersPreserved=true；spec version=8，源Style名称 NavSea Delivery Full Semantic ExtentFix；productionFingerprintSha256=e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996（SDK回读序列化JSON，不是HTTP包字节）。SOURCE_CHANGE运行时67层，连续段[63,67)依次是 weather-color、raster-particle、测试circle、内建 org.maplibre.annotations.points symbol。STATIC_RC的连续段[63,66)同样包括内建annotation symbol。现有 continuousRangeSupportsParticleFastPath 要求其范围内**每一层**均支持 retained dynamic range；因此这些普通circle/symbol使Gate #22持续失败；这项结论为“源码判定+本机层清单”，未进行绕过Gate的运行实验。
+6. Gate #23 supportedScene 源码逻辑与 retainedSupported、fastContinuousSupported 及单C配置有关，**#22与#23不是根因完全独立的两次失败**；二者虽为不同Gate，却可能共享同一个不支持的C层根因。Retained R[0,63)仍持续 Build0、unknown-dependency；部分RCRR其它R也有static-placement。不能只消除C阻断就承诺Fast会成功。
+7. NavSea只读核对：当前src/map/particle/RenderSegmentHost.tsx 配置 R→C，从 rn-weather-color 开始；旧STEP-112的FZG1 113层RCRR_PREFIX属不同运行配置。同版本113个Layer的完整Source/ID/type/visibility/业务数据清单仍缺，不能把TEST-APP-STRUCTURAL的63/66/67层宣称为113层完整等价。FZG1-2存在debug NavSea安装，但**本轮未启动/修改NavSea用户数据**。
+8. Android设备截图已采集：artifacts/maplibre-particle/android-validation/step113/step113-source-change-screen.png（1920×1200），仅归档，未进行NavSea同版本逐像素比对。Mac Native GTest CMake配置尝试退出码1：缺少libuv（记录/tmp/particle-step113-macos-cmake.log）；未安装依赖，未进入GTest构建与运行，不记PASS。
+9. 后续受保护顺序：先由跨项目负责人获取NavSea同版本113层完整只读snapshot及真实selector；然后在Test App精准构造Layer/Source/顺序并获取120帧一对一同条件比较；分别建立R Build准入、C范围支持、Scene聚合依赖的源码及像素等价证明；通过后才能在Shared Core按受控范围修改Gate逻辑。禁止在证据不足时关闭 fail-closed Gate。RDC未在本轮运行新Android编译、改变渲染逻辑或做正式发行。

docs/报告/STEP-114_FastPath安全准入与TestApp闭环_Codex完成报告_v1.md

@@ -0,0 +1,134 @@
+# STEP-114 Fast Path 安全准入与 Test App 闭环 Codex 完成报告 v1
+
+日期：2026-10-11（JST）。
+
+## 1. 执行结论
+
+**PARTIAL：受控安全子集源码、独立最小场景与中文交付已完成；真实 Fast、编译和设备闭环未验收。Symbol R 准入 BLOCKED，CustomMVTVector 与非粒子 C 继续 fail-closed。**
+
+核心结果：完整场景无任何结构性 Symbol 时，全局 Placement controller 的 stale 单独不再阻止 #13；有隐藏/空Symbol或AnnotationSymbol时保持原判定。R缺源明确报missing-source，仍拒绝Build/Reuse，revision登记机制不变。独立FAST_SMOKE用现有安全GeoJSON/circle R + WeatherColor/Particle C及真实Native计数；另交付3个反向场景，不直接注入candidate或人工Frame结果。
+
+本机旧STEP-113 JSON明确navsea_delivery为普通Vector，R还依赖未在Native source表中的tide；不能把该unknown-dependency归因于CustomMVTVector。这项新事实已记录于调查，旧报告与正式PBF五场景不改。
+
+## 2. 实际模型、Git与版本
+
+- **GPT-6.1-Sol（gpt-6.1-sol）/ high**。实际从本机 `/Users/tei/.codex/sessions/2026/10/11/rollout-2026-10-11T09-44-12-01a1286a-d6a4-7e32-b91a-a9f3e63d8f3e.jsonl` 的最新 `turn_context.model/effort/cwd` 核实；未切换/升级模型，未启动子代理、另一实例或后台Codex。
+- Mac / Darwin 24.6.0 / x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 起点branch=`particle/main`，start HEAD=`b02e54de3d45fcf612126ae8f037cba204f590ea`；无分支/worktree变更，未commit/push，收尾HEAD保持起点。
+- 起点tracked clean；已有STEP-110/111/114三份未跟踪任务书。STEP-110/111原样保护，STEP-114只读不修改；暂存区未写。
+- `git submodule status` 起点全部空格前缀，无未初始化或偏移标记；未操作子模块。
+- Native/Test App=`13.6.1-particle.23`；没有改版本、RN公共方法/类型、Source Lock或发行。当前旧APK不包含本轮新源码。
+- Integration相关正式Contracts/RFC/ADR只读；任务提供main=`80667d6c343411d03a760425438e3d292f452118`采用既有RDC事实，没有同步/fetch/pull或远端回读，没有跨项目写入。
+
+## 3. 实际修改文件（tracked）
+
+| 文件 | 实际内容与影响 |
+|---|---|
+| `src/mln/renderer/particle_fast_path.hpp` | 内部结构检测helper；非空完整层表无Symbol才可忽略controller transition；生产24Gate evaluator与失败掩码未改 |
+| `src/mln/renderer/render_orchestrator.cpp` | #13输入按全场结构限定，层表数量不符保守；缺RenderSource先报missing-source；CustomMVT拒绝仍保留 |
+| `test/renderer/retained_underlay_cache.test.cpp` | 3个Step114FastPathSafety用例源码：无Symbol/其它Gate保护，隐藏/空/AnnotationSymbol保护，revision/cache注册/异步失效/全局失效状态机 |
+| `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/ParticleCoreLayerValidationActivity.kt` | 独立菜单/Intent/状态恢复、统一场景退出、诊断区域与前后台生命周期；原STEP-113菜单明确标正式PBF |
+| `粒子开发记录.md` | 仅末尾追加本轮中文状态与下一步 |
+
+## 4. 实际新增文件
+
+1. `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step114FastSmokeScene.kt`：独立离线FAST_SMOKE/3负场景，真实Native低频UI、操作前后文件、Source/Image/Camera/缓存/真实Annotation操作及Reload/生命周期取证。
+2. `docs/20_调查/STEP-114_FastPath安全准入与闭环判定_v1.md`：R/C/Placement控制流、旧JSON事实、mutation追踪、安全前提/反例及停止范围。
+3. `docs/60_测试/STEP-114_独立FastSmoke场景与RDC验收_v1.md`：场景说明、Mac精确定向命令、后续Android用户手工命令、实际JSON正向检查与反向/生命周期矩阵。
+4. `docs/50_Step记录/STEP-114_FastPath安全准入与TestApp闭环_v1.md`：已做/未做勾选、真实结果与待验收表。
+5. 本报告。
+
+用户提供的未跟踪STEP-114任务书不是本轮生成物。旧STEP-110/111未跟踪文件未修改/暂存；原STEP-113场景类与STEP-102 fixture未修改。
+
+## 5. 安全范围、兼容与零修改部分
+
+R准入/RevisionBook/GPUcache算法零语义修改；缺源只修正诊断原因。没有证明CustomMVT完整revision契约，保留其拒绝。普通Vector和GeoJSON不是CustomMVT，不混淆类型。独立GeoJSON子集现有sourceDiff/immutable signature/onTileChanged/资源epoch/key保护详见调查。
+
+非粒子C准入与Scene复合条件零修改，#22/#23保留。FAST_SMOKE独立Style在没有Annotation实例时移除其空内建layer；保留source，不改AnnotationManager。ANNOTATION_BLOCKED重新加载合法Style，保留内建layer并创建真实marker；不是生产零重载Annotation能力。原正式PBF五场景完整保留。
+
+Symbol R的Build gate、commit/fade、scene placementStable、全图碰撞、controller计算、资源链均零修改；无最终GPU输入结果证书，停止新增签名设计。#13改动只影响完整无Symbol场景；空表/数量不一致保守，有一个隐藏/空Symbol也按原transition阻止。尚未进入旧表的新layer被immutable signature、Annotation pending和其它原Gate保护。
+
+Shared Core没有平台分叉，没有新RN/JS/JNI控制API/ABI。既有可选诊断schema和24Gate顺序未改；缺源理由从模糊unknown-dependency变为已有理由missing-source是有意诊断差异。preFastPlacementTransition为本轮限定后的实际输入，post原始placementTransitionActive可能仍true；此差异不是shadow mismatch，也不是修改controller。
+
+风险/限制：Native与Kotlin未编译；FAST_SMOKE尚未实测；本地sceneReady不是Native运行PASS；自动短延迟采样可能漏瞬态；App私有快照文件随显式操作增长；性能/像素/GL与Metal差异未测。Future新Placement-capable类型须同步扩展结构检测，当前只有Symbol声明CrossTileIndex::Required。
+
+## 6. 与任务书差异与停止点
+
+按步骤完成源码审查与可安全范围实现；任务允许PARTIAL。没有危险地放行CustomMVT、Annotation C或Symbol R，也没有复刻NavSea113层。R cache正向利用现有已支持GeoJSON，不新增未证source准入。新增无Symbol场景#13限定是调查中确认的安全局部修复；缺源更准确诊断使真正失败点可见。
+
+真实Fast/反向/lifecycle闭环仍待执行。Symbol R结果证书需要更大跨平台设计，列BLOCKED；若涉及公共语义/API，回Integration RFC，不自行扩改。任务允许改测试源但禁止Codex运行编译/测试，遵守该边界。
+
+## 7. 精确定向 RDC 验收命令
+
+下面只交RDC/普通Terminal执行。进入仓库后逐项执行，任何失败立即停止链，保留完整日志，不用旧runner；带完整退出码保护的可复制脚本在测试说明第2节。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+cmake --preset macos-metal
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+build-macos-metal/mbgl-test-runner --gtest_filter='Step114FastPathSafety.*:FastGateTrace.*:ParticleFastPath.*:RetainedUnderlayCache.*:RetainedUnderlayRevision.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*:RenderSegmentDiagnostics.*:RenderOrchestratorError.*:RenderOrchestratorTeardown.*:ImageManager.*:GlyphPBF.*' --gtest_color=no
+```
+
+renderer=Metal，Debug preset，parallel=3，target仅mbgl-test-runner。记录命令/exit/耗时/log路径/实际用例数量/skipped；新增3个Step114用例必须被发现并执行。STEP-113缺libuv的配置失败日志仍是既有证据，本轮未再次配置、未安装依赖；若仍失败，保留首错并记BLOCKED，不能宣称测试通过。
+
+Android由用户后续一次手工运行 `./tools/particle_android_validation/build_validation_apk.sh`；其后手工安装/启动/取证命令逐条见测试说明第3—5节，固定serial=`192.168.200.139:5555`。入口Intent=`--es step114_scenario FAST_SMOKE`，三个负场景名为CIRCLE_C_BLOCKED/ANNOTATION_BLOCKED/SYMBOL_R_BLOCKED。完整快照为App files/step114-*.json；保存source/image/camera/cache动作前、提交后、100/500/1500ms证据。Codex没有执行这些命令。
+
+## 8. 已执行检查与未执行验收
+
+已执行：前置规范/任务/实际源码阅读，Git branch/HEAD/status/submodule只读；本地当前rollout模型字段核实；保留的STEP-113JSON解析、SourceType与缺tide取证；无构建静态函数/范围/哈希/追加完整性核对；tracked及新增文件空白检查。
+
+**NOT RUN**：CMake/Ninja/Bazel/Native编译链接、C++测试、Kotlin编译、Gradle/APK/AAR、ADB/安装/logcat/截图/设备、Jest、性能/GPU/像素对照、iOS实机、发行、commit/push/远端HEAD。没有本轮编译/测试失败日志，也不能据此推断会通过。3个新增C++用例是源码交付，不是运行PASS；状态机markBuildSucceeded不是GPU成功证据。
+
+静态检查的最终实际结果与保护哈希在第12节记录。终态仍有本轮tracked/untracked改动，未暂存、未提交。
+
+## 9. 产物
+
+实际产物仅源文件、测试源、四份中文文档与开发记录追加。无本轮APK/AAR/XCFramework、版本/SHA、构建/设备日志或运行截图。artifact目录的STEP-113JSON属于旧RDC证据，本轮只读未修改，不作为本轮新产物。
+
+## 10. 剩余阻塞与未完成事项
+
+| 项目 | 状态/原因 |
+|---|---|
+| 独立smoke真实Fast | 未验证；必须NativeFull/Fast/Build/Reuse及24Gate和截图共同证明 |
+| Mac配置/编译/测试 | 未执行；旧libuv阻塞是否仍存在未知 |
+| Android编译与设备闭环 | 未执行，留用户一次手工统一验收 |
+| Source异步变化/资源/camera/cache/Reload/前后台/销毁 | 已有源码和精确取证入口，运行证据待执行；捕获失败不可假称安全反向PASS |
+| Glyph实际结果/资源失效 | 未新增TestApp glyph控制；无Symbolbaseline不含glyph像素；现有资源回归不能代替Symbol证书 |
+| Symbol R首次Build | BLOCKED；commit/fade没有充分稳定结果证书，不做危险简化 |
+| CustomMVT/非粒子C | fail-closed；无完整revision/复合等价证明 |
+| PBF缺tide/大量Symbol | 缺源诊断已清楚，原数据/业务层不改；不承诺生产Fast |
+| iOS/Metal设备与CPU/GPU收益 | NOT VERIFIED；不以Android或Mac状态机结果替代 |
+
+## 11. 独立验收证据与后续
+
+RDC先核对本报告/调查/源码diff与安全前提，再跑Mac定向命令；用户后续统一Android。baseline必须真实4层与R[0,2)/C[2,4)，至少一个completed fast-rendered、knownMask=0xffffff/failMask=0、decisionMismatch=0、cacheInputs valid/revision相等，Full>0、Build>0、同生命周期Fast/Reuse delta>0；同时截图确认Rcircle/天气/粒子及反向重建正确。测试说明含读取真实JSON的断言。
+
+负场景必须继续阻止Fast并正确显示/更新内容；Source/Tile/Image/Camera/缓存禁用/Reload/前后台/Teardown、旧PBF5场景及STEP-102独立回归仍需日志/快照与可见结果。只见Fast数字不等于安全/性能PASS。若未达真实Fast维持PARTIAL，失败保留现场再返回受控修复。
+
+本轮禁止Git提交/push；后续达合理门槛且获授权后RDC仅scoped提交本轮明确路径并核对origin远端HEAD。不得含原STEP-110/111，不发行，不自行创建后续Step。
+
+## 12. 收尾静态事实
+
+- `git diff --check` 退出0；五个tracked修改路径，无其它tracked修改。四份新中文文档与新Kotlin文件各执行no-index空白检查，无诊断；Markdown代码围栏成对。
+- 生产`evaluateParticleFastPath`和`particleFastGateFailureMask`与HEAD提取的完整函数逐字相同；C范围准入、R全局/局部稳定性函数逐字相同，CustomMVT拒绝分支仍在。3个新增用例仅核对源码数量，未运行。
+- 原`Step113PbfGateScene.kt`与HEAD字节相同，SHA-256=`6e7befeb90ae172aaeff4b636a7640274dfb1065d8c97744cbc6af8d22b4ccae`；`Step102PlacementFixture.kt`同样未变，SHA-256=`e44912970dd6353787be7a3e5f9924fe1249e2305d495f1e25e707352c97d3c7`。
+- 开发记录的HEAD原始162365字节前缀完整保留，原SHA-256=`0479875a30577cb497b973f89a0d74b3b8b8d300d5dfb683ed3a537749b37b3f`；仅9行/1583字节追加。
+- STEP-110 SHA-256=`33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`，STEP-111=`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`，与既有保护值相同；本次任务书只读SHA-256=`415c20df0e8d514b68dfa79cd6d9394e4c6d2c4f215c402d9a4a365862c87cfc`。
+- 旧RDC完整`source-change-after-full.json`只读SHA-256=`24a06fa1cb072a628c650723c58a880895ec656f4972fa55d3cb064bfb2aabda`；本轮新场景需要的两个cycle各metadata.json/field.f32已静态确认存在。
+- 一次用Python stdin追加中文记录的尝试因UTF-8源码解析退出1，未写文件；随后用apply_patch完成追加。最终原前缀核对通过。这是工具文本编码失败，不是构建/测试失败。
+- 终态`particle/main@b02e54de3d45fcf612126ae8f037cba204f590ea`；`git diff --cached --name-only`为空。status为本轮5个tracked修改、5个新增文件，以及原有STEP-110/111/114三任务书；未commit/push/回读远端。
+
+以上只证明静态一致性、范围与保护文件完整性，不作为Native/Kotlin编译、GPU/Fast或全任务PASS。
+
+
+## RDC 独立审核追加（2026-10-11）
+
+**结论：源码/差异/接口静态审核 PASS；Native 与 Android 编译、Fast 帧 NOT VERIFIED；整体 STEP-114 PARTIAL。**
+
+- RDC 独立阅读本轮 Native diff、C++ 新用例、STEP-114 Android Test App 新场景与菜单、生命周期接线；git diff --check 退出码 0。本轮只有范围内的五个 tracked 改动和新增 Kotlin/中文文档；原 STEP-110/111 未跟踪任务书不修改、不暂存。
+- 新增三项 Step114FastPathSafety 用例存在，覆盖无 Symbol、隐藏/Annotation Symbol 和 Source revision/cache 状态机，但**没有实际运行**。
+- Step113PbfGateScene.kt SHA-256 为 6e7befeb90ae172aaeff4b636a7640274dfb1065d8c97744cbc6af8d22b4ccae，Step102PlacementFixture.kt SHA-256 为 e44912970dd6353787be7a3e5f9924fe1249e2305d495f1e25e707352c97d3c7，均未变化。
+- Java SDK 只读核对实际提供 Style.removeLayer(String) 与 MapLibreMap.getAnnotations()。Kotlin/Gradle 编译未执行。
+- Mac 预检：pkg-config --exists libuv 返回 1，与先前 macos-metal CMake required libuv 失败一致。独立 C++ header -fsyntax-only 试验退出码 1，首错为 Xcode AppleClang 找不到标准 C++ 头文件 array，实际在进入项目源码检查前终止。日志存于 Mac /tmp/step114-header-check.log。两项均是环境阻塞，不是本轮 Native 测试 PASS 或已证明代码错误；未安装/修改依赖。
+- 实际 Fast Path 命中、正反 GPU 渲染、Android 设备、性能、iOS 均未验证。正式 PBF 仍有 tide 缺源、Symbol R Placement、内建 Annotation C 的阻断。STEP-114 独立最小场景属于待用户一次 Android 手工构建集中验收内容，不能用旧 APK。
+- 后续 scoped Git 收尾若执行仅表示 PARTIAL 源码及测试入口已归档，**不代表正式发布或 Fast Path 修复完成**，不打 Tag/Source Lock。

docs/报告/STEP-116_STEP113原PBF_FastPath实际修复_Codex完成报告_v1.md

@@ -0,0 +1,112 @@
+# STEP-116 STEP-113 原 PBF Fast Path 实际修复 Codex 完成报告 v1
+
+日期：2026-10-11（JST）。**源码交付 PARTIAL；原 STATIC_RC Fast 未实测，缺 tide 与 Symbol R 准入仍 BLOCKED。已按授权完成可控修改后停止，交 RDC 独立审计。**
+
+## 1. 实际模型与工作区
+
+- 实际模型全名 **GPT-6.1-Sol（gpt-6.1-sol）/ high**。读取本地会话 `01a1286a-d6a4-7e32-b91a-a9f3e63d8f3e` rollout 的 `turn_context.model/effort` 得到 gpt-6.1-sol/high；未切换模型、无子代理或第二Codex进程。
+- 机器 Darwin 24.6.0 / x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`，branch `particle/main`。
+- 起点/交付HEAD：`e2d202b560ad0165101546597c43f2ef0ccf4542`，未commit/push，未回读远端HEAD。起点tracked clean，STEP-110/111/116任务书未跟踪；子模块状态正常，未操作。
+- Android Native版本仍 `13.6.1-particle.23`。没有新APK/AAR，不能使用原STEP113 APK代表此次源码。
+- Integration main `80667d6c343411d03a760425438e3d292f452118` 采用用户给定RDC事实，只读AGENTS/规范/contract/coordination；没有NavSea/Integration写入、同步或发行。
+- 已读强制前置：根AGENTS/PARTICLE_BASELINE、全部项目规范、总则README及四份有效总则、STEP112/113/114/115现行交付及STEP116任务、相关实际实现和保留完整JSON。详细范围见调查文件。
+
+## 2. 已实现 / 阻塞 / 未运行
+
+| 项目 | 状态 | 结果 |
+|---|---|---|
+| 空SDK Annotation C | 已实现（Implemented），未验收 | STATIC_RC确认零实例/内部身份后仅移除一次points，保留Source、原63层；stop恢复，后续添加/Style替换撤销验收条件 |
+| 后续真实Annotation不漏内容 | 已实现，未验收 | 私有ensurePointLayer在Native Symbol add/update及style-loaded同步恢复缺层；no-op update也dirty，在Map::onUpdate采样前完成，poll只报告，不承担恢复时序 |
+| 缺源R | 阻塞（Blocked） | tide-spots依赖不存在tide；缺已执行GPU零贡献证书，不实现empty准入，维持missing-source |
+| Symbol R Build | 阻塞 | Continuous重算changed、不重算stale两分支均阻断；无最终GPU/Placement/atlas等证书，不放宽Gate |
+| 诊断/原生计数 | 已实现 | 可选missingSourceIds、独立Placement状态、真实Fast UI；24Gate及生产首错/计数不改 |
+| STEP115复测工具 | 已实现，未运行 | tracked源码锁定；PID后实际≥75秒等待；同生命周期/24Gate/blocked撤销/计数reset拒绝，仍校验APK与设备SHA |
+| C++测试源码 | 已实现，未运行（Not Run） | 四个Step116Safety账本/诊断/保守Gate用例，三个Annotations.Step116真实渲染回归 |
+| 真正原PBF Fast、视觉/性能 | 无法验证 | 没有新构建、设备120帧或Fast增长，不写Closed/PASS |
+
+未删除tide-spots、SOURCE_CHANGE circle、任何正式Symbol；没有改FPS/forecast/原PBF URI、Core C准入、Placement算法、cache成功计数或制造Fast。STEP114独立Smoke和STEP102 fixture未修改。非STATIC_RC四场景保留原Annotation语义；所有场景共享的Native Annotation修复仅在缺Source/points时补回，已有Layer不替换。
+
+## 3. 实际文件清单
+
+修改的源码/测试/工具：
+
+1. `src/mln/annotation/annotation_manager.cpp`：缺失points的同步恢复与no-op更新dirty。
+2. `src/mln/annotation/annotation_manager.hpp`：仅私有ensurePointLayer方法，无数据布局变化。
+3. `src/mln/renderer/render_segment_json.hpp`：同snapshot的每段missingSourceIds只读诊断。
+4. `platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step113PbfGateScene.kt`：STATIC_RC空辅助层一次调整、恢复/撤销、manifest及独立阻塞摘要。
+5. `test/api/annotations.test.cpp`：三项实际出图/恢复/不覆盖/reload测试源码。
+6. `test/renderer/retained_underlay_cache.test.cpp`：四项缺源/async revision/资源全局/保守Symbol/多Gate诊断测试源码。
+7. `tools/particle_android_validation/verify_step113_fast_path.py`：时长和拒绝条件；本轮没有执行脚本。
+8. `tools/particle_android_validation/README.md`：更新当前复测边界并追加STEP116说明。
+9. `粒子开发记录.md`：仅末尾追加本Step。
+
+新增四份中文文档（不覆盖历史版本）：
+
+1. `docs/20_调查/STEP-116_STEP113原PBF_FastPath阻塞安全修复审查_v1.md`。
+2. `docs/50_Step记录/STEP-116_STEP113原PBF_FastPath实际修复_v1.md`。
+3. `docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md`。
+4. 本报告。
+
+**公开API/ABI与控制协议不变**：无include公开头、C/Java/Kotlin/RN/JNI方法签名、公共配置、版本/发行坐标变更；新增私有方法不改AnnotationManager成员布局。现有可选诊断JSON每段增加missingSourceIds，Test App私有summary增加诊断字段；这是任务授权的观测扩展，不新增Host控制协议或准入契约。
+
+## 4. 静态结果与保护证据
+
+已经执行：仓库/branch/HEAD/status/submodule只读核对；前置文档及源码阅读；保留JSON解析和SHA；diff人工审查、Python AST解析（没有导入/运行脚本）；git diff --check、新增文档空白/围栏和范围检查。最终结果见文末静态收尾。静态检查不等同C++/Kotlin编译或测试通过。
+
+未执行：Native/CMake/Ninja/Bazel、链接/codegen/测试程序、Gradle/APK、ADB/安装/Logcat/设备截图、Jest、性能测量、commit/push/远端回读、发布。没有观察到新编译/测试失败，因为未执行；不能推断将通过。
+
+保留旧JSON SHA=`24a06fa1cb072a628c650723c58a880895ec656f4972fa55d3cb064bfb2aabda`。
+
+- STEP-110未跟踪文件 SHA=`33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`。
+- STEP-111未跟踪文件 SHA=`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。
+- STEP102 Placement fixture SHA=`e44912970dd6353787be7a3e5f9924fe1249e2305d495f1e25e707352c97d3c7`。
+- STEP114 FastSmoke源码 SHA=`94c28a111883fa784b0d9d81515c9e7ce7232d77a51eab48b4954705f1a39eb0`。
+
+这些文件保持原样；保护任务书未暂存，开发记录原HEAD字节前缀保留。先前探索个别猜测路径不存在后，均按rg找到真实src/mln路径，未将不存在路径当证据或创建替代文件。
+
+## 5. 精确定向交接
+
+完整、按失败停止的命令和证据结构位于 `docs/60_测试/STEP-116_STEP113原PBF专用APP验收_v1.md`。必要顺序：
+
+1. RDC只读审计diff/七项测试、线程和安全边界，按独立授权scoped锁定本轮源码；不得包含保护任务书或无关文件。
+2. RDC Native：`cmake --preset macos-metal` → `cmake --build build-macos-metal --target mbgl-test-runner --parallel 3` → 定向filter `Step116Safety.*:Annotations.*:FastGateTrace.*:ParticleFastPath.*:RenderSegmentDiagnostics.*:RenderSegmentPlacementFree.*:RenderSegmentLocality.*:RenderSegmentPlan.*`。首项失败即停，不用旧runner。
+3. 用户在最新锁定HEAD手工一次执行标准 `./tools/particle_android_validation/build_validation_apk.sh`，再明确serial手工 `adb install -r`，记录build-info/APK/安装SHA。
+4. RDC/用户：`python3 -B tools/particle_android_validation/verify_step113_fast_path.py --preflight-only`，成功后 `--scenario STATIC_RC --seconds 90`；默认serial为192.168.200.139:5555。版本/源码锁不符停止。
+5. 用户手动EXPORT LAST SNAPSHOT，RDC回读完整120帧，核对24Gate/mismatch0/pre-post、原63层/Source/空层manifest、真实Build/Reuse/Full/Fast；用户画面及安全回退单独验收。
+
+预期仍有missing-source/Symbol阻塞。即使C空层修复成立，仍不得保证#23、R Build或Fast成功。缺源empty需要GPU排除/资源时序证据，Symbol需要绑定成功Full/Build的结果证书；当前任务授权不足以通过危险跨层重写弥补这两项。收到真实RDC编译/测试错误后按固定闭环修复，本轮停止于实现交付。
+
+## 6. 实际静态收尾
+
+- `git diff --check` 退出0，无空白诊断；四份新文档逐份 `git diff --no-index --check /dev/null <明确路径>` 无诊断，围栏成对；验收文档bash代码块仅以 `bash -n` 解析，内嵌Python和复测工具仅AST解析，没有执行命令正文或导入工具。
+- 9个tracked文件修改，统计308行新增/12行删除；另有本轮四份文档新增。起点三份未跟踪任务书仍未跟踪，暂存区为空，branch/HEAD保持原值。
+- 开发记录HEAD原始164685字节前缀完全保留，原SHA=`0adbe3fbe366651e3a79369dbf13d2e494a2b4545e29efaad72b299b43d2f4dd`，仅追加1440字节（8行）。
+- 已逐字与HEAD比较：生产 `particle_fast_path.hpp`、公开 `render_segment.hpp`、`renderer_impl.cpp`、`render_orchestrator.cpp` 和 Activity接线完全未变；STEP110/111/102/114冻结SHA与上节相符，旧完整JSON也未修改。测试源码实际新增7个用例。
+
+本轮实现与测试源的交付SHA-256（独立审计后若修正，应重算并记录，不能沿用此表冒充新源码）：
+
+| 文件 | SHA-256 |
+|---|---|
+| Step113PbfGateScene.kt | d50281713ae551edc9a48b1550254602e4950c9ddca66855bb689620c9f6f2b6 |
+| annotation_manager.cpp | 6e0faf6ab585362bfb1ee4d6e79163390041295331d7c8c652156963318bfe6a |
+| annotation_manager.hpp | a4c18d12a12dd4be3ddca7c667e9c45da8a57d6108956e605e1e4fe0796932c0 |
+| render_segment_json.hpp | 9c1fa02fa0e7a2eccf4aeb8fe346913fb87b62258c662c303db087399cf9ca1d |
+| annotations.test.cpp | b316c23c557a46f819895b7ea74a415ff5c833d0751521c28a5dd8251166daf6 |
+| retained_underlay_cache.test.cpp | cc1d26540008df3b74cc97fa13e54e77092f2edb596d4c8c56d7a15504bdb109 |
+| verify_step113_fast_path.py | 87a797eee0e907078cd8f49dbceb83dd3affda9b00c51cc691c1f4c553eb705e |
+
+以上只证明交付范围和静态一致性，不证明Native/Kotlin可编译、测试通过或Fast安全。编译、设备、像素及性能仍全部未验收。
+
+
+## RDC 独立核验追加（2026-10-11）
+
+**本轮结论：限定范围源码/接口及操作说明静态审查完成；Mac Native配置 BLOCKED；Android APK/设备Fast NOT RUN，整体PARTIAL。**
+
+- 起点粒子仓库 particle/main=e2d202b560ad0165101546597c43f2ef0ccf4542；Integration origin/main已由RDC fetch并与本地main同步，HEAD=80667d6c343411d03a760425438e3d292f452118。未接触NavSea与Integration正式文件。
+- Codex实际模型 gpt-6.1-sol/high；本轮实现仅原STEP-113 STATIC_RC 的 SDK 空Annotation辅助层、Native AnnotationManager缺层恢复、缺源只读JSON诊断和测试验证器，不改变正式63个PBF layer、原五场景其他分支、Fast Gate/caching的准入或公开控制面。新增7项非Jest C++用例源码，尚未执行。
+- RDC直接核对 Android Style.java 对象removeLayer(Layer)文档明确注明被移除Layer可以重新添加；与STEP116在stop中恢复原wrapper的目的相符。Native AnnotationManager恢复与事件生命周期仍须编译、图像和设备验证，不凭静态阅读标PASS。
+- RDC核对旧SOURCE_CHANGE实际完整JSON：Native FastGate gates每项有order，firstFrame的knownMask等字段存在；STEP116验收脚本的原JSON结构检查有数据来源，但并非本轮运行证据。
+- Mac shell当前无rg可执行，RDC将STEP116手动导出命令中的rg替换为标准grep -E，保留同样的文件筛选表达式。Python验收器ast.parse通过，git diff --check通过。
+- Mac Native按当前标准命令重新执行真正的cmake --preset macos-metal配置（使用/Users/tei/Library/Android/sdk/cmake/3.31.6/bin/cmake），退出码1：Required package libuv缺失，日志保存artifacts/maplibre-particle/step116-native/configure.log。严格串行停止，未执行构建目标、未运行7项C++测试。失败是环境依赖，不应改写成代码编译通过/失败或跳过继续。
+- 未执行Android Gradle、APK安装、ADB启动STEP113、新Fast计数、逐帧画面、iOS Metal回归、发行/tag/Source Lock。正式PBF缺tide以及Symbol R Placement仍保留fail-closed；此任务只是安全部分实现，并不解决原STATIC_RC无法进入Fast的全部原因。
+- 用户在本轮源码scoped Git锁定且push远端核验后，需手工一次集中Android编译与install -r，再执行STEP115同HEAD/安装SHA预检、原STATIC_RC 90秒、完整120帧+24Gate+截图与其它负场景验收。新APK前禁止把旧c6d13e1产物Fast0作为本轮修复验收。若仍Fast0，必须保留缺源、Placement和C实际结果并交跨平台Core负责人确定GPU结果证书。

docs/报告/STEP-117_原PBF_Fast缓存准入_Codex完成报告_v1.md

@@ -0,0 +1,93 @@
+# STEP-117 原 PBF Fast 缓存准入 Codex 完成报告 v1
+
+日期：2026-10-11（JST）。**结果：BLOCKED。缺tide零GPU贡献与Symbol首次Build均未获得充分安全证据，保持fail-closed；已完成源码调查、原120帧复核、七项非Jest回归源码及全部中文交付。原PBF Fast目标没有完成。**
+
+## 1. 实际模型、环境和版本
+
+- 实际 **GPT-6.1-Sol（gpt-6.1-sol）/ high**，读取当前会话rollout `01a12912-9a0c-7712-9624-793f04b3f681` 的turn_context.model/effort确认；未升级、切换、启动子代理或第二Codex。
+- Mac.lan / Darwin24.6.0 / x86_64；仓库 `/Users/tei/dev/MapLibreParticleLab`；branch `particle/main`。
+- 起点/交付HEAD `43e5f5b91598b9c3d3f1c788052d4bbd2d616668`；无commit/push、无远端回读、无分支/子模块操作。起点tracked clean，三份未跟踪任务书STEP110/111/117保留。
+- `platform/android/VERSION=13.6.1-particle.23`，未改公开版本/发行/Source Lock；本轮没有APK/AAR/XCFramework。
+- Integration本地只读HEAD `80667d6c343411d03a760425438e3d292f452118`；只读instructions/contract等规范，无跨仓写入、同步或向他人发送消息。
+
+## 2. 根因与停止点
+
+原实机JSON SHA `cd491d2acca97119f1d4f2d6f77eb7b229c17b90d4be1181a59202308429b219` 已完整解析并逐帧复算。STEP116的90秒FastDelta=0、FullDelta=920是保留实测。本轮复核120帧为119Full/0Fast/1pending；#3/#4/#23各失败120、#12/#13各105、#22为0、mismatch0。原63层和C两天气层保留，R仍缺tide、Build/Reuse=0。
+
+**缺源**：缺source没有新LayerRenderItem，但RenderLayer的停用只排队RemoveGroup；processChanges执行后才退出registry，停用并不清旧drawables/tiles/placementData。原JSON无双group/旧数据排除与成功提交代次；不能把absence登记为loaded/stable或伪造revision。保持missing-source。
+
+**Symbol**：pre有105帧changed=false/fade非零/transition=true及15帧true/0/false，post104+15。正常Continuous重算必changed，recent必stale；duration0/禁用transition也不能建立结果证书。per-R Build及retainedSupported/preparedScene各有独立保护，layer fingerprint只含Impl指针/index，缺opacity/dynamic attributes/atlas/collision/uniform等最终GPU状态。建立完整证书需要跨Placement/Bucket/Drawable/Atlas/Renderer生命周期实现与平台证据，本轮按任务停止该部分，所有Gate保持。
+
+调查文件给出源码链、已成立/未成立证据、反例和B1–B4协调需求。任务明确允许证据不足保持fail-closed；没有以既有烟测或测试进程代替正式目标，也没有把研究完成称为实现完成。
+
+## 3. 实际修改文件及接口边界
+
+修改：
+
+1. `test/renderer/retained_underlay_cache.test.cpp`：新增4项Step117Safety，实际Controller/Placement生命周期、disabled/zero duration、缺源墓碑与恢复的cache状态机、camera/viewport/content/topology/config失效。
+2. `test/renderer/render_orchestrator_error.test.cpp`：新增3项Step117Safety，实际createRenderTree/sourceDiff、registry RemoveGroup队列、Tile/Glyph/Image回调与context/style清理；仅扩展已有测试friend结构的enqueue辅助，不改生产头文件。
+3. `粒子开发记录.md`：只追加STEP117记录。
+
+新增：
+
+1. `docs/20_调查/STEP-117_PBF_R首次缓存Build安全证据_v1.md`。
+2. `docs/50_Step记录/STEP-117_原PBF_Fast缓存准入_v1.md`。
+3. `docs/60_测试/STEP-117_FZG1_原PBF真实Fast验收计划_v1.md`。
+4. 本报告。
+
+生产src/include/Shader/Android/RN/JNI/API/ABI零修改；没有新增诊断字段/控制协议、源状态或新的准入bool。test/CMakeLists.txt已登记两个测试文件，无需修改构建表。原Step113PbfGateScene、原五场景/SOURCE_CHANGE、STEP116空Annotation修复、STEP102/114入口、旧测试断言均保留。没有测试App假tide，没有删除正式tide-spots或Symbol。README无运行入口变化，本轮无需修改。
+
+## 4. 七项测试的准确状态
+
+`Step117Safety.*` 七项全部 **NOT RUN / NOT COMPILED**，没有GTest成功日志。Controller与sourceDiff/observer/registry测试调用真实实现；空桶、无数据step117-source与两个测试group是最小生命周期fixture，不能当作原PBF像素/旧GPU资源证书。显式markBuildSucceeded仅属于cache状态机fixture，不是GPU成功；observer在测试线程注入，不代表真正异步网络并发。
+
+尚缺完整Renderer首次Build与提交证书、跨source/跨段collision、真实glyph/atlas延迟、曾渲染后缺源的旧Drawable清理、Full/Fast像素对照和设备恢复。既有Annotations.Step116实际图像测试保留，新增tracker测试不冒充真实Annotation设备验证。
+
+## 5. 已执行与未执行检查
+
+已执行：前置文档和实际源码读取；本机branch/HEAD/status/submodule与Integration本地HEAD只读核对；原JSON SHA/结构/120帧逐项Gate及pre/post统计复核；静态API/变更范围、测试登记/签名/生命周期人工核对；git diff --check、中文文档和开发记录/保护文件完整性核查。最终具体收尾结果见第8节。
+
+未执行：任何Native/CMake/Ninja/Bazel编译/链接/codegen/GTest、Gradle/APK、ADB/安装/运行/设备logcat/截图、Jest、iOS/Metal设备、性能或像素测量、commit/push/远端HEAD、发布。未观察到新编译/测试失败，因为根本未运行；不能推断会通过。历史Mac缺libuv是STEP116 RDC事实，本轮没有重跑或修依赖。
+
+## 6. RDC接手与具体协调需求
+
+1. RDC独立审查本报告、调查、diff及七测试。按验收计划逐项运行Mac Native定向命令，首错即停，报告实际匹配7项的数量/结果；不使用旧runner。
+2. 粒子负责人协调Shared Core：缺源absent依赖绑定已应用双group排除、旧Renderable数据与成功提交代次；Symbol结果证书先影子比较，覆盖collision/opacities/vertices/atlas/uniform/camera/context/异步纪元。没有证书维持BLOCKED，不修改Gate迎合计数。
+3. Integration协调正式Style/Host tide是否为真实动态注入、加载与身份语义；不在此仓库改服务器/造数据。公共责任/错误语义改变才提交RFC/ADR；内部优化可以平台中性实现，无需凭空扩大公共合同。
+4. 后续受控实现完成、RDC审计与源码锁定后，按用户明确授权执行一次标准 `./tools/particle_android_validation/build_validation_apk.sh`、install -r、同HEAD/设备SHA预检、原STATIC_RC至少90秒、完整120帧24Gate与Mutation/用户画面验收。没有生产改动时重建本轮测试源码不能解决Fast0。
+
+精确命令与证据矩阵在 `docs/60_测试/STEP-117_FZG1_原PBF真实Fast验收计划_v1.md`。不由Codex运行，不以STEP114 FAST_SMOKE代替。Native编译与测试、Android SHA、真实Build/Reuse/Fast、用户视觉和安全回退分别判定，不把单项成功写成全任务PASS。
+
+## 7. Git/制品待回填项
+
+本轮不commit/push，提交message/hash不适用；远端HEAD未核验。RDC若后续获授权，只按第3节七个明确任务路径scoped提交（任务书是否纳入另按授权），不得包含STEP110/111、其他dirty/untracked或Git忽略JSON。普通push后回读 `origin refs/heads/particle/main` 并与实际提交核对。
+
+Native runner来源/日志/exit/耗时、Android构建源码HEAD/制品SHA/设备SHA、独立Fast/视觉验收均为“待RDC回填”，不提前填成功或借用旧c48a72a9来源。
+
+## 8. 静态收尾结果
+
+- `git diff --check`退出0，无空白诊断。tracked差异只含第3节两个测试文件和开发记录，新增356行、删除0行；四份新文档逐个执行`git diff --no-index --check /dev/null <明确路径>`，无空白诊断，exit1仅表示与空文件有差异。
+- 七项`TEST(Step117Safety, ...)`源码名称唯一，两个文件在现有test/CMakeLists.txt登记；原文件diff只有插入，原测试代码及断言没有删除或替换。人工核对当前UpdateParameters成员顺序、Placement/observer/sourceDiff相关声明，以及测试source销毁前detach与排空scheduler；未作编译，因此不能据此保证测试可执行。
+- 生产Renderer/Orchestrator/Placement/particle_fast_path/render_segment_json/render_segment公开头、AnnotationManager和STEP113/114场景与HEAD字节相同。原Step113PbfGateScene SHA=`d50281713ae551edc9a48b1550254602e4950c9ddca66855bb689620c9f6f2b6`。全部tracked修改路径不含src/include、公共API/ABI或Android；24Gate、计数与正式场景保持。
+- 开发记录原HEAD的167,048字节前缀完整，原SHA=`8544702389dab5d829afe145dd5e7cd23083992a887b5fc4857a8b57f468cf8a`；本轮仅追加2,252字节/10行。
+- STEP110未跟踪MD SHA=`33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`；STEP111=`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`，保持原值且仍未跟踪；暂存区为空。
+- 四份新文档中文正文/成对代码围栏/空白核对完成；验收计划内Python只做AST解析，没有运行其中命令。原274,693字节JSON SHA未变、仍Git忽略，120帧24Gate失败数逐帧与聚合相符，pre/post所有R的Build/Reuse=0、placementGatePassed=false。
+- 静态审计脚本曾分别因Git中文路径转义和pre/post中cache字段为扁平序列化而中止。随后改为`--name-only -z`读取真实路径，并按原JSON扁平build/reuse字段复核；没有修改证据、测试断言或验收阈值。修正后的范围/证据审计完成。这两次是审计读取错误，不是C++编译/测试结果。
+- 终态HEAD保持`43e5f5b91598b9c3d3f1c788052d4bbd2d616668`；status只有三个tracked修改、四份新交付文档及起点三份未跟踪任务书。未commit/push，独立RDC验收尚未开始。
+
+以上只证明静态范围与文件完整性。安全准入仍BLOCKED，Native/Android测试未运行，真实Fast/像素/性能目标没有通过。
+
+
+## RDC独立核验附录（2026-10-11）
+
+- RDC先核对Integration main=80667d6c343411d03a760425438e3d292f452118、Particle当前particle/main=43e5f5b91598b9c3d3f1c788052d4bbd2d616668；源码与git已跟踪改动起点为空，仅两个用户保护未跟踪任务书。
+- 用户本轮要求继续真实STEP113 PBF Fast优化，Codex实际GPT-6.1-Sol High。调查原STEP116实机120帧JSON，缺tide Source以及Symbol placement重算/stale循环仍无法安全创建首次GPU缓存；已有证据只能证明无新的LayerRenderItem，不能证明旧GPU drawables/已经应用的双LayerGroup删除。保留既有24Gate/生产Core，安全准入BLOCKED。
+- Codex新增7个Step117Safety C++测试源码，分布于两个既有登记的test/renderer文件；RDC独立对两个最终文件以当前Android OpenGL/x86_64的NDK clang++、真实compile_commands.json C++20 flags和googletest头文件进行-fsyntax-only。retained_underlay_cache.test.cpp exit0（6.3s），render_orchestrator_error.test.cpp exit0（5.3s），RDC检查结果PASS。语法检查日志存Git忽略artifacts/maplibre-particle/step117-native-syntax/*.log。
+- RDC核查原生产src/include/Renderer/Placement/Fast Gate、Android STEP113/114及Source/style均无文件改动，git diff --check通过。故**没有新的运行时改动供Android APK验证**：重复编译/安装STEP116相同行为的APK不能使Build/Reuse/Fast改善，未触发第二次高成本Android周期。GTest链接运行、GPU像素等价、iOS/Metal、真实Fast目标仍NOT RUN/BLOCKED，不能将NDK语法退出0标为GTest PASS。
+- Integration正式现有RFC/ADR/Contract/status/coordination未包含所需R Symbol已提交GPU结果证书。B1缺源零贡献、B2 Symbol跨层结果证书与影子验收、B3真实tide Source身份/宿主动态注入语义须由粒子负责人/Integration按职责协调设计；本执行项目不得自行改变Shared Core公共契约或正式Style。
+- 七项测试当前仍是源码语法检查级别，不等于实测; 下一步应先由粒子负责人协调Shared Core结果证书及合法真实tide来源，受控实现后再使用原STEP113 STATIC_RC APK复测。任意无法安全证明的条件继续fail-closed。
+
+
+### RDC 严格 -Werror 编译参数复核修正（2026-10-11）
+
+第一次NDK -fsyntax-only按项目真实C++20参数编译两个测试文件均exit0，但测试辅助函数遗漏可选retainedUnderlayState字段初始化，产生一条 -Wmissing-designated-field-initializers 警告；第一次探测曾附加 -Wno-error，不能直接标作正式 -Werror 验收。RDC后续对 test/renderer/retained_underlay_cache.test.cpp 增加一行显式 retainedUnderlayState={}，保留原逻辑，然后从临时核验脚本中移除 -Wno-error，严格复用Android NDK OpenGL/x86_64真实compile_commands.json的 -Werror 及C++20参数重新执行两文件 -fsyntax-only：retained_underlay_cache.test.cpp退出0/5.3秒，render_orchestrator_error.test.cpp退出0/5.2秒；对应Git忽略日志均无警告输出。**严格语法检查PASS；GTest链接运行仍NOT RUN，Symbol GPU证书及Fast仍BLOCKED。**修正仅测试辅助字段初始化，不涉及生产src/renderer、Android APK和正式Gate。

docs/报告/STEP-119_Android真机Fast首次通过_阶段验收_v1.md

@@ -0,0 +1,12 @@
+# STEP-119 Android 真机 Fast 首次通过阶段报告
+
+日期：2026-10-11 JST。结论：FAST_OBSERVED / PARTIAL；不是最终全面PASS。
+
+- 源码APK Commit：3d989a00a822989339a6d7cb4d23acc04396670e；Android OpenGL/x86_64完整Gradle Native编译+链接+打包BUILD SUCCESS；已对9个C++生产/测试单元做NDK严格-Werror语法检查PASS，发现并修复两处命名空间及测试Mutable/Immutable构造错误。
+- APK SHA-256：57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135；APK大小66702125字节。FZG1-2（ADB 192.168.200.139:5555）安装Success且已安装base.apk SHA一致；预检PASS。
+- 实测STATIC_RC_NO_TIDE（TestApp独立场景，不修改正式Style），原63基础层有效62+天气2=Native64；R[0,62)、missingSourceIds为空；场景有效。
+- 同一PID=27241，真实观察90.010秒：FastDelta=1819，FullDelta=0；最近120帧Fast=119，Full=0，decisionMismatch=0。
+- R缓存Build累计=1，Reuse累计=3276，placementGatePassed=True。复用增量=1819。静态结果首次真机Build、Reuse、Fast均已达到>0目标。
+- 原始设备JSON：artifacts/maplibre-particle/android-validation/step113-retest-20261011_170012/static_rc_no_tide/result.json；SHA256=8718ce113820e7cc0cc2b4d5b801e6847c92e9ced79cd4fecbee58bfeef1c27c。旧STEP118真实JSON与APK保留，未覆盖。
+- 其他未验：原63层缺源负对照；Camera/Style/Source/Tile/Annotation/Context变更后的Full安全撤销与重新Build；航标/文字图像与层序人工目视；13项非Jest GTest实际运行；macOS Metal/iOS。Mac Metal CMake因既有libuv缺失未配置（非新增依赖），Android链路使用原工具成功。
+- 不能凭Fast计数判断静态图像和Symbol结果等价；STEP119保持PARTIAL，不可直接发行或宣称全部PASS。

docs/报告/STEP-119_RCRR多场景局限性_阶段验收_v1.md

@@ -0,0 +1,64 @@
+# STEP-119 RCRR 多场景局限性阶段验收报告 v1
+
+日期：2026-10-11 JST
+
+## 一、目标与结论
+
+**结论：部分可行／阶段 PARTIAL。** Android 真机已证明一个原始四段 RCRR 场景能让后两段 R 分别 Build=1、Reuse=536；但最前 R 缺失 `tide`，同时宽 C 不满足当前 Fast 场景约束，整帧持续 Full。已新增三种区分 C 宽度及错误动态 R 的 Test App 对照入口，并据设备真实 Style 63 层清单完成静态区间核对。新增入口仍需用户手工编译 APK 后实测，不能宣称三种 GPU 场景 PASS；STEP-119 不 CLOSED。
+
+## 二、实际基线和执行链
+
+- RDC 设备：Mac.lan；Mac 仓库 `/Users/tei/dev/MapLibreParticleLab`，当前分支 `particle/main`，本轮起点 HEAD `46c88b0209474376225b54ae0ad701881673743d`。
+- Integration `main` 已通过 RDC `git fetch` + `git merge --ff-only`，本地/远端一致 `80667d6c343411d03a760425438e3d292f452118`；已读取 `PARTICLE_PROJECT_INSTRUCTIONS.md`、README、WORKFLOW、TEAM_MODEL、contracts/rfc/adr/status/compatibility、项目 AGENTS/规范/总则。
+- APK 源码锁：`3d989a00a822989339a6d7cb4d23acc04396670e`，SHA-256：`57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135`，ADB：`192.168.200.139:5555`。此次没有重复 Android 编译/安装。源 HEAD 与已安装 APK 的差异由先前文档提交构成；新测试源码改动后，后续新场景须重新进行用户手工 APK 构建、SHA 锁定。
+- 既有 `STATIC_RC_NO_TIDE` 正向 FastDelta=1819、FullDelta=0、Build=1、Reuse=3276 和原 `STATIC_RC` 63 层缺源负向 Fast=0/Full=305，均为已验收历史证据，没有重复执行。
+
+## 三、已执行真机 RCRR 和证据
+
+`PARTIAL_RCRR` 原场景运行 80.007 秒、PID=28169，3 个完整 Native 摘要，设备 SHA 一致。Native 总数 66；R[0,3) / C[3,39) / R[39,64) / R[64,66)。
+
+| 指标 | 实际结果 |
+|---|---|
+| R0 | Build=0 / Reuse=0 / missingSourceIds=[tide] |
+| R2 | Build=1 / Reuse=536 |
+| R3 | Build=1 / Reuse=536 |
+| 80 秒增量 | Fast=0 / Full=596 |
+| 最近 120 帧 | Fast=0 / Full=119 |
+| decisionMismatch | 0 |
+| 24 Gate 累计 | unsupported-continuous-layer=599、unsupported-scene=599、cache-invalid=595 |
+
+执行进程退出码 0，表示**原生观测及取证成功**，不表示 RCRR Fast 成功。证据路径：
+`artifacts/maplibre-particle/android-validation/step119-rcrr-observe-20261011_172720/partial_rcrr/result.json`、`logcat.txt`、`screen.png`。
+
+### 关键事实校正
+
+从设备 Debug App 的 `step113-STATIC_RC-324220201.json` 只读提取 `styleParity.baseLayerManifest`，正式 63 层索引：`tide-spots=2`、`sea-area-fill=3`、`clip-outline=31`、`special-pattern-line-754=37`。其生产 Style 指纹与当日 Fast 成功场景一致。原 R0 只有 background / base-raster / tide-spots；**天气在 C 内而不是 R0**。原 C 范围很宽，混合了普通海图图层和天气动态层。此前对 R0 图层组成的初步猜测已经被真实 Manifest 修正，未写入最终推荐结论。
+
+## 四、新增三种 RCRR Test App 入口（未上机）
+
+- `RCRR_C_NARROW_NO_TIDE`：R[0,31) / C[31,33) / R[33,63) / R[63,64)，C 只包含两天气层。用于验证全段缓存和最终 Fast 的可能性。
+- `RCRR_C_WIDE_NO_TIDE`：R[0,2) / C[2,38) / R[38,63) / R[63,64)，C 混合天气与静态 PBF。用于验证白名单边界和宽 C 的实际代价。
+- `RCRR_R_DYNAMIC_NO_TIDE`：R[0,33) / C[33,38) / R[38,63) / R[63,64)，天气被放入错误 R。用于验证失效与 Full 安全拒绝。
+
+代码变更严格局限于 Test App `Step113PbfGateScene.kt`、`verify_step113_fast_path.py` 和新增 `test_step119_rcrr_scenarios.py`，保留原所有场景。生产 PBF63 的定义、服务器 URL、天气实际字段及图层相对顺序不变；只在明确 NO_TIDE 测试副本排除已确认的唯一孤立层。对新场景增加精确 R 范围匹配，不降低原验证器 24 Gate 或 FAST_OBSERVED 条件。
+
+源级校验：设备实际 Manifest 分段结构 3/3 与预期一致；Python unittest 4/4 PASS；`git diff --check` PASS。没有 Android Kotlin/NDK 编译或新 APK/设备验收，**三种新增场景为 SOURCE_READY / NOT VERIFIED**。
+
+## 五、当前 RCRR 模式的局限性
+
+1. **全帧 Fast 是全局准入。** R2/R3 的 Cache 能各自 Build/Reuse，但 R0 缺源时整帧仍 Full；不能按各 R Reuse 求和冒充 Fast。
+2. **连续 C 不是任意图层的免责通道。** 原宽 C 下 `unsupported-continuous-layer` 持续增加，说明当前 Fast 路径不支持直接把大量普通海图层划入 C 并期望跳过完整场景处理。需要以新窄 C 实测来确认适用边界。
+3. **配置高度依赖真实 Style 顺序。** 同一个 layerId 相对位置设错可能造成循环 C 混入静态层或天气落入 R；实际 PBF 63 层与 NavSea 113 层现场定义不同，不能按历史索引照搬。
+4. **缓存分段独立性有限。** 即使 R 分段有缓存，Source/Style/Tile/Symbol Placement/Atlas/Opacity/Annotation 的全局结果版本可能要求跨段失效；当前 13 项源级 C++ 测试尚未真正 GTest 运行，相关安全边界待进一步真机验证。
+5. **性能与显存不是必然收益。** 多个 R RenderTarget/Composite 会增大缓存资源与混合成本；当前没有同场景 RC/RCRR 同相机有效帧时间和 GPU 内存对照，不能声称多段比单 R 更快。
+6. **视觉与平台仍未关闭。** 尚无强制 Full/RCRR 同 Style 静态航标、Symbol、文字、层序的人工确认；Metal CMake 仍因既有 libuv 缺失未配置成功，13 GTest 与 iOS 真机没有新验证。
+
+## 六、风险与下一步
+
+建议以**窄 C、其余静态 R**作为 RCRR 正向候选，保留原 63 层 RCRR 和两个新负向变体。下一次由用户按既有 Mac 标准手工只进行一轮最新源码 APK 构建后，RDC 串行执行三场景各 90 秒真实诊断和同视角视觉对照；若窄 C 仍被 unsupported gate 拒绝，应保留 Full、检查准确原因和局限边界，而不是修改 Gate 放行。
+
+状态为 `ANDROID_RCRR_FAIL_CLOSED_OBSERVED / MULTI_RCRR_SOURCE_READY / OVERALL_PARTIAL`。更详细命令、矩阵和预期证据位于 `docs/60_测试/STEP-119_RCRR多配置验收矩阵_v1.md`。本次不是 GSRL 正式发行，没有 SOURCE_LOCK、发布 Tag 或版本覆盖；未跟踪 STEP-110/111 文档禁止纳入提交。
+
+## 七、Git 收尾
+
+本段由 RDC 在完成 scoped commit/push 与远端回读后补写最终提交、Push 与远端 HEAD；在此之前不得声称 Git 收尾通过。

docs/报告/STEP-119_RCRR粒子独占C_CPU真机验证_阶段报告_v2.md

@@ -0,0 +1,65 @@
+# STEP-119 RCRR 粒子独占 C 与 CPU 实机对照阶段报告 v2
+
+日期：2026-10-11（JST）。实际执行：Mac.lan RDC，Android FZG1-2 x86_64 / `192.168.200.139:5555`，后端 OpenGL。**本报告为真实 Android 固定相机稳态验证，不是 STEP-119 全量 CLOSED/PASS。**
+
+## 一、执行结论
+
+**粒子独占 C 的 RCR、RCRR、RCRRR 三种分段均已在 Native 真正执行 FastPath（观测窗口 Fast 100%）；同一 PBF/天气场/相机条件下，两个 R 段的 RCR 平均 CPU 工作量显著低于三 R/四 R。** 宽 C 混入海图或 Particle 放入 R 的两项负对照均安全拒绝 Fast，24 Gate 没有误判。
+
+CPU 为 Android App **整个进程**的 utime+stime，不是某个 Native render() 调用的精确耗时；`CPU毫秒/帧`是实测进程 CPU 核秒/秒除以同段 Native 帧率的估算值，**不证明 GPU、功耗、动画视觉等价或动态天气切换安全。**
+
+## 二、来源锁与步骤执行返回
+
+- Integration `main` 通过 Mac RDC `fetch + --ff-only`，HEAD `80667d6c343411d03a760425438e3d292f452118`。
+- Particle 分支 `particle/main`，本次真机 APK 对应源码 Commit：`32ac795fc4abd04006673bf644f87a711329e78f`，完整 SHA256：`2bbd1cb4dc9e03ec56d8404363970e56f76b03819f6f2b50c8aee6dbb6fa43d2`。
+- **构建 PASS，exit0**：RDC 经用户本轮明确授权在 Mac 执行 `build_validation_apk.sh`，Java17、Android x86_64 OpenGL Kotlin/Native Build Success；APK 66,702,127 bytes，libmaplibre.so 40,138,024 bytes。只是现有弃用 API 警告。
+- **传输/安装 PASS**：`adb install -r` 因网络慢无终态而终止，非编译失败；改为临时 Mac LAN HTTP→设备 `curl` 下载无损 gzip（31,582,202 bytes）→SHA-256校验→设备解压成原 APK再校验→`pm install -r` 返回 `Success` exit0。临时 HTTP 已停止。最终 `verify_step113_fast_path.py --preflight-only` exit0：源码 HEAD、build-info、Mac APK SHA、已安装设备 base.apk SHA、x86_64 全匹配。
+- **采样器第一次试跑 BLOCKED，exit3**：ADB `sh -c` 参数转义阻塞读取进程 /proc；已停止，不计 RCRR 缺陷。临时忽略目录的测量器按同一 APK 修复为单个 ADB shell 命令，并在温机期保存日志避免 logcat 轮转；原记录1次 `SUMMARY_ALIGNMENT_LIMIT` exit2，明确排除 CPU 比较。
+- **有效 CPU Benchmark 8 次，exit0**：2次 Full、3次 RCRR、2次 RCR、1次 RCRRR。均同一 Commit/APK SHA/正式Style指纹 `e0f9c2d1df38ae5d5953b561c52efe2f8590336de80b988e1d2935580d30b996`；每次 24 Gate、decisionMismatch 0、Native/CPU 时间边界误差≤9秒、Lifecycle不变、真实分段/无 tide / 空 Annotation 受控。
+- **负例各 90 秒观察，命令 exit2（预期负例状态），安全验收 PASS**：`RCRR_C_WIDE_NO_TIDE` FastDelta0 FullDelta339，`unsupported-continuous-layer`；`RCRR_R_DYNAMIC_NO_TIDE` FastDelta0 FullDelta322，`unsupported-continuous-layer`+动态粒子 R0 的反复 `static-unstable/cache-invalid`；两项 `decisionMismatch=0`、24 Gate完整。此 exit2 是严格验证器的 `NO_FAST_OBSERVED`，**不是 GPU 测试崩溃**。
+- Python 现有非 Jest 合约/CPU比较测试 **12项 PASS**；修正后的正式 CPU 工具源代码仅为测试 Python（不改 Native/Test APK）。使用原 APK 的实测仍以旧源码 SHA `32ac...` 为准；仓库后续 Git 文档/测试器提交不倒写至 APK 来源。
+
+## 三、实测 CPU / Fast 帧效率
+
+每次独立冷启动，35秒 warmup，再约90秒稳定 CPU 采样，间隔6秒。相机固定（33.45,129.97、zoom10.5、bearing0、tilt0），场输入/forecast暂停/目标 FPS设置相同；Native FPS 实际值不等于目标 FPS，不得使用设定值算 CPUms/帧。
+
+| 模式 | R数量 | 有效轮数 | Native FPS（实测） | 进程 CPU / 单核 | 估算 CPU ms/完成帧 |
+|---|---:|---:|---|---|---|
+| Full，缓存关闭 | 3 | 2 | 9.98、10.61 | 61.6%、63.3% | 61.74、59.61；中位 60.67 |
+| RCR，Particle独占C | 2 | 2 | 59.67、59.40 | 19.7%、22.0% | 3.30、3.70；中位 **3.50** |
+| RCRR，Particle独占C | 3 | 3 | 53.93、55.03、54.22 | 37.6%、38.7%、39.9% | 6.96、7.04、7.37；中位 **7.04** |
+| RCRRR，Particle独占C | 4 | 1 | 48.94 | 38.3% | **7.82** |
+
+对先 Full → Fast RCRR → 后 Full 的严格同源 A-B-A：
+- Full CPU ms/帧基线取中位 **60.6716**，RCRR Fast **7.0396**：估算降低 **88.40%**；Fast比率100%；Full前后 CPU/秒漂移 **2.70%**，未达15%复测阈值。
+- 同基线计算 RCR **3.2996**：估算降低 **94.56%**；RCRRR **7.8212**：估算降低 **87.11%**。RCR/RCRRR 不在严格 Full-Fast-Full 的相邻三次中，属于同 Style/设备基准横向对照，不能赋予与 A-B-A 完全相同的控制力度。
+- RCR 3.30/3.70 与 RCRR 7.04/7.37 的交叉重复稳定支持**本场景两 R 优于三 R**。不能据此把差距直接归因为 FBO 合成或强称“R数越多必然越慢”：四 R 一次 CPU/秒略低于三 R，且缺少 GPU 渲染链 Profiling。
+- Fast组全部在稳定观察窗口 `FullDelta=0`、`FastFraction=1.0`、`windowCount=120`、最后120帧 `Fast=119/Full=0`，每个 R 原先真实 Build1，观测窗口内 `BuildDelta=0、InvalidateDelta=0、Reuse大量增长`。这验证**稳态** Cache Reuse，不验证主动变更后安全重建。
+
+## 四、证据坐标
+
+Git 忽略的本地设备证据目录：
+`artifacts/maplibre-particle/android-validation/step119-rcrr-cpu/`
+
+- A-B-A 综合 `compare-20261011_193224.json`。
+- 包含全部三种 Fast 结构的比较 `compare-20261011_193724.json`。
+- Full 有效：`20261011_184647-rcrr_full_control_no_tide/result.json`、`20261011_193006-rcrr_full_control_no_tide/result.json`。
+- RCR：`20261011_193242-rcr_particle_only_no_tide/result.json`、`20261011_194206-rcr_particle_only_no_tide/result.json`。
+- RCRR：`20261011_184406-rcrr_c_narrow_no_tide/result.json`、`20261011_192746-rcrr_c_narrow_no_tide/result.json`、`20261011_194427-rcrr_c_narrow_no_tide/result.json`。
+- RCRRR：`20261011_193504-rcrrr_particle_only_no_tide/result.json`。
+- 无效首轮 Full（仅保留排障）：`20261011_184029-rcrr_full_control_no_tide/result.json`。
+- 负对照：`artifacts/maplibre-particle/android-validation/step113-retest-20261011_193754/rcrr_c_wide_no_tide/result.json`、`step113-retest-20261011_194000/rcrr_r_dynamic_no_tide/result.json`。
+
+原始数据/Logcat 没有加入 Git，以上路径仅在执行 Mac 本地工作树中。正式报告记录事实和 Hash，**不能把本报告当作已发布或 Source-Locked APK**。
+
+## 五、性能和架构局限 / 后续验收
+
+1. **C 单独 Particle 是当前强准入边界**：宽 C 含普通海图会拒绝 Fast；把实时粒子错放 R 会频繁失效。不得为跑分降低24 Gate。
+2. **R 数量不是越多越好**：本次两 R 性能最好，RCRR/RCRRR 受更多缓存、RenderTarget和合成/上传等成本影响的原因尚需 CPU/GPU 分项 Profiling，不得越证据结论。
+3. **WeatherColor 在 R**：固定 forecast 的稳态 Build1/Reuse 大量通过；field 更新、插值时间、颜色表、可见度、Opacity、Source/Tile变化是否触发正确的失效、Full、重 Build/Reuse，**未验证**。
+4. **视觉等价未通过**：航标、字体、跨段 Symbol Placement/遮挡、层次和色彩需同视角 Full/RC/RCR/RCRR 人工真实屏幕验收；尤其两 R 不允许以牺牲 Symbol 语义换速度。
+5. **动态地图与错误恢复未通过**：Camera移动缩放旋转、Style、Source、Tile、Annotation、Context丢失以及反复切换的 Full→Fast恢复、无旧图闪现，未经过系统测试。
+6. **跨平台与低层证明未通过**：Mac Metal/iOS、13项 STEP119新增 C++ GTest 真跑、GPU 时间/温度/电量未确认。Android APK 为测试 Debug x86_64，不能外推产品 ABI 或真机温度。
+7. **长期运行/网络压力未通过**：设备网络传输约 48KiB/s，使用 gzip+LAN HTTP转移大APK完成安装；不能把安装网络瓶颈归咎于 FastPath，也不能用静态场证明运行稳定性。
+
+阶段裁定：`ANDROID_RCRR_STEADY_FAST_CPU_PASS / TWO_NEGATIVES_FAIL_CLOSED_PASS / STEP119_PARTIAL`。建议后续优先 RCR 两 R 方案做动态/视觉/生命周期长时间测试，**不修改正式生产配置，不在此报告直接决定采用**。

docs/报告/STEP-119_SymbolRetained生命周期修复_Codex完成报告_v1.md

@@ -0,0 +1,128 @@
+# STEP-119 SymbolRetained 生命周期修复 Codex 完成报告 v1
+
+日期：2026-10-12（JST）。状态：**IMPLEMENTED / WAITING_RDC_VALIDATION**。接续此前因用量限制中断的同一任务，四个既有修改经静态复审及明确缺口修正后交付。没有运行编译或测试，整体 STEP-119 仍未验收，不报告整体 PASS。
+
+## 1. 模型、环境与 Git 基线
+
+- 用户本轮明确指定 `GPT-6.1 Sol High`，即 `gpt-6.1-sol / high`。当前工具没有执行器模型/推理参数元数据；轻量查找 `/Users/tei/.codex/sessions/2026/10/12` 返回目录不存在，实际运行参数无法独立核验。记录用户指定值，不把它写成已从执行器日志核实。未主动升级模型、启动第二实例或子代理。
+- `Mac.lan`，Darwin 24.6.0，x86_64；目录 `/Users/tei/dev/MapLibreParticleLab`。
+- 开工/交付 branch=`particle/main`，HEAD=`badb515d590fbdf221751b6677de3da0a5650d7e`。基线为四个已有 tracked 修改及 STEP-110/111 两份 untracked 任务书；不从头复写，不改分支/worktree/HEAD。
+- `git submodule status` 已只读检查，没有变更前缀；无子模块修改。未 commit/push/tag/fetch/pull/rebase/reset/clean，未回读远端 HEAD（本轮禁止远端操作）。
+- 只读当前 v25 Source Lock：Android/RN `13.6.1-particle.25`，iOS `6.29.0-particle.25`，冻结构建源 `f32f6f45fd359007e8b3c77911b66d9e7fc93848`。发行记录与制品未修改，本轮未生成制品，不能以现有 v25 包验证本工作区修复。
+- 首先读取 Astra 原文 `/tmp/fzg1_astra_guidance_20261012.md`，再读取仓库规则、当前资料和现有 diff。当前用户续作授权优先于旧任务中的历史基线/跨项目调查和 Git 收尾安排。
+
+## 2. 实际修改文件及生命周期不变量
+
+| 文件 | 实际变更与不变量 |
+|---|---|
+| `src/mln/gfx/symbol_drawable_data.hpp` | 内部数据保存强类型 atlas 与实际原生 atlas tweaker；创建时两者来自同一份 atlas，增加内部 Drawable 类型标记。它们不拥有 RenderTile 或底层 Tile。 |
+| `src/mln/renderer/layers/render_symbol_layer.hpp` | 私有同源/绑定/整组复用/采集辅助方法及当前地址→ID/atlas 映射；仅保存当前代次，不建立历史容器列表。friend 测试入口不修改公共 API。 |
+| `src/mln/renderer/layers/render_symbol_layer.cpp` | prepare 从同次 source 获取 raw owner 与原 Y 排序列表，先校验成员地址再读 ID/atlas，保留 fading tile。成功复用先检查 tile/pass 整组，再全部刷新当前 RenderTile/owner；Bucket、atlas、layer tweaker、数据/类型或成员失配整组移除重建，atlas 缺失移除旧绘制。Retained 从强引用 atlas 取证，旧指针只作当前地址映射查找，使用 Drawable 自己的 ID；类型未知/绑定不符/未上传立即拒绝。owner 只放入 resources，不序列化 owner 地址。 |
+| `test/renderer/retained_underlay_cache.test.cpp` | 13 项 `SymbolRetainedLifetime` 源码调用生产 prepare/bind/rebind/retained 辅助路径与原生 atlas tweaker；真实类接口/签名和友元访问逐项静态核对。atlas-only TileRenderData 显式覆盖空 Bucket/LayerRenderData 查询，避免基类 assert；补组内类型失配、Text/IconRGBA/IconSDF/Halo 稳定身份、未知类型及证书释放检查。 |
+| `docs/50_Step记录/STEP-119_SymbolRetained生命周期修复_v1.md`（新增） | 本阶段目标、基线、完成/待验清单及交接。 |
+| `docs/报告/STEP-119_SymbolRetained生命周期修复_Codex完成报告_v1.md`（新增） | 本报告，记录事实、准确命令、风险和停止条件。 |
+| `粒子开发记录.md` | 仅末尾追加本次实现与未验证事实，保留历史内容。 |
+
+两个新文档路径创建前已确认不存在，同主题无旧版本，选择 v1；使用独占创建，未覆盖旧报告。前三个生产文件及测试均沿用开工时修改；本续作生产补丁仅增加 Retained 对未知 SymbolType 的拒绝，测试补丁只处理上述明确缺口及覆盖不足。
+
+### 所有权与稳定性
+
+1. Drawable 只由通过同源校验的 owner/元素绑定。复用检查不从旧 RenderTile 读取 ID/Bucket/atlas；任何一个 Text/Icon/Halo 成员不兼容时整组移除，避免 `updateTile()` 的“任一成功”留下半新半旧组。
+2. 同 Bucket/atlas 保持 Drawable 和 tweaker 身份，仅刷新 owner/RenderTile 与既有动态属性；source 每次产生新容器不应自行造成每帧重建或证书字节变化。
+3. 当前容器拥有 RenderTile；RenderTile 独占 renderData；真实 GeometryTileRenderData 强持有 LayoutResult/atlas，LayoutResult 负责槽位释放。证据 resources 保活容器，但不调用 `result.retain(renderTilesOwner)`，因此 owner 地址不进入比较字节。证书 candidate/completed 替换或 invalidate 后旧证据可退出，未新增无界容器。
+4. Retained 先验证当前地址/保存的 ID、内部数据类型、atlas 来源、实际 tweaker 和 shader，再检查真实 glyph/icon 纹理绑定及上传状态。任何缺证立即返回 incomplete，不沿失效裸指针追读 renderData/atlas。
+5. RenderTile 内 `Tile&` 的寿命独立；保活容器不保活 Tile，不允许把旧 Tile 上的 getOverscaledTileID/holdForFade 当成安全操作。测试分别计数 Tile 与 TileRenderData，旧 Tile 销毁后仅比较旧地址及读取 atlas 强引用。
+6. 同 atlas 的 texture 替换经原生 tweaker 更新实际绑定，前后证据不同；原地像素更新即使上传后指针不变，仍依赖真实 content epoch。既有 Build 前/后及提交后复核、证书版本/R cache/prepared Fast 保护保留，未改变准入顺序或放宽任何判据。
+
+## 3. 静态审查与测试源码范围
+
+13 项生命周期源码覆盖：连续 prepare 后刷新/释放旧 renderData、owner/元素错配、atlas 替换整组清理与新纹理绑定、组内单成员失配、atlas 缺失、同 atlas texture 更换及重新 Build/Reuse 状态、未上传原地更新拒绝、owner 身份不进入完整空组结果字节、Tile 与 renderData 寿命分离、Layer 移除及证书失效释放 atlas、同名 Source 替换、tile 退出清理、Text/Icon/SDF/Halo 连续三代保持身份、未知 Symbol 类型拒绝（其中相关情形合并在同一用例）。
+
+测试使用真实 RenderSource/Tile/TileRenderData/RenderTile、SymbolBucket、Drawable/TileLayerGroup 接口和生产辅助方法；GPU Texture/Drawable/Shader 使用 CPU 替身。真实 API 的纯虚函数、构造参数、Mutable→Immutable 转换、SymbolLayer.baseImpl 可见性及派生类 friend 访问继承 protected 成员已静态核对，没有用悬空指针解引用构造普通反例。
+
+**覆盖限制**：atlas-only fixture 不生成真实 Placement/顶点/GPU 命令；atlasResult 是生产采集的局部证据，不能代表完整渲染证书。整组失配测试走生产移除入口，但重新创建由 fixture 添加 Drawable，仍需 RDC 实际 update/builder/GPU 链验证。tile 退出测试直接调用正常 update 使用的清理入口，没有伪造 Context 或声称执行完整 update。owner 稳定证书测试走完整生产空组采集；非空 Text/Icon/Halo 稳定性只检查绑定输入和身份。原地 image patch 上传后的 epoch、Style/context 清理引用既有 `Step119SymbolResults.RealTileGlyphImageStyleContextCallbacksRejectBuiltCertificate` 等回调测试源码，不等同真实槽位释放、Source/Style/context 完整运行验收。
+
+## 4. 已做及未做检查
+
+已做：必要文件阅读、开工 Git/机器/版本及 diff 审查；真实 C++ 接口/生命周期调用静态核对；确认测试文件在 `test/CMakeLists.txt` 已登记；源码静态计数 `SymbolRetainedLifetime` 为13项；新增文档版本/路径检查；STEP-110/111 SHA-256 保护检查；开发记录追加与文件范围检查。
+
+已执行四源码路径 scoped `git diff --check -- src/mln/gfx/symbol_drawable_data.hpp src/mln/renderer/layers/render_symbol_layer.cpp src/mln/renderer/layers/render_symbol_layer.hpp test/renderer/retained_underlay_cache.test.cpp`：**exit=0，stdout/stderr 空**。最终全工作区及七任务路径空白检查由本轮落盘后再次执行，结果见下方交付记录。空白检查不证明 C++ 编译或测试通过。
+
+未执行：CMake 配置、Native/NDK 编译、`-fsyntax-only`、链接、GTest、Metal/iOS/GPU运行、Gradle/APK、ADB/安装、Jest、Bazel/codegen、发行、Git写操作及远端读取。没有新编译失败日志、设备日志、截图、APK/SO SHA 或 Build/Reuse/Fast 数据；既有 libuv 环境失败只作为历史限制，未重试也未修改环境。
+
+保护的未跟踪任务书 SHA-256：
+
+- STEP-110：`33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0`。
+- STEP-111：`f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4`。
+
+## 5. RDC 准确编译与定向测试命令（Codex 未执行）
+
+独立审查本报告和实际 diff 后，在同一工作区逐条执行；每条保存 command/exit/耗时/完整日志路径，失败立即停止下一步，回传首个真实 error、target 与必要上下文。PATH 找不到 cmake 时可使用既有 `/usr/local/opt/cmake/bin/cmake`；不得安装升级依赖或关闭宏绕过 libuv/工具链错误。
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+cmake --preset macos-metal
+cmake --build build-macos-metal --target mbgl-test-runner --parallel 3
+build-macos-metal/mbgl-test-runner --gtest_filter='SymbolRetainedLifetime.*:Step119SymbolResults.*' --gtest_list_tests
+build-macos-metal/mbgl-test-runner --gtest_filter='SymbolRetainedLifetime.*:Step119SymbolResults.*:RetainedUnderlayCache.*:RenderOrchestratorError.*:RenderOrchestratorTeardown.*:CrossTileSymbolLayerIndex.*' --gtest_color=no
+```
+
+必须发现本轮13项 `SymbolRetainedLifetime` 与既有13项 `Step119SymbolResults`（后者分布两个已登记文件），真实执行数量非零。零匹配、旧 runner、仅语法检查不能写 GTest PASS。Metal 与 Android OpenGL 分别保留编译及运行事实；Android 实际 compile_commands 的类型核对须保持原 `-Werror`，不加 `-Wno-error`。本轮未生成额外编译脚本。
+
+Vulkan 至少取得生产修改的兼容性编译证据；已有 macOS Vulkan 环境可用以下真实 preset/target，环境缺失则记未验证/阻塞，不升级环境：
+
+```bash
+cmake --preset macos-vulkan
+cmake --build build-macos-vulkan --target mbgl-core --parallel 3
+```
+
+Vulkan Symbol provenance 既有保守边界保持，编译成功不等于其 Symbol retained 运行通过。可在既有 sanitizer 配置下补查 UAF，不改造构建体系；Host Metal/GTest 也不替代 iOS 真机。
+
+## 6. 后续 FZ-G1 验收命令与证据（Codex 未执行）
+
+**前置门槛**：独立审计/Native验证完成、后续 Git 来源锁和 Android/设备操作获得授权。当前 tracked dirty，verifier 的 `SOURCE_NOT_LOCKED` 会拒绝本工作区；本轮禁止提交，故这是后续验收前置条件，不能改 verifier、伪造 build-info 或用旧 APK。本报告仅交命令，不代执行 Android/ADB，也不代授权 Git。
+
+用户/RDC 按其阶段授权完成一次标准新 APK 构建与安装，固定 FZG1-2、serial=`192.168.200.139:5555`、OpenGL Debug/x86_64：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+./tools/particle_android_validation/build_validation_apk.sh
+adb -s 192.168.200.139:5555 install -r artifacts/maplibre-particle/android-validation/MapLibreAndroidTestApp-validation-opengl-debug-x86_64.apk
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --preflight-only
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario STATIC_RC_NO_TIDE --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario RCRR_C_NARROW_NO_TIDE --seconds 90
+python3 -B tools/particle_android_validation/verify_step113_fast_path.py --serial 192.168.200.139:5555 --scenario STATIC_RC --seconds 90
+```
+
+正向缓存保持开启，每次稳定后须真实 Build>0、Reuse>0、FastDelta>0，完整120帧24Gate mismatch=0；原63层 STATIC_RC 缺 tide 继续作为安全拒绝负对照，验证器可能返回 NO_FAST_OBSERVED/exit2，不能当正向 PASS，也不能添加假 tide。正向静止90秒不是生命周期验收。
+
+RDC/用户还需反复 pan/zoom/rotate、跨 tile/world wrap、Source同名替换、Style清理/重载、glyph/icon/atlas更新、后台恢复/context reset；每次变化保存失效 → Full → 新 Build → 成功 Full Reuse → Fast 的顺序证据，Text/Icon/SDF/Halo 不消失、残影或错位。相同相机的 Full/Fast 图像对照、资源随循环最终释放均须实测。保持正式 Style/Source 和公共契约，不以禁用 Retained、每帧重建或放宽24Gate替代验证。
+
+必须保存：新锁定源码 HEAD/diff、build-info/完整构建日志、本地及安装 APK SHA-256、实际 libmaplibre.so Build ID与匹配符号、测试发现/执行数、Build/Reuse/Full/Fast/Invalidate 区间增量、完整24Gate快照、操作前后截图及视觉判断、资源数量/释放证据和全部未验证项。证据写新目录，不覆盖 ignored 历史证据。
+
+异常先保存 crash 日志/bugreport，不先清日志；由获授权执行者执行：
+
+```bash
+STEP119_EVIDENCE_DIR=$(mktemp -d /tmp/step119-symbol-lifetime-XXXXXX)
+adb -s 192.168.200.139:5555 logcat -b crash -d > "$STEP119_EVIDENCE_DIR/crash-logcat.txt"
+adb -s 192.168.200.139:5555 bugreport "$STEP119_EVIDENCE_DIR/bugreport.zip"
+```
+
+## 7. 风险、证据缺口与停止门槛
+
+- 缺原始寄存器 tombstone；原 Build ID `485459ba44f806ef0a0c08633c717bfd5d82ad8f` 和匹配符号应保留，不能断言 `0x8cdc7c` 唯一原因是本 UAF 链。
+- 当前模型运行参数没有可独立回读的执行器元数据，RDC报告须补该身份事实；不伪造“已核实”。
+- 真实 C++ 编译、GTest、Metal/OpenGL/Vulkan、底层 Tile 寿命及真实 atlas 槽位/像素变化、异步线程边界、释放/内存开销均未验收。静态检查只能排除部分明显问题。
+- 若必须改变公共契约、重构全部 Tile 所有权、永久禁用缓存、放宽测试/证书或修改发行物才能继续，停止扩大修改并标 BLOCKED。
+- 编译/链接/GTest失败、SIGSEGV、24Gate mismatch、Fast永久归零、资源循环单调增长、Symbol视觉异常均保留现场，不能通过降门槛、旧APK或隐藏失败制造 PASS。
+
+本轮实现交接到此，后续由 RDC 独立验证；失败按 Codex 修复 → RDC 验证闭环返回，不继续后续开发阶段。
+
+## 8. 最终交付静态检查记录
+
+- 完整命令 `git diff --check`：exit=0，stdout/stderr 空。
+- 七个任务文件显式路径的 `git diff --check -- ...`：exit=0，stdout/stderr 空。新建 Step/报告尚未跟踪，Git diff 不包含其内容；另以轻量 Python 文件检查确认两份 UTF-8 文档状态、末尾换行及无行尾空白，不借此声称 Git 已检查 untracked 内容。
+- `git status --short`：仅四个接续源码、开发记录、两份新增本任务文档及两份原有保护任务书；没有其它修改。branch/HEAD 与开工一致。
+- 最终 STEP-110/111 SHA-256 与开工值一致；开发记录内容以 HEAD 原文的完整字节为前缀，只有末尾追加。
+- 静态计数：生命周期13项，既有 Step119SymbolResults 为9+4=13项。没有发现/执行 GTest，不能声称实际26项通过。
+- 没有新的编译/测试/设备验收结论；状态维持 IMPLEMENTED / WAITING_RDC_VALIDATION。

docs/报告/STEP-119_Symbol缓存_Codex完成报告_v1.md

@@ -0,0 +1,88 @@
+# STEP-119 Symbol缓存 Codex完成报告 v1
+
+日期：2026-10-11（JST）。结论：**IMPLEMENTED_WAITING_ANDROID**。Shared Core实现与13项非Jest测试源码已完成；Native可编译性、测试运行、真实R Build/Reuse/Fast和视觉结果均未验收，不能写全任务PASS。现阶段立即交RDC独立审计与验证。
+
+## 1. 真实执行环境与授权
+
+- 仓库：/Users/tei/dev/MapLibreParticleLab；Mac.lan，Darwin24.6.0，x86_64。
+- 分支：particle/main；开工/交付HEAD均为869930046b11dbeb3b147e3be952a2e847316292，本轮没有Git提交或push。
+- 实际模型/推理档位：gpt-6.1-sol / high，来自本会话rollout的turn_context核实，未升级、未启动子代理或另一个Codex实例。核实文件：/Users/tei/.codex/sessions/2026/10/11/rollout-2026-10-11T15-20-51-01a1299f-0c2b-78b0-8599-e50812c108dd.jsonl。
+- Native版本仍13.6.1-particle.23，未更改发行坐标。Integration本地HEAD80667d6c343411d03a760425438e3d292f452118；已读取当前全部要求的协作规则/协议，只读，无跨仓写入。
+- 当前任务仅内部Renderer实现、两个已登记测试文件与四份中文文档/开发记录。禁止的构建、设备、Jest及Git写操作全部未执行。
+
+## 2. 已实施的行为
+
+原死锁是多个条件共同导致：新Placement令changed=true、recent令stale/hasTransitions=true、已结束fade通常>=1，并且global/perSegment/preparedScene存在独立阻断。本轮实现最终绘制输入证书，没有只改单个布尔条件。
+
+正常Full保持原全场Placement/crossTile碰撞、updateLayerBuckets、动态/opacity/paint顶点、processChanges和原Style语义。先运行原生Symbol tweaker及上传，核查UBO容量、共享属性GPU背板与非dirty索引，再复制实际UBO、Drawable绑定属性、text/icon索引与segments/排序、wrap tile、atlas/texture/shader身份、实际混合/剔除/深度状态、全局组数/ordinal和原注册关系。精确字节比较不以placed布尔或hash代替GPU输入。
+
+同绑定、同settled输入与上一成功提交Full相等时准入首次Build；成功present/endFrame及再次复核后，建立匹配Build revision。下一成功Full Reuse之后才Fast。Full Reuse也检查精确candidateHasBuild，防止组合revision碰撞借旧结果。普通Full替换旧prepared tree保留复制证据；真实reset仍清空。global稳定性、perSegment Gate和preparedSceneSupported全部接入同一证书。
+
+新增内部hasActiveSymbolFade区分刷新stale与真实fade，旧hasTransitions继续用于正常刷新。GL/Metal原生opacity clamp逐顶点检查，未结束fade/异常packed值拒绝；Fast保留被认证的Full fade值。只有实际编译的原生GL/Metal Symbol源码及合法uniform宏才能登记shader来源，名字相同的未知shader拒绝。
+
+Source/style/tile/glyph/image/atlas/camera/viewport/pixelRatio/context/Annotation/update signature、ready与异步epoch保护继续保留；补上Glyph requested/error、Tile/Symbol error。注册/绘制错误推进error/content代次；上传/编码/提交异常清旧缓存和证书后原样抛出。未知Symbol类型须原生typeInfo身份一致；pending/旧隐藏组/collision额外组/不可读或超16MiB输入均保守拒绝。原24Gate evaluator、顺序、mask、诊断公开结构和计数判据未修改。
+
+## 3. 实际修改文件（共25个）
+
+| 文件 | 变更用途 |
+|---|---|
+| src/mln/renderer/symbol_render_result.hpp（新增） | 精确输入、合法fade终点、绑定、完成Full/Build/Reuse证书 |
+| src/mln/renderer/symbol_render_inputs.hpp（新增） | 实际vertex/instance属性字节与不可变buffer身份 |
+| src/mln/renderer/symbol_shader_provenance.hpp（新增） | 原生shader来源及uniform宏白名单 |
+| src/mln/renderer/layers/render_symbol_layer.hpp | 内部结果采集入口与原group身份 |
+| src/mln/renderer/layers/render_symbol_layer.cpp | 原生Symbol实际Drawable/Bucket/Atlas/索引/绘制状态取证 |
+| src/mln/renderer/layers/symbol_layer_tweaker.hpp | 实际UBO证据与执行帧记录 |
+| src/mln/renderer/layers/symbol_layer_tweaker.cpp | 复制实际上传字段，覆盖consolidation两路径 |
+| src/mln/text/placement.hpp | 内部真实fade查询声明 |
+| src/mln/text/placement.cpp | 真实fade查询，保留原stale/placement频率 |
+| src/mln/renderer/render_orchestrator.hpp | 内部采集/error代次与visitor错误失效 |
+| src/mln/renderer/render_orchestrator.cpp | registry/source/global取证、真fade与异步epoch |
+| src/mln/renderer/renderer_impl.hpp | 证书容器及独立完成signature |
+| src/mln/renderer/renderer_impl.cpp | 上传后准入、global/perSegment/prepared/Fast、Build/Reuse/完成复核 |
+| src/mln/renderer/renderer.cpp | 普通Full保留证据，逃出编码/提交异常清缓存 |
+| src/mln/renderer/render_tree.hpp | Fast保留认证fade参数 |
+| src/mln/shaders/gl/shader_program_gl.cpp | 原生GL编译来源薄接入 |
+| src/mln/mtl/context.cpp | 原生Metal源码/entry/宏薄接入 |
+| src/mln/shaders/mtl/shader_program.cpp | Metal来源生命周期撤销 |
+| test/renderer/retained_underlay_cache.test.cpp | 新增9项Step119SymbolResults |
+| test/renderer/render_orchestrator_error.test.cpp | 新增4项Step119SymbolResults |
+| docs/20_调查/STEP-119_Symbol结果证书与R缓存Build实现依据_v1.md（新增） | 生命周期、不变量、反例、限制 |
+| docs/50_Step记录/STEP-119_Symbol缓存实际实现_v1.md（新增） | 本阶段状态、已做/未验与下一步 |
+| docs/60_测试/STEP-119_原PBF_FAST实机联合验收计划_v1.md（新增） | RDC精确命令、来源锁、正负场景/失效/视觉矩阵 |
+| docs/报告/STEP-119_Symbol缓存_Codex完成报告_v1.md（新增） | 本报告 |
+| 粒子开发记录.md | 仅末尾追加STEP119中文记录 |
+
+没有修改include公开API头、RN/JNI/ObjC/Java/Kotlin、正式PBF/Style/URL、STEP118派生场景、Integration协议、天气层或Core-owned timeline/playback。未修改测试登记/build规范、验证器、STEP110/111任务书、历史报告与ignored原设备证据。
+
+## 4. 已执行检查与结果
+
+- 仓库/Integration规则、当前源码/任务与STEP112–118关键证据阅读；实际branch/HEAD/status/version、模型turn_context核实。
+- 轻量静态接线复核：Full/Build/Reuse/Fast、原24Gate、SourceRevisionBook、GL/Metal source与clamp、reset/error路径、测试登记与验收命令。
+- git diff --check：exit0；这是空白检查，不是C++编译或测试。
+- 13项新增TEST源码静态计数，两个文件已有CMake登记；实际共享CPU vector无GPU背板/已release无背板反例纳入失败测试；未修改STEP117/118既有断言。
+- 静态文件范围、开发记录仅追加、公开头/Style/设备证据及两个保护任务书哈希核查。具体保护SHA见下节。
+
+本轮未执行CMake/Ninja/Native编译、fsyntax-only、GTest、Metal/iOS运行、Gradle/APK构建、ADB安装/设备命令、Bazel/codegen、Jest、commit/push或网络远端HEAD回读。没有新的APK/设备SHA、GPU fence、截图或计数结果；没有凭进程退出或静态检查声称PASS。未产生新的编译/测试失败日志；旧libuv环境问题仅作为历史限制。
+
+## 5. 原证据与保护边界
+
+STEP118旧真机事实：原63→派生62基础Layer+天气2=Native64，R[0,62)、C[62,64)，missingSourceIds=[]；fallback=static-placement，Build0/Reuse0；90.00806697399821秒FastDelta0/FullDelta942、24Gate mismatch0。旧APK源3051196054c7b69815c298040dae61d26499d9f2，SHA44afcfabe0cf4f1ec93f35899241bd73093aa6db4b5cb82ca2120dd531b8f3e9。这些是旧失败证据，不能改写成本轮成功。
+
+| 只读保护文件 | SHA-256 |
+|---|---|
+| 未跟踪STEP110任务MD | 33037df71b4b30aa7956d59f4b99f77af3085405b24111bc0fe11ec857a93db0 |
+| 未跟踪STEP111任务MD | f3a5806f25384bf46055db2edfea0d21bfbc4124184bc813b46e38b8079c1ec4 |
+| artifacts/maplibre-particle/android-validation/step113-retest-20261011_140448/static_rc_no_tide/result.json | d3d20fc35bbd17e9f0ea0dd014ca4af8e0c5c5284d9f0c009bc20981d876ff10 |
+| 同目录screen.png | c8b57a8432626c9209ca9a614a747728d4256bd09273b28c26a793a75a6d44d4 |
+
+## 6. 未验收、阻塞和RDC交接
+
+- 当前源码尚未由RDC独立审计/锁定。现有verifier要求tracked clean以及APK来源HEAD/本地与设备SHA一致，会对当前dirty报SOURCE_NOT_LOCKED；这不是本轮已运行报错，而是读取代码确认的预检。Codex无commit/push授权，不绕过保护，Git收尾由RDC在其明确阶段授权内scoped负责。
+- 所有新增C++代码/13项测试仍NOT COMPILED/NOT RUN。状态机fixture的手工Build标记、模拟payload/CollisionGroups不等于真实Symbol GPU、碰撞或像素等价，必须另跑真实路径。
+- Android原STATIC_RC_NO_TIDE Build>0/Reuse>0/FastDelta>0尚未证实；原63缺tide负对照仍应拒绝。Source/Style/相机/异步/Annotation/Context矩阵与Full/Fast视觉全部待证。
+- Metal/iOS实际source/UBO/instancing路径尚未验证；Vulkan/WebGPU无本轮provenance登记，Symbol缓存继续保守拒绝，普通Full不变。
+- 16MiB输入上限、数据量、取证CPU/内存成本、真实异步竞态与平台GPU完成仍是待测限制。超限或缺证明继续Full，不能调低验收判据制造通过。
+
+RDC先读本报告/实际diff，按[联合验收计划](../60_测试/STEP-119_原PBF_FAST实机联合验收计划_v1.md)锁源码并执行准确命令：macos-metal配置、mbgl-test-runner编译、13项发现与定向GTest；Android GL真实编译参数核查。通过后集中一次标准APK流水线/install，以显式serial 192.168.200.139:5555验证STATIC_RC_NO_TIDE至少90秒、真实R Build/Reuse/Fast与120帧24Gate mismatch0，再做原63负对照及变更/视觉矩阵。
+
+RDC须保留新锁定HEAD、本地APK/设备SHA、命令/exit/耗时/日志、测试数量、Layer/Source/R/C清单、Build/Reuse/Full/Fast区间增量、完整24Gate快照、截图与用户视觉结果。失败保存首个真实错误/现场，最多5轮当前Step修复，不跳后续阶段。源码交付到此停止；独立验收尚未完成。

docs/报告/STEP-119_粒子独占C与CPU效率_阶段验收_v1.md

@@ -0,0 +1,51 @@
+# STEP-119 粒子独占 C 与 CPU 效率阶段验收报告 v1
+
+日期：2026-10-11（JST）。阶段结果：**SOURCE_READY / CPU_BENCH_READY / ANDROID_NEW_APK_NOT_RUN / STEP119_PARTIAL**。
+
+## 一、可行性结论
+
+用户确认 RCRR 的正常使用原则是 C 只放粒子，后续必须以实际 CPU 效率衡量 FastPath 而非单看 Fast 计数。源码检查确认：Native `tryRenderParticleFastFrame()` 使用 `singleContinuousSegment(plan)`；Fast 执行仅访问当前唯一 C 段的 LayerGroup，R 需全部缓存有效、无版本/内容/Placement/Annotation 等 24 Gate 安全问题。原则**有条件可行**，不等于 WeatherColor 放入 R 后已经获得 Fast 资格。
+
+**没有取得新 APK 的 Full/Fast CPU 性能对比数值**；本报告仅完成测试场景、测量器与验收准备。不能宣称 CPU 性能提升、GTest 或 iOS 完成。
+
+## 二、实际基线和执行状态
+
+- 设备 Mac.lan，通过 RDC 操作 `/Users/tei/dev/MapLibreParticleLab`；原有 `particle/main` 分支，起点 `1072816740fa69b7b23cd70602a402be19e5be2a`。
+- Integration `/Users/tei/dev/navsea-particle-integration` 已 `fetch main`、`merge --ff-only origin/main`，本地/远端一致 `80667d6c343411d03a760425438e3d292f452118`。已依据当前规则确认 Android/iOS/Shared Core 边界及项目 AGENTS。
+- 既有设备 APK 源 commit `3d989a00a822989339a6d7cb4d23acc04396670e`、SHA-256 `57d68800770d431a2ce9247406f636e7a01cc19fccaf4c59f5eb3a7c99128135`；**未重新编译或安装，不得对新场景使用旧 APK 验收**。
+- 之前的原 `PARTIAL_RCRR` 80秒真机负例保留：R0 因缺 tide Build=0/Reuse=0、R2/R3 各 Build=1/Reuse=536、FastDelta=0/FullDelta=596、decisionMismatch=0。旧 `STATIC_RC_NO_TIDE` 正向 Fast=1819，数据/图层顺序不同，不当作新 CPU 对照数据。
+
+## 三、新 Test App 结构
+
+不改生产 PBF、原 63 层场景或 Shared Core 的 24 Gate。Test App 在唯一无 tide 测试副本中得到 62 个基础层，插入的 WeatherColor 索引31、Particle 索引32。正常性能候选只允许 Particle C[32,33)：
+
+- `RCRR_C_NARROW_NO_TIDE`：R[0,32)、C[32,33)、R[33,63)、R[63,64)。
+- `RCR_PARTICLE_ONLY_NO_TIDE`：R[0,32)、C[32,33)、R[33,64)。
+- `RCRRR_PARTICLE_ONLY_NO_TIDE`：R[0,32)、C[32,33)、R[33,38)、R[38,63)、R[63,64)。
+- `RCRR_FULL_CONTROL_NO_TIDE`：与第一组同源、同图层、同 RCRR Plan，但调用 `setRetainedUnderlayEnabled(false)`，目的是同屏 Full CPU 基线；预期原生 Fast=0，实际须设备证明。
+
+老 `RCRR_C_WIDE_NO_TIDE`、`RCRR_R_DYNAMIC_NO_TIDE` 仍保留为错误划分安全负对照，不列为正常性能候选。原 `PARTIAL_RCRR` 和 `STATIC_RC` 及 v1 报告均保留历史事实。
+
+Test App 菜单的操作 ID 从10/11/12迁移到100/101/102，避免新增 enum 场景 10/11 与 Snapshot、Mutate 冲突；Full 对照按钮显示 CACHE OFF。Native 摘要新增 `sampleElapsedMs` 与 benchmark 档 6 秒报告周期，仅用于关联 CPU 采样，不修改 Gate 或 Render 路径。
+
+## 四、CPU 真实测量方案
+
+新增 `tools/particle_android_validation/benchmark_step119_cpu.py`：在用户提供相同源码构建并正确安装的 APK 上，调用既有严格 `inspect()` 锁 commit、SHA、ABI/安装设备；启动目标 Activity，Warmup35秒，稳定观察90秒，按6秒读取 Android `/proc/PID/stat` 的 utime+stime 和 `/proc/uptime`。设备访问能力已只读检查：真实 `CLK_TCK=100`，`/proc/<PID>/stat` 可读取，但**CPU Benchmark 本身尚未对新 APK 运行**。
+
+输出 `CPU Core Seconds`、`CPU Core Equivalent`（CPU%相对单核）、`Native FPS`、Fast/Full增量、FastFraction、估算 `CPU ms/完成帧` 和分段 Build/Reuse/Invalidation。CPU 为**整个 App 进程**的时间，并非 C++ renderer 独占的精准逐帧计时。Fast 稳定区间要求 FastFraction≥95%，Full 对照要求 Full>0、Fast=0，且 24 Gate mismatch=0；失败按原始事实保存 JSON 并返回非零。
+
+新增 `tools/particle_android_validation/compare_step119_cpu.py`：读取 Full→Fast→Full A-B-A 实际结果与 RCR/RCRRR 结果，校验同设备/APK SHA/Style 指纹、场景生命周期和 CPU/Native 边界，将 Full 两轮作为 CPU/帧基线，计算各 Fast 组 CPU/帧变化比例及 CPU/秒和 FPS。若 Full 两端 CPU/秒漂移大于15%，结果标记需复测。此比较用于检验 CPU FastPath 收益，**不代表 GPU 时间、能耗或省电已经证明**；FPS 不同时必须同时呈报 CPU每秒与CPU每帧。
+
+## 五、当前已执行验证与未执行项
+
+- Python 非 Jest 结构/CPU 算法测试：12 项 PASS，运行退出码 0；涵盖4类有效性能结构与2类保守负例、错误分段/缺源/Annotation失败、原 STATIC_RC / 原 PBF63 边界、proc/stat解析与 CPU/fps 归一计算。
+- CPU 工具 CLI 参数校验/AST：PASS；Android ADB 读设备时钟率：`100`（只读）。
+- `git diff --check`：本阶段代码检查通过，最终 commit/push 信息以后续 RDC 实际状态补充。
+- 新 Kotlin Test App 尚未经用户手工 Gradle 编译/打包；四种 CPU 场景 Native 真实 Full/Fast、CPU时间、帧率与图像仍为 **NOT VERIFIED**。
+- Source/Style/Tile/Camera/Annotation 等失效及恢复、13项 STEP119 Native GTest、Metal/iOS 独立验证均未完成。Mac libuv 既有缺失不擅自装依赖/升级系统工具。
+
+## 六、工程风险与下一步
+
+只有在 C[32,33) 实际得到 Fast、视觉匹配及 CPU/帧或 CPU/秒的受控改善后，才考虑产品采用。多 R 可能提高 FBO/Composite 成本；WeatherColor 放 R 可能因当前 Core 类型/动态数据结果证书被保守拒绝；如果 Main CPU 指标改善但持续功耗/热度上升，也不等于总体有益。
+
+详见 `docs/60_测试/STEP-119_RCRR多配置验收矩阵_v2.md`。本报告是阶段验收，不进入发行、不创建 Tag/SOURCE_LOCK，也不覆盖上轮或未跟踪的 STEP110/111。Git 以 RDC 实际新 commit/push/远端 SHA 返回为准。

docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md

@@ -0,0 +1,147 @@
+# STEP-120 iOS 原始 Filter 无损 Native 接口 Codex 完成报告 v1
+
+日期：2026-10-21（JST）。结论：**BLOCKED（未实现公共接口）**。
+
+本轮完成前置阅读、实际源码调查与交接条件整理。当前“仅改两个文件、直接复用指定转换器、所有原始 Filter 无损、Native 拒绝 detach Layer”四项要求存在契约阻塞；没有修改 SDK，也没有将调查或空白检查写成接口实现、编译或运行 PASS。NavSea 仍为联调唯一业务主责，D4-13 未解除阻塞。
+
+## 1. 环境、模型与 Git 基线
+
+- 实际主机：`Mac.lan`，Darwin `24.6.0`，macOS `15.7.7 (24G720)`，`x86_64`。
+- 仓库：`/Users/tei/dev/MapLibreParticleLab`；分支：`particle/main`；开工 HEAD：`9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`。
+- `git worktree list --porcelain` 仅列出原仓库；`git submodule status` 全部为正常空格前缀，没有未初始化、偏离提交或冲突标记。本轮没有修改子模块。
+- 开工 tracked 工作区和暂存区无差异，但不是完全干净：预先存在未跟踪任务书 `docs/40_任务/STEP-120_iOS原始Filter无损Native接口_Codex任务_v1.md`。保留该文件，未 stage。
+- 用户指定外部 CLI 配置为 `GPT-6.1 Sol High`（`gpt-6.1-sol / high`）。当前工具未提供执行器模型/推理参数元数据，实际配置无法独立核验；不把用户指定值写成已核实的运行身份。没有切换模型、启动其他 Codex 实例或子代理。
+- 只读发行文档：Android/RN `13.6.1-particle.27`；iOS Metal/SwiftPM `6.29.0-particle.27`；发行构建源码 `970e3ad606e59873a32e9389e65ef257e1c259bb`；正式 Tag `maplibre-particle/rn/13.6.1-particle.27`。这些是既有发行记录，不包含本 Step 的新接口。
+- 已完整读取 `AGENTS.md`、`PARTICLE_BASELINE.md`、`docs/00_项目规范/` 全部文档、项目总则 README 指定的四份现行总则、当前任务书、V27 README，并回读相关 Darwin/C++ 实现与上一 Step 生命周期修复报告。
+- 历史 Linux 路径、Ubuntu 环境及旧版本坐标与当前 Mac/V27 事实不同；遵循当前任务，不修改总则、不创建分支。当前任务指定的报告目录与 Git 禁止项优先于历史流程。
+
+## 2. 阻塞证据与边界
+
+### B1：指定复用的 JSON 桥接并非对所有合法 JSON 字符串无损
+
+实际源码：
+
+- `platform/darwin/src/MLNStyleValue.mm:16`：字符串使用 `@(value.c_str())`；第 34 行字典键同样使用 `c_str()`。两处都采用以 NUL 结尾的字符串语义。
+- `platform/darwin/src/MLNConversion.h:105` 起：`toString()` 使用 `std::string([value UTF8String])`，没有传入 UTF-8 字节长度；字典成员枚举的键也使用无长度构造。
+- `src/mln/style/rapidjson_conversion.hpp` 的字符串及键转换使用 `GetStringLength()`，因此从 Style JSON 进入 Core 的字符串可以保留嵌入 NUL。
+
+可复核的源码级反例：合法 JSON Filter `["==","name","a\u0000b"]` 可在 Core 保留三字节字符串。`Filter::serialize()` 保留其值，但指定 getter 桥接会将该字符串变成 `@"a"`；setter 直接使用当前 Foundation 转换器也会截断同类输入。这是源码推导，**没有执行 iOS 实验**。
+
+只增加两个直接包装方法会公开有损接口。预检后拒绝嵌入 NUL 可以避免静默损坏，却仍无法提供任务要求的所有未修改原始 Filter 的精确快照，属于缩小契约，不能自行采用。
+
+若继续坚持通用无损约束，需确认以下实现路径之一：授权修复既有辅助文件 `MLNStyleValue.mm`、`MLNConversion.h`；或明确允许在新接口内实现独立的长度感知转换，调整“直接使用真实既有辅助函数”的要求。前者超出当前两个源码文件范围，并需要验证共享转换器对旧接口的影响；本轮两者均未实施。
+
+此外，Foundation 转换器的数值 `toValue()` 使用 `doubleValue`，而 Core 的 legacy Filter 序列化可保留 `uint64_t/int64_t`。例如 legacy 数值 `9007199254740993` 存在 setter 精度丢失风险。后续必须验证并明确精确支持或失败拒绝，不能将 Foundation 输出持有整数等同于双向无损。
+
+### B2：rawLayer 存活不等于仍属于当前 Style
+
+- `platform/darwin/src/MLNStyleLayer.mm:15` 起仅保存私有 `_pendingLayer` 与 `_weakLayer`；`rawLayer` 返回 `_weakLayer.get()`。
+- 同文件 `removeFromStyle:` 在成功移除时把 Core Layer 所有权转回 `_pendingLayer`；正常移除后 `rawLayer` 仍有效，可重新加入 Style。
+- `MLNStyleLayer_Private.h` 的 `MLNAssertStyleLayerIsValid()` 只拒绝空 `rawLayer`，未提供 Style 成员关系检查。公共及私有现有 Layer 接口也没有 owning Style / attached 查询。
+
+因此，这个宏可以处理因销毁而失效的 Layer，却不能满足“Native 拒绝所有正常 detach Layer”的严格解释。仅在两个文件内添加新的生命周期标记不能替代权威 Style 查询；本轮不建立另一套 Host Context、generation、revision 或生命周期跟踪状态。
+
+已通过异步澄清说明两种语义：沿用 SDK 有效 Layer 语义并由 Host 校验成员关系；或坚持 Native 拒绝 detach、在当前范围下报 BLOCKED。落盘时尚无答复，不把未答复当作放宽安全条件的授权。即使选择前者，B1 仍需解决。
+
+### 已确认可以复用的事实
+
+- `mln::style::Layer` 已有 `getFilter()` / `setFilter()`；`mln::style::Filter` 已有 `serialize()`。
+- `MLNStyleValue_Private.h` 声明真实 `MLNJSONObjectFromMBGLValue()`；`MLNConversion.h` 提供 `makeConvertible(id)`；`mln/style/conversion/filter.hpp` 提供 `Converter<Filter>`。现有 `NSPredicate+MLNAdditions.mm` 是直接转换调用的实际参考。
+- `Filter{}` 序列化为 `NullValue`，既有 Foundation 桥接将其变成 `NSNull`。但 Core 当前转换 `null` 的 legacy 分支生成恒真表达式，不能直接把这一步当作原空 Filter 的精确恢复；新 setter 应对空值明确设置 `Filter{}`。
+- `platform/darwin/bazel/files.bzl` 已将 `MLNVectorStyleLayer.h` 列入 `MLN_DARWIN_OBJC_HEADERS`，`.mm` 已登记源码；`platform/darwin/BUILD.bazel` 的 `darwin_objc_hdrs` 被 `platform/ios/BUILD.bazel` 的 `public_hdrs` 引用并传入 `MapLibre.dynamic`。无需为公开声明修改生成器或构建配置。
+
+## 3. 实际修改与 ABI 状态
+
+仅有以下项目文档变更：
+
+| 文件 | 处理 |
+| --- | --- |
+| `docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v1.md` | 新增本报告；创建前不存在同题版本。 |
+| `docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v1.md` | 新增阻塞状态与交接清单；创建前不存在同题版本。 |
+| `粒子开发记录.md` | 仅末尾追加本 Step 事实。 |
+
+`MLNVectorStyleLayer.h/.mm`、全部辅助源码、C++ Core、具体 Layer 生成器、Android、Particle、RenderCore、发行文档及 SOURCE_LOCK 均未修改。没有新增 ObjC selector、导出符号、实例变量或 C++ ABI 变更；当前 SDK **没有** `rawStyleFilterJSONObject` / `setRawStyleFilterJSONObject:error:`。不应让 Host 直接调用尚不存在的方法。
+
+阻塞解除后的接口草案仍为以下两个 selector，**不是本轮已交付 API**：
+
+```objc
+- (nullable id)rawStyleFilterJSONObject;
+- (BOOL)setRawStyleFilterJSONObject:(nullable id)json
+                             error:(NSError * _Nullable * _Nullable)error;
+```
+
+新接口应说明线程与现有 Style 修改入口一致；getter 从当前 Core Filter 取值，不经 NSPredicate 或初始化 styleJSON；setter 先检查 JSON 类型、有限数值、深度及循环容器，再解析临时 Filter，只有成功后才能调用 `setFilter()`；失败不修改原层。`nil` / `NSNull` 的清空语义及错误域/异常应在实现时冻结。不得更改原 `predicate` 的签名或旧行为，也不得通过移除重建 Layer 实现恢复。
+
+## 4. 至少三组安全样例与 RDC Test Gate
+
+以下是交接的源码级断言条件，**均未编译、未运行**，没有新增或修改测试文件。可在授权后使用现有 Darwin `MLNStyleLayerTests` / `MLNPredicateTests` 框架组织测试；当前任务禁止扩大测试文件范围，本轮将样例保存在报告中。
+
+### 样例 A：两个不同属性的 all，加 locale
+
+```json
+["all",
+  ["<=", ["string", ["get", "name"]], "m",
+    ["collator", {"case-sensitive": false, "diacritic-sensitive": true, "locale": "de"}]],
+  [">=", ["string", ["get", "category"]], "a",
+    ["collator", {"case-sensitive": false, "diacritic-sensitive": true, "locale": "de"}]]]
+```
+
+从当前运行时 Layer 读取 `before`，确认含第二个属性 `category`、两个条件及两个 `locale=de`。设置独立覆盖 Filter 后恢复 `before`，断言读取对象与 `before` 结构相等，Core `serialize()` 的对应树一致。不要只断言 NSPredicate 相等。另以数值 `all` 的 `minDepth <= 10` 与 `maxDepth >= 2` 验证不同属性不会折叠成同一属性的 BETWEEN。
+
+### 样例 B：一般等号
+
+```json
+["==", "kind", "buoy"]
+```
+
+对 legacy 形式及表达式形式 `["==",["get","kind"],"buoy"]` 分别执行读取、覆盖、恢复；以当前 Core 序列化结果为比较基准。外部通过其他有效 SDK 入口修改 Filter 后，新 getter 必须反映当前状态，不能回读初始化 JSON。全过程记录 Layer 身份、ID、Source、Paint/Layout 与层序，确认仅 Filter 变化。
+
+### 样例 C：原为空
+
+构造当前 Core `Filter{}`，getter 应返回 `NSNull`；覆盖后以该快照恢复，断言 Core `bool(getFilter()) == false`，`serialize()` 仍为 NullValue，而非恒真表达式。若接口最终允许 `nil`，同样验证其清空行为。`NSNull` 也应在合法嵌套 JSON 位置保留，不得吞掉数组成员。
+
+### 必需反例与扩展条件
+
+| 条件 | 必须观测的结果 |
+| --- | --- |
+| 当前 Filter 含 `a\u0000b`；对象键含嵌入 NUL | 阻塞解除后应精确保留字符及键长度；不能静默变成 `a`。 |
+| legacy 整数 `9007199254740993` | 精确往返，或在变更前明确拒绝不支持的输入；不能静默取整后返回成功。 |
+| 超过冻结深度上限、循环数组/字典、非字符串键、NSDate/NSData、NaN/Infinity、Core 解析错误 | 明确失败，设置前后 Core Filter 和其余 Layer 状态完全一致。深度上限须在实现时明确，当前未冻结数值。 |
+| 销毁 Style 后 rawLayer 失效、正常移除仍存活、同名 Layer 替换 | 分别按最终冻结的失效/成员关系契约拒绝；不得用旧指针或只比较 Layer ID 伪造有效性。 |
+| Raster/Background Layer 或错误的内部 raw 类型 | 不得走 Vector Filter 设置；明确拒绝/异常。 |
+| Core 序列化得到布尔常量 | 验证 getter 快照能否被 setter 精确恢复；现有 Core 顶层 primitive 转换行为需要专门处理，不能假定直接转换总是对称。 |
+
+## 5. 已执行与未执行检查
+
+已执行：仓库规范和任务阅读、实际主机检查、Git branch/HEAD/status/worktree/submodule 只读检查、实际调用签名与公开 Headers 构建链静态审查、三个必需样例的源码推导、保护文件 SHA-256 记录、创建前版本检查。写文档前 `git diff --check` 返回 exit=0；文档落盘后的检查结果见末尾交付记录。
+
+没有执行：ObjC/C++ `-fsyntax-only`、Bazel/Xcode/CMake/Ninja/Gradle 编译、链接、codegen、XCTest/GTest/Jest、打包、安装、ADB、模拟器/真机运行、网络发行核验。没有编译/测试失败日志，因为没有启动这些命令。若干只读探查最初使用旧 `mbgl` 路径或不存在的候选辅助头，随后按真实 `mln` 路径核对；这不是构建结果。
+
+没有执行任何 stage/commit/push/tag、新建/切换 branch/worktree、reset/clean、依赖升级或发布。没有新增制品，因此没有本 Step 的 XCFramework/APK/AAR 大小、SHA-256 或设备验收证据。没有远端写入，也未查询远端 HEAD。
+
+保护的预存任务书 SHA-256：`8231df05be824e414e186471e7ca37139545dcb1390658ae2a2734fb2182c547`。保护文件的落盘前哈希保存在本机会话临时记录 `/tmp/step120_readonly_baseline_hashes.json`，该文件不是仓库交付物；最终检查还应直接与 Git HEAD 对比，以免依赖临时文件存续。
+
+## 6. 独立验收命令与后续证据
+
+先解决 B1/B2、重新明确允许范围，再实现接口并交 RDC 独立审计。当前阻塞阶段不应仅运行旧 SDK 构建后宣称新接口通过。以下是从当前正式 Pipeline 读取的准确 **iOS 单项构建命令，Codex 未执行**：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic
+```
+
+不要为此调用 `release.sh ... build`：该脚本还会执行 Android 构建、Maven Local 发布等本任务未授权步骤。不得以现有 V27 产物替代新实现的编译证据。
+
+RDC 构建后应独立读取当次生成的 `bazel-out/darwin_x86_64-opt/bin/platform/ios/MapLibre.dynamic.xcframework.zip`，确认 `ios-arm64/MapLibre.framework/Headers/MLNVectorStyleLayer.h` 中两个公开 selector 均存在。后续提供实际 ObjC 调用编译/链接证据及本报告各样例的 XCTest/运行结果；单纯 ZIP 内出现头文件不足以证明实现可调用。
+
+独立验收需保留：执行器实际模型/档位证据；实现后的 HEAD 与精确 diff；完整命令、exit code、耗时、日志路径；当次 XCFramework SHA-256；导出头文件及可调用性；样例的 Core 序列化前后树、Foundation 值/类型与字符串长度；失败输入的原层未变证据；失效/detach/同名替换行为；Paint/Layout/Source/Z-order 未变证据。新发行与 NavSea Host 集成另起授权步骤，遵守 GSRL 与跨项目边界。
+
+当前未完成：公共 API 实现、输入防护、源码语法编译、iOS SDK 精确构建、实际无损与生命周期验证。当前 ABI 保持原状不等于新 API ABI 验证通过。结论维持 **BLOCKED**，不标记 iOS 可打包、发版、真机 PASS，也不代表原始多源 Provider 项目完成。
+
+## 7. 落盘后的静态交付记录
+
+- `git diff --check`：exit=0，无输出；`git diff --cached --exit-code`：exit=0，暂存区未变。Git diff 不包含未跟踪文档内容，另以 Python 检查两份新文档和开发记录的 UTF-8、末尾换行及行尾空白，全部通过。
+- 当前 tracked 差异只有开发记录，增加 7 行、1513 字节；逐字节确认以 Git HEAD 中的完整旧开发记录为前缀，属于末尾追加。
+- 两个指定 SDK 文件、`MLNStyleValue.mm`、`MLNConversion.h` 与 Git HEAD 字节完全一致；这些源码、V27 README/SOURCE_LOCK 及预存 STEP-120 任务书的 SHA-256 均与落盘前记录一致。
+- `git status --short` 仅列开发记录、两份本轮新增文档及原有未跟踪任务书；没有其他项目修改。branch/HEAD 保持 `particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`。
+- 本节是静态文档/范围检查记录，不是语法编译、iOS 构建或测试 PASS。没有解除 B1/B2，也没有新增接口。

docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md

@@ -0,0 +1,219 @@
+# STEP-120 iOS 原始 Filter 无损 Native 接口 Codex 完成报告 v2
+
+日期：2026-10-21（JST）。实现交付状态：**IMPLEMENTED_WAITING_RDC_IOS_BUILD**。
+
+本轮按 v2 裁决，在限定两个 SDK 文件中增加“无损或拒绝”的通用 ObjC 公共接口。完成的是源码实现和静态审查，**没有执行 ObjC++ 语法编译、iOS 构建或 Native 单测，尚不能确认编译、链接及运行通过**。v1 报告保留原文；其两个契约阻塞由本轮用户裁决收敛，不据此声称完整 JSON 支持。
+
+NavSea 仍为唯一业务主责。本轮没有实现或迁入 Provider、CM95、Mapping、四档、Pickup、Danger、Planning 逻辑；原始多源 Provider 总目标仍开放。
+
+## 1. 环境、模型与 Git 基线
+
+- 实际主机：`Mac.lan`，Darwin `24.6.0`，macOS `15.7.7 (24G720)`，`x86_64`；仓库 `/Users/tei/dev/MapLibreParticleLab`。
+- 开工分支/HEAD：`particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`。`git worktree list --porcelain` 只有原工作区；子模块状态均为空格前缀，无未初始化、偏离提交或冲突标记。
+- 开工不是干净工作区：开发记录已有 v1 的末尾追加；未跟踪文件包括 v1/v2 任务书、v1 Step 和 v1 报告。它们均保留；本轮不覆盖旧文档、不暂存。
+- 用户指定外部执行器必须为 `GPT-6.1 Sol High`（`gpt-6.1-sol / high`）；工具没有可独立核实的模型/推理参数元数据。因此仅记录用户指定配置，实际执行器配置仍待外部证据，不宣称已核实。未自行切换模型、启动另一实例或子代理。
+- 已重新完整读取 AGENTS、PARTICLE_BASELINE、项目规范全部文档、总则 README 及四份现行总则、当前路线、v1/v2 任务书、v1 报告、V27 README 和相关 Darwin/Core 源码。早期 Linux 路径/系统/版本与实际 Mac/V27 不同，按本轮任务执行，未编辑总则。
+- 现有正式坐标仍为 Android/RN `13.6.1-particle.27`、iOS `6.29.0-particle.27`；发行构建源码为 `970e3ad606e59873a32e9389e65ef257e1c259bb`。本轮新接口没有进入该既有发行包。
+
+## 2. 实际修改文件与接口
+
+| 文件 | 实际修改 |
+| --- | --- |
+| `platform/darwin/src/MLNVectorStyleLayer.h` | 增加两个公共 selector、错误域/枚举及中文契约说明。 |
+| `platform/darwin/src/MLNVectorStyleLayer.mm` | 增加局部预检、独立快照、Core 解析、结构/表达式核对与 Filter 写入后回滚验证。 |
+| `docs/50_Step记录/STEP-120_iOS原始Filter无损Native接口_v2.md` | 新增本次实现/待验收清单。 |
+| `docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md` | 新增本报告，不覆盖 v1。 |
+| `粒子开发记录.md` | 在开工时已有 v1 内容之后仅末尾追加。 |
+
+公开接口：
+
+```objc
+- (nullable id)rawStyleFilterJSONObjectWithError:(NSError * _Nullable * _Nullable)error;
+- (BOOL)setRawStyleFilterJSONObject:(id)json error:(NSError * _Nullable * _Nullable)error;
+```
+
+getter 成功返回数组或 NSNull；失败返回 nil。setter 接收数组或 NSNull；nil 不是清空指令。两者成功都会将提供的 error 指针置 nil，可以不传 error 指针。采用带 error 的 getter，使不支持的快照和真正的空 Filter 可明确区分。
+
+错误域为 `MLNStyleFilterErrorDomain`；NSError.code 使用以下公开枚举，localizedDescription 以对应标识开头，Host 应以域/数值分支而非解析描述文字。
+
+| code | 公开枚举 | 标识及意义 |
+| --- | --- | --- |
+| 1 | `MLNStyleFilterErrorUnsupported` | `E_FILTER_UNSUPPORTED`：不支持、超限、不可逆或写入前验证异常；没有调用目标写入。 |
+| 2 | `MLNStyleFilterErrorInvalidLayer` | `E_FILTER_INVALID_LAYER`：rawLayer 不存在、类型不符或写入前已失效/被替换。 |
+| 3 | `MLNStyleFilterErrorWrongThread` | `E_FILTER_WRONG_THREAD`：未在主线程调用。 |
+| 4 | `MLNStyleFilterErrorMutationFailed` | `E_FILTER_MUTATION_FAILED`：写入或后验核对失败，原 Filter 已恢复且核实；Host 应重新获取状态。 |
+| 5 | `MLNStyleFilterErrorRollbackFailed` | `E_FILTER_ROLLBACK_FAILED`：无法确认恢复，Host 必须废弃当前操作 Context。 |
+
+## 3. 源码安全不变量与静态证明
+
+### 3.1 预检与表示等价
+
+`NormalizeFilterValue` 直接遍历 C++ `mln::Value`，只接受 JSON 值。`SnapshotFilterJSON` 独立读取 Foundation JSON 为 C++ 值，使用带长度 UTF-8 字节，不调用全局转换器来决定输入是否已经有损。对象键和值、数组成员和顺序、布尔与数值类型均保留；对象键顺序不参与 JSON 等价比较。
+
+有限、范围内的整数和浮点数归一为 double 后进行 C++ 树比较，避免整数/浮点存储类型不同导致误拒绝。整数界限为 `±9007199254740991`，整数转 double 在此范围精确；更大的整数/浮点数即使恰好可表示也保守拒绝。NSNumber 仅接受标准整数/float/double/布尔编码，CFBoolean 与普通数值区分，NSDecimalNumber 全拒绝；不做十进制舍入或字符串数值解析。
+
+字符串、键在调用真实 `MLNJSONObjectFromMBGLValue` 之前，必须证明 UTF-8 有效且不含 NUL。桥接后再次经独立读取器生成 C++ 树并比较，防止转换产生截断、类型改变或键合并。**未修改** `MLNStyleValue.mm`、`MLNConversion.h` 等全局转换器。
+
+### 3.2 getter 的重放证明
+
+1. 在主线程检查当前 rawLayer 非空且 Core LayerTypeInfo 为 Geometry/Source::Required，复制当前 Filter；不读取 NSPredicate 或初始化 styleJSON。
+2. 先对表达式树做深度/节点预检，再从当前 Filter 的 `serialize()` 得到值树并检查资源/类型限制。
+3. 只将受支持的数值存储类型精确归一，调用真实 Foundation 桥接，再独立读取并比较值树。
+4. 使用真实 `conversion::convert<Filter>(makeConvertible(json), error)` 反向解析；要求重放后的 `Filter.serialize()` 与原值树相等。
+5. 同时检查表达式存在性、表达式序列化树和 Core `Expression::operator==`。不以 `Filter::operator==` 的 shared_ptr 身份代替语义检查。
+6. 全部成立才返回快照；不支持或异常返回 NSError，getter 没有任何 Filter 写入。
+
+这同时检查 legacy 保留的 JSON 和实际执行的表达式树；仅仅“legacy 原文还在”不足以通过。
+
+### 3.3 setter 的写入前准入与后验处理
+
+1. 验证 rawLayer/线程，保存原 Filter 副本及原 Layer 弱指针；独立读取调用方 JSON。调用方不得并发修改容器或 Style。
+2. 从受检 C++ 值建立桥接快照，Core 只解析这份独立对象；要求输入树与解析后 `serialize()` 相等。
+3. 对新 Filter 运行 getter 的整条重放证明，再对原 Filter 做相同证明。**原状态不支持快照时也拒绝覆盖**，不把危险旧状态先覆盖再考虑恢复。
+4. 写入前重新核对弱指针/当前 rawLayer 身份及原 Filter；验证期间改变则拒绝。只有这些检查结束后才调用 `setFilter(next)`。
+5. 写入后核对实际 Filter 的值树及表达式；成功才返回 YES。发生异常或不等价则调用 `setFilter(previous)` 恢复保存的真实 Filter，随后独立核对恢复结果。
+6. observer 可在写入/恢复后抛异常，所以恢复后的核对独立执行。弱指针失效时不继续解引用旧地址，返回无法确认恢复的错误。
+
+`setFilter` 只有目标写入和回滚两处；没有移除/重建 Layer、改变 Paint/Layout/Source/层序或重载 Style。写入尝试可能触发既有 Core observer/渲染失效；回滚不撤销已产生的通知，Host 不能把错误当作无事件发生，也不能在无法恢复时继续复用原 Context。
+
+空 Filter 特例在解析前直接构造 `Filter()`，不把 NSNull 经 legacy converter 变成恒真表达式。Root NSNull 可成功读写；合法嵌套 NSNull 保持原成员位置。
+
+## 4. 精确准入与拒绝域
+
+| 项目 | 本次约束 |
+| --- | --- |
+| JSON 深度 | 根为 1，最大 64；对象键也按其子节点深度计数。循环容器会触及深度/节点限制而拒绝。 |
+| 节点数 | 单次值树最多 4096，包含容器、值和对象键；表达式树另受 64 层/4096 节点限制。 |
+| 字符串大小 | 一棵值树的字符串及键 UTF-8 字节总量最多 262144；不是 HTTP 大小或进程内存限额。 |
+| 字符 | 字符串/键任意位置含 U+0000、非法 UTF-8/无法无损编码均拒绝，包含 literal 数据。 |
+| 数值 | 拒绝 NaN、Infinity、负零、绝对值大于 2^53-1、NSDecimalNumber、非标准 NSNumber 编码。布尔和数字不合并。 |
+| Foundation 类型 | 支持 NSArray、NSString、NSNumber、NSNull、仅字符串键的 NSDictionary；其他类型拒绝。顶层只准数组或 NSNull。 |
+| 操作符候选 | `all/any/none/!`，`==/!=/</<=/>/>=`，`get/has/!has/in/!in/literal`，`string/number/boolean` 断言和 `collator`。候选仍必须过 Core 解析及后验比较。 |
+| legacy 子集 | 仅明确形状的纯 legacy 组合：all/any/none 的子项仍为 legacy；比较为属性字符串加单个标量；in/!in 为属性字符串加标量列表；has/!has 恰有属性参数。混合表达式、数组/对象操作数或额外参数拒绝。 |
+| Core 变化 | setter 输入增加隐式断言、literal 标量展开、常量折叠、缺省 collator 参数补全、丢失未知键或其他结构变化均拒绝；不靠猜测证明等价。 |
+| 其他复杂表达式 | match/case/let/within/distance 等不在本次候选集，即使 SDK 其他入口支持也拒绝。未来扩展另行授权。 |
+| 常量 Filter | 顶层布尔快照当前拒绝；NSNull 不与恒真布尔合并。 |
+| 当前状态 | 原 Filter 不能通过 getter 全路径证明时，setter 同样拒绝覆盖，包括清空操作。 |
+
+Core 自己的 `serialize()` 必须先产生实际值树，之后才能检查该树的大小；本次限制约束准入值和局部遍历，不承诺 Core 内部首次序列化的绝对内存/耗时上界。对已存在表达式先做遍历上限检查。未增加缓存、并发保障或任意自定义 Foundation 子类的副作用隔离；调用方应传普通 JSON 容器并在主线程串行操作。
+
+当前运行时 getter 获得的快照已经过往返验证，可直接作为恢复候选。Host 新造的 setter 输入应使用 Core 可往返形式，例如数值范围显式使用 `number` 断言、collator 显式带两个布尔项；不要把“合法 Style JSON”理解为本次 API 必须接受的全集。
+
+## 5. Style 成员关系与 ABI 边界
+
+SDK **只操作当前有效 rawLayer**。正常 `removeLayer:` 后仍由 ObjC pendingLayer 拥有的对象、尚未加入 Style 的对象，可以使用本次接口；销毁后的空 rawLayer 拒绝。Host 必须用当前 Style 的 Layer ID 查询结果核对对象身份，并检查自身 Token/代次/Context 与外部修改。Native 没有创建另一套 Context、generation 或 revision；弱指针仅用于本次调用后验核对和回滚。
+
+Raster/Background ObjC 对象不继承本接口，Host 应先做 MLNVectorStyleLayer 类型检查。内部错误地给 Vector peer 绑定非 Geometry 或不需 Source 的 rawLayer 时返回 InvalidLayer，不对其写 Filter。
+
+本轮新增两个 ObjC selector、一个导出 NSErrorDomain 和枚举，没有新增实例变量、修改 C++ ABI、改变既有方法签名或实现。旧 predicate/description 方法从 `setPredicate:` 起的完整实现后缀与 HEAD 逐字节相同。**二进制兼容性仅有静态依据，尚未编译/链接验证**；旧 V27 二进制不具备新接口，不能使用新头文件链接旧包并宣称可用。
+
+`MLNVectorStyleLayer.h/.mm` 已在 `platform/darwin/bazel/files.bzl` 登记；公共头经 Darwin `darwin_objc_hdrs` 传入 iOS `public_hdrs` 与 `MapLibre.dynamic`；iOS umbrella `Mapbox.h` 已 import 此头。未修改生成器、Build 配置或发行记录。
+
+## 6. 安全样例及静态采集
+
+以下 JSON/断言条件随本报告交付；只核对了生产源码路径，**未编译、未运行 Native 样例，不记测试 PASS**。不在允许范围外新增测试源码，也没有 Jest。
+
+### A：简单等值（表达式与受限 legacy）
+
+```json
+["==", ["get", "kind"], "buoy"]
+```
+
+另测 legacy `["==","kind","buoy"]`。两者分别从当前 Core Filter 取快照、设置其他受支持 Filter、恢复原快照；记录 C++ `Filter.serialize()`、表达式树及 Foundation 值。要求恢复前后的树相等，不以两种 Filter 互相相等替代各自恢复。
+
+静态依据：Core comparison 对 `==` 保留 get 与字符串操作数；legacy 原文和值树由 Core 保留，反向生成的实际 legacy 表达式也接受独立相等检查。
+
+### B：范围 all 使用两个不同属性
+
+```json
+["all",
+  ["<=", ["number", ["get", "minDepth"]], 10],
+  [">=", ["number", ["get", "maxDepth"]], 2]]
+```
+
+静态依据：显式类型断言避免 setter 再由 Core 增加 number 包装；两个条件和 `maxDepth` 均在 Value 比较中逐项保留。Core 重放及表达式相等也必须通过，SDK 不走原 NSPredicate 的 BETWEEN 折叠路径。RDC 应另外给原始无显式断言形式做 setter 负例，确认结构变化时返回 Unsupported 且无写入；运行时 getter 对已由 Core 生成断言的 Filter 则从当前序列化读取。
+
+### C：两个属性及 locale 参数
+
+```json
+["all",
+  ["<=", ["string", ["get", "name"]], "m",
+    ["collator", {"case-sensitive": false, "diacritic-sensitive": true, "locale": "de"}]],
+  [">=", ["string", ["get", "category"]], "a",
+    ["collator", {"case-sensitive": false, "diacritic-sensitive": true, "locale": "de"}]]]
+```
+
+静态依据：Core `CollatorExpression::serialize()` 明确保留两个布尔项及 locale；本次独立 JSON 读取保留所有对象成员；getter/setter 需要两棵条件树及实际表达式同时相等。RDC 必须断言 `category` 和两个 `locale=de` 均保留，并验证省略布尔项的 setter 输入被保守拒绝。
+
+### D：NUL 明确拒绝
+
+```json
+["==", "name", "a\u0000b"]
+```
+
+另测 literal 对象键 `a\u0000b`。getter fixture 应从 Core 构造含完整三字节字符串的 Filter，避免经有损辅助函数先构造错误测试基线。setter 通过 NSJSONSerialization 解析上述 JSON 得到含 NUL 的 NSString。两条路径都应返回 Unsupported；setter 比较完整原 Filter/原 Impl 与 observer 计数，确认预检拒绝、没有 setFilter 调用。静态依据为 `FilterBudget::string()` 在桥接之前的 `find('\0')` 检查。
+
+### E：空 Filter 与 common 组合
+
+Core 原 `Filter()` 的 getter 应返回 NSNull，设置有效 Filter 后用 NSNull 恢复，要求 `bool(getFilter()) == false`，serialize 为 NullValue。另测 `any`、`!`、`has` 与 `["in",["get","kind"],["literal",["buoy","beacon"]]]`，确认其可往返形式可用，literal 内 NSNull 不丢位置。
+
+RDC 可在现有 Darwin XCTest 框架加入下列调用形状，完整 fixture 与断言仍需由独立验收实现，当前没有已登记的新 Native 测试：
+
+```objc
+NSError *error = nil;
+id saved = [layer rawStyleFilterJSONObjectWithError:&error];
+XCTAssertNotNil(saved);
+XCTAssertNil(error);
+XCTAssertTrue([layer setRawStyleFilterJSONObject:overrideJSON error:&error]);
+XCTAssertNil(error);
+XCTAssertTrue([layer setRawStyleFilterJSONObject:saved error:&error]);
+XCTAssertNil(error);
+XCTAssertEqualObjects(saved, [layer rawStyleFilterJSONObjectWithError:&error]);
+```
+
+还需独立验证：边界深度/节点/字节上限及超限；循环容器、NaN/Infinity/-0、大整数/NSDecimalNumber、非字符串键、NSDate/NSData；未知操作符、短 `["in"]`、混合 legacy/表达式、Core 解析错误；失效 Layer、非 Vector、后台线程；正常 detach 仍有效且由 Host 阻止错误成员操作；外部 Filter 更新被 getter 读取；返回对象修改不影响 rawLayer；Paint/Layout/Source/层序/Layer 身份不变。
+
+回滚测试必须通过测试 observer 或等效受控钩子使 `onLayerChanged` 一次性改写 Filter/抛异常，验证 code=4 的完整恢复；再使恢复无法核实或 Layer 失效，验证 code=5。测试应设置递归保护，不让注入本身无限递归；保存实际前后树及回调计数。当前这些运行证据均缺失。
+
+## 7. 已执行检查、未执行项与差异
+
+已执行的轻量检查：
+
+- 机器/版本及 Git branch、HEAD、status、worktree、submodule 只读检查；当前源码/规则重读。
+- 静态核对真实 Value、Filter、Expression、Layer/WeakPtr、Foundation 转换签名；Bazel C++20/异常支持与公开头路径只读审查。
+- `git diff --check` 以及显式两个 SDK 路径和开发记录的 scoped 空白检查：均 exit=0、无输出；不等同编译。
+- Python 源文件核对：旧 `setPredicate:` 至文件末尾字节完全保持；只含两处 `->setFilter(`；保护任务书、v1 文档、共享转换器及 V27 记录哈希均未变化。这些是源码/保护检查，不是 Native 行为测试。
+
+没有执行 ObjC++/C++ `-fsyntax-only`、Bazel/Xcode/CMake/Ninja/Gradle 构建、链接、codegen、XCTest/GTest/Jest、打包、安装、ADB、模拟器/真机或性能测试。没有新构建/测试失败日志；不能用静态检查声称它们通过。只读查找中的不存在候选路径已按实际 `mln`/`src` 路径核正，不是编译错误。
+
+未 stage/commit/push/tag；未新建/切换分支或 worktree；未 reset/clean、升级依赖、修改其他仓库或发行。没有执行远端操作，故无远端 HEAD 核验。本轮没有产物大小、SHA-256、设备日志或实际运行证据。
+
+与 v2 授权范围差异：无源码扩围；getter 命名采用 `...WithError:` 以返回 NSError，符合本轮无损或拒绝语义。Android 未修改/构建；任务开头双平台授权没有覆盖同一任务中明确的两文件范围与禁止长构建规定。
+
+## 8. RDC 精确命令与独立证据
+
+独立审计本报告与当前 diff 后，在同一实际工作区执行以下 **iOS 单项构建，Codex 未执行**：
+
+```bash
+cd /Users/tei/dev/MapLibreParticleLab
+git diff --check
+bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic
+```
+
+这是现有正式 Pipeline 的真实 iOS target；不要为单项验证调用整套 release.sh，以免执行 Android、Maven Local 或发布步骤。编译失败保留现场，回传首个真实 error、target、必要上下文及完整日志路径，不改宏或放宽 `-Werror` 制造通过。
+
+构建后检查当次 `bazel-out/darwin_x86_64-opt/bin/platform/ios/MapLibre.dynamic.xcframework.zip`：在 `ios-arm64/MapLibre.framework/Headers/MLNVectorStyleLayer.h` 中确认两个 selector、错误域和枚举；再进行实际 ObjC 调用的编译/链接与上述 XCTest。当前正式动态 target 为真机 arm64，不把旧包或其他平台产物当作新接口证据。
+
+需采集：外部执行器实际模型/档位；不变 HEAD 与本轮精确 diff；真实编译 command/exit/耗时/完整日志；新产物 SHA-256 和 Headers；实际调用编译/链接；各样例的 C++ 原树/表达式与重放结果、Foundation 类型/UTF-8 长度、error domain/code；每种预检拒绝前后状态未变；真实回滚两类错误；Style/Layer/Host 身份与失效边界证据；非 Filter 属性及层序不变。
+
+未完成/无法验证项：真实 ObjC++ 编译、链接、iOS Metal SDK 构建、所有 Native 样例执行、回滚异常注入、线程/生命周期和 ABI 消费者验证、真机/Host 联调。若以上成功，另起正式发行与 NavSea Host 集成步骤，遵守 GSRL。本轮不标记 iOS 可打包、发版或真机 PASS。
+
+## 9. 最终静态交付记录
+
+- 文档落盘后 `git diff --check`、`git diff --cached --exit-code` 均 exit=0、无输出；前者不覆盖 untracked 文档，因此另逐文件检查本轮五个文件的 UTF-8、末尾换行及无行尾空白，全部通过。
+- tracked diff 只有两个 SDK 文件及开发记录：头文件新增 54 行、实现新增 374 行；开发记录相对 HEAD 包含既有 v1 和本轮追加，共新增 15 行。本轮相对续行开工时的完整记录仅末尾增加 2037 字节，已验证原字节全量保留。
+- SHA-256 保护检查确认两份任务书、v1 Step/报告、两个全局转换器及 V27 README/SOURCE_LOCK 与本轮开工时一致。临时保护记录位于 `/tmp/step120_v2_baseline.json`，原开发记录快照位于 `/tmp/step120_v2_development_log_before`；它们是本地自检材料，不是构建产物或仓库交付文件。
+- Python 仅解析报告中四组 JSON 样例，确认 JSON 语法、第二属性、locale 和实际解码的 NUL；不代表 Core 接受或 Native 测试通过。
+- 源码交付 SHA-256：`MLNVectorStyleLayer.h` 为 `7c3e09d3582db6bd170bc091d05fe99a02ebc7f400eff60451758245134d9d6f`；`.mm` 为 `0fb201c86c058381007a405c9933406e25f3fa8d15204b22f46d57bda479326d`。
+- 最终 branch/HEAD 保持 `particle/main@9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188`；暂存区无差异，没有其他文件修改。子模块开工状态正常，本轮未修改子模块或工作区结构。
+- 结论仍为 **IMPLEMENTED_WAITING_RDC_IOS_BUILD**；本节所有通过项都仅是静态源码、文档及范围检查。

docs/报告/STEP-120_iOS原始Filter无损接口_RDC编译验收报告_v1.md

@@ -0,0 +1,23 @@
+# STEP-120 iOS 原始 Filter 无损接口 RDC 独立编译验收报告 v1
+
+日期：2026-10-21 JST。联调业务唯一主责 NavSea；专业支持仓 MapLibreParticleLab。本报告只是 Native 编译证据，不是 .28 正式发行、Runtime 或设备验收。
+
+## 实际基线
+- Mac /Users/tei/dev/MapLibreParticleLab，分支 particle/main，初始 HEAD 9d6c9e9684e4c71cc2fb3f08bfb27e1638be4188；未创建/切换分支、Worktree，未触碰无关项目。
+- Codex GPT-6.1 Sol High 已按 STEP-120 v2 修改 platform/darwin/src/MLNVectorStyleLayer.h 与 .mm；中文报告 docs/报告/STEP-120_iOS原始Filter无损Native接口_Codex完成报告_v2.md。
+- 当前新增两个 ObjC API：rawStyleFilterJSONObjectWithError:、setRawStyleFilterJSONObject:error:。保留旧 predicate 逻辑、原 Style Layer 的业务语义和原 .27 正式发行文件。
+
+## RDC 真实编译与校验
+- 命令：bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic。
+- 日志：/private/tmp/JOINT-PBF-001-STEP120-RDC-ios-metal-build-v1.log。
+- 结果：INFO: Build completed successfully, 708 total actions；1176.689s；只有 /opt/homebrew/lib 搜索路径 warning，不影响链接。
+- 产物：bazel-out/darwin_x86_64-opt/bin/platform/ios/MapLibre.dynamic.xcframework.zip。
+- 大小 4,187,287 bytes，SHA256 577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74。
+- unzip -tq PASS；产物仅 ios-arm64 真机 Slice；公开头 MLNVectorStyleLayer.h 包含上述两个 API。
+- git diff --check PASS；尚未执行设备调用或 Native Filter 回滚的独立运行测试。
+
+## 后续及边界
+- “无损或拒绝”不等于所有 CM95 Filter 自动支持；Host 必须核对 Layer 实例、Style 代次、revision、外部修改。
+- .28 GSRL 必须基于干净的冻结源码提交，随后由现有 release.sh 流水线完成 Android/RN/iOS 统一构建、原子发布、公网回读、Source Lock/Manifest、Tag/Push；不得覆盖旧 .27。
+- NavSea 必须等待正式 SwiftPM 6.29.0-particle.28，然后再完成 MLRN iOS Bridge 的查询、应用、恢复三 API 及编译。Android 现有 .27 Kotlin Bridge 已构建通过但 .28 必须回归。
+- 当前状态：STEP120_RDC_IOS_METAL_OPT_BUILD_PASS / XCFRAMEWORK_HEADER_EXPORT_PASS / DEVICE_RUNTIME_PENDING / V28_RELEASE_PENDING。

docs/报告/STEP-121_V28统一正式发行_RDC完成报告_v1.md

@@ -0,0 +1,33 @@
+# STEP-121 V28 统一正式发行 RDC 完成报告 v1
+
+日期：2026-10-21 JST。执行者 GPT/RDC，Native 实现由 MapLibreParticleLab 自己的 GPT-6.1 Sol High Codex 完成。唯一联调 Lead=NavSea，本报告只证明 MapLibreParticleLab 专业支持方的正式发行。
+
+## 结果
+**CLOSED / GSRL RELEASE_PASS**。
+
+| 必做项 | 结果 |
+| --- | --- |
+| STEP-120 两个 SDK 文件与中文报告的 scoped Git 提交 | 已完成，1aba9875f07d8e609eb5bf42810a4d8f40d15d3f |
+| GSRL prepare 版本冻结与源码提交 | 已完成，4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8 |
+| Android 四 ABI Release 与 Maven Local | 已完成，四 ABI 构建均 PASS |
+| RN tgz 与 iOS Metal Bazel opt XCFramework | 已完成，Build PASS |
+| Publish NAS 原子发布及六项公网回读 | 已完成，PASS |
+| SwiftPM Exact 6.29.0-particle.28 | 已完成，公网 Tag PASS |
+| README/SOURCE_LOCK 与最终 GSRL Manifest | 已完成，发行 Git Tag 所在提交包含 |
+| Finalize Git Tag/Push | 已完成，e48258434e5b9ee40ab1d414c223a4ed809be879 |
+| Android/iOS 真机原 Filter 回归 | 无法验证，未运行 App |
+| NavSea 正式 Host 多源 E2E 与 CM95 Mapping | 未完成，属于 NavSea 下一阶段 |
+
+## 版本与锁
+- Android Maven：cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28
+- RN：@navsea/maplibre-particle-rn@13.6.1-particle.28
+- iOS SwiftPM：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git Exact 6.29.0-particle.28 / MapLibre
+- 正式 Tag：maplibre-particle/rn/13.6.1-particle.28
+- 源码 Commit：4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8；Final Commit：e48258434e5b9ee40ab1d414c223a4ed809be879
+- 六项 SHA-256、文件大小、正式下载 URL 参见 release/maplibre-particle/13.6.1-particle.28/SOURCE_LOCK.json。
+- GSRL 日志：/private/tmp/JOINT-PBF-001-V28-GSRL-prepare.log、build.log、publish.log、finalize.log。
+
+## 限制
+Release 成功只证明一套冻结源码构建、来源与公网文件可信，不证明 iOS Filter 的 Runtime 与复杂表达式在设备上能安全切换。新增 Native API 对不支持的 Filter 会拒绝；Host 必须保持 Layer Style 实例、revision、身份和安全审查。未用旧 .27 的截图代替新 .28 设备证据。
+
+下一步由 NavSea Lead 接入与编译验收；本仓不允许追加 CM95 专属业务代码。

docs/报告/V25_iOS实体机Bazel构建兼容性修复与资源溯源_v1.md

@@ -0,0 +1,21 @@
+# V25 iOS 实体机 Bazel 构建兼容性修复与资源溯源 v1
+
+日期：2026-10-11。范围：仅 Particle 统一发行的 iOS Metal 实体机 arm64 构建与 Bazel Core 文件声明；不改共享运行时 API，不引入 Simulator slice。
+
+## 故障与原因
+
+- V25 首次统一发行 `release.sh 25 build` 的 Android 四 ABI Release AAR 与 Maven Local PASS；在 iOS Bazel opt `AssetCatalogCompile` 因 Xcode `actool` 返回 `No available simulator runtimes for platform iphonesimulator` 中断。手工指定 `actool --platform iphoneos` 亦同样失败，不能将其误读为 XCFramework 需要模拟器架构。
+- 后续尝试暴露 Bazel Core 声明缺失：当前源码已新增 `src/mln/renderer/symbol_shader_provenance.hpp`、`symbol_render_inputs.hpp`、`symbol_render_result.hpp`，原 `bazel/core.bzl` 中 `MLN_CORE_HEADERS` 未登记；已补齐三项。
+
+## 实体机资源输入与溯源
+
+- v23 正式发行：`13.6.1-particle.23` / iOS `6.29.0-particle.23`，来源 `release/maplibre-particle/13.6.1-particle.23/SOURCE_LOCK.json` 的正式发行 iOS ZIP。该 ZIP 本地 SHA-256=`9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a`，与 v23 Source Lock 一致。
+- 提取 ZIP 内 `MapLibre.xcframework/ios-arm64/MapLibre.framework/Assets.car`，本次纳入版本控制 `platform/ios/resources/Assets.car`，SHA-256=`997014687d17e93b9a979b4a47229d082e04a03587b01b4718ac7cb20f1a196b`。
+- 核对 `git diff 87f3d1c59a52581fb8339f0ea7d106b9f4b94fef HEAD -- platform/ios/resources/Images.xcassets` 为无差异；即资源原始输入自 v23 冻结源码未改变。保留原始 `.xcassets` 文件供其他构建使用，仅 `apple_xcframework(name="MapLibre.dynamic")` 的资源输入使用上述受控、可追溯的已编译 `Assets.car`，避免当前 Xcode 环境的 `actool` 错误。
+- 该预编译资源绑定 Xcode 26.3 (`17C529`) 工具链；后续原始资源改变或 Xcode 资源格式变更时，须重新生成并记录 Hash，不能无限期假设可复用。
+
+## 验证与边界
+
+- 原 Bazel opt Metal 真机命令：`bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic`。本阶段候选资源及头文件修正的验证结果为 `Build completed successfully`，exit 0；约 772 项，实际构建 563 actions 后的增量验证通过。
+- 产生 `bazel-bin/platform/ios/MapLibre.dynamic.xcframework.zip`，仅 `ios-arm64`，无 Simulator；ZIP 内 `MapLibre.framework/Assets.car` SHA-256 与输入 `997014...` 一致。
+- 以上仅证明 iOS 实体机二进制**可以构建**，不代表 iOS 真机运行通过、NavSea RN 宿主端验收、正式公网发行已通过。正式 Build Source Commit、Android/iOS/RN 同源构建、GSRL Source Lock、远端制品 SHA 需另行严格验收。

docs/报告/V25_统一正式发行_GSRL_RDC完成报告_v1.md

@@ -0,0 +1,36 @@
+# V25 统一正式发行 GSRL RDC 完成报告 v1
+
+日期：2026-10-12（JST）
+结论：**GSRL RELEASED / PASS**。跳过 v24，v23 历史 Tag/制品未覆盖。设备运行时与 Host 联调独立待验收。
+
+## 版本及身份
+
+- Android OpenGL AAR / React Native：`13.6.1-particle.25`；iOS Metal / SwiftPM：`6.29.0-particle.25`。
+- 仓库：`https://git.eyaku.jp/tei/MapLibreParticleLab`；发行分支：`particle/main`。
+- 实际统一 Build Source Commit：`f32f6f45fd359007e8b3c77911b66d9e7fc93848`，已 Push 并与远端一致。
+- GSRL Source Lock 文档提交：`4b2f3c8d3874161c9cba832a4ba28d5182b05ca6`，Commit Message：`release: record v25 GSRL source lock and receipt instructions`。
+- Pipeline Finalize Commit / 完成 Tag 时的 Final HEAD：`3774d0a8418daa36d7a988b2ce9650a6a1178fc4`，Commit Message：`release: finalize unified particle.25`。
+- 不可变正式 Tag：`maplibre-particle/rn/13.6.1-particle.25`，远端 annotated tag peeled Commit = `3774d0a8418daa36d7a988b2ce9650a6a1178fc4`；SwiftPM 远端 `6.29.0-particle.25` 存在。
+- 发布入口：`release/maplibre-particle/13.6.1-particle.25/README.md`、`SOURCE_LOCK.json`；六文件 SHA/大小/地址以 Source Lock 为权威。
+
+## 严格串行执行及验收
+
+1. Integration main 同步并核对跨项目发行约束；版本占用核对，v25 未占用；Prepare 提交 `d5841e6471058614e9a06bf5e27dba0df38e8a97`，远端核验 PASS。
+2. 首次 Build 的 Android 四 ABI AAR、Maven Local PASS；iOS Bazel `actool` 因无 Simulator Runtime 失败。**v25 不增加 Simulator 架构**。使用未变化的 v23 `Images.xcassets` 对应、Xcode 26.3 编译的 `Assets.car`（SHA256 `997014687d17e93b9a979b4a47229d082e04a03587b01b4718ac7cb20f1a196b`），并补齐三处 Bazel Core 头文件声明，详见 `V25_iOS实体机Bazel构建兼容性修复与资源溯源_v1.md`；源修复提交 `f32f6f45fd359007e8b3c77911b66d9e7fc93848`。
+3. 正式 `release.sh 25 build`：**exit 0**，Android 四 ABI 完整，Maven Local、iOS Bazel opt Metal 真机 ios-arm64 ZIP（无 Simulator slice）、RN npm pack PASS。构建日志：`/tmp/maplibre_v25_unified_release_build_final_20261011.log`。
+4. `release.sh 25 publish`：**exit 0**，NAS 原子发布、六文件公网逐字节读回 PASS、SwiftPM Tag 已发布。日志：`/tmp/maplibre_v25_unified_release_publish_20261011.log`。
+5. 生成 GSRL `gsrl/source-lock/v1` Source Lock；六项文件 SHA-256 与本机正式构建产物逐一比对 PASS；版本、依赖、来源、使用说明齐全，Git scoped Commit。
+6. `release.sh 25 finalize`：**exit 0**，正式 Finalize Commit、发行 Tag Push 成功；再次 Fetch 确认 `origin/particle/main` 与正式 Tag 的 peeled Commit 均为 `3774d0a8418daa36d7a988b2ce9650a6a1178fc4`。日志：`/tmp/maplibre_v25_unified_release_finalize_20261012.log`。
+7. 2026-10-12 独立公网二次回读：AAR、POM、Module、RN tgz、iOS Metal ZIP、ZIP.sha256 **6/6 PASS**，各 URL 下载退出码 0、size 与 SHA 均和 Source Lock 相同；SwiftPM 远端 Tag 再次核验存在。
+
+## 三个主体制品 SHA-256
+
+- Android AAR：`629d5d437d884ec2017f3fde007aaadfd2bc787983457f75bcaf4d4a13184a1e`
+- RN tgz：`e5ed678c90bad6082dda30fb9937894cabe28732160391816b785d3c88c208e9`
+- iOS Metal XCFramework ZIP：`91808cfb5559dfa050fe4d466d2c9fa2dc492021bd1a203c778450dc0dae20af`
+
+## 未覆盖事项
+
+- 本次 **未执行 v25 发行 AAR/RN/iOS XCFramework 的 Android/iPad 真机运行与 NavSea Host 整体验收**。早前 STEP-119 Android CPU FastPath 基准来自其他源码版本和 Validation APK，不能冒充 v25 正式制品的设备 PASS；动态 Camera、Style、Source/Tile/Annotation 更新与像素等价仍为后续专项验收。
+- GSRL RELEASED/PASS 仅证明来源、版本、正式制品及公网验收链闭合，不等于功能或性能全场景认证。
+- 本报告为 Tag 后的审计文档增补，**不得移动或覆盖既有发行 Tag**；后续分支文档 Commit 不更改正式 Tag 指向。

docs/报告/V26_Metal混合Segment视觉错误_Retained保留修复调查报告_v2.md

@@ -0,0 +1,73 @@
+# V26 Metal 混合 Segment 视觉错误——保留 Retained 的修复调查报告 v2
+
+日期：2026-10-13
+状态：**iPad F 组真机 FAIL（2026-10-13 18:51 JST）；CommandBuffer 修正候选不能作为修复完成证据。Native 编译/安装/启动通过，但 Retained 视觉验收不通过。禁止发布 V27。**
+前一版：`V26_Metal混合Segment视觉错误_安全降级调查报告_v1.md` **REJECTED**，禁止发布其中关闭 Metal Retained 的方案。
+
+## 1. 用户强制约束
+
+- 不允许关闭整个 Retained、不允许把有效 Retained Plan 隐式改成全量 Live。
+- Retained 必须保持 GPU 离屏绘制、缓存 Build/Reuse、Cache Texture 合成；Continuous 执行频率保持独立。
+- Android/iOS 使用同一套 JS Plan 和用户步骤，不以 `Platform.OS` 分配不同实验语义。
+- 以 Style Z-order 为唯一图层顺序，不改本船、AIS 或天气业务数据。
+- 不新增私有 RN/Native API，不改 Particle Contract。
+- 实际执行：2026-10-13 经用户授权，ChatGPT 通过 RDC 在 Mac 远程执行 iOS Metal 构建、签名、覆盖安装与启动；Android 原生编译和安装未执行。iPad 视觉验收由用户人工确认。
+
+## 2. 已取得的实际复现
+
+来源：Pleiades iPad mini 5，已安装 V26；Windows NavSea Metro `192.168.200.100:8081`。
+
+- E：全 115 层 CONTINUOUS，Retained 总开关开启，0 Retained Segment，iPad 无闪烁，图标/本船航行线/AIS 航线/色场/粒子正确。快照 `/tmp/navsea-v26-ipad-render-20261013/E-0746/start.json`。
+- F：R0 仅 `background`，C1 其余 114 层，Native `valid=true`, `fallback=false`，`actualExecution=[composite,live]`，R0 build 96/reuse 2778。冷启动即图标过大、本船/AIS 航线消失；天气仍可见且不闪。快照 `/tmp/navsea-v26-ipad-render-20261013/F-0740/start.json`。
+- 原始 RC：R0 层 0..30，C1 层 31..114；天气 ON 后闪烁，OFF 后持续。旧 RCR 预检的末端 Layer ID 硬编码与实际 Style 不符，现场最终跑 RC。
+- A：关闭 Retained 不闪；B：Native 天气隐藏不闪；C 和 D 分别只显示色场或粒子都闪。C/D 使用相同 Native Runtime 数据提交，不代表单独 shader 根因。
+
+F 在仅最底层缓存时也失败，说明“缩小缓存至简单图层”不能作为修复。
+
+### 2026-10-13 新构建真机复测（候选 FAIL）
+
+- RDC Mac Bazel `bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic`：943/943，exit 0。新候选 ZIP SHA-256：`b89bc06bf03eba20a5790da21215fe7e167da20b3fdfa6a34782420bd503a354`。
+- 新 XCFramework 从本地 ZIP 替换至暂存 NavSea.app，codesign 重新签名和验证 PASS，Pleiades 覆盖安装及启动 PASS；没有发布/替换正式 SwiftPM V26。
+- 用户报告新候选 E：地图、天气 ON/OFF 都正常（E 不执行 Retained Cache）。
+- 用户报告新候选 F：**FAIL**，冷启动光弧等图形巨大、不闪、航向线消失、天气开关无可见效果。不能将无闪烁当作正确。
+- 新 F Native 快照：`/tmp/navsea-v27-retained-ipad-stage/F-1851/start.json` 和 `end.json`，时间 `2026-10-13T09:51:04Z`、generation 3、mapReactTag 802、118 Style Layers；R0 `[0,1)` `background`、`actualExecution=composite`、`build=13`、`reuse=1069`、`invalidation=13`；C1 `[1,118)` `actualExecution=live`；`valid=true/fallback=false`。证明缓存确实工作，但画面仍错。
+- 结论：CommandBuffer 原实现存在执行序不明确的风险，然而此候选未修复视觉缺陷，**无法将它认定为根因或 V27 修复**。后续重点分析 Metal Composite 的绘制状态、RenderPass、Stencil/Depth 和 Live 绘制的相互作用。
+- 新 F 完成后 Windows Metro 同一 Android/iOS Debug 开关已改回 E，iOS Bundle HTTP 200；**用户于 2026-10-13 20:43 JST 确认 iPad 重新运行 E 后显示 OK**。由此 E 稳定恢复；F 明确失败。候选仍留在 iPad，仅切回 JS E，不代表回装了旧 V26。
+- 后续本轮只读源代码调查：`renderer_impl.cpp` 的 F/E 共同走标准 Live `drawableOpaquePass/drawableTranslucentPass`，区别是 F 额外执行了 `RetainedUnderlayCache::beginBuild/finishBuild/composite`；`mtl::RenderPass` 和 `PaintParameters::beginRenderTarget()` 会重建 Pass 状态及清理 tile clipping mask ID。需重点验证 Cache Composite 的真实 Metal state、Stencil/Depth、顶点/纹理坐标以及 Live drawable 的状态恢复；仅从快照计数不能推断根因。
+
+## 3. 已从实际代码确认的候选根因
+
+V26 `src/mln/mtl/offscreen_texture.cpp` 的 `OffscreenTextureResource::bind` 以 `context.getBackend().getCommandQueue()->commandBuffer()` 单独取得离屏 CommandBuffer；`swap()` 对它独立 `commit + waitUntilCompleted`。
+
+iOS `platform/ios/src/MLNMapView+Metal.mm` 的默认画面 `MLNMapViewMetalRenderableResource` 自建 `commandQueue` / `commandBuffer`，直到帧末 `swap` 才提交。
+
+`renderer_impl.cpp` 先用默认画面 CommandBuffer 组织上传，再绘制 Retained 离屏缓存、调用其 `present`，之后在默认画面绘制缓存纹理及 Continuous。**这两条独立命令队列并不建立“主帧上传 → 离屏构建 → 主帧合成”的 GPU 顺序保证。** 这是确定存在的同步风险；是否是图标放大/航线丢失的唯一原因仍需真机验证。
+
+## 4. 第二版实现（保留 Retained）
+
+- `include/mln/mtl/context.hpp` 和 `src/mln/mtl/context.cpp`：提供帧内借用的主 CommandBuffer 指针，在 beginFrame/endFrame 清理，不持有跨帧引用。
+- `src/mln/mtl/command_encoder.cpp`：默认画面 UploadPass 创建时，将它的 CommandBuffer 登记为当前帧 CommandBuffer。
+- `include/mln/mtl/offscreen_texture.hpp`、`src/mln/mtl/offscreen_texture.cpp`：增加仅供 Retained Cache 显式启用的帧内排序开关。启用后其离屏 RenderPass **复用当前帧主 CommandBuffer**；离屏 `swap` 在共享模式只清理引用，**不提前提交主帧**，由默认画面帧末统一 commit。未启用此开关的离屏纹理（包括 Snapshot/其它 RenderTarget），即使同帧存在主 CommandBuffer，也维持原先的独立 commit/wait。
+- `src/mln/renderer/retained_underlay_cache.cpp`：仅在 Metal Retained Cache 分配或使用 offscreenTexture 时显式启用上述开关；OpenGL 路径不变。
+- `test/renderer/mtl_retained_attachments.test.cpp`：新增共享 CommandBuffer、离屏 swap 后仍允许添加同帧 RenderPass 的针对性 Metal 测试。
+
+预期顺序：一个 Metal CommandBuffer 内 `Upload → Retained offscreen render → main composite → live Continuous → final present`。各 Pass 的独立 Color/Depth/Stencil attachment 继续保留。
+**没有修改 `RetainedUnderlayCache` 的 Build/Reuse/Composite 语义，也没有跳过任意合法 Retained Segment。**
+
+## 5. 验收和停止条件
+
+1. 检查改动的 C++ 格式与差异；本轮不自动运行 Native 编译或设备操作。
+2. 用户手工构建 Metal Candidate XCFramework（使用现有已验证命令 `bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic`），在独立测试版中接入。**不能覆盖正式 V26、不能用旧 SwiftPM binary 冒充新补丁。**
+3. 先运行 MetalRetainedAttachments 的针对性单测，确认共享 CommandBuffer 不提前 commit，独立离屏路径不退化。
+4. iPad 首先复测 F：保留 `[R(background),C(rest)]` 的 Native Plan，不允许 Native 临时回退全部 Continuous；要求 `build>0`、`reuse>0`、`actualExecution=[composite,live]`，并且图标大小和所有航线正常。
+5. F 通过后再测 RC：天气 OFF/ON/OFF，色场、粒子、本船/AIS/海图视觉完整，无异常闪烁；对照 Android OpenGL 同一 JS Plan。
+6. 检查帧率、CPU/GPU 时间、缓存重建/复用、内存；保证 Retained 的性能价值。
+7. F 如果仍错误，**立即停止**，采集 Metal GPU Capture 对比两个 RenderPass 的资源绑定与混合/Depth/Stencil，不能宣布 bug 已修好，也不得重新关闭 Retained。
+
+## 6. 当前工程和发行状态
+
+Mac 仓库 `/Users/tei/dev/MapLibreParticleLab` branch `particle/main`、当前起点 HEAD `b0f34cc9a299a75af1f7e708c63d75eaa42e9ca2`。源码改动尚未 commit/push/tag/publish；正式 V26 SOURCE_LOCK 指向 `fce326a9009d3fc21eb91c5df362f0769163d07e`，它是旧发行身份，不代表此次候选已发布。
+
+Windows NavSea 当前 JS 已取消 iOS 独享 E：Debug Android/iOS 均选 E，Release BASELINE。正式修复后需在新 Native 实际安装成功、用户批准测试窗口后，把共用 JS Test Mode 切到 F/RC 进行对照；不能在旧 V26 上提前切换造成已知异常。
+
+当前明确结论：**这是保留 Retained 的候选修复，尚未通过 Native 编译与设备画面确认，不能写成 CLOSED/PASS。**

docs/报告/V26_Metal混合Segment视觉错误_Retained保留修复调查报告_v3.md

@@ -0,0 +1,45 @@
+# V26 Metal 混合 Segment 视觉缺陷——保留 Retained 修复调查报告 v3
+
+日期：2026-10-13
+状态：**第二版 Stencil 状态修正 F 真机 FAIL / ABORTED；图标仍异常放大，且用户报告地图无法移动。已保存证据、恢复共用 JS E，并归档/撤销失败的源码补丁。不可发布 V27。**
+正式发行：**NOT RELEASED，不得标记 V27 PASS；保留 Retained 构建/复用/合成**
+上版：`V26_Metal混合Segment视觉错误_Retained保留修复调查报告_v2.md`（CommandBuffer 候选 F 真机失败）
+
+## 1. 已证实事实
+
+- Pleiades iPad mini 5；Native 旧 V26 F，及第一版 CommandBuffer 候选 F，均真机 FAIL：背景 Retained 真实 `Build/Reuse/Composite`，但光弧或图标被放大、航向线消失、天气开关异常。旧版本 E（全 Continuous）多次由用户确认正常。
+- 第一次候选 Native F 快照保留于 `/tmp/navsea-v27-retained-ipad-stage/F-1851/start.json` 与 `end.json`，其中 Retained R0 `[0,1)`、C1 `[1,118)`、`build=13`、`reuse=1069`、`actualExecution=composite`、`valid=true`、`fallback=false`。
+- 不能据此认定 CommandBuffer 是根因。原候选 `MapLibre.dynamic.xcframework.zip` SHA-256 为 `b89bc06bf03eba20a5790da21215fe7e167da20b3fdfa6a34782420bd503a354`；旧候选补丁备份在 `/tmp/navsea-v27-retained-ipad-stage/patches/V27_candidate1_commandbuffer_plus_current_context.patch`。
+
+## 2. 本次单变量改动
+
+恢复前一版 CommandBuffer 改动的七个源码/测试文件，原 Candidate 1 不再参与当前源码编译。仅两个文件相对 `particle/main` HEAD `b0f34cc9a2` 发生功能代码修改：
+
+- `src/mln/mtl/context.cpp`：`Context::renderTileClippingMasks` 的 Metal Stencil ID 设置改走 `mtlRenderPass.setStencilReference(...)`，不再绕过 RenderPass 缓存直接调用 `encoder->setStencilReferenceValue`。
+- `src/mln/mtl/tile_layer_group.cpp`：3D Stencil Reference 也走 RenderPass 缓存，删除不再使用的局部 encoder 引用。
+
+代码已确认存在 Metal 原先绕过 RenderPass 状态缓存的路径；其与 F 画面错误的因果关系**尚待真机结果**。没有变更 Retained Cache 或共享 RN API，未禁用 Retained，未引入 JS Android/iOS 平台分流。
+
+## 3. 新 Native 制品与安装
+
+- Mac `/Users/tei/dev/MapLibreParticleLab`，`bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic`，exit 0，约 49 秒；`git diff --check` PASS。
+- 新 Metal ZIP SHA-256：`5a8bef4e8419ae2b8c5bf22253361d40a4ed7ffd7c156ea73d5df8eae72b3393`。
+- 独立保留于 `/tmp/navsea-v27-retained-ipad-stage/candidate2_stencil/MapLibre.dynamic.xcframework.zip`；最小源码 patch 同目录 `candidate2_stencil_only.patch`。
+- RDC Mac 使用现有 `scripts/ios-install-test-device.sh` 的 `scripts/pass.txt` 所对应 Keychain 与签名身份，在暂存 App 替换完整 MapLibre.framework，重新签名并严格验证；覆盖安装 Pleiades `com.navsea.app` 成功，`devicectl process launch` 成功。
+- 无卸载、无清数据、无 SwiftPM V26 正式仓库/Package 更改、无发布、无 Git Commit/Tag。
+- 安装后 E Native 快照：`/tmp/navsea-v27-retained-ipad-stage/candidate2_stencil/E-preF/start.json`，时间 `2026-10-13T12:00:50Z`，`valid=true`，0 Retained / 1 Continuous、`[0,118)` Live。仅验证了运行时模式，并非用户视觉结果。
+
+## 4. 第二版 F 真机结果（失败，已停止测试）
+
+- 用户于 2026-10-13 21:09～21:10 JST 确认 **F 仍有大图标，没有改进，并补充报告“也不移动了”**。目前“无法移动”是手势没有作用，还是相机已变但视觉没有更新，仍需通过输入事件/相机指标判定，不得臆测。
+- 从 Pleiades 实际取得 `Library/Caches/navsea-render-segment-start.json` 与 `end.json`，已保存在 `/tmp/navsea-v27-retained-ipad-stage/candidate2_stencil/F-failed-20261013-2110/`。其中 capturedAt `2026-10-13T12:10:12Z`、`generation=4`、`mapReactTag=804`、`styleLayerCount=118`、`valid=true/fallback=false`；R0 `[0,1)` `background`，`actualExecution=composite`、`build=14`、`reuse=6076`、`invalidation=14`；C1 `[1,118)` `actualExecution=live`；`fullCpuFrame=6231`。帧计数不等于相机更新证明。
+- 用户报告画面失败，Native 配置/执行链未发生全 Live 回退，因此第二版 Stencil 修正 **FAIL**。没有进入 RC，没有发布 V27。
+- Windows Metro 当前统一 Debug 开关已经恢复为 `E_CONTINUOUS_ONLY`，iOS Bundle HTTP 200，Android 同一 JS 源配置；用户需冷启动 iPad 才能加载 E。**用户 2026-10-13 21:18 JST 已再次确认本次切回 E 后正常，包括地图移动；因此 E 恢复 PASS。**
+- 失败的第二版源码 diff 另存 `/tmp/navsea-v27-retained-ipad-stage/candidate2_stencil/candidate2_failed_stencil_source.patch`。已只针对两个改动的 Metal 源文件 `git restore` 回 `particle/main` HEAD；无其他功能文件变更，报告保留，iPad 上仍是已安装的 Candidate 2 二进制（仅 JS 回 E），不等于已更换 Native。
+- 下一轮调查把相机/手势事件、Native 相机矩阵变化、Retained 的 `camera-or-boundary` invalidation、主画面真实绘制与 GPU 合成可视化分开验证，再制定单一变量修复；禁止无验证继续叠加补丁。
+
+## 5. 范围与发布约束
+
+- 仅本地候选，不代表 V27 已发行。
+- 不接受关闭 Retained、全 Continuous 降级或 JS 平台分流作为最终修复。
+- 若 F 依旧失败，下一轮应进一步检查 Retained Composite 顶点/纹理与 Metal Encoder 状态、Stencil/Depth、主画面 RenderPass，并用证据区分构建与合成副作用。

docs/报告/V26_Metal混合Segment视觉错误_安全降级调查报告_v1.md

@@ -0,0 +1,58 @@
+# V26 Metal 混合 Segment 视觉错误与第一阶段安全降级调查报告 v1
+
+**已撤回：2026-10-13 用户明确要求必须保留 Retained 实际构建/复用/合成。本文安全降级代码已在 Particle 工作区撤销，禁止按本文编译或发布。请以同主题 v2 修复调查报告为准。**
+
+日期：2026-10-13
+状态：**已撤回（REJECTED）——原代码级安全降级方案不可用；保留本文件仅作历史记录**
+目标仓库：`MapLibreParticleLab`
+冻结 V26 源码：`fce326a9009d3fc21eb91c5df362f0769163d07e`（SOURCE_LOCK），当前工作分支 `particle/main`，修改前 HEAD `b0f34cc9a299a75af1f7e708c63d75eaa42e9ca2`。
+
+## 一、iPad 实测事实
+
+iPad：Pleiades（iPad mini 5）；iOS 已安装 V26 Native。实验使用 Windows CARBON7i `D:\React\NavSea` 的 Metro `192.168.200.100:8081`，而非 Mac 本地 Metro。
+
+- 原始 RC：天气 ON 后本船/AIS/海图闪烁，天气 OFF 后仍异常。
+- A（关闭 Retained，完整天气）：不闪烁。
+- B（保留 Retained，隐藏 Native 天气）：不闪烁；色场与粒子均无显示。
+- C（只有色场，保留 Retained）：色场出现，闪烁。
+- D（只有粒子，保留 Retained）：闪烁。
+- E（Retained 总开关开、实际 0 Retained + 1 Continuous）：不闪、天气色场和粒子完整，本船/AIS 图标尺寸与航线正常。
+- F（最底层 background 单层 Retained + 其余 114 层 Continuous）：冷启动即图标异常放大、本船航行线与 AIS 航线消失；不闪；天气色场与粒子正常。**F 是失败，不得据其不闪而判 PASS**。
+
+iPad Native 快照原始保存于 Mac：
+`/tmp/navsea-v26-ipad-render-20261013/E-0746/start.json`、
+`/tmp/navsea-v26-ipad-render-20261013/F-0740/start.json`；
+F：`enabled=true`, `valid=true`, `fallback=false`; R0 `[0,1)` 实际 `composite`，C1 `[1,115)` 实际 `live`；
+E：`enabled=true`, `valid=true`, `fallback=false`; 单 Continuous `[0,115)` 实际 `live`。
+旧 RCR 实验曾因 JS 预检将最后 Layer 硬编码为 `chartDangerScanCenterLineLayer`，但实际最后 Layer 是 `route-history-dotted-line`，回退到 RC。不要把当时现场当成 RCR Native 执行证明。
+
+## 二、已核对的 Native 代码路径
+
+`src/mln/renderer/renderer_impl.cpp` 中，实际含 Retained Segment 的绘制在独立 RenderPass 中构建离屏缓存，调用 `RetainedUnderlayCache::composite`，然后绘制 Continuous 图层。
+`src/mln/renderer/retained_underlay_cache.cpp` 的缓存创建与合成对应 `prepareResources`、`beginBuild`、`finishBuild`、`composite`。
+iOS Metal `src/mln/mtl/render_pass.cpp` 已有 Color/Depth/Stencil Clear 逻辑，尚不能证明清屏本身出错。
+现有证据将异常定位在 **实际执行 Retained 离屏构建/合成和连续图层共存时**，但尚未证明具体 GPU 状态或 shader 错误。
+
+## 三、第一阶段保护性补丁（尚未发布）
+
+1. `include/mln/renderer/render_segment.hpp`：新增 `requiresMetalRetainedCompositeSafetyFallback`，针对合法 Plan 内任何 RETAINED Segment + Metal 后端启用安全回退；全 Continuous 和非 Metal 保留原逻辑。
+2. `src/mln/renderer/renderer_impl.cpp`：Native 检测到上述情形时，禁止 Retained 离屏资源构建、Reuse、合成；释放历史缓存；完整 Style 范围做常规 Live Opaque+Translucent 绘制。阻止 Particle FastFrame 在该组合误准入。Native 诊断 `globalLiveFallbackReason` 记录 `metal-retained-composite-safety`，`actualExecution` 应全部为 `live`。
+3. `test/renderer/retained_underlay_cache.test.cpp`：加入 OpenGL 不启用、Metal R-C 启用、Metal全Continuous不启用、Metal全Retained启用、无效Plan不启用的安全策略单测。
+
+**此补丁属于 correctness-first 的暂时降级方案，不是 Retained 合成根因修复，也不提供 Retained GPU 加速。** 禁止在未做真实 Metal 回归前声称问题已关闭。Native 公共 JS API 与输入 Contract 不变；Renderer 层仍以 Style Z-order 为唯一图层顺序。
+
+## 四、待用户手工验收
+
+1. 保留冻结 V26 artifact，不覆盖正式发行版本；从当前修改源码建立新的测试版 iOS Metal XCFramework / Test Host，不把未验证产物标成 V26 正式版本。用户手工完成 iOS 构建、安装、启动。
+2. 用统一 JS 测试配置加载含 Retained Segment 的 RC/F 方案，确认 Native 诊断显示 `global-live`、`metal-retained-composite-safety`，且无 Retained texture build/composite；不能只凭 JS mode badge 判断。
+3. 冷启动关天气、ON、OFF，检查本船/AIS 图标尺寸、航行线、海图层、天气色场、粒子、图层 Z-order、视觉稳定。
+4. Android OpenGL 使用完全相同的 JS Plan 对照，确认没有触发 Metal 安全回退；记录 native 版本差异，版本未对齐时不得直接宣称平台差异。
+5. 记录帧率、CPU、GPU、内存和耗电；补丁性能可能低于 Retained 缓存方案。
+6. 后续通过 Metal GPU Capture/离屏纹理、Blend、Depth/Stencil 和 Drawables 生命周期调查根因，修复后再移除安全降级，并对 R-C/R-C-R、多 Retained 段复测。
+
+## 五、执行边界与状态
+
+- 本轮没有执行 iOS/Android 原生编译、APK/XCFramework 安装、ADB、真机自动操作，也没有发布 tag/制品。
+- 粒子仓库工作区变更先保持未提交，避免污染冻结 V26。
+- Windows NavSea Debug JS 的平台分流已移除：Android/iOS 共用 `E_CONTINUOUS_ONLY`，Release 仍为 `BASELINE`。这项改动仍需 Android 用户手工真机核验。
+- 全部修复最终验收需要跨项目 Integration 按既定 Contract/Status 更新，不由 NavSea 独自宣告 Particle 发布完成。

docs/报告/V26_统一正式发行_GSRL_RDC完成报告_v1.md

@@ -0,0 +1,54 @@
+# V26 统一正式发行 GSRL RDC 完成报告 v1
+
+日期：2026-10-13 07:38:02 +0900（JST）
+结论：**GSRL RELEASED / PASS**。仅指来源锁、发行包、公网回读与 Git 发行链闭合；NavSea 产品集成及真机运行不属于本结论。
+
+## 版本及源码身份
+
+- Android OpenGL AAR、React Native：`13.6.1-particle.26`；iOS Metal/SwiftPM：`6.29.0-particle.26`。
+- Git Remote：`https://git.eyaku.jp/tei/MapLibreParticleLab`；正式源码分支 `particle/main`。
+- **冻结实际 Build Source Commit**：`fce326a9009d3fc21eb91c5df362f0769163d07e`（Android 4 ABI、iOS Metal、RN 同源），已 Push 并验证远端。
+- 相关修复与文档提交：`343ca2fa68f807a2120948006dc12d052aa96059`，`fix: secure Symbol Retained drawable lifetime and record investigations`，包含用户要求保留的 STEP-110/111 两份任务书。
+- Prepare Commit：`fce326a9009d3fc21eb91c5df362f0769163d07e`，`release: prepare unified particle.26`。
+- GSRL Source Lock Commit：`21c4450e01c3d5b8be3743867a26374dce3c8cf3`，`release: record v26 GSRL source lock and receipt instructions`，Push PASS。
+- **正式 Finalize / Tag Commit**：`e3cd9eba3cd02149d431e0061b8d32192d876f78`，`release: finalize unified particle.26`。
+- Tag：`maplibre-particle/rn/13.6.1-particle.26`，已 Push，远端 annotated tag peeled SHA = `e3cd9eba3cd02149d431e0061b8d32192d876f78`；Final HEAD/远端 `particle/main` 在 Finalize 完成时均 = `e3cd9eba3cd02149d431e0061b8d32192d876f78`。
+- SwiftPM Tag：`6.29.0-particle.26`，已通过远端 `ls-remote` 验证。
+- 本次独立验收结束时 Git 工作区干净，未创建 Worktree，未强制覆盖/移动任何正式 Tag 或历史版本。
+
+## 严格串行执行、日志及验收
+
+1. Integration `main` = `80667d6c343411d03a760425438e3d292f452118`，与远端 `main` 一致；V26 公网发行位点原本未占用。
+2. 将 4 个 Symbol Retained 修改源码/测试、`粒子开发记录.md`、STEP-119 两份报告与 STEP-110/111 两份历史任务书 **9 个文件全部 Commit/Push**，Git 工作区恢复干净。冻结源码 V26 版本号并 Push。
+3. `release.sh 26 build` 返回 **exit 0**；Android OpenGL 四 ABI 分别完成 Release 编译，Maven Local AAR/POM/Module PASS；iOS Bazel opt Metal arm64 真机 XCFramework PASS（无 Simulator）；RN npm pack PASS。
+   - 构建日志：`/tmp/maplibre_v26_unified_build_20261012.log`。
+4. `release.sh 26 publish` 返回 **exit 0**；NAS SSH 临时路径上传、远端 SHA-256 核对、原子升级、六文件公网逐字节回读、SwiftPM 版本 Tag 全部 PASS。
+   - 日志：`/tmp/maplibre_v26_publish_20261013.log`。
+5. 按 GSRL v1 生成独立 `release/maplibre-particle/13.6.1-particle.26/SOURCE_LOCK.json`、中文接收说明和 `release/README.md` 当前推荐入口；GSRL Commit/Push 与远端 HEAD 验证通过。
+6. `release.sh 26 finalize` 返回 **exit 0**：4 项 Manifest/iOS 发布元信息 Commit、Git Tag Push PASS。日志：`/tmp/maplibre_v26_finalize_20261013.log`。
+7. **独立二次验收**：公网 6 个文件单独重新下载，逐项 SHA-256/大小与 Source Lock 和本地构建物一致，结果 **6/6 PASS**；Android AAR 确认 4 个 `jni/<ABI>/libmaplibre.so`，iOS ZIP 仅 `ios-arm64`，RN tgz version/peer 正确，Git Remote HEAD/Tag/source 关系一致，工作区干净。
+   - 机器可读独立核验文件：`/tmp/maplibre_v26_independent_receipt_20261013.json`。
+
+## 正式文件验收表（重新计算的公网 SHA-256）
+
+| 交付文件 | 字节数 | SHA-256 | 公网回读 |
+| --- | ---: | --- | --- |
+| android-sdk-particle-opengl-13.6.1-particle.26.aar | 16640537 | `46c1cf7ff8ebc3bedc25aa38d7d445078a2301e6ca223c0307b93e830991c2b9` | PASS |
+| android-sdk-particle-opengl-13.6.1-particle.26.pom | 5687 | `b1e34295c58238a45a8b14d33c801028c3cabc0f40aae6116d007b352fa25520` | PASS |
+| android-sdk-particle-opengl-13.6.1-particle.26.module | 6999 | `405b3bb3732ef29a0b54e6b24b192839d07d4c28e959276d6bd92051637011c4` | PASS |
+| navsea-maplibre-particle-rn-13.6.1-particle.26.tgz | 29038 | `3136316bb6508e774748b21c2095ab61b522d2cf4c3ff2e8c67774dde8549b93` | PASS |
+| MapLibre.dynamic.xcframework.zip | 4181892 | `64b51c2b9eaec4adefcfb2dfc1c6338943f11db4d6c4ce2a4e1c2a39bb84bddb` | PASS |
+| MapLibre.dynamic.xcframework.zip.sha256 | 99 | `ae79556c2b288a3970d6e4eba0c30a68023faa79ff55de291c9e2f30f16fd9ae` | PASS |
+
+下载 URL、依赖和安装说明以 `release/maplibre-particle/13.6.1-particle.26/README.md` 和 `SOURCE_LOCK.json` 为准。正式版本不在 Git 存放大二进制，以 NAS PBF/Maven/npm/SwiftPM 公开发行仓库为获取入口。
+
+## 明确未验收项
+
+- 本次**没有把 V26 正式 Android AAR 安装到 NavSea/FZ-G1 进行产品集成验收**，也没有对 V26 正式 iOS Metal XCFramework 执行 iPhone/iPad 实机运行测试；两者均为 **NOT_TESTED**。
+- STEP-119 原 FZ-G1 MapLibre Test App 开发态四轮稳定和 CPU/FastPath 测试，仅说明独立引擎测试表现，**不是 V26 正式二进制/NavSea 运行验收**。
+- 13 项新增 C++ 生命周期 GTest 未运行，Mac CMake 环境缺 `libuv`，状态 **BLOCKED / NOT_TESTED**；不得将静态检查或 Android/Metal 正式编译视作 GTest 通过。
+- Context 重建、完整 Atlas/Style/Source 变更压力、像素完全等价、跨平台真机及 RN Host 行为，不在本次 GSRL 身份/制品闭环内，不声明通过。
+
+## 收尾注意
+
+该报告属于 **Tag 完成后的审计记录追加**。记录进入 `particle/main` 的后续文档 Commit，不移动或覆盖已经完成的 V26 正式 Tag `maplibre-particle/rn/13.6.1-particle.26`；Tag 仍固定指向 `e3cd9eba3cd02149d431e0061b8d32192d876f78`。发行 Source Lock 永久记录实际构建源码 `fce326a9009d3fc21eb91c5df362f0769163d07e`，不能用之后的分支 HEAD 替换。

docs/报告/V27_统一正式发行_GSRL_RDC完成报告_v1.md

@@ -0,0 +1,72 @@
+# V27 统一正式发行 GSRL RDC 完成报告 v1
+
+日期：2026-10-14（JST）
+结论：**GSRL RELEASED / PASS**。该结论限于 Git Source Lock、正式发行文件、依赖与公网取回一致性，不等同于 NavSea 真机产品验收。
+
+## 一、发行范围与版本
+
+- 项目：MapLibreParticleLab；Git Remote：https://git.eyaku.jp/tei/MapLibreParticleLab
+- 当前仓库：Mac.lan /Users/tei/dev/MapLibreParticleLab，分支 particle/main。
+- Android OpenGL AAR / React Native：13.6.1-particle.27。
+- iOS Metal / SwiftPM：6.29.0-particle.27，仅 iOS arm64 真机，不含 Simulator。
+- 冻结的实际共用构建源码 Commit：970e3ad606e59873a32e9389e65ef257e1c259bb。
+- 正式 Git Tag：maplibre-particle/rn/13.6.1-particle.27。
+- Tag 直接目标（peeled commit）：3c3dcb9d1856c41e9e50734aa12bda0b6f71e294。
+- Annotated Tag 对象：ee09f254fd3c42c8be999ce1bd39aed6477d08a2。
+- 公网 Maven：https://pbf.jpcn.ccwu.cc/maven
+- 公网 RN：https://pbf.jpcn.ccwu.cc/npm
+- 公网 iOS：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle
+- SwiftPM 仓库：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git
+
+V27 源码变化重点为 Metal Retained Underlay Composite 顶点缓冲绑定槽位修正为 maxUBOCountPerShader + 0。三份 V26 失败候选调查报告作为历史证据保留；此前失败候选不能被认作本次正式修复。NavSea 当前采用 RCR 运行基线，仍保留 Retained；不将 E 全 Continuous 降级作为 V27 最终方案。
+
+## 二、环境与发行前保护
+
+- Integration 仓库 /Users/tei/dev/navsea-particle-integration 已 fetch 核验：main 与 origin/main 均为 80667d6c343411d03a760425438e3d292f452118，差异 0/0。
+- GSRL 正式规范采用 v1.0.0；Win11 D:\React\GSRL 核验 HEAD 8a34221da415b3a880969e22e3b768d705a28944。
+- 开始时 Particle particle/main 为 b0f34cc9a299a75af1f7e708c63d75eaa42e9ca2，与 origin/particle/main 一致。存在一项未提交的 Metal Shader 变更和三份未跟踪历史报告。
+- 只将本次 Metal 修复和三份历史报告纳入源代码提交；未删除无关修改，未新建或切换 Git 分支、Worktree，未 Force Push。
+- 发行前 V27 Git Tag 不存在，三个主要公网地址均为 HTTP 404；没有覆盖既有 V26 文件或 Tag。
+- 本次全部实际设备操作由 RDC 直连 Mac 执行，没有调用 Codex。
+
+## 三、严格串行执行结果
+
+1. 前置 Git 修复提交：a9cea8b581f71bf8aab8b85a73a258017d69a33e，fix: retain correct Metal composite vertex buffer slot；包括 Shader 与三份历史报告，Commit/Push/Remote Receipt PASS。
+2. V27 Prepare：release.sh 27 prepare，exit 0；生成版本配置并提交 970e3ad606e59873a32e9389e65ef257e1c259bb，release: prepare unified particle.27。该提交就是后续发行文件统一使用的实际构建源码，已 Push 并核对远端。
+3. V27 Build：release.sh 27 build，exit 0；Android OpenGL 四 ABI Gradle Release 与 Maven Local AAR/POM/Module PASS，Bazel 8.6.0 opt Metal XCFramework PASS，RN npm pack PASS。完整日志：/tmp/maplibre_v27_unified_build_20261014.log。Bazel 报告 INFO Build completed successfully，ZIP 为 ios-arm64 真机版；Android 编译日志确认四种 libmaplibre.so。
+4. V27 Publish：release.sh 27 publish，exit 0；NAS SSH 暂存上传、哈希对照及路径原子晋升，AAR/POM/Module/RN tgz/iOS ZIP/iOS ZIP.sha256 六文件公网逐字节回读 PASS；SwiftPM 6.29.0-particle.27 Tag PASS。日志：/tmp/maplibre_v27_publish_20261014.log。
+5. GSRL Source Lock：新建 release/maplibre-particle/13.6.1-particle.27/SOURCE_LOCK.json 及 README.md，并在 release/README.md 登记当前推荐版。Source Lock Commit：7f92f71416fd57dcd55c5c836365385049a6450a，release: record v27 GSRL source lock and receipt instructions；Commit/Push/Remote Receipt PASS。
+6. Finalize：release.sh 27 finalize，exit 0。四份通用/iOS Manifest 与 Package.swift 模板 Commit：3c3dcb9d1856c41e9e50734aa12bda0b6f71e294，release: finalize unified particle.27。推送 particle/main 及新的 annotated Git Tag，远端 peeled Tag 与 Final Commit 一致。日志：/tmp/maplibre_v27_finalize_20261014.log。
+7. 独立二次核验：不是依靠发布脚本内部的回读结论，而是重新下载六项公网文件，按 Source Lock 单独计算 SHA-256 和文件大小，6/6 PASS；AAR 四 ABI、iOS ZIP 无 Simulator、RN package version/peer、SwiftPM Tag、源码 Commit 祖先关系、远端 Tag/HEAD 及 Git clean 均 PASS。机器可读回执：/tmp/maplibre_v27_independent_receipt_20261014.json。
+8. 本报告属于发行 Tag 完成后的追加审计记录。后续提交本报告不移动既有 V27 Tag，也不更改 Source Lock 指向的实际构建源码 Commit。
+
+## 四、六项正式文件独立校验
+
+| 文件 | 大小（字节） | SHA-256 | 公网独立下载 |
+| --- | ---: | --- | --- |
+| android-sdk-particle-opengl-13.6.1-particle.27.aar | 16640539 | 2ff3ead8e5d7cb8802a4c05ba20cd7f8f0a7029f72619f9a2ec176c942ae8de4 | PASS |
+| android-sdk-particle-opengl-13.6.1-particle.27.pom | 5687 | 324d14d689ba7c9206298734d7f9636b95e947c7241d94ec60f8f1d57bd1b701 | PASS |
+| android-sdk-particle-opengl-13.6.1-particle.27.module | 6999 | 403804395f065cef75f1254403edbda67c3a885769acbf6d25e091d37c325910 | PASS |
+| navsea-maplibre-particle-rn-13.6.1-particle.27.tgz | 29040 | fdd67210debd8363d4bf72fcc0120ef747dc3037d55b8c0d83330dd98bb0bc5d | PASS |
+| MapLibre.dynamic.xcframework.zip | 4181894 | 5dbde28600df35484a7f31e7c7c4780f27b919fc6ec59f6aa88d65d81342448c | PASS |
+| MapLibre.dynamic.xcframework.zip.sha256 | 99 | 1dba0b0a2831beeadcc022801622829d630ef0838babdfef4edc4b8bec34e08d | PASS |
+
+六项文件的完整实际下载 URL、依赖版本和使用方法由本版 SOURCE_LOCK.json / README.md 权威记录。
+
+## 五、未测试事项、风险及下一步
+
+- 本次未在 Android/FZ-G1 安装运行 V27 正式发行 AAR，也未通过正式 NavSea Host 真机验收；先前开发态 Test App 验收不能代替正式发行包验收。
+- 本次未在 iPad/iPhone 安装运行 V27 正式发行 XCFramework；用户此前确认的是 Metal slot-9 预发行调试候选画面，不应虚报正式制品真机 PASS。
+- 未执行新增或历史 C++ 生命周期 GTest；不以构建 PASS 冒充 GTest PASS。
+- RCR 是当前 Host 基线；RCRR 仍须按其单独测试范围区分实验能力和产品正式验收。
+- GSRL PASS 表明源码可恢复、产物可取得且 SHA-256 相符，不能推断与所有 NavSea Host 场景兼容或端到端运行稳定。
+- 后续正式接入应从 release/README.md 选择 V27，接收方复核 SOURCE_LOCK.json 的六项哈希，并依据各平台操作边界完成真机验收。
+
+## 六、Git 与 Source Lock 最终原则
+
+冻结 Build Source Commit：970e3ad606e59873a32e9389e65ef257e1c259bb。
+Source Lock Commit：7f92f71416fd57dcd55c5c836365385049a6450a。
+正式 Finalize / Tag Commit：3c3dcb9d1856c41e9e50734aa12bda0b6f71e294。
+正式 Tag：maplibre-particle/rn/13.6.1-particle.27。
+
+上述源码、发行文件和 Tag 通过远端与公网独立核验。发行 Tag 不会因本报告后续追加提交而移动。

include/mln/renderer/render_segment.hpp

@@ -1,5 +1,6 @@
 #pragma once
 
+#include <array>
 #include <cstdint>
 #include <optional>
 #include <set>
@@ -237,6 +238,72 @@ struct RenderSegmentDiagnosticsEntry {
     std::optional<RenderSegmentCacheDiagnostics> cache;
 };
 
+// Platform-neutral, bounded diagnostic samples. No pointers to mutable renderer objects.
+struct FastGateRetainedSample {
+    uint32_t segmentIndex = 0;
+    RenderSegmentCacheDiagnostics cache;
+    bool placementGatePassed = false;
+    std::string actualExecution;
+};
+
+struct FastGateCacheInputSample {
+    uint32_t segmentIndex = 0;
+    bool exists = false;
+    bool valid = false;
+    uint64_t buildRevision = 0;
+    uint64_t staticRevision = 0;
+};
+
+struct FastGatePhaseSample {
+    // Placement changed/fade come from the last completed render-tree snapshot
+    // in pre-fast. Fast tree flags do not imply a fresh Placement calculation.
+    // They are never substituted for the current controller gate #13.
+    bool hasPlacementSnapshot = false;
+    bool placementChanged = false;
+    float symbolFadeChange = 0;
+    bool placementTransitionActive = false;
+    bool retainedSamplesTruncated = false;
+    uint64_t contentRevision = 0;
+    uint64_t topologyRevision = 0;
+    uint64_t configRevision = 0;
+    uint64_t fullCpuFrame = 0;
+    std::optional<uint64_t> processSimulationAdvance;
+    std::vector<FastGateRetainedSample> retained;
+};
+
+struct FastGateFrameSample {
+    uint64_t sequence = 0;
+    uint64_t frame = 0;
+    int64_t updateTimeNs = 0;
+    uint32_t failMask = 0;
+    uint32_t knownMask = 0x00ffffff;
+    std::string firstFailure;
+    bool decisionConsistent = true;
+    bool candidate = false;
+    bool preFastPlacementTransition = false;
+    bool placementTransitionsEnabled = true;
+    bool completed = false;
+    std::string outcome{"pending"};
+    bool cacheInputsTruncated = false;
+    std::vector<FastGateCacheInputSample> cacheInputs;
+    FastGatePhaseSample pre;
+    FastGatePhaseSample post;
+};
+
+struct FastGateTraceDiagnostics {
+    uint32_t schemaVersion = 1;
+    uint64_t lifecycle = 0;
+    uint64_t attempts = 0;
+    uint64_t overwritten = 0;
+    uint64_t decisionMismatch = 0;
+    uint64_t fullRendered = 0;
+    uint64_t fastRendered = 0;
+    uint64_t noRender = 0;
+    std::array<uint64_t, 24> failureCounts{};
+    std::array<uint64_t, 24> firstFailureCounts{};
+    std::vector<FastGateFrameSample> frames;
+};
+
 struct RenderSegmentDiagnostics {
     uint32_t schemaVersion = 1;
     bool enabled = true;
@@ -274,6 +341,7 @@ struct RenderSegmentDiagnostics {
     RenderMutationDiagnostics lastMutation;
     std::vector<StyleLayerDiagnostics> styleLayers;
     std::vector<RenderSegmentDiagnosticsEntry> segments;
+    std::optional<FastGateTraceDiagnostics> fastGateTrace;
 };
 
 struct ResolvedRenderSegment {

integration/react-native/MapLibreParticleRNTestHost/plugins/withParticleNativeAndroid.js

@@ -6,7 +6,7 @@ const marker = "// MapLibreParticleRNTestHost NavSea Particle release SDK";
 module.exports = function withParticleNativeAndroid(config) {
   return withProjectBuildGradle(config, (project) => {
     if (project.modResults.contents.includes(marker)) return project;
-    project.modResults.contents += `\n${marker}\ngradle.projectsEvaluated {\n  allprojects { p ->\n    p.repositories.maven { repository -> repository.url = p.uri("https://pbf.jpcn.ccwu.cc/maven") }\n    p.configurations.configureEach { configuration ->\n      configuration.resolutionStrategy.dependencySubstitution {\n        substitute module("org.maplibre.gl:android-sdk-opengl") using module("cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23")\n      }\n    }\n  }\n}\nrootProject.ext.set("org.maplibre.reactnative.nativeVersion", "13.6.1")\nrootProject.ext.set("org.maplibre.reactnative.nativeVariant", "opengl")\n`;
+    project.modResults.contents += `\n${marker}\ngradle.projectsEvaluated {\n  allprojects { p ->\n    p.repositories.maven { repository -> repository.url = p.uri("https://pbf.jpcn.ccwu.cc/maven") }\n    p.configurations.configureEach { configuration ->\n      configuration.resolutionStrategy.dependencySubstitution {\n        substitute module("org.maplibre.gl:android-sdk-opengl") using module("cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28")\n      }\n    }\n  }\n}\nrootProject.ext.set("org.maplibre.reactnative.nativeVersion", "13.6.1")\nrootProject.ext.set("org.maplibre.reactnative.nativeVariant", "opengl")\n`;
     return project;
   });
 };

packages/maplibre-particle-rn/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 13.6.1-particle.28（Android / iOS 统一发行）
+
+- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 28。
+## 13.6.1-particle.27（Android / iOS 统一发行）
+
+- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 27。
+## 13.6.1-particle.26（Android / iOS 统一发行）
+
+- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 26。
+## 13.6.1-particle.25（Android / iOS 统一发行）
+
+- Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 25。
 ## 13.6.1-particle.23（Android / iOS 统一发行）
 
 - Mac unified release pipeline 统一生成 Android Native、RN package 与 iOS SwiftPM/XCFramework；共享 Particle revision 23。

packages/maplibre-particle-rn/README.md

@@ -1,6 +1,6 @@
 # @navsea/maplibre-particle-rn
 
-当前版本：`13.6.1-particle.23`。Android Native 必须配套 `cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23`。本包是 React Native 的薄控制面，不负责 Map 组件、provider、HTTP、manifest、下载、缓存或 NavSea 业务策略。
+当前版本：`13.6.1-particle.28`。Android Native 必须配套 `cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28`。本包是 React Native 的薄控制面，不负责 Map 组件、provider、HTTP、manifest、下载、缓存或 NavSea 业务策略。
 
 ## 当前推荐主链：QBIN V4
 
@@ -37,7 +37,7 @@ Podfile 的 `post_install do |installer|` 必须同时调用 `$MLRN.post_install
 RN tgz：
 
 ```text
-https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.23.tgz
+https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.28.tgz
 ```
 
 Native Maven repository：
@@ -49,7 +49,7 @@ https://pbf.jpcn.ccwu.cc/maven
 Native coordinate：
 
 ```text
-cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23
+cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28
 ```
 
-Expo plugin 与 `android/build.gradle` 必须指向同一 `.23`。正常 Consumer 不复制 AAR、不依赖 MapLibreParticleLab 源码路径，也不以 Maven Local 作为公网验证主路径。完整 Linux 发布与 Win11 验证流程见 `docs/50_Step记录/STEP-080_Android_AAR与RNTestHost标准构建流水线_v2.md`。
+Expo plugin 与 `android/build.gradle` 必须指向同一 `.28`。正常 Consumer 不复制 AAR、不依赖 MapLibreParticleLab 源码路径，也不以 Maven Local 作为公网验证主路径。完整 Linux 发布与 Win11 验证流程见 `docs/50_Step记录/STEP-080_Android_AAR与RNTestHost标准构建流水线_v2.md`。

packages/maplibre-particle-rn/android/build.gradle

@@ -14,7 +14,7 @@ android {
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:2.1.20"
-  implementation "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23"
+  implementation "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28"
   compileOnly project(":maplibre_maplibre-react-native")
   testImplementation "junit:junit:4.13.2"
 }

packages/maplibre-particle-rn/app.plugin.js

@@ -20,7 +20,7 @@ const iosTag = "navsea-maplibre-particle-rn-maplibre-spm";
 module.exports = function withNavSeaMapLibreParticle(config) {
   config = withProjectBuildGradle(config, (project) => {
     if (project.modResults.contents.includes(androidMarker)) return project;
-    project.modResults.contents += `\n${androidMarker}\ngradle.projectsEvaluated {\n  allprojects { p ->\n    p.repositories.maven { repository -> repository.url = p.uri("https://pbf.jpcn.ccwu.cc/maven") }\n    p.configurations.configureEach { configuration ->\n      configuration.resolutionStrategy.dependencySubstitution {\n        substitute module("org.maplibre.gl:android-sdk-opengl") using module("cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23")\n      }\n    }\n  }\n}\nrootProject.ext.set("org.maplibre.reactnative.nativeVersion", "13.6.1")\nrootProject.ext.set("org.maplibre.reactnative.nativeVariant", "opengl")\n`;
+    project.modResults.contents += `\n${androidMarker}\ngradle.projectsEvaluated {\n  allprojects { p ->\n    p.repositories.maven { repository -> repository.url = p.uri("https://pbf.jpcn.ccwu.cc/maven") }\n    p.configurations.configureEach { configuration ->\n      configuration.resolutionStrategy.dependencySubstitution {\n        substitute module("org.maplibre.gl:android-sdk-opengl") using module("cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28")\n      }\n    }\n  }\n}\nrootProject.ext.set("org.maplibre.reactnative.nativeVersion", "13.6.1")\nrootProject.ext.set("org.maplibre.reactnative.nativeVariant", "opengl")\n`;
     return project;
   });
 

packages/maplibre-particle-rn/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@navsea/maplibre-particle-rn",
-  "version": "13.6.1-particle.23",
+  "version": "13.6.1-particle.28",
   "description": "NavSea MapLibre Particle React Native pure Field Renderer API.",
   "license": "BSD-2-Clause",
   "main": "src/index.ts",

platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/ParticleCoreLayerValidationActivity.kt

@@ -63,6 +63,14 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     private var step097Topology: Step097StencilFixture.Topology? = null
     private var step099Scenario: Step099ReadinessFixture.Scenario? = null
     private var step101Scenario: String? = null
+    private var step113DiagnosticsHeight: Int? = null
+    private var step113DiagnosticsMaxLines = 6
+    private var step113Scene: Step113PbfGateScene? = null
+    private var step113Scenario: Step113PbfGateScene.Scenario? = null
+    private var step114Scene: Step114FastSmokeScene? = null
+    private var step114Scenario: Step114FastSmokeScene.Scenario? = null
+    private var step114DiagnosticsHeight: Int? = null
+    private var step114DiagnosticsMaxLines = 6
     private var step102Scenario: Step102PlacementFixture.Scenario? = null
     private var step102Tick = 0L
     private val step102Handler = Handler(Looper.getMainLooper())
@@ -347,6 +355,16 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
         step093Variant = savedInstanceState?.getString(STATE_STEP093_VARIANT)
             ?.let { value -> Step093Variant.values().firstOrNull { it.name == value } }
             ?: Step093Variant.DEFAULT
+        val savedStep113 = if (savedInstanceState?.containsKey("step113_scenario") == true) {
+            savedInstanceState.getString("step113_scenario")
+        } else intent.getStringExtra("step113_scenario")
+        step113Scenario = savedStep113
+            ?.let { value -> Step113PbfGateScene.Scenario.values().firstOrNull { it.name == value } }
+        val savedStep114 = if (savedInstanceState?.containsKey("step114_scenario") == true) {
+            savedInstanceState.getString("step114_scenario")
+        } else intent.getStringExtra("step114_scenario")
+        step114Scenario = savedStep114
+            ?.let { value -> Step114FastSmokeScene.Scenario.values().firstOrNull { it.name == value } }
         super.onCreate(savedInstanceState)
         Log.i(
             TAG,
@@ -359,6 +377,8 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
         status = findViewById(R.id.validationStatus)
         diagnostics = findViewById(R.id.validationDiagnostics)
         mapView.addOnDidFailLoadingMapListener { errorMessage ->
+            step113Scene?.onStyleLoadFailed(errorMessage)
+            step114Scene?.onStyleLoadFailed(errorMessage)
             if (navSeaPbfMode || purePbfMode) {
                 Log.e(TAG, "NAVSEA_PBF_STYLE_ERROR reason=$errorMessage")
             } else if (realWeatherMode) {
@@ -379,7 +399,9 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
             updateNavSeaPbfButtonState()
             updatePbfModeButtonState()
             updateRetainedCacheButtonState()
-            if (step102Scenario != null) loadStep102Style()
+            if (step114Scenario != null) startStep114Scene(step114Scenario!!)
+            else if (step113Scenario != null) startStep113Scene(step113Scenario!!)
+            else if (step102Scenario != null) loadStep102Style()
             else if (step101Scenario != null) loadStep101Style()
             else if (step097Topology != null) loadStep097StencilStyle()
             else if (step093Mode) loadStep093Style(configureBeforeStyle = false)
@@ -688,6 +710,8 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
             menu.add(0, 17, 17, "STEP-099 READINESS")
             menu.add(0, 18, 18, "STEP-101 TEARDOWN")
             menu.add(0, 19, 19, "STEP-102 PLACEMENT LOCALITY")
+            menu.add(0, 20, 20, "STEP-113 FZG1-PBF GATE")
+            menu.add(0, 21, 21, "STEP-114 独立 FAST_SMOKE（非正式 PBF）")
             setOnMenuItemClickListener { item ->
                 when (item.itemId) {
                     in Step093Topology.values().indices -> applyStep093Scene(Step093Topology.values()[item.itemId])
@@ -701,6 +725,8 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
                     17 -> showStep099Menu(anchor)
                     18 -> showStep101Menu(anchor)
                     19 -> showStep102Menu(anchor)
+                    20 -> showStep113Menu(anchor)
+                    21 -> showStep114Menu(anchor)
                 }
                 true
             }
@@ -761,6 +787,137 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
         }
     }
 
+    private fun showStep113Menu(anchor: android.view.View) {
+        PopupMenu(this, anchor).apply {
+            Step113PbfGateScene.Scenario.values().forEachIndexed { index, scenario ->
+                menu.add(0, index, index, "STEP-113 正式 PBF · ${scenario.name}")
+            }
+            menu.add(0, 100, 100, "EXPORT LAST SNAPSHOT")
+            menu.add(0, 101, 101, "MUTATE PROBE SOURCE ONCE")
+            menu.add(0, 102, 102, "EXIT STEP-113")
+            setOnMenuItemClickListener { item ->
+                when (item.itemId) {
+                    in Step113PbfGateScene.Scenario.values().indices ->
+                        startStep113Scene(Step113PbfGateScene.Scenario.values()[item.itemId])
+                    100 -> step113Scene?.export()
+                    101 -> step113Scene?.mutateSource()
+                    102 -> { stopStep113Scene(); loadValidationStyle(active, enabled, "STEP113_EXIT") }
+                }
+                true
+            }
+            show()
+        }
+    }
+
+    private fun startStep113Scene(scenario: Step113PbfGateScene.Scenario) {
+        stopStep113Scene()
+        stopStep102Scenario()
+        stopStep099Scenario()
+        stopStep093DiagnosticsPolling()
+        step101Handler.removeCallbacksAndMessages(null)
+        step101Scenario = null
+        step097Topology = null
+        step093Mode = false
+        pureParticleMode = false
+        purePbfMode = false
+        navSeaPbfMode = false
+        realWeatherMode = false
+        weatherRuntime?.dispose()
+        weatherRuntime = null
+        styleReady = false
+        ++styleLoadEpoch // Cancel previous asynchronous style callbacks.
+        step113Scenario = scenario
+        retainedCacheEnabled = scenario != Step113PbfGateScene.Scenario.RCRR_FULL_CONTROL_NO_TIDE
+        updateRetainedCacheButtonState()
+        step113DiagnosticsHeight = diagnostics.layoutParams.height
+        step113DiagnosticsMaxLines = diagnostics.maxLines
+        diagnostics.maxLines = 10
+        diagnostics.layoutParams = diagnostics.layoutParams.apply { height = (156 * resources.displayMetrics.density).toInt() }
+        status.text = "STEP-113 FZG1-PBF Gate · ${scenario.name} · PARTIAL"
+        step113Scene = Step113PbfGateScene(this, maplibreMap) { diagnostics.text = it }
+            .also { it.start(scenario) }
+    }
+
+    private fun stopStep113Scene() {
+        // Existing style-switch entry points all call this method; also stop the
+        // independent smoke before another scene takes ownership of this Map.
+        stopStep114Scene()
+        step113Scene?.stop()
+        step113DiagnosticsHeight?.let { originalHeight ->
+            diagnostics.maxLines = step113DiagnosticsMaxLines
+            diagnostics.layoutParams = diagnostics.layoutParams.apply { height = originalHeight }
+        }
+        step113DiagnosticsHeight = null
+        step113Scene = null
+        step113Scenario = null
+    }
+
+    private fun showStep114Menu(anchor: android.view.View) {
+        PopupMenu(this, anchor).apply {
+            Step114FastSmokeScene.Scenario.values().forEachIndexed { index, scenario ->
+                menu.add(0, index, index, "独立 smoke · ${scenario.name}")
+            }
+            listOf("导出当前 Native 快照", "单次更新 R GeoJSON", "Pan/Zoom 往返", "Reload 当前场景",
+                "单次 Image 变更", "禁用/恢复缓存", "单次更新真实 Annotation", "退出独立 smoke")
+                .forEachIndexed { index, title -> menu.add(0, 10 + index, 10 + index, title) }
+            setOnMenuItemClickListener { item ->
+                when (item.itemId) {
+                    in Step114FastSmokeScene.Scenario.values().indices ->
+                        startStep114Scene(Step114FastSmokeScene.Scenario.values()[item.itemId])
+                    10 -> step114Scene?.export()
+                    11 -> step114Scene?.mutateSource()
+                    12 -> step114Scene?.panZoom()
+                    13 -> step114Scene?.reload()
+                    14 -> step114Scene?.mutateImage()
+                    15 -> step114Scene?.toggleCache()
+                    16 -> step114Scene?.mutateAnnotation()
+                    17 -> { stopStep113Scene(); loadValidationStyle(active, enabled, "STEP114_EXIT") }
+                }
+                true
+            }
+            show()
+        }
+    }
+
+    private fun startStep114Scene(scenario: Step114FastSmokeScene.Scenario) {
+        stopStep113Scene()
+        stopStep102Scenario()
+        stopStep099Scenario()
+        stopStep093DiagnosticsPolling()
+        step101Handler.removeCallbacksAndMessages(null)
+        step101Scenario = null
+        step097Topology = null
+        step093Mode = false
+        pureParticleMode = false
+        purePbfMode = false
+        navSeaPbfMode = false
+        realWeatherMode = false
+        weatherRuntime?.dispose()
+        weatherRuntime = null
+        styleReady = false
+        ++styleLoadEpoch
+        step114Scenario = scenario
+        retainedCacheEnabled = true
+        updateRetainedCacheButtonState()
+        step114DiagnosticsHeight = diagnostics.layoutParams.height
+        step114DiagnosticsMaxLines = diagnostics.maxLines
+        diagnostics.maxLines = 10
+        diagnostics.layoutParams = diagnostics.layoutParams.apply { height = (156 * resources.displayMetrics.density).toInt() }
+        status.text = "STEP-114 独立 smoke · $scenario · 待真实 Native 验收"
+        step114Scene = Step114FastSmokeScene(this, maplibreMap) { diagnostics.text = it }.also { it.start(scenario) }
+    }
+
+    private fun stopStep114Scene() {
+        step114Scene?.stop()
+        step114DiagnosticsHeight?.let { originalHeight ->
+            diagnostics.maxLines = step114DiagnosticsMaxLines
+            diagnostics.layoutParams = diagnostics.layoutParams.apply { height = originalHeight }
+        }
+        step114DiagnosticsHeight = null
+        step114Scene = null
+        step114Scenario = null
+    }
+
     private fun showStep102Menu(anchor: android.view.View) {
         PopupMenu(this, anchor).apply {
             Step102PlacementFixture.Scenario.values().forEachIndexed { index, scenario ->
@@ -778,6 +935,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadStep102Style() {
+        stopStep113Scene()
         val scenario = step102Scenario ?: return
         stopStep093DiagnosticsPolling()
         step093Mode = false
@@ -810,6 +968,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadStep101Style() {
+        stopStep113Scene()
         val scenario = step101Scenario ?: return
         stopStep102Scenario()
         stopStep099Scenario()
@@ -836,6 +995,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun applyStep099Scenario(scenario: Step099ReadinessFixture.Scenario) {
+        stopStep113Scene()
         stopStep102Scenario()
         stopStep093DiagnosticsPolling()
         step093Mode = false
@@ -971,6 +1131,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadStep097StencilStyle() {
+        stopStep113Scene()
         val topology = step097Topology ?: return
         styleReady = false
         val epoch = ++styleLoadEpoch
@@ -1124,6 +1285,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadStep093Style(configureBeforeStyle: Boolean) {
+        stopStep113Scene()
         weatherRuntime?.dispose()
         weatherRuntime = null
         styleReady = false
@@ -1621,6 +1783,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadValidationStyle(active: Boolean, enabled: Boolean, reason: String = "STYLE_CHANGE") {
+        stopStep113Scene()
         stopStep102Scenario()
         if (step099Scenario != null) stopStep099Scenario()
         step097V4GoldenReady = false
@@ -1692,6 +1855,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     )
 
     private fun loadPureParticleStyle(active: Boolean, enabled: Boolean, reason: String) {
+        stopStep113Scene()
         weatherRuntime?.dispose()
         weatherRuntime = null
         this.active = active
@@ -1721,6 +1885,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadPurePbfStyle(reason: String) {
+        stopStep113Scene()
         weatherRuntime?.dispose()
         weatherRuntime = null
         styleReady = false
@@ -1752,6 +1917,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     }
 
     private fun loadNavSeaPbfStyle(active: Boolean, enabled: Boolean, reason: String) {
+        stopStep113Scene()
         weatherRuntime?.dispose()
         weatherRuntime = null
         this.active = active
@@ -2397,8 +2563,8 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
             }
         } else if (step093Mode || step097Topology != null) startStep093DiagnosticsPolling()
     }
-    override fun onResume() { super.onResume(); mapView.onResume() }
+    override fun onResume() { super.onResume(); mapView.onResume(); step113Scene?.resume(); step114Scene?.resume() }
-    override fun onPause() { mapView.onPause(); super.onPause() }
+    override fun onPause() { step113Scene?.pause(); step114Scene?.pause(); mapView.onPause(); super.onPause() }
     override fun onStop() {
         step101Handler.removeCallbacksAndMessages(null)
         step093Handler.removeCallbacks(step093DiagnosticsPoll)
@@ -2408,6 +2574,7 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
         super.onStop()
     }
     override fun onDestroy() {
+        stopStep113Scene()
         step102Handler.removeCallbacksAndMessages(null)
         step101Handler.removeCallbacksAndMessages(null)
         if (step101Scenario != null) Log.i(TAG, "STEP101_MAPVIEW_DESTROY_ENTER scenario=$step101Scenario completed=$step101Completed")
@@ -2422,6 +2589,8 @@ class ParticleCoreLayerValidationActivity : AppCompatActivity() {
     override fun onLowMemory() { super.onLowMemory(); mapView.onLowMemory() }
 
     override fun onSaveInstanceState(outState: Bundle) {
+        outState.putString("step113_scenario", step113Scenario?.name)
+        outState.putString("step114_scenario", step114Scenario?.name)
         outState.putBoolean(STATE_ACTIVE, active)
         outState.putBoolean(STATE_ENABLED, enabled)
         outState.putInt(STATE_MASK_MODE, maskMode)

platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step113PbfGateScene.kt

@@ -0,0 +1,576 @@
+package org.maplibre.android.testapp.activity.particle
+
+import android.content.Context
+import android.os.Handler
+import android.os.Looper
+import android.os.SystemClock
+import android.util.Base64
+import android.util.Log
+import org.json.JSONArray
+import org.json.JSONObject
+import org.maplibre.android.camera.CameraPosition
+import org.maplibre.android.geometry.LatLng
+import org.maplibre.android.maps.MapLibreMap
+import org.maplibre.android.maps.Style
+import org.maplibre.android.maps.WeatherRuntime
+import org.maplibre.android.style.layers.Layer
+import org.maplibre.android.style.layers.SymbolLayer
+import org.maplibre.android.style.sources.GeoJsonSource
+import org.maplibre.android.testapp.BuildConfig
+import org.maplibre.geojson.Feature
+import org.maplibre.geojson.Point
+import java.io.File
+import java.security.MessageDigest
+
+/** STEP-113: real remote chart, explicit partial parity, fixed forecast and low-frequency pull. */
+internal class Step113PbfGateScene(
+    private val context: Context,
+    private val map: MapLibreMap,
+    private val display: (String) -> Unit
+) {
+    enum class Scenario { PBF63, STATIC_RC, PARTICLE_OFF, PARTIAL_RCRR, SOURCE_CHANGE, STATIC_RC_NO_TIDE,
+        RCRR_C_NARROW_NO_TIDE, RCRR_C_WIDE_NO_TIDE, RCRR_R_DYNAMIC_NO_TIDE,
+        RCR_PARTICLE_ONLY_NO_TIDE, RCRRR_PARTICLE_ONLY_NO_TIDE, RCRR_FULL_CONTROL_NO_TIDE }
+
+    private val handler = Handler(Looper.getMainLooper())
+    private var generation = 0
+    private var running = false
+    private var paused = false
+    private var ready = false
+    private var failureReason: String? = null
+    private var runtime: WeatherRuntime? = null
+    private var scenario = Scenario.PBF63
+    private var parity = JSONObject()
+    private var latest: JSONObject? = null
+    private var lastLogMs = 0L
+    private var mutation = 0
+    private var exportSequence = 0L
+    private var commandResults = JSONObject()
+    private var savedGestures: List<Boolean>? = null
+    private var annotationStyle: Style? = null
+    private var detachedEmptyAnnotationLayer: Layer? = null
+    private val poll = object : Runnable {
+        override fun run() {
+            if (!running || paused) return
+            if (running) {
+                try {
+                    checkAnnotationOwnership()
+                    // One shared snapshot query per refresh; all UI/log/export uses this copy.
+                    val native = JSONObject(map.getRenderSegmentDiagnostics())
+                    latest = envelope(native)
+                    val trace = native.optJSONObject("fastGateTrace")
+                    val frames = trace?.optJSONArray("frames")
+                    val lastFrame = if (frames != null && frames.length() > 0) frames.optJSONObject(frames.length() - 1) else null
+                    val firstFailure = lastFrame?.optString("firstFailure") ?: native.optString("fastPathFallbackReason")
+                    val gates = trace?.optJSONArray("gates") ?: JSONArray()
+                    val rank = (0 until gates.length()).map { gates.getJSONObject(it) }
+                        .sortedByDescending { it.optLong("failures") }.take(4)
+                    val segments = native.optJSONArray("segments") ?: JSONArray()
+                    display(buildString {
+                        append("STEP-113 $scenario · ${if (ready) "READY/PARTIAL" else failureReason ?: "LOADING"} · actual=${native.optInt("styleLayerCount")}\n")
+                        append("first=$firstFailure seq=${lastFrame?.optLong("sequence")} full=${trace?.optLong("fullRendered")} ")
+                        append("window=${trace?.optInt("windowCount")} mismatch=${trace?.optLong("decisionMismatch")}\n")
+                        append("Fast=${trace?.optLong("fastRendered")} · 空Annotation调整=${commandResults.optBoolean("emptyBuiltinAnnotationLayerRemoved")}\n")
+                        append(rank.joinToString(" / ") { "${it.optString("reason")}=${it.optLong("failures")}" })
+                        for (i in 0 until segments.length()) {
+                            val s = segments.getJSONObject(i)
+                            val c = s.optJSONObject("cache")
+                            append("\n${s.optString("strategy")}[${s.optInt("beginIndex")},${s.optInt("endExclusive")}) ")
+                            append("${c?.optString("cacheState") ?: "live"} B=${c?.optLong("build") ?: 0} ")
+                            append("R=${c?.optLong("reuse") ?: 0} I=${c?.optLong("invalidation") ?: 0}")
+                        }
+                    })
+                    val now = SystemClock.elapsedRealtime()
+                    val summaryIntervalMs = if (isCpuBenchmark(scenario)) 6000L else 30000L
+                    if (now - lastLogMs >= summaryIntervalMs) {
+                        lastLogMs = now
+                        logRecord("summary", summary(native))
+                    }
+                } catch (error: Exception) {
+                    display("STEP-113 诊断读取失败: ${error.message}")
+                    Log.e(TAG, "diagnostic-read-failed", error)
+                }
+            }
+            handler.postDelayed(this, 3000L)
+        }
+    }
+
+    fun start(next: Scenario) {
+        stop()
+        running = true
+        scenario = next
+        ready = false
+        failureReason = null
+        latest = null
+        parity = JSONObject()
+        lastLogMs = 0L
+        mutation = 0
+        commandResults = JSONObject()
+        val epoch = ++generation
+        display("STEP-113 $scenario · 加载正式 PBF · 113层完整等价未验证")
+        val ui = map.uiSettings
+        savedGestures = listOf(ui.isScrollGesturesEnabled(), ui.isRotateGesturesEnabled(),
+            ui.isTiltGesturesEnabled(), ui.isZoomGesturesEnabled(),
+            ui.isDoubleTapGesturesEnabled(), ui.isQuickZoomGesturesEnabled())
+        ui.setAllGesturesEnabled(false)
+        map.cancelTransitions()
+        // CPU A/B control: exactly the same style, camera, weather and RCRR plan.
+        // Only the retained-cache enable bit differs.
+        val fullControl = scenario == Scenario.RCRR_FULL_CONTROL_NO_TIDE
+        map.setRetainedUnderlayEnabled(!fullControl)
+        commandResults.put("forceFullControl", fullControl)
+        if (!paused) handler.post(poll)
+        map.setStyle(Style.Builder().fromUri(STYLE_URL)) production@ { loaded ->
+            if (!running || epoch != generation) return@production
+            try {
+                val root = JSONObject(loaded.json)
+                val baseLayers = root.getJSONArray("layers")
+                val base = JSONArray(baseLayers.toString())
+                check(base.length() == 63) { "正式基础层数已变化: ${base.length()}，保留现场" }
+                val ids = (0 until base.length()).map { base.getJSONObject(it).getString("id") }
+                check(ids.distinct().size == ids.size && "clip-outline" in ids && "sea-area-fill" in ids &&
+                    "special-pattern-line-754" in ids) { "正式 Style 边界 ID 缺失或重复" }
+                // STEP-118: Keep the original 63-layer PBF baseline unchanged.
+                // Only the explicitly named user-approved variant excludes one
+                // orphaned Symbol layer whose tide Source is already absent.
+                val omitTideLayer = isNoTideVariant(scenario)
+                val tideDependent = (0 until base.length()).filter {
+                    base.getJSONObject(it).optString("source") == TIDE_SOURCE
+                }
+                if (omitTideLayer) {
+                    check(!root.getJSONObject("sources").has(TIDE_SOURCE)) {
+                        "正式Style出现真实tide Source；停止本次仅移除孤立层实验"
+                    }
+                    check(tideDependent.size == 1 &&
+                        base.getJSONObject(tideDependent.single()).optString("id") == TIDE_LAYER &&
+                        base.getJSONObject(tideDependent.single()).optString("type") == "symbol") {
+                        "tide引用结构不符合已核验的唯一孤立Symbol层；禁止扩大删除范围"
+                    }
+                }
+                val effectiveBase = if (omitTideLayer) JSONArray().apply {
+                    for (i in 0 until base.length()) {
+                        if (i !in tideDependent) put(base.getJSONObject(i))
+                    }
+                } else base
+                val effectiveIds = (0 until effectiveBase.length()).map { effectiveBase.getJSONObject(it).getString("id") }
+                check(!omitTideLayer || (effectiveBase.length() == 62 && TIDE_LAYER !in effectiveIds)) {
+                    "tide移除数量不等于1；停止"
+                }
+                val source = root.getJSONObject("sources").getJSONObject("navsea_delivery")
+                check(root.optString("sprite") == SPRITE && root.optString("glyphs") == GLYPHS &&
+                    source.optString("type") == "vector" && source.optJSONArray("tiles")?.optString(0) == TILES) {
+                    "正式 Sprite/Glyph/VectorTile URI 与 NavSea URL 事实源不一致"
+                }
+                parity = JSONObject().put("evidence", "TEST-APP-STRUCTURAL")
+                    .put("styleUrl", STYLE_URL).put("styleVersion", root.optInt("version"))
+                    .put("styleVersionBasis", "Style specification version; 包版本未知")
+                    .put("stylePackageVersionObserved", JSONObject.NULL)
+                    .put("styleMetadata", root.opt("metadata") ?: JSONObject.NULL)
+                    .put("styleName", root.optString("name"))
+                    .put("fingerprintBasis", "SDK-returned-production-json-utf8")
+                    .put("productionFingerprintSha256", sha256(loaded.json))
+                    .put("baseLayerCount", base.length()).put("baseLayersPreserved", !omitTideLayer)
+                    .put("effectiveBaseLayerCount", effectiveBase.length())
+                    .put("tideLayerExcluded", omitTideLayer)
+                    .put("excludedLayerId", if (omitTideLayer) TIDE_LAYER else JSONObject.NULL)
+                    .put("excludedLayerSource", if (omitTideLayer) TIDE_SOURCE else JSONObject.NULL)
+                    .put("excludedLayerCount", if (omitTideLayer) 1 else 0)
+                    .put("tideOriginalSourcePresent", root.getJSONObject("sources").has(TIDE_SOURCE))
+                    .put("full113Equivalent", false).put("missingProductionDynamicLayerDefinitions", true)
+                    .put("dynamicParity", "测试场结构模式；缺少同版本113层完整Source/Layer/visibility/数据快照")
+                    .put("navSeaSourceHead", "ad9aa043fde37f87462f31de3fbd8ce008f8424b")
+                    .put("navSeaSourceSelector", "RenderSegmentHost.tsx:RC@rn-weather-color")
+                    .put("deviceReferenceSelector", "用户STEP-112:RCRR_PREFIX[0,13)/[13,33)/[33,107)/[107,113)")
+                    .put("baseLayerManifest", layerManifest(base))
+                    .put("effectiveBaseLayerManifest", layerManifest(effectiveBase))
+                    .put("sprite", root.optString("sprite"))
+                    .put("glyphs", root.optString("glyphs")).put("vectorSource", JSONObject(source.toString()))
+                    .put("productionSources", JSONObject(root.getJSONObject("sources").toString()))
+                    .put("internalAnnotationPolicy", "STATIC_RC及全部NO_TIDE场景加载时移除空SDK辅助层；后续添加不再移除")
+                    .put("styleAdjustmentScope", if (omitTideLayer)
+                        "TEST-APP-ONLY；原生产Style63层不变；测试副本排除唯一tide-spots→tide孤立Symbol层" else
+                        "NONE；生产Style基础63层原样")
+                val hasField = scenario != Scenario.PBF63
+                if (hasField) {
+                    val sources = root.getJSONObject("sources")
+                    check(!sources.has(SOURCE)) { "天气 Source ID 冲突" }
+                    sources.put(SOURCE, JSONObject().put("type", "raster-array").put("host-field-submission", true))
+                    val layers = JSONArray()
+                    val prefix = isSegmentedScenario(scenario)
+                    for (i in 0 until effectiveBase.length()) {
+                        layers.put(effectiveBase.getJSONObject(i))
+                        if (prefix && effectiveBase.getJSONObject(i).getString("id") == "clip-outline") addFields(layers)
+                    }
+                    if (!prefix) addFields(layers) // NavSea current source fragment appends to top.
+                    if (scenario == Scenario.SOURCE_CHANGE) {
+                        sources.put(PROBE_SOURCE, JSONObject().put("type", "geojson")
+                            .put("data", JSONObject().put("type", "FeatureCollection").put("features", JSONArray())))
+                        layers.put(JSONObject().put("id", PROBE_LAYER).put("type", "circle")
+                            .put("source", PROBE_SOURCE).put("paint", JSONObject()
+                                .put("circle-radius", 6).put("circle-color", "#ff8800")))
+                    }
+                    root.put("layers", layers)
+                }
+                // Prove all non-excluded production definitions, including
+                // visibility and order, remain byte-equivalent within the JSON.
+                // The original 63-layer manifest/fingerprint is kept separately.
+                val finalLayers = root.getJSONArray("layers")
+                val retainedBase = (0 until finalLayers.length()).map { finalLayers.getJSONObject(it) }
+                    .filter { it.getString("id") in ids }
+                check(retainedBase.size == effectiveBase.length() &&
+                    retainedBase.map { it.getString("id") } == effectiveIds &&
+                    retainedBase.indices.all {
+                        retainedBase[it].toString() == effectiveBase.getJSONObject(it).toString()
+                    } && (!omitTideLayer || retainedBase.none { it.optString("source") == TIDE_SOURCE })) {
+                    "修改后的基础图层集合与用户授权的单一tide排除不一致"
+                }
+                parity.put("testStyleFingerprintSha256", sha256(root.toString()))
+                    .put("testJsonLayerCount", finalLayers.length())
+                    .put("baseParityBasis", if (omitTideLayer)
+                        "同次SDK生产Style63层回读；测试副本仅排除tide-spots，其余62层定义逐项比较；不等同原63层像素验收" else
+                        "同次SDK生产Style回读；完整定义逐层比较，不是设备画面证明")
+                val clipIndex = effectiveIds.indexOf("clip-outline")
+                check(clipIndex >= 0 && clipIndex + 1 < effectiveIds.size) {
+                    "生产Style的clip-outline之后没有基础图层；不可推断RCRR天气位置"
+                }
+                val plan = planJson(scenario, effectiveIds.last(), effectiveIds[clipIndex + 1])
+                parity.put("testPlanSelector", when (scenario) {
+                    Scenario.PARTIAL_RCRR -> "旧RCRR缺源负对照：R0包含缺源tide，C1混合天气与大量静态PBF"
+                    Scenario.RCRR_C_NARROW_NO_TIDE -> "RCRR粒子独占C：WeatherColor及海图均在R"
+                    Scenario.RCRR_C_WIDE_NO_TIDE -> "RCRR宽C：天气及部分PBF；后续静态R"
+                    Scenario.RCRR_R_DYNAMIC_NO_TIDE -> "RCRR负例：粒子进入R，C含普通海图"
+                    Scenario.RCR_PARTICLE_ONLY_NO_TIDE -> "RCR粒子独占C：与RCRR同Style测试缓存分段开销"
+                    Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE -> "RCRRR粒子独占C：增加R段测试分段开销"
+                    Scenario.RCRR_FULL_CONTROL_NO_TIDE -> "与粒子独占C的RCRR同Style/Plan；缓存禁用Full CPU基线"
+                    else -> if (hasField) "当前NavSea源码RC:rn-weather-color" else "基础63层全RETAINED"
+                })
+                    .put("requestedPlan", JSONObject(plan))
+                commandResults.put("planAccepted", map.setRenderSegmentPlan(plan))
+                map.setStyle(Style.Builder().fromJson(root.toString())) testStyle@ { style ->
+                    if (!running || epoch != generation) return@testStyle
+                    try {
+                        if (scenario == Scenario.STATIC_RC || isNoTideVariant(scenario)) {
+                            removeEmptyAnnotationLayer(style, ids)
+                        }
+                        map.cameraPosition = CameraPosition.Builder().target(LatLng(33.45, 129.97))
+                            .zoom(10.5).bearing(0.0).tilt(0.0).build()
+                        if (hasField) initializeFields()
+                        ready = true
+                        lastLogMs = 0L
+                        handler.removeCallbacksAndMessages(null)
+                        if (!paused) handler.post(poll)
+                    } catch (error: Exception) { fail(error) }
+                }
+            } catch (error: Exception) { fail(error) }
+        }
+    }
+
+    private fun removeEmptyAnnotationLayer(style: Style, baseIds: List<String>) {
+        check(ANNOTATION_LAYER !in baseIds && map.annotations.isEmpty()) {
+            "存在生产同名层或遗留Annotation，禁止移除辅助层"
+        }
+        check(!parity.getJSONObject("productionSources").has(ANNOTATION_SOURCE)) {
+            "生产Style占用内部Annotation Source ID，禁止推断为空SDK依赖"
+        }
+        val layer = style.getLayer(ANNOTATION_LAYER)
+        check(layer is SymbolLayer && layer.sourceId == ANNOTATION_SOURCE) {
+            "内建Annotation层身份不符，保留现场"
+        }
+        check(style.getSource(ANNOTATION_SOURCE) != null) { "内建Annotation Source缺失" }
+        // The object overload preserves the detached wrapper for restoration.
+        check(style.removeLayer(layer)) { "空内建Annotation层移除失败" }
+        annotationStyle = style
+        detachedEmptyAnnotationLayer = layer
+        check(style.getSource(ANNOTATION_SOURCE) != null) { "不得移除内建Source" }
+        commandResults.put("emptyBuiltinAnnotationLayerRemoved", true)
+            .put("annotationInstancesAtRemoval", 0).put("annotationSourcePreserved", true)
+        parity.put("removedInternalLayer", ANNOTATION_LAYER)
+            .put("adjustmentScope", "STATIC_RC一次；仅SDK空辅助层；非生产63层")
+        logRecord("annotation-policy", JSONObject(commandResults.toString()).put("scenario", scenario.name))
+    }
+
+    private fun restoreEmptyAnnotationLayer(reason: String) {
+        val style = annotationStyle
+        val layer = detachedEmptyAnnotationLayer
+        try {
+            if (style != null && layer != null && map.style === style && style.getLayer(ANNOTATION_LAYER) == null) {
+                style.addLayer(layer)
+            }
+            commandResults.put("annotationRemovalEnded", reason)
+        } finally {
+            annotationStyle = null
+            detachedEmptyAnnotationLayer = null
+        }
+    }
+
+    private fun checkAnnotationOwnership() {
+        val style = annotationStyle ?: return
+        if (map.style !== style) {
+            restoreEmptyAnnotationLayer("style-replaced")
+            fail(IllegalStateException("Style已替换，空层调整停止；新Style图层原样保留"))
+        } else if (map.annotations.isNotEmpty() || style.getLayer(ANNOTATION_LAYER) != null) {
+            // Native AnnotationManager restores the point layer synchronously
+            // at add/update, before Map::onUpdate. Polling only reports revocation.
+            restoreEmptyAnnotationLayer("annotation-or-layer-added")
+            fail(IllegalStateException("Annotation/辅助层已添加，保留内容并撤销STATIC_RC空层验收条件"))
+        }
+    }
+
+    private fun addFields(layers: JSONArray) {
+        layers.put(JSONObject().put("id", COLOR).put("type", "weather-color").put("source", SOURCE)
+            .put("paint", JSONObject().put("weather-color-opacity", 0.62)))
+        layers.put(JSONObject().put("id", PARTICLE).put("type", "raster-particle").put("source", SOURCE)
+            .put("layout", JSONObject().put("visibility", if (scenario == Scenario.PARTICLE_OFF) "none" else "visible"))
+            .put("paint", JSONObject().put("raster-particle-active", true).put("raster-particle-particle-count", 1024)))
+    }
+
+    private fun initializeFields() {
+        val host = WeatherRuntime(map, WeatherRuntime.Config(SOURCE, COLOR, PARTICLE))
+        runtime = host
+        // Existing real-weather canonical assets. Explicitly not the current NavSea forecast/QBIN feed.
+        val results = JSONArray()
+        for (cycle in listOf("2026080700", "2026080706")) {
+            val path = "integration/particle-weatherv2/ecmwf-hres-wind-20260807/$cycle"
+            val meta = context.assets.open("$path/metadata.json").bufferedReader().use { it.readText() }
+            val data = context.assets.open("$path/field.f32").use { it.readBytes() }
+            val result = host.submitWindField(meta, data)
+            results.put(result.name)
+            check(result.accepted()) { "Field提交拒绝: $cycle $result" }
+        }
+        commandResults.put("fieldSubmit", results)
+            .put("forecastSeek", host.setForecastTime(FORECAST_MS).name)
+            .put("forecastPause", host.setPlaybackState(WeatherRuntime.PlaybackState.PAUSE).name)
+            .put("particleVisibility", host.setParticleVisible(scenario != Scenario.PARTICLE_OFF).name)
+            .put("targetFps", host.setTargetFps(WeatherRuntime.TargetFps.FPS_30).name)
+        check(host.state == WeatherRuntime.State.READY &&
+            commandResults.getString("forecastSeek") == "ACCEPTED" &&
+            commandResults.getString("forecastPause") == "ACCEPTED" &&
+            commandResults.getString("particleVisibility") == "ACCEPTED" &&
+            commandResults.getString("targetFps") == "ACCEPTED") { "固定预报/30fps命令未全部接受: $commandResults" }
+    }
+
+    fun mutateSource() {
+        if (!running || !ready || scenario != Scenario.SOURCE_CHANGE) return
+        val source = map.style?.getSourceAs<GeoJsonSource>(PROBE_SOURCE) ?: return
+        source.setGeoJson(Feature.fromGeometry(Point.fromLngLat(129.97 + (++mutation % 2) * 0.01, 33.45)))
+        // Single explicit mutation; polling never changes Source, Symbol, forecast or camera.
+        commandResults.put("sourceMutationCount", mutation)
+        logRecord("source-command", JSONObject().put("schemaVersion", 1).put("scenario", scenario.name)
+            .put("mutation", mutation).put("source", PROBE_SOURCE).put("evidence", "TEST-APP-STRUCTURAL"))
+    }
+
+    private fun envelope(native: JSONObject): JSONObject = JSONObject().put("schema", "step113-pbf-fast-gate")
+        .put("schemaVersion", 1).put("appVersion", BuildConfig.VERSION_NAME)
+        .put("scenario", scenario.name).put("sceneGeneration", generation)
+        .put("sceneReady", ready).put("blockedReason", failureReason ?: JSONObject.NULL)
+        .put("sampleElapsedMs", SystemClock.elapsedRealtime()).put("styleParity", parity)
+        .put("cameraRequested", JSONObject().put("latitude", 33.45).put("longitude", 129.97)
+            .put("zoom", 10.5).put("bearing", 0.0).put("pitch", 0.0).put("gesturesEnabled", false))
+        .put("commands", JSONObject(commandResults.toString()))
+        .put("forecastRequestedMs", if (runtime != null) FORECAST_MS else JSONObject.NULL)
+        .put("actualForecastTimeObservedMs", JSONObject.NULL)
+        .put("forecastStatus", runtime?.playbackState?.name ?: "NO_FIELD")
+        .put("fieldParity", "既有ECMWF canonical双帧测试数据；非NavSea当前业务预报")
+        .put("particleTick", JSONObject().put("targetFps", runtime?.targetFps?.name ?: "NONE")
+            .put("state", runtime?.state?.name ?: "NO_FIELD").put("particleVisible", scenario != Scenario.PARTICLE_OFF && runtime != null)
+            .put("simulationCounterScope", "process-debug-counter; 非本Map独占计数")
+            .put("processSimulationAdvance", lastPost(native)?.opt("processSimulationAdvance") ?: JSONObject.NULL))
+        .put("native", native)
+
+    private fun lastPost(native: JSONObject): JSONObject? {
+        val frames = native.optJSONObject("fastGateTrace")?.optJSONArray("frames") ?: return null
+        return if (frames.length() > 0) frames.optJSONObject(frames.length() - 1)?.optJSONObject("post") else null
+    }
+
+    private fun summary(native: JSONObject): JSONObject {
+        val t = native.optJSONObject("fastGateTrace") ?: JSONObject()
+        val gates = t.optJSONArray("gates") ?: JSONArray()
+        val counts = JSONArray()
+        for (i in 0 until gates.length()) {
+            val g = gates.getJSONObject(i)
+            counts.put(JSONArray().put(g.optString("reason")).put(g.optLong("failures")).put(g.optLong("firstFailures")))
+        }
+        val rs = JSONArray()
+        val segmentRanges = JSONArray()
+        val segments = native.optJSONArray("segments") ?: JSONArray()
+        for (i in 0 until segments.length()) {
+            val s = segments.getJSONObject(i)
+            segmentRanges.put(JSONObject().put("strategy", s.optString("strategy"))
+                .put("begin", s.optInt("beginIndex")).put("end", s.optInt("endExclusive")))
+            val c = s.optJSONObject("cache") ?: continue
+            rs.put(JSONObject().put("segment", s.optInt("segmentIndex")).put("begin", s.optInt("beginIndex"))
+                .put("end", s.optInt("endExclusive")).put("state", c.optString("cacheState"))
+                .put("build", c.optLong("build")).put("reuse", c.optLong("reuse"))
+                .put("invalidation", c.optLong("invalidation")).put("fallback", c.optLong("fallbackCount"))
+                .put("reason", c.optString("lastFallbackReason")))
+            rs.getJSONObject(rs.length() - 1)
+                .put("missingSourceIds", s.optJSONArray("missingSourceIds") ?: JSONArray())
+                .put("placementCapable", s.optBoolean("placementCapable"))
+                .put("placementGatePassed", s.optBoolean("placementGatePassed"))
+        }
+        return JSONObject().put("schema", "step113-summary").put("schemaVersion", 1).put("scenario", scenario.name)
+            .put("sampleElapsedMs", SystemClock.elapsedRealtime())
+            .put("sceneReady", ready).put("blockedReason", failureReason ?: JSONObject.NULL)
+            .put("sceneGeneration", generation).put("full113Equivalent", false).put("basePreserved", parity.optBoolean("baseLayersPreserved"))
+            .put("originalBaseLayerCount", parity.optInt("baseLayerCount"))
+            .put("effectiveBaseLayerCount", parity.optInt("effectiveBaseLayerCount"))
+            .put("tideLayerExcluded", parity.optBoolean("tideLayerExcluded"))
+            .put("excludedLayerId", parity.opt("excludedLayerId") ?: JSONObject.NULL)
+            .put("excludedLayerSource", parity.opt("excludedLayerSource") ?: JSONObject.NULL)
+            .put("excludedLayerCount", parity.optInt("excludedLayerCount"))
+            .put("fingerprint", parity.optString("productionFingerprintSha256")).put("styleUrl", STYLE_URL)
+            .put("actualLayers", native.optInt("styleLayerCount")).put("planValid", native.optBoolean("valid"))
+            .put("planReason", native.optString("lastReason")).put("lifecycle", t.optLong("lifecycle"))
+            .put("attempts", t.optLong("attempts")).put("windowCount", t.optInt("windowCount"))
+            .put("windowBegin", t.optLong("windowBeginSequence")).put("windowEnd", t.optLong("windowEndSequence"))
+            .put("windowFullRendered", t.optLong("windowFullRendered"))
+            .put("windowFastRendered", t.optLong("windowFastRendered"))
+            .put("processSimulationAdvance", lastPost(native)?.opt("processSimulationAdvance") ?: JSONObject.NULL)
+            .put("overwritten", t.optLong("overwritten")).put("decisionMismatch", t.optLong("decisionMismatch"))
+            .put("fullRendered", t.optLong("fullRendered")).put("fastRendered", t.optLong("fastRendered"))
+            .put("gateFailureCounts", counts).put("segmentRanges", segmentRanges).put("retained", rs)
+            .put("commands", JSONObject(commandResults.toString()))
+            .put("sources", native.optJSONArray("sources") ?: JSONArray())
+            .put("placementChanged", native.optBoolean("placementChanged"))
+            .put("placementTransitionActive", native.optBoolean("placementTransitionActive"))
+            .put("symbolFadeChange", native.opt("symbolFadeChange") ?: JSONObject.NULL)
+    }
+
+    fun export() {
+        // Export exactly the last low-frequency shared snapshot; do not request an extra render/query.
+        val record = latest ?: return
+        val file = File(context.filesDir, "step113-${scenario.name}-${SystemClock.elapsedRealtime()}.json")
+        try {
+            file.writeText(record.toString(), Charsets.UTF_8)
+            logRecord("snapshot", record)
+            display("STEP-113 已导出 ${file.name}；Logcat标签 $TAG")
+        } catch (error: Exception) { Log.e(TAG, "export-failed", error) }
+    }
+
+    private fun logRecord(kind: String, record: JSONObject) {
+        // Logcat has a per-entry limit. UTF-8 -> Base64 ensures chunks never split Unicode.
+        val data = Base64.encodeToString(record.toString().toByteArray(Charsets.UTF_8), Base64.NO_WRAP)
+        val chunks = data.chunked(2400)
+        val id = "${SystemClock.elapsedRealtime()}-${generation}-${++exportSequence}"
+        chunks.forEachIndexed { index, chunk ->
+            Log.i(TAG, JSONObject().put("schemaVersion", 1).put("kind", kind).put("exportId", id)
+                .put("chunkIndex", index).put("chunkCount", chunks.size).put("encoding", "base64-utf8")
+                .put("payload", chunk).toString())
+        }
+    }
+
+    fun onStyleLoadFailed(message: String) {
+        if (running) fail(IllegalStateException(message))
+    }
+
+    private fun fail(error: Exception) {
+        ready = false
+        failureReason = "BLOCKED: ${error.message}"
+        display("STEP-113 BLOCKED: ${error.message}")
+        Log.e(TAG, "scene-blocked", error)
+        logRecord("blocked", JSONObject().put("schemaVersion", 1).put("scenario", scenario.name)
+            .put("reason", error.message).put("styleUrl", STYLE_URL).put("evidence", "NOT-VERIFIED"))
+    }
+
+    fun pause() { paused = true; handler.removeCallbacksAndMessages(null) }
+    fun resume() {
+        paused = false
+        handler.removeCallbacksAndMessages(null)
+        if (running) handler.post(poll)
+    }
+    fun stop() {
+        running = false
+        ++generation
+        handler.removeCallbacksAndMessages(null)
+        try { restoreEmptyAnnotationLayer("scene-stopped") }
+        catch (error: Exception) { Log.e(TAG, "annotation-layer-restore-failed", error) }
+        runtime?.dispose()
+        runtime = null
+        savedGestures?.let { flags ->
+            val ui = map.uiSettings
+            ui.setScrollGesturesEnabled(flags[0])
+            ui.setRotateGesturesEnabled(flags[1])
+            ui.setTiltGesturesEnabled(flags[2])
+            ui.setZoomGesturesEnabled(flags[3])
+            ui.setDoubleTapGesturesEnabled(flags[4])
+            ui.setQuickZoomGesturesEnabled(flags[5])
+        }
+        savedGestures = null
+        ready = false
+    }
+
+    companion object {
+        const val TAG = "STEP113Gate"
+        const val STYLE_URL = "https://pbf.jpcn.ccwu.cc/style/style.navsea-delivery-full-semantic-extentfix.json"
+        private const val SPRITE = "https://pbf.jpcn.ccwu.cc/sprite/sprite"
+        private const val GLYPHS = "https://pbf.jpcn.ccwu.cc/fonts/{fontstack}/{range}.pbf"
+        private const val TILES = "https://pbf.jpcn.ccwu.cc/pbf/pbf-delivery-full-20260418-rebuild/{z}/{x}/{y}.pbf"
+        private const val SOURCE = "rn-weather-fields"
+        private const val COLOR = "rn-weather-color"
+        private const val PARTICLE = "rn-weather-particles"
+        private const val PROBE_SOURCE = "step113-source-probe"
+        private const val PROBE_LAYER = "step113-source-probe-circle"
+        private const val TIDE_SOURCE = "tide"
+        private const val TIDE_LAYER = "tide-spots"
+        private const val ANNOTATION_SOURCE = "org.maplibre.annotations"
+        private const val ANNOTATION_LAYER = "org.maplibre.annotations.points"
+        private const val FORECAST_MS = 1786060800000L
+
+        private fun isSegmentedScenario(s: Scenario): Boolean = s == Scenario.PARTIAL_RCRR ||
+            s == Scenario.RCRR_C_NARROW_NO_TIDE || s == Scenario.RCRR_C_WIDE_NO_TIDE ||
+            s == Scenario.RCRR_R_DYNAMIC_NO_TIDE || s == Scenario.RCR_PARTICLE_ONLY_NO_TIDE ||
+            s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE || s == Scenario.RCRR_FULL_CONTROL_NO_TIDE
+
+        private fun isCpuBenchmark(s: Scenario): Boolean = s == Scenario.RCRR_C_NARROW_NO_TIDE ||
+            s == Scenario.RCR_PARTICLE_ONLY_NO_TIDE || s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE ||
+            s == Scenario.RCRR_FULL_CONTROL_NO_TIDE
+
+        private fun isNoTideVariant(s: Scenario): Boolean = s == Scenario.STATIC_RC_NO_TIDE ||
+            s == Scenario.RCRR_C_NARROW_NO_TIDE || s == Scenario.RCRR_C_WIDE_NO_TIDE ||
+            s == Scenario.RCRR_R_DYNAMIC_NO_TIDE || s == Scenario.RCR_PARTICLE_ONLY_NO_TIDE ||
+            s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE || s == Scenario.RCRR_FULL_CONTROL_NO_TIDE
+
+        private fun planJson(s: Scenario, finalBaseId: String, firstAfterClipId: String): String {
+            val segments = JSONArray().put(JSONObject().put("strategy", "RETAINED"))
+            if (s != Scenario.PBF63) {
+                val continuousStart = when (s) {
+                    Scenario.PARTIAL_RCRR, Scenario.RCRR_C_WIDE_NO_TIDE -> "sea-area-fill"
+                    Scenario.RCRR_R_DYNAMIC_NO_TIDE -> firstAfterClipId
+                    else -> if (s == Scenario.RCRR_C_NARROW_NO_TIDE ||
+                        s == Scenario.RCR_PARTICLE_ONLY_NO_TIDE ||
+                        s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE ||
+                        s == Scenario.RCRR_FULL_CONTROL_NO_TIDE) PARTICLE else COLOR
+                }
+                segments.put(JSONObject().put("strategy", "CONTINUOUS").put("startLayerId", continuousStart))
+                if (isSegmentedScenario(s)) {
+                    val particleOnlyC = s == Scenario.RCRR_C_NARROW_NO_TIDE ||
+                        s == Scenario.RCR_PARTICLE_ONLY_NO_TIDE ||
+                        s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE ||
+                        s == Scenario.RCRR_FULL_CONTROL_NO_TIDE
+                    val upperRetainedStart = if (particleOnlyC)
+                        firstAfterClipId else "special-pattern-line-754"
+                    segments.put(JSONObject().put("strategy", "RETAINED").put("startLayerId", upperRetainedStart))
+                    if (s == Scenario.RCRRR_PARTICLE_ONLY_NO_TIDE) {
+                        segments.put(JSONObject().put("strategy", "RETAINED")
+                            .put("startLayerId", "special-pattern-line-754"))
+                    }
+                    if (s != Scenario.RCR_PARTICLE_ONLY_NO_TIDE) {
+                        segments.put(JSONObject().put("strategy", "RETAINED").put("startLayerId", finalBaseId))
+                    }
+                }
+            }
+            return JSONObject().put("schemaVersion", 1).put("segments", segments).toString()
+        }
+
+        private fun layerManifest(layers: JSONArray): JSONArray = JSONArray().apply {
+            for (i in 0 until layers.length()) {
+                val l = layers.getJSONObject(i)
+                put(JSONObject().put("index", i).put("id", l.getString("id")).put("type", l.getString("type"))
+                    .put("source", l.opt("source") ?: JSONObject.NULL)
+                    .put("visibility", l.optJSONObject("layout")?.optString("visibility", "visible") ?: "visible"))
+            }
+        }
+        private fun sha256(text: String): String = MessageDigest.getInstance("SHA-256")
+            .digest(text.toByteArray(Charsets.UTF_8)).joinToString("") { "%02x".format(it.toInt() and 0xff) }
+    }
+}

platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/particle/Step114FastSmokeScene.kt

@@ -0,0 +1,329 @@
+package org.maplibre.android.testapp.activity.particle
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.Color
+import android.os.Handler
+import android.os.Looper
+import android.os.SystemClock
+import android.util.Log
+import org.json.JSONArray
+import org.json.JSONObject
+import org.maplibre.android.annotations.Marker
+import org.maplibre.android.annotations.MarkerOptions
+import org.maplibre.android.camera.CameraPosition
+import org.maplibre.android.geometry.LatLng
+import org.maplibre.android.maps.MapLibreMap
+import org.maplibre.android.maps.Style
+import org.maplibre.android.maps.WeatherRuntime
+import org.maplibre.android.style.layers.PropertyFactory.iconImage
+import org.maplibre.android.style.layers.SymbolLayer
+import org.maplibre.android.style.sources.GeoJsonSource
+import org.maplibre.android.testapp.BuildConfig
+import org.maplibre.geojson.Feature
+import org.maplibre.geojson.Point
+import java.io.File
+
+/** 独立离线最小场景；不代表正式 PBF/NavSea。所有帧与缓存计数仅来自 Native。 */
+internal class Step114FastSmokeScene(
+    private val context: Context,
+    private val map: MapLibreMap,
+    private val display: (String) -> Unit
+) {
+    enum class Scenario { FAST_SMOKE, CIRCLE_C_BLOCKED, ANNOTATION_BLOCKED, SYMBOL_R_BLOCKED }
+
+    private val handler = Handler(Looper.getMainLooper())
+    private var generation = 0
+    private var running = false
+    private var paused = false
+    private var ready = false
+    private var blocked: String? = null
+    private var scenario = Scenario.FAST_SMOKE
+    private var runtime: WeatherRuntime? = null
+    private var marker: Marker? = null
+    private var savedGestures: List<Boolean>? = null
+    private var commands = JSONObject()
+    private var mutation = 0
+    private var cameraAlternate = false
+    private var actionSequence = 0L
+    private var lastLogMs = 0L
+    private val poll = object : Runnable {
+        override fun run() {
+            if (!running || paused) return
+            try {
+                val native = JSONObject(map.getRenderSegmentDiagnostics())
+                val trace = native.optJSONObject("fastGateTrace")
+                val segments = native.optJSONArray("segments") ?: JSONArray()
+                display(buildString {
+                    append("STEP-114 $scenario · 独立 smoke · ${if (ready) "READY/待验收" else blocked ?: "LOADING"}\n")
+                    append("Native Full=${trace?.optLong("fullRendered")} Fast=${trace?.optLong("fastRendered")} ")
+                    append("windowFast=${trace?.optLong("windowFastRendered")} mismatch=${trace?.optLong("decisionMismatch")}\n")
+                    for (i in 0 until segments.length()) {
+                        val s = segments.getJSONObject(i)
+                        val c = s.optJSONObject("cache")
+                        append("${s.optString("strategy")}[${s.optInt("beginIndex")},${s.optInt("endExclusive")}) ")
+                        append("B=${c?.optLong("build") ?: 0} Reuse=${c?.optLong("reuse") ?: 0} ")
+                        append("${s.optString("actualExecution")} ${c?.optString("lastFallbackReason") ?: ""}\n")
+                    }
+                    append("固定预报/相机；操作前后快照保存在 files/step114-*.json")
+                })
+                val now = SystemClock.elapsedRealtime()
+                if (now - lastLogMs >= 30000L) {
+                    lastLogMs = now
+                    Log.i(TAG, "scenario=$scenario ready=$ready full=${trace?.optLong("fullRendered")} " +
+                        "fast=${trace?.optLong("fastRendered")} mismatch=${trace?.optLong("decisionMismatch")}")
+                }
+            } catch (error: Exception) { fail(error) }
+            handler.postDelayed(this, 3000L)
+        }
+    }
+
+    fun start(next: Scenario = Scenario.FAST_SMOKE) {
+        stop()
+        running = true
+        scenario = next
+        ready = false
+        blocked = null
+        commands = JSONObject()
+        mutation = 0
+        cameraAlternate = false
+        lastLogMs = 0L
+        val epoch = ++generation
+        display("STEP-114 $scenario · 独立离线场景加载中；正式 PBF 五场景另在 STEP-113")
+        val ui = map.uiSettings
+        savedGestures = listOf(ui.isScrollGesturesEnabled(), ui.isRotateGesturesEnabled(),
+            ui.isTiltGesturesEnabled(), ui.isZoomGesturesEnabled(),
+            ui.isDoubleTapGesturesEnabled(), ui.isQuickZoomGesturesEnabled())
+        ui.setAllGesturesEnabled(false)
+        map.cancelTransitions()
+        map.setRetainedUnderlayEnabled(true)
+        val plan = JSONObject().put("schemaVersion", 1).put("segments", JSONArray()
+            .put(JSONObject().put("strategy", "RETAINED"))
+            .put(JSONObject().put("strategy", "CONTINUOUS").put("startLayerId", COLOR_LAYER)))
+        commands.put("requestedPlan", plan).put("planAccepted", map.setRenderSegmentPlan(plan.toString()))
+        if (!paused) handler.post(poll)
+        map.setStyle(Style.Builder().fromJson(styleJson())) loaded@ { style ->
+            if (!running || epoch != generation) return@loaded
+            try {
+                check(commands.getBoolean("planAccepted")) { "RenderSegmentPlan 未接受" }
+                check(map.annotations.isEmpty()) { "存在非本场景 Annotation，禁止移除其层" }
+                if (scenario != Scenario.ANNOTATION_BLOCKED) {
+                    // 只在这个没有 Annotation 实例的独立场景移除空内建层。
+                    // 保留内建 source；生产场景和 Native Annotation 行为均不修改。
+                    check(style.getLayer(ANNOTATION_LAYER) != null && style.removeLayer(ANNOTATION_LAYER)) {
+                        "空内建 Annotation 层未能移除，保留 fail-closed 现场"
+                    }
+                    commands.put("emptyBuiltinAnnotationLayerRemoved", true)
+                } else {
+                    check(style.getLayer(ANNOTATION_LAYER) != null) { "内建 Annotation 层缺失" }
+                    marker = map.addMarker(MarkerOptions().position(LatLng(33.45, 129.97)))
+                    commands.put("realAnnotationAdded", true)
+                }
+                if (scenario == Scenario.SYMBOL_R_BLOCKED) {
+                    style.addImage(IMAGE, image(Color.YELLOW))
+                    style.addLayerBelow(SymbolLayer(SYMBOL_LAYER, PROBE_SOURCE)
+                        .withProperties(iconImage(IMAGE)), COLOR_LAYER)
+                    commands.put("structuralSymbolInR", true)
+                }
+                map.cameraPosition = camera(false)
+                initializeFields()
+                ready = true
+                handler.removeCallbacksAndMessages(null)
+                if (!paused) handler.post(poll)
+            } catch (error: Exception) { fail(error) }
+        }
+    }
+
+    private fun styleJson(): String {
+        val layers = JSONArray()
+            .put(JSONObject().put("id", "step114-background").put("type", "background")
+                .put("paint", JSONObject().put("background-color", "#172c40")))
+            .put(JSONObject().put("id", "step114-r-circle").put("type", "circle").put("source", PROBE_SOURCE)
+                .put("paint", JSONObject().put("circle-radius", 12).put("circle-color", "#ff8800")))
+            .put(JSONObject().put("id", COLOR_LAYER).put("type", "weather-color").put("source", FIELD_SOURCE)
+                .put("paint", JSONObject().put("weather-color-opacity", 0.62)))
+            .put(JSONObject().put("id", PARTICLE_LAYER).put("type", "raster-particle").put("source", FIELD_SOURCE)
+                .put("paint", JSONObject().put("raster-particle-active", true)
+                    .put("raster-particle-particle-count", 1024)))
+        if (scenario == Scenario.CIRCLE_C_BLOCKED) {
+            layers.put(JSONObject().put("id", "step114-c-circle").put("type", "circle").put("source", PROBE_SOURCE)
+                .put("paint", JSONObject().put("circle-radius", 5).put("circle-color", "#00ffff")))
+        }
+        return JSONObject().put("version", 8).put("name", "STEP-114 independent offline smoke")
+            .put("sources", JSONObject()
+                .put(PROBE_SOURCE, JSONObject().put("type", "geojson")
+                    .put("data", JSONObject(Feature.fromGeometry(Point.fromLngLat(129.97, 33.45)).toJson())))
+                .put(FIELD_SOURCE, JSONObject().put("type", "raster-array").put("host-field-submission", true)))
+            .put("layers", layers).toString()
+    }
+
+    private fun initializeFields() {
+        val host = WeatherRuntime(map, WeatherRuntime.Config(FIELD_SOURCE, COLOR_LAYER, PARTICLE_LAYER))
+        runtime = host
+        val submitted = JSONArray()
+        for (cycle in listOf("2026080700", "2026080706")) {
+            val path = "integration/particle-weatherv2/ecmwf-hres-wind-20260807/$cycle"
+            val meta = context.assets.open("$path/metadata.json").bufferedReader().use { it.readText() }
+            val data = context.assets.open("$path/field.f32").use { it.readBytes() }
+            val result = host.submitWindField(meta, data)
+            submitted.put(result.name)
+            check(result.accepted()) { "离线 Field 提交失败: $cycle $result" }
+        }
+        commands.put("fieldSubmit", submitted)
+            .put("forecastSeek", host.setForecastTime(FORECAST_MS).name)
+            .put("forecastPause", host.setPlaybackState(WeatherRuntime.PlaybackState.PAUSE).name)
+            .put("particleVisibility", host.setParticleVisible(true).name)
+            .put("targetFps", host.setTargetFps(WeatherRuntime.TargetFps.FPS_30).name)
+        check(host.state == WeatherRuntime.State.READY && listOf("forecastSeek", "forecastPause",
+            "particleVisibility", "targetFps").all { commands.getString(it) == "ACCEPTED" }) {
+            "固定预报/粒子控制未全部接受: $commands"
+        }
+    }
+
+    // 操作前、提交后与短延迟分别保存真实 Native 窗口；不等待、不强制 Full、不构造 Gate 输入。
+    private fun action(name: String, change: () -> Unit) {
+        if (!running || !ready || paused) return
+        val epoch = generation
+        val id = ++actionSequence
+        try {
+            capture("$id-$name-before")
+            change()
+            commands.put("lastAction", name).put("actionSequence", id)
+            capture("$id-$name-submitted")
+            for (delay in listOf(100L, 500L, 1500L)) {
+                handler.postDelayed({
+                    if (running && !paused && epoch == generation) {
+                        try { capture("$id-$name-after-${delay}ms") } catch (error: Exception) { fail(error) }
+                    }
+                }, delay)
+            }
+        } catch (error: Exception) { fail(error) }
+    }
+
+    fun mutateSource() = action("source") {
+        val source = checkNotNull(map.style?.getSourceAs<GeoJsonSource>(PROBE_SOURCE))
+        ++mutation
+        source.setGeoJson(Feature.fromGeometry(Point.fromLngLat(129.97 + (mutation % 2) * 0.01, 33.45)))
+        commands.put("sourceMutationCount", mutation)
+    }
+
+    fun panZoom() = action("pan-zoom") {
+        cameraAlternate = !cameraAlternate
+        map.cameraPosition = camera(cameraAlternate)
+        commands.put("cameraAlternate", cameraAlternate)
+    }
+
+    fun mutateImage() = action("image") {
+        val count = commands.optInt("imageMutationCount") + 1
+        checkNotNull(map.style).addImage(IMAGE, image(if (count % 2 == 1) Color.RED else Color.YELLOW))
+        commands.put("imageMutationCount", count)
+    }
+
+    fun toggleCache() = action("cache-toggle") {
+        val enabled = !commands.optBoolean("cacheDisabled", false)
+        map.setRetainedUnderlayEnabled(!enabled)
+        commands.put("cacheDisabled", enabled)
+    }
+
+    fun mutateAnnotation() = action("annotation") {
+        val annotation = checkNotNull(marker) { "请先选择 ANNOTATION_BLOCKED" }
+        ++mutation
+        annotation.position = LatLng(33.45, 129.97 + (mutation % 2) * 0.01)
+        commands.put("annotationMutationCount", mutation)
+    }
+
+    fun reload() {
+        if (!running) return
+        try { capture("reload-before") } catch (error: Exception) { fail(error); return }
+        start(scenario)
+    }
+
+    private fun envelope(native: JSONObject, phase: String) = JSONObject()
+        .put("schema", "step114-fast-smoke").put("schemaVersion", 1).put("appVersion", BuildConfig.VERSION_NAME)
+        .put("scenario", scenario.name).put("sceneGeneration", generation).put("sceneReady", ready)
+        .put("blockedReason", blocked ?: JSONObject.NULL).put("sampleElapsedMs", SystemClock.elapsedRealtime())
+        .put("phase", phase).put("evidence", "INDEPENDENT-SMOKE; 非PBF/非113层等价")
+        .put("commands", JSONObject(commands.toString())).put("forecastRequestedMs", FORECAST_MS)
+        .put("actualForecastTimeObservedMs", JSONObject.NULL)
+        .put("fieldBasis", "既有离线 ECMWF canonical 双帧；非NavSea当前QBIN")
+        .put("cameraObservedFromSdk", JSONObject().put("latitude", map.cameraPosition.target?.latitude)
+            .put("longitude", map.cameraPosition.target?.longitude).put("zoom", map.cameraPosition.zoom)
+            .put("bearing", map.cameraPosition.bearing).put("pitch", map.cameraPosition.tilt))
+        .put("native", native)
+
+    private fun capture(phase: String) {
+        val record = envelope(JSONObject(map.getRenderSegmentDiagnostics()), phase)
+        write(record, phase)
+    }
+
+    private fun write(record: JSONObject, phase: String) {
+        val file = File(context.filesDir, "step114-${scenario.name}-${generation}-${SystemClock.elapsedRealtime()}-$phase.json")
+        file.writeText(record.toString(), Charsets.UTF_8)
+        Log.i(TAG, "snapshot=${file.name} scenario=$scenario generation=$generation phase=$phase")
+    }
+
+    fun export() {
+        if (!running) return
+        try { capture("manual") } catch (error: Exception) { fail(error) }
+    }
+
+    fun onStyleLoadFailed(message: String) { if (running) fail(IllegalStateException(message)) }
+
+    private fun fail(error: Exception) {
+        ready = false
+        blocked = "BLOCKED: ${error.message}"
+        display("STEP-114 $scenario $blocked")
+        Log.e(TAG, "scene-blocked", error)
+    }
+
+    fun pause() {
+        if (running) try { capture("pause-before") } catch (error: Exception) { fail(error) }
+        paused = true
+        handler.removeCallbacksAndMessages(null)
+    }
+
+    fun resume() {
+        paused = false
+        handler.removeCallbacksAndMessages(null)
+        if (running) handler.post(poll)
+    }
+
+    fun stop() {
+        if (running) try { capture("teardown-before") } catch (error: Exception) { Log.e(TAG, "capture-failed", error) }
+        running = false
+        ++generation
+        handler.removeCallbacksAndMessages(null)
+        runtime?.dispose()
+        runtime = null
+        marker?.let { map.removeMarker(it) }
+        marker = null
+        savedGestures?.let { flags ->
+            val ui = map.uiSettings
+            ui.setScrollGesturesEnabled(flags[0]); ui.setRotateGesturesEnabled(flags[1])
+            ui.setTiltGesturesEnabled(flags[2]); ui.setZoomGesturesEnabled(flags[3])
+            ui.setDoubleTapGesturesEnabled(flags[4]); ui.setQuickZoomGesturesEnabled(flags[5])
+        }
+        savedGestures = null
+        ready = false
+        Log.i(TAG, "scene-stop generation=$generation；MapView 销毁验收由 Activity/设备日志确认")
+    }
+
+    companion object {
+        const val TAG = "STEP114Gate"
+        private const val ANNOTATION_LAYER = "org.maplibre.annotations.points"
+        private const val PROBE_SOURCE = "step114-r-geojson"
+        private const val FIELD_SOURCE = "step114-fields"
+        private const val COLOR_LAYER = "step114-color"
+        private const val PARTICLE_LAYER = "step114-particles"
+        private const val SYMBOL_LAYER = "step114-r-symbol"
+        private const val IMAGE = "step114-image"
+        private const val FORECAST_MS = 1786060800000L
+
+        private fun camera(alternate: Boolean) = CameraPosition.Builder()
+            .target(LatLng(33.45, if (alternate) 130.0 else 129.97))
+            .zoom(if (alternate) 11.0 else 10.5).bearing(0.0).tilt(0.0).build()
+
+        private fun image(color: Int): Bitmap = Bitmap.createBitmap(16, 16, Bitmap.Config.ARGB_8888)
+            .apply { eraseColor(color) }
+    }
+}

platform/android/VERSION

@@ -1 +1 @@
-13.6.1-particle.23
+13.6.1-particle.28

platform/darwin/src/MLNVectorStyleLayer.h

@@ -5,6 +5,23 @@
 
 NS_ASSUME_NONNULL_BEGIN
 
+/** 原始 Filter 接口的错误域。 */
+FOUNDATION_EXTERN MLN_EXPORT NSErrorDomain const MLNStyleFilterErrorDomain;
+
+/** 原始 Filter 接口的稳定错误代码；不影响既有 predicate 接口。 */
+typedef NS_ENUM(NSInteger, MLNStyleFilterErrorCode) {
+  /** E_FILTER_UNSUPPORTED：输入超限、不支持或无法证明无损重放；未写入。 */
+  MLNStyleFilterErrorUnsupported = 1,
+  /** E_FILTER_INVALID_LAYER：rawLayer 已失效或不是支持的 Vector Layer。 */
+  MLNStyleFilterErrorInvalidLayer = 2,
+  /** E_FILTER_WRONG_THREAD：必须在主线程调用。 */
+  MLNStyleFilterErrorWrongThread = 3,
+  /** E_FILTER_MUTATION_FAILED：写入/后验检查失败，已验证原 Filter 恢复。 */
+  MLNStyleFilterErrorMutationFailed = 4,
+  /** E_FILTER_ROLLBACK_FAILED：无法确认恢复；Host 必须废弃当前操作 Context。 */
+  MLNStyleFilterErrorRollbackFailed = 5,
+};
+
 /**
  ``MLNVectorStyleLayer`` is an abstract superclass for style layers whose content
  is defined by an ``MLNShapeSource`` or ``MLNShapeSource`` object.
@@ -53,6 +70,43 @@ MLN_EXPORT
  */
 @property (nonatomic, nullable) NSPredicate *predicate;
 
+/**
+ 读取当前有效 rawLayer 的 Filter JSON 快照；不经过 NSPredicate 或初始化 Style JSON。
+ 空 Filter 返回 NSNull；失败返回 nil，并通过 error 报告原因。
+
+ 仅返回经现有 Foundation/Core 转换器往返验证的子集：JSON 最大深度 64（根为 1），
+ 最多 4096 个节点（含对象键），字符串和键的 UTF-8 总量最多 256 KiB。
+ 字符串/键含 U+0000 或非法 UTF-8、非有限数值、负零、绝对值大于 2^53-1 的数值、
+ 非 JSON Core 值以及不可重放的 Filter 均报 MLNStyleFilterErrorUnsupported。
+ 结构比较保留数组顺序、对象键和值、布尔/数值区别；仅精确可表示的数值存储类型可归一。
+
+ 常用 all/any/!/比较/get/has/in/literal、类型断言和 collator 可以进入验证；
+ 其他操作符、混合 legacy/表达式 Filter 或发生折叠/默认值补全而无法结构往返者可能拒绝。
+ 返回对象与 Layer 状态分离，调用方不得在调用期间并发修改输入或 Style。
+
+ 必须在主线程调用。本接口不证明 Layer 属于当前 Style：未加入或正常移除后仍存活的
+ Layer 可以使用。Host 必须另行核验当前 Style 按 ID 查得的对象身份、Token/代次等；
+ rawLayer 已销毁则失败。该接口不管理 Host Context 或 revision。
+ */
+- (nullable id)rawStyleFilterJSONObjectWithError:(NSError * _Nullable * _Nullable)error;
+
+/**
+ 只设置当前 rawLayer 的 Filter。输入为 Filter 数组或 NSNull（精确恢复空 Filter）；
+ nil 不作为清空指令。NSDecimalNumber 及不支持的 Foundation 类型也会被拒绝。
+
+ 在写入前对输入建立独立快照、验证 Core 解析/序列化不丢失结构，并证明新旧 Filter
+ 可以经上述 getter 的同一路径重放。任何准入失败都返回 NO，原 Layer 不变。
+ 输入必须已是 Core 可往返的形式；显式 literal 标量、常量折叠或省略 collator 默认项
+ 等即使语义可能等价，也可被保守拒绝。具体限制与 rawStyleFilterJSONObjectWithError: 一致。
+
+ 写入后重新检查实际 Filter；若不符或写入抛出异常则尝试恢复原 Filter。
+ MLNStyleFilterErrorMutationFailed 表示恢复已核实，但宿主仍应重新获取状态；
+ MLNStyleFilterErrorRollbackFailed 表示状态无法确认，宿主必须废弃当前操作 Context。
+ 成功仅代表本次 Filter 操作，不能替代 Host 的 Style 成员关系/外部修改检测。
+ 不修改 Paint/Layout/Source/层序，也不移除 Layer 或重载 Style。
+ */
+- (BOOL)setRawStyleFilterJSONObject:(id)json error:(NSError * _Nullable * _Nullable)error;
+
 @end
 
 NS_ASSUME_NONNULL_END

platform/darwin/src/MLNVectorStyleLayer.mm

@@ -1,8 +1,382 @@
 #import "MLNVectorStyleLayer.h"
 #import "MLNStyleLayer_Private.h"
 
+#import <CoreFoundation/CoreFoundation.h>
+
+#include <mln/style/conversion/filter.hpp>
+
+#include <cmath>
+#include <cstring>
+
+NSErrorDomain const MLNStyleFilterErrorDomain = @"MLNStyleFilterErrorDomain";
+
+namespace {
+using Filter = mln::style::Filter;
+using Value = mln::Value;
+using Array = std::vector<Value>;
+using Object = std::unordered_map<std::string, Value>;
+
+constexpr std::size_t MLNFilterMaxDepth = 64;
+constexpr std::size_t MLNFilterMaxNodes = 4096;
+constexpr std::size_t MLNFilterMaxStringBytes = 256 * 1024;
+constexpr int64_t MLNFilterMaxInteger = 9007199254740991LL;
+
+// 对象键也占一个节点；循环 Foundation 容器在触及深度或节点上限时拒绝。
+struct FilterBudget {
+  std::size_t nodes = 0;
+  std::size_t stringBytes = 0;
+
+  bool enter(std::size_t depth) {
+    return depth <= MLNFilterMaxDepth && ++nodes <= MLNFilterMaxNodes;
+  }
+  bool string(const std::string &text) {
+    if (text.size() > MLNFilterMaxStringBytes - stringBytes ||
+        text.find('\0') != std::string::npos) return false;
+    if (![[NSString alloc] initWithBytes:text.data()
+                                length:text.size()
+                              encoding:NSUTF8StringEncoding]) return false;
+    stringBytes += text.size();
+    return true;
+  }
+};
+
+std::optional<Value> FilterNumber(double number) {
+  if (!std::isfinite(number) || std::abs(number) > MLNFilterMaxInteger ||
+      (number == 0 && std::signbit(number))) return std::nullopt;
+  return Value(number);
+}
+
+// 只归一精确可表示的数值；不使用 JSON 文本比较、NSPredicate 或 Filter 的指针相等。
+std::optional<Value> NormalizeFilterValue(const Value &value, FilterBudget &budget,
+                                         std::size_t depth = 1) {
+  if (!budget.enter(depth)) return std::nullopt;
+  return value.match(
+      [](mln::NullValue) -> std::optional<Value> { return Value(mln::NullValue()); },
+      [](bool v) -> std::optional<Value> { return Value(v); },
+      [](int64_t v) -> std::optional<Value> {
+        if (v < -MLNFilterMaxInteger || v > MLNFilterMaxInteger) return std::nullopt;
+        return FilterNumber(static_cast<double>(v));
+      },
+      [](uint64_t v) -> std::optional<Value> {
+        if (v > static_cast<uint64_t>(MLNFilterMaxInteger)) return std::nullopt;
+        return FilterNumber(static_cast<double>(v));
+      },
+      [](float v) { return FilterNumber(v); }, [](double v) { return FilterNumber(v); },
+      [&](const std::string &v) -> std::optional<Value> {
+        return budget.string(v) ? std::optional<Value>(Value(v)) : std::nullopt;
+      },
+      [&](const Array &items) -> std::optional<Value> {
+        if (items.size() > MLNFilterMaxNodes - budget.nodes) return std::nullopt;
+        Array result;
+        for (const auto &item : items) {
+          auto child = NormalizeFilterValue(item, budget, depth + 1);
+          if (!child) return std::nullopt;
+          result.push_back(std::move(*child));
+        }
+        return Value(std::move(result));
+      },
+      [&](const Object &items) -> std::optional<Value> {
+        if (items.size() > (MLNFilterMaxNodes - budget.nodes) / 2) return std::nullopt;
+        Object result;
+        for (const auto &item : items) {
+          if (!budget.enter(depth + 1) || !budget.string(item.first)) return std::nullopt;
+          auto child = NormalizeFilterValue(item.second, budget, depth + 1);
+          if (!child) return std::nullopt;
+          result.emplace(item.first, std::move(*child));
+        }
+        return Value(std::move(result));
+      },
+      [](const auto &) -> std::optional<Value> { return std::nullopt; });
+}
+
+std::optional<Value> NormalizeFilterValue(const Value &value) {
+  FilterBudget budget;
+  return NormalizeFilterValue(value, budget);
+}
+
+std::optional<Value> SnapshotFilterJSON(id json, FilterBudget &budget, std::size_t depth = 1) {
+  if (!json || !budget.enter(depth)) return std::nullopt;
+  if (json == [NSNull null]) return Value(mln::NullValue());
+  if ([json isKindOfClass:[NSString class]]) {
+    NSString *text = json;
+    if (text.length > MLNFilterMaxStringBytes - budget.stringBytes) return std::nullopt;
+    NSData *data = [text dataUsingEncoding:NSUTF8StringEncoding allowLossyConversion:NO];
+    if (!data || data.length > MLNFilterMaxStringBytes - budget.stringBytes) return std::nullopt;
+    std::string value(data.length ? static_cast<const char *>(data.bytes) : "", data.length);
+    return budget.string(value) ? std::optional<Value>(Value(std::move(value))) : std::nullopt;
+  }
+  if ([json isKindOfClass:[NSNumber class]]) {
+    if ([json isKindOfClass:[NSDecimalNumber class]]) return std::nullopt;
+    if (CFGetTypeID((__bridge CFTypeRef)json) == CFBooleanGetTypeID())
+      return Value([json boolValue] != NO);
+    const char *type = [json objCType];
+    if (!type || !type[0] || type[1] || !std::strchr("cCsSiIlLqQfdB", type[0]))
+      return std::nullopt;
+    return FilterNumber([json doubleValue]);
+  }
+  if ([json isKindOfClass:[NSArray class]]) {
+    NSArray *items = json;
+    if (items.count > MLNFilterMaxNodes - budget.nodes) return std::nullopt;
+    Array result;
+    for (id item in items) {
+      auto child = SnapshotFilterJSON(item, budget, depth + 1);
+      if (!child) return std::nullopt;
+      result.push_back(std::move(*child));
+    }
+    return Value(std::move(result));
+  }
+  if ([json isKindOfClass:[NSDictionary class]]) {
+    NSDictionary *items = json;
+    if (items.count > (MLNFilterMaxNodes - budget.nodes) / 2) return std::nullopt;
+    Object result;
+    for (id key in items) {
+      if (![key isKindOfClass:[NSString class]]) return std::nullopt;
+      auto name = SnapshotFilterJSON(key, budget, depth + 1);
+      auto child = name ? SnapshotFilterJSON(items[key], budget, depth + 1) : std::nullopt;
+      if (!name || !child) return std::nullopt;
+      if (!result.emplace(name->get<std::string>(), std::move(*child)).second) return std::nullopt;
+    }
+    return Value(std::move(result));
+  }
+  return std::nullopt;
+}
+
+std::optional<Value> SnapshotFilterJSON(id json) {
+  FilterBudget budget;
+  return SnapshotFilterJSON(json, budget);
+}
+
+// 有限操作符准入；literal 的载荷是 JSON 数据，不按表达式解释。
+// 特别在 Core 访问 ["in"] 的缺失参数前拒绝非法形状。
+bool FilterSyntax(const Value &value) {
+  if (!value.is<Array>()) return !value.is<Object>();
+  const auto &items = value.get<Array>();
+  if (items.empty() || !items[0].is<std::string>()) return false;
+  const auto &op = items[0].get<std::string>();
+  const auto count = items.size();
+  if (op == "literal") return count == 2;
+  if (op == "collator") {
+    if (count != 2 || !items[1].is<Object>()) return false;
+    for (const auto &item : items[1].get<Object>()) if (!FilterSyntax(item.second)) return false;
+    return true;
+  }
+  bool valid = (op == "all" || op == "any" || op == "none") ? count >= 1
+               : op == "!" ? count == 2
+               : (op == "==" || op == "!=" || op == "<" || op == "<=" || op == ">" || op == ">=")
+                   ? (count == 3 || count == 4)
+               : (op == "get" || op == "has") ? (count == 2 || count == 3)
+               : op == "!has" ? count == 2
+               : (op == "in" || op == "!in") ? count >= 3
+               : (op == "string" || op == "number" || op == "boolean") ? count >= 2
+               : false;
+  if (!valid) return false;
+  for (std::size_t i = 1; i < count; ++i) if (!FilterSyntax(items[i])) return false;
+  return true;
+}
+
+// 仅接受具有明确参数形状的 legacy Filter，拒绝 Core 宽松分支可能忽略的混合表达式。
+bool LegacyFilterSyntax(const Value &value) {
+  if (!value.is<Array>()) return false;
+  const auto &items = value.get<Array>();
+  if (items.empty() || !items[0].is<std::string>()) return false;
+  const auto &op = items[0].get<std::string>();
+  if (op == "all" || op == "any" || op == "none") {
+    if (items.size() < 2) return false;
+    for (std::size_t i = 1; i < items.size(); ++i) if (!LegacyFilterSyntax(items[i])) return false;
+    return true;
+  }
+  if (items.size() < 2 || !items[1].is<std::string>()) return false;
+  if (op == "has" || op == "!has") return items.size() == 2;
+  bool valid = (op == "in" || op == "!in") ? items.size() >= 3
+               : (op == "==" || op == "!=" || op == "<" || op == "<=" || op == ">" || op == ">=")
+                   && items.size() == 3;
+  if (!valid) return false;
+  for (std::size_t i = 2; i < items.size(); ++i)
+    if (items[i].is<Array>() || items[i].is<Object>()) return false;
+  return true;
+}
+
+bool FilterExpressionFits(const Filter &filter) {
+  if (!filter.expression) return true;
+  if (!*filter.expression) return false;
+  std::size_t nodes = 0;
+  const auto visit = [&](const auto &self, const mln::style::expression::Expression &expression,
+                         std::size_t depth) -> bool {
+    if (depth > MLNFilterMaxDepth || ++nodes > MLNFilterMaxNodes) return false;
+    bool valid = true;
+    expression.eachChild([&](const auto &child) { if (valid) valid = self(self, child, depth + 1); });
+    return valid;
+  };
+  return visit(visit, **filter.expression, 1);
+}
+
+bool SameFilter(const Filter &actual, const Filter &expected, const Value &expectedJSON) {
+  if (!FilterExpressionFits(actual) || !FilterExpressionFits(expected)) return false;
+  auto serialized = NormalizeFilterValue(actual.serialize());
+  if (!serialized || *serialized != expectedJSON ||
+      actual.expression.has_value() != expected.expression.has_value()) return false;
+  if (!actual.expression) return true;
+  auto actualExpression = NormalizeFilterValue((**actual.expression).serialize());
+  auto expectedExpression = NormalizeFilterValue((**expected.expression).serialize());
+  return actualExpression && expectedExpression && *actualExpression == *expectedExpression &&
+         **actual.expression == **expected.expression;
+}
+
+std::optional<Filter> ParseFilterJSON(const Value &expected, id json) {
+  if (expected.is<mln::NullValue>()) return Filter();
+  if (!expected.is<Array>() || !FilterSyntax(expected)) return std::nullopt;
+  mln::style::conversion::Error error;
+  auto parsed = mln::style::conversion::convert<Filter>(
+      mln::style::conversion::makeConvertible(json), error);
+  if (!parsed || !FilterExpressionFits(*parsed)) return std::nullopt;
+  auto serialized = NormalizeFilterValue(parsed->serialize());
+  if (!serialized || *serialized != expected || !parsed->expression) return std::nullopt;
+  auto expression = NormalizeFilterValue((**parsed->expression).serialize());
+  if (!expression || (*expression != expected && !LegacyFilterSyntax(expected))) return std::nullopt;
+  return parsed;
+}
+
+// 输出真实桥接对象前，先检查 C++ 树，再核对桥接值和 Core 重放的结构与表达式语义。
+id CheckedFilterJSON(const Filter &filter, Value &expected) {
+  if (!FilterExpressionFits(filter)) return nil;
+  auto normalized = NormalizeFilterValue(filter.serialize());
+  if (!normalized) return nil;
+  id json = MLNJSONObjectFromMBGLValue(*normalized);
+  auto bridged = SnapshotFilterJSON(json);
+  if (!bridged || *bridged != *normalized) return nil;
+  auto replayed = ParseFilterJSON(*normalized, json);
+  if (!replayed || !SameFilter(filter, *replayed, *normalized)) return nil;
+  expected = std::move(*normalized);
+  return json;
+}
+
+NSError *FilterError(MLNStyleFilterErrorCode code, NSString *detail) {
+  NSString *identifier = @"E_FILTER_UNSUPPORTED";
+  switch (code) {
+    case MLNStyleFilterErrorUnsupported: identifier = @"E_FILTER_UNSUPPORTED"; break;
+    case MLNStyleFilterErrorInvalidLayer: identifier = @"E_FILTER_INVALID_LAYER"; break;
+    case MLNStyleFilterErrorWrongThread: identifier = @"E_FILTER_WRONG_THREAD"; break;
+    case MLNStyleFilterErrorMutationFailed: identifier = @"E_FILTER_MUTATION_FAILED"; break;
+    case MLNStyleFilterErrorRollbackFailed: identifier = @"E_FILTER_ROLLBACK_FAILED"; break;
+  }
+  return [NSError errorWithDomain:MLNStyleFilterErrorDomain code:code
+                        userInfo:@{NSLocalizedDescriptionKey : [NSString stringWithFormat:@"%@: %@", identifier, detail]}];
+}
+
+mln::style::Layer *FilterLayer(MLNVectorStyleLayer *receiver, NSError **error) {
+  if (![NSThread isMainThread]) {
+    if (error) *error = FilterError(MLNStyleFilterErrorWrongThread, @"原始 Filter 接口必须在主线程调用。");
+    return nullptr;
+  }
+  auto *layer = receiver.rawLayer;
+  if (!layer || layer->getTypeInfo()->tileKind != mln::style::LayerTypeInfo::TileKind::Geometry ||
+      layer->getTypeInfo()->source != mln::style::LayerTypeInfo::Source::Required) {
+    if (error) *error = FilterError(MLNStyleFilterErrorInvalidLayer, @"rawLayer 已失效或不是 Vector Layer。");
+    return nullptr;
+  }
+  return layer;
+}
+
+// 弱指针仅保护后验检查/回滚，不表示 Style 成员关系，也不管理 Host Context。
+NSError *ApplyFilter(MLNVectorStyleLayer *receiver, const Filter &next, const Value &nextJSON,
+                     const Filter &previous, const Value &previousJSON,
+                     const mapbox::base::WeakPtr<mln::style::Layer> &weakLayer) {
+  const auto current = [&]() {
+    auto *layer = weakLayer.get();
+    return layer && receiver.rawLayer == layer ? layer : nullptr;
+  };
+  bool attempted = false;
+  try {
+    @try {
+      auto *layer = current();
+      if (!layer) return FilterError(MLNStyleFilterErrorInvalidLayer, @"写入前 rawLayer 已失效或被替换；未写入。");
+      if (!SameFilter(layer->getFilter(), previous, previousJSON))
+        return FilterError(MLNStyleFilterErrorUnsupported, @"验证期间原 Filter 已改变；未写入。");
+      attempted = true;
+      layer->setFilter(next);
+      if (current() && SameFilter(current()->getFilter(), next, nextJSON)) return nil;
+    } @catch (NSException *exception) {
+      (void)exception;
+      // 写入或 observer 抛出异常后，仍进入下面的原状态恢复和独立核对。
+    }
+  } catch (...) {
+  }
+  if (!attempted)
+    return FilterError(MLNStyleFilterErrorUnsupported, @"写入前验证异常；未写入。");
+  bool restored = false;
+  try {
+    @try {
+      if (auto *layer = current()) layer->setFilter(previous);
+    } @catch (NSException *exception) {
+      (void)exception;
+    }
+  } catch (...) {
+  }
+  // observer 可以在原 Filter 已恢复后抛出异常，恢复核对必须独立执行。
+  try {
+    @try {
+      restored = current() && SameFilter(current()->getFilter(), previous, previousJSON);
+    } @catch (NSException *exception) {
+      (void)exception;
+    }
+  } catch (...) {
+  }
+  return restored ? FilterError(MLNStyleFilterErrorMutationFailed, @"写入或后验检查失败；原 Filter 已恢复并核实。")
+                  : FilterError(MLNStyleFilterErrorRollbackFailed, @"无法确认原 Filter 恢复；Host 必须废弃当前 Context。");
+}
+}  // namespace
+
 @implementation MLNVectorStyleLayer
 
+- (id)rawStyleFilterJSONObjectWithError:(NSError **)error {
+  if (error) *error = nil;
+  auto *layer = FilterLayer(self, error);
+  if (!layer) return nil;
+  try {
+    @try {
+      Value expected;
+      const Filter filter = layer->getFilter();
+      if (id json = CheckedFilterJSON(filter, expected)) return json;
+    } @catch (NSException *exception) {
+      (void)exception;
+    }
+  } catch (...) {
+  }
+  if (error) *error = FilterError(MLNStyleFilterErrorUnsupported, @"当前 Filter 超限、不受支持或无法证明无损重放。");
+  return nil;
+}
+
+- (BOOL)setRawStyleFilterJSONObject:(id)json error:(NSError **)error {
+  if (error) *error = nil;
+  auto *layer = FilterLayer(self, error);
+  if (!layer) return NO;
+  auto weakLayer = layer->makeWeakPtr();
+  try {
+    @try {
+      const Filter previous = layer->getFilter();
+      auto input = SnapshotFilterJSON(json);
+      if (input) {
+        // 解析独立的桥接快照，避免转换器读取调用方的可变容器。
+        id snapshot = MLNJSONObjectFromMBGLValue(*input);
+        auto bridged = SnapshotFilterJSON(snapshot);
+        auto next = bridged && *bridged == *input ? ParseFilterJSON(*input, snapshot) : std::nullopt;
+        Value nextJSON, previousJSON;
+        if (next && CheckedFilterJSON(*next, nextJSON) && nextJSON == *input &&
+            CheckedFilterJSON(previous, previousJSON)) {
+          NSError *failure = ApplyFilter(self, *next, nextJSON, previous, previousJSON, weakLayer);
+          if (error) *error = failure;
+          return failure == nil;
+        }
+      }
+    } @catch (NSException *exception) {
+      (void)exception;
+    }
+  } catch (...) {
+  }
+  if (error) *error = FilterError(MLNStyleFilterErrorUnsupported, @"输入或原 Filter 超限、不受支持或无法证明无损重放；未写入。");
+  return NO;
+}
+
 - (void)setPredicate:(NSPredicate *)predicate {
   [NSException raise:MLNAbstractClassException format:@"MLNVectorStyleLayer is an abstract class"];
 }

platform/ios/BUILD.bazel

@@ -143,8 +143,8 @@ apple_xcframework(
     bundle_name = "MapLibre",
     data = glob([
         "resources/*.lproj/**",
-        "resources/*.xcassets/**",
     ]) + [
+        "resources/Assets.car",
         "PrivacyInfo.xcprivacy",
         "resources/metal-cpp-ignores.txt",
     ],

release/README.md

@@ -6,12 +6,18 @@
 
 | 发行代号 | Android Native / RN | iOS Metal | 状态 | 入口 |
 | --- | --- | --- | --- | --- |
+| v27 | `13.6.1-particle.27` | `6.29.0-particle.27` | GSRL Source Lock 正式发行 | [v27 版本说明](maplibre-particle/13.6.1-particle.27/README.md) |
+| v26 | `13.6.1-particle.26` | `6.29.0-particle.26` | GSRL Source Lock 正式发行 | [v26 版本说明](maplibre-particle/13.6.1-particle.26/README.md) |
+| v25 | `13.6.1-particle.25` | `6.29.0-particle.25` | GSRL Source Lock 正式发行 | [v25 版本说明](maplibre-particle/13.6.1-particle.25/README.md) |
 | v23 | `13.6.1-particle.23` | `6.29.0-particle.23` | GSRL Source Lock 正式发行 | [v23 版本说明](maplibre-particle/13.6.1-particle.23/README.md) |
 | v22 | `13.6.1-particle.22` | `6.29.0-particle.22` | GSRL Source Lock 正式发行 | [v22 版本说明](maplibre-particle/13.6.1-particle.22/README.md) |
 
+- v27 Source Lock：[SOURCE_LOCK.json](maplibre-particle/13.6.1-particle.27/SOURCE_LOCK.json)
+- v26 Source Lock：[SOURCE_LOCK.json](maplibre-particle/13.6.1-particle.26/SOURCE_LOCK.json)
+- v25 Source Lock：[SOURCE_LOCK.json](maplibre-particle/13.6.1-particle.25/SOURCE_LOCK.json)
 - v23 Source Lock：[SOURCE_LOCK.json](maplibre-particle/13.6.1-particle.23/SOURCE_LOCK.json)
 - v22 Source Lock：[SOURCE_LOCK.json](maplibre-particle/13.6.1-particle.22/SOURCE_LOCK.json)
-- v22 统一发布清单：[release-manifest.json](maplibre-particle/release-manifest.json)
+- 最新统一发布清单：[release-manifest.json](maplibre-particle/release-manifest.json)
 - Maven：`https://pbf.jpcn.ccwu.cc/maven`
 - RN 包：`https://pbf.jpcn.ccwu.cc/npm`
 - iOS Metal 二进制：`https://pbf.jpcn.ccwu.cc/swift/maplibre-particle`

release/maplibre-particle/13.6.1-particle.25/README.md

@@ -0,0 +1,36 @@
+# MapLibre Particle v25 正式发行
+
+Android/RN：`13.6.1-particle.25`；iOS Metal/SwiftPM：`6.29.0-particle.25`。跳过 v24，v23 不覆盖。
+
+Build Source Commit：`f32f6f45fd359007e8b3c77911b66d9e7fc93848`。
+
+正式发行 Git Tag：`maplibre-particle/rn/13.6.1-particle.25`。
+
+## 公网获取入口
+
+| 组件 | URL |
+| --- | --- |
+| android / android-sdk-particle-opengl-13.6.1-particle.25.aar | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.aar |
+| android / android-sdk-particle-opengl-13.6.1-particle.25.pom | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.pom |
+| android / android-sdk-particle-opengl-13.6.1-particle.25.module | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.module |
+| reactNative / navsea-maplibre-particle-rn-13.6.1-particle.25.tgz | https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.25.tgz |
+| ios / MapLibre.dynamic.xcframework.zip | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.25/MapLibre.dynamic.xcframework.zip |
+| ios / MapLibre.dynamic.xcframework.zip.sha256 | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.25/MapLibre.dynamic.xcframework.zip.sha256 |
+
+所有六个文件 SHA-256 与尺寸均以同目录 `SOURCE_LOCK.json` 的 `files[]` 为准。发布时使用统一流水线 `tools/particle_release_pipeline/release.sh 25`，经公网重下载逐字节比对通过。
+
+## 安装 / 使用
+
+- Android Maven：`https://pbf.jpcn.ccwu.cc/maven`，依赖 `cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.25`；包括四 ABI。
+- RN：从表中 tgz 安装 `@navsea/maplibre-particle-rn@13.6.1-particle.25`，peer `@maplibre/maplibre-react-native@11.5.0`。
+- iOS：SwiftPM `https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git`，exact tag `6.29.0-particle.25`，product `MapLibre`，Metal ios-arm64 实体机专用，无 Simulator。
+
+## GSRL 接收与验收边界
+
+从本发行入口读取 SOURCE_LOCK.json，核对 Build Source Commit、Tag、依赖和六项制品的 SHA-256；任何不匹配均不得按 v25 接收。
+
+Android / iOS 真实设备发行产物、RN Host 整体联调在 v25 尚未执行，不能把 STEP-119 旧 APK 稳态 CPU 结果视作 v25 二进制真机验收。
+
+本版对 iOS 资源编译采用受控预编译 Assets.car：原始 Images.xcassets 自 v23 未变、Xcode 26.3、SHA 已记录，详见 `docs/报告/V25_iOS实体机Bazel构建兼容性修复与资源溯源_v1.md`。
+
+发行清单：`release/maplibre-particle/release-manifest.json`。

release/maplibre-particle/13.6.1-particle.25/SOURCE_LOCK.json

@@ -0,0 +1,104 @@
+{
+  "schemaVersion": "gsrl/source-lock/v1",
+  "project": "MapLibreParticleLab",
+  "releaseUnit": "Particle unified Android OpenGL / React Native / iOS Metal",
+  "version": "13.6.1-particle.25",
+  "versions": {
+    "android": "13.6.1-particle.25",
+    "reactNative": "13.6.1-particle.25",
+    "ios": "6.29.0-particle.25"
+  },
+  "source": {
+    "gitRemote": "https://git.eyaku.jp/tei/MapLibreParticleLab",
+    "gitCommit": "f32f6f45fd359007e8b3c77911b66d9e7fc93848",
+    "gitRef": "refs/tags/maplibre-particle/rn/13.6.1-particle.25",
+    "note": "gitCommit是实际构建冻结源提交；GSRL Source Lock与最终发行清单在后续提交内记录，Tag指向包含Source Lock和发行清单的最终Commit。"
+  },
+  "files": [
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.25.aar",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.aar",
+      "sha256": "629d5d437d884ec2017f3fde007aaadfd2bc787983457f75bcaf4d4a13184a1e",
+      "sizeBytes": 16625344
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.25.pom",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.pom",
+      "sha256": "1d699fa3b0584fe73c54fec01ae2d310c25be2181f9a92445d5cf354aae685b2",
+      "sizeBytes": 5687
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.25.module",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.25/android-sdk-particle-opengl-13.6.1-particle.25.module",
+      "sha256": "e67ee618439561be7e410ca6a2af9594055827903f16e53f16c1ffc967735273",
+      "sizeBytes": 6999
+    },
+    {
+      "releaseUnit": "reactNative",
+      "name": "navsea-maplibre-particle-rn-13.6.1-particle.25.tgz",
+      "location": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.25.tgz",
+      "sha256": "e5ed678c90bad6082dda30fb9937894cabe28732160391816b785d3c88c208e9",
+      "sizeBytes": 29029
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.25/MapLibre.dynamic.xcframework.zip",
+      "sha256": "91808cfb5559dfa050fe4d466d2c9fa2dc492021bd1a203c778450dc0dae20af",
+      "sizeBytes": 4176630
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip.sha256",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.25/MapLibre.dynamic.xcframework.zip.sha256",
+      "sha256": "a6e708b547600b20f7e8500f8e756be5f720b8df4c7ffa0565da99d695631469",
+      "sizeBytes": 99
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "@maplibre/maplibre-react-native",
+      "version": "11.5.0",
+      "role": "React Native host peer, iOS MapLibreReactNative Pod"
+    },
+    {
+      "name": "React Native",
+      "version": ">=0.80.0",
+      "role": "RN package peer requirement"
+    },
+    {
+      "name": "Expo",
+      "version": ">=54.0.0 (optional)",
+      "role": "RN optional peer"
+    },
+    {
+      "name": "Android Native SDK",
+      "version": "13.6.1-particle.25",
+      "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.25",
+      "role": "OpenGL AAR, arm64-v8a/armeabi-v7a/x86/x86_64"
+    },
+    {
+      "name": "iOS SwiftPM MapLibre",
+      "version": "6.29.0-particle.25",
+      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
+      "role": "Exact version, product MapLibre, Metal ios-arm64"
+    }
+  ],
+  "usage": "release/maplibre-particle/13.6.1-particle.25/README.md",
+  "releaseManifest": "release/maplibre-particle/release-manifest.json",
+  "status": "RELEASED",
+  "validation": {
+    "publicReadback": "PASS - release.sh 25 publish, six files public download byte-compared to build artifacts",
+    "androidBuild": "PASS - four ABI OpenGL Release AAR, build source f32f6f45...",
+    "iosMetalBuild": "PASS - Bazel opt Metal ios-arm64 XCFramework, no simulator slices",
+    "reactNativePack": "PASS - npm pack, peer @maplibre/maplibre-react-native 11.5.0",
+    "androidDevice": "NOT_TESTED - V25 release binary",
+    "reactNative115HostIntegration": "NOT_TESTED - V25",
+    "iosMetalDevice": "NOT_TESTED - V25 release binary",
+    "step119CPU": "PARTIAL - STEP-119 earlier validation APK source 32ac795... not V25 release binary",
+    "note": "GSRL PASS is source/file identity and availability only, not device runtime certification. iOS device-only build reused byte-identical Xcode 26.3 v23 Assets.car from unchanged original assets; see docs/报告/V25_iOS实体机Bazel构建兼容性修复与资源溯源_v1.md."
+  }
+}

release/maplibre-particle/13.6.1-particle.26/README.md

@@ -0,0 +1,32 @@
+# MapLibre Particle V26 正式发行
+
+Android/RN：`13.6.1-particle.26`；iOS Metal/SwiftPM：`6.29.0-particle.26`。
+
+统一真实构建源码 Commit：`fce326a9009d3fc21eb91c5df362f0769163d07e`；正式 Git Tag：`maplibre-particle/rn/13.6.1-particle.26`。
+正式身份、依赖与六项文件 SHA-256 以本目录 [SOURCE_LOCK.json](SOURCE_LOCK.json) 为准。
+
+## 公网发行文件
+
+| 组件 / 文件 | 获取 URL |
+| --- | --- |
+| android / android-sdk-particle-opengl-13.6.1-particle.26.aar | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.aar |
+| android / android-sdk-particle-opengl-13.6.1-particle.26.pom | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.pom |
+| android / android-sdk-particle-opengl-13.6.1-particle.26.module | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.module |
+| reactNative / navsea-maplibre-particle-rn-13.6.1-particle.26.tgz | https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.26.tgz |
+| ios / MapLibre.dynamic.xcframework.zip | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.26/MapLibre.dynamic.xcframework.zip |
+| ios / MapLibre.dynamic.xcframework.zip.sha256 | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.26/MapLibre.dynamic.xcframework.zip.sha256 |
+
+## 安装和使用
+
+- Android Maven：配置仓库 `https://pbf.jpcn.ccwu.cc/maven`，依赖 `cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.26`；OpenGL AAR 含 `armeabi-v7a`、`arm64-v8a`、`x86`、`x86_64`。
+- RN：使用上表 tgz 安装 `@navsea/maplibre-particle-rn@13.6.1-particle.26`；peer 依赖 `@maplibre/maplibre-react-native@11.5.0`，React Native `>=0.80.0`，可选 Expo `>=54.0.0`。
+- iOS：SwiftPM 仓库 `https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git`，精确版本 `6.29.0-particle.26`，product `MapLibre`；Metal、iOS arm64 真机设备专用，不含 Simulator。
+
+## GSRL 接收要求和测试边界
+
+按此目录 SOURCE_LOCK 核对项目、版本、Git Commit/Tag、全部交付文件的 SHA-256、依赖和安装说明；不匹配不得接收。
+`release.sh 26 build` 从上述冻结源码正式构建；`release.sh 26 publish` 执行 NAS 原子发布、六项文件公网下载逐字节对比、SwiftPM Tag 核对均通过。
+
+V26 正式 AAR/Metal ZIP 的真机验收及 NavSea Host 整体接入 **NOT_TESTED**；原 STEP-119 FZ-G1 四轮 Test App 开发态检查不是此次正式 AAR 的运行验收。新增 C++ 生命周期 GTest 因 Mac 缺少 libuv 前置依赖未执行；这些事项不虚报 PASS。
+
+总发行 Manifest：[release-manifest.json](../release-manifest.json)。

release/maplibre-particle/13.6.1-particle.26/SOURCE_LOCK.json

@@ -0,0 +1,104 @@
+{
+  "schemaVersion": "gsrl/source-lock/v1",
+  "project": "MapLibreParticleLab",
+  "releaseUnit": "Particle unified Android OpenGL / React Native / iOS Metal",
+  "version": "13.6.1-particle.26",
+  "versions": {
+    "android": "13.6.1-particle.26",
+    "reactNative": "13.6.1-particle.26",
+    "ios": "6.29.0-particle.26"
+  },
+  "source": {
+    "gitRemote": "https://git.eyaku.jp/tei/MapLibreParticleLab",
+    "gitCommit": "fce326a9009d3fc21eb91c5df362f0769163d07e",
+    "gitRef": "refs/tags/maplibre-particle/rn/13.6.1-particle.26",
+    "note": "gitCommit是本次Android/RN/iOS共用的实际冻结构建源码；发行Tag指向含SOURCE_LOCK与发行Manifest的后续Final Commit。"
+  },
+  "files": [
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.26.aar",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.aar",
+      "sha256": "46c1cf7ff8ebc3bedc25aa38d7d445078a2301e6ca223c0307b93e830991c2b9",
+      "sizeBytes": 16640537
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.26.pom",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.pom",
+      "sha256": "b1e34295c58238a45a8b14d33c801028c3cabc0f40aae6116d007b352fa25520",
+      "sizeBytes": 5687
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.26.module",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.26/android-sdk-particle-opengl-13.6.1-particle.26.module",
+      "sha256": "405b3bb3732ef29a0b54e6b24b192839d07d4c28e959276d6bd92051637011c4",
+      "sizeBytes": 6999
+    },
+    {
+      "releaseUnit": "reactNative",
+      "name": "navsea-maplibre-particle-rn-13.6.1-particle.26.tgz",
+      "location": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.26.tgz",
+      "sha256": "3136316bb6508e774748b21c2095ab61b522d2cf4c3ff2e8c67774dde8549b93",
+      "sizeBytes": 29038
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.26/MapLibre.dynamic.xcframework.zip",
+      "sha256": "64b51c2b9eaec4adefcfb2dfc1c6338943f11db4d6c4ce2a4e1c2a39bb84bddb",
+      "sizeBytes": 4181892
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip.sha256",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.26/MapLibre.dynamic.xcframework.zip.sha256",
+      "sha256": "ae79556c2b288a3970d6e4eba0c30a68023faa79ff55de291c9e2f30f16fd9ae",
+      "sizeBytes": 99
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "@maplibre/maplibre-react-native",
+      "version": "11.5.0",
+      "role": "React Native host peer, iOS MapLibreReactNative Pod"
+    },
+    {
+      "name": "React Native",
+      "version": ">=0.80.0",
+      "role": "RN package peer requirement"
+    },
+    {
+      "name": "Expo",
+      "version": ">=54.0.0 (optional)",
+      "role": "RN optional peer"
+    },
+    {
+      "name": "Android Native SDK",
+      "version": "13.6.1-particle.26",
+      "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.26",
+      "role": "OpenGL AAR, arm64-v8a/armeabi-v7a/x86/x86_64"
+    },
+    {
+      "name": "iOS SwiftPM MapLibre",
+      "version": "6.29.0-particle.26",
+      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
+      "role": "Exact version, product MapLibre, Metal ios-arm64"
+    }
+  ],
+  "usage": "release/maplibre-particle/13.6.1-particle.26/README.md",
+  "releaseManifest": "release/maplibre-particle/release-manifest.json",
+  "status": "RELEASED",
+  "validation": {
+    "publicReadback": "PASS - release.sh 26 publish exit 0; AAR, POM, Module, RN tgz, Metal ZIP, ZIP.sha256 six public files byte-compared to release artifacts",
+    "androidBuild": "PASS - Android OpenGL Release four ABI from frozen source fce326a9009d3fc21eb91c5df362f0769163d07e",
+    "iosMetalBuild": "PASS - Bazel opt Metal ios-arm64 XCFramework, no simulator slices",
+    "reactNativePack": "PASS - npm pack @navsea/maplibre-particle-rn 13.6.1-particle.26; peer MapLibre RN 11.5.0",
+    "androidDevice": "NOT_TESTED - V26 final release AAR itself; STEP-119 earlier development Test App validated separately",
+    "reactNative115HostIntegration": "NOT_TESTED - V26 final release binary in NavSea",
+    "iosMetalDevice": "NOT_TESTED - V26 final release XCFramework on iPhone/iPad",
+    "step119CppGTest": "BLOCKED - Mac CMake prerequisite libuv unavailable, 13 lifecycle GTest sources not executed",
+    "note": "GSRL RELEASED verifies frozen source/files/dependency/public retrieval; it does not certify NavSea production runtime, Android/iOS device tests, or unexecuted C++ GTest."
+  }
+}

release/maplibre-particle/13.6.1-particle.27/README.md

@@ -0,0 +1,35 @@
+# MapLibre Particle V27 正式发行
+
+Android/RN：13.6.1-particle.27；iOS Metal/SwiftPM：6.29.0-particle.27。
+
+统一实际构建源码 Commit：970e3ad606e59873a32e9389e65ef257e1c259bb；正式 Git Tag：maplibre-particle/rn/13.6.1-particle.27。
+正式来源、依赖和六项文件 SHA-256 以本目录 [SOURCE_LOCK.json](SOURCE_LOCK.json) 为准。
+
+## 内容及公开下载
+
+本次新增 Metal Retained Underlay Composite 顶点缓冲槽修复（maxUBOCountPerShader + 0），保留 V26 失败候选的历史调查记录。RCR 为当前 NavSea Host 基线选择；不以 E 全 Continuous 降级冒充本次修复。
+
+| 组件 / 文件 | 公网 URL |
+| --- | --- |
+| android / android-sdk-particle-opengl-13.6.1-particle.27.aar | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.aar |
+| android / android-sdk-particle-opengl-13.6.1-particle.27.pom | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.pom |
+| android / android-sdk-particle-opengl-13.6.1-particle.27.module | https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.module |
+| reactNative / navsea-maplibre-particle-rn-13.6.1-particle.27.tgz | https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.27.tgz |
+| ios / MapLibre.dynamic.xcframework.zip | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.27/MapLibre.dynamic.xcframework.zip |
+| ios / MapLibre.dynamic.xcframework.zip.sha256 | https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.27/MapLibre.dynamic.xcframework.zip.sha256 |
+
+## 安装、依赖与兼容性
+
+- Android：Maven https://pbf.jpcn.ccwu.cc/maven ，坐标 cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.27；OpenGL AAR 包含 armeabi-v7a、arm64-v8a、x86、x86_64。
+- React Native：安装上表 tgz，对应 @navsea/maplibre-particle-rn@13.6.1-particle.27；MapLibre React Native 11.5.0、React Native >=0.80.0，Expo >=54.0.0 可选。
+- iOS：SwiftPM https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git ，Exact Version 6.29.0-particle.27，Product MapLibre；Metal iOS arm64 真机专用，无 Simulator slice。
+
+## GSRL 核验与运行测试边界
+
+release.sh 27 build：Android 四 ABI、Maven Local、iOS Metal Bazel opt、RN pack PASS。
+release.sh 27 publish：NAS 原子发布、六项公网文件逐字节回读、SwiftPM 版本 Tag 核验 PASS。
+
+此次尚未执行 V27 正式二进制的 Android/iOS 真机安装运行、NavSea Host 整体接入及 C++ 生命周期 GTest。此前 slot-9 测试候选获用户视觉确认，不等于本次发行包通过设备验收。
+
+接收方必须独立核对 Git Commit/Tag、全部文件 SHA-256、依赖与安装说明；校验未通过不得正式接入。
+统一 [发行 Manifest](../release-manifest.json)。

release/maplibre-particle/13.6.1-particle.27/SOURCE_LOCK.json

@@ -0,0 +1,104 @@
+{
+  "schemaVersion": "gsrl/source-lock/v1",
+  "project": "MapLibreParticleLab",
+  "releaseUnit": "Particle unified Android OpenGL / React Native / iOS Metal",
+  "version": "13.6.1-particle.27",
+  "versions": {
+    "android": "13.6.1-particle.27",
+    "reactNative": "13.6.1-particle.27",
+    "ios": "6.29.0-particle.27"
+  },
+  "source": {
+    "gitRemote": "https://git.eyaku.jp/tei/MapLibreParticleLab",
+    "gitCommit": "970e3ad606e59873a32e9389e65ef257e1c259bb",
+    "gitRef": "refs/tags/maplibre-particle/rn/13.6.1-particle.27",
+    "note": "gitCommit是本次Android/RN/iOS共用的实际冻结构建源码；发行Tag指向含SOURCE_LOCK与发行Manifest的后续Final Commit。"
+  },
+  "files": [
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.27.aar",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.aar",
+      "sha256": "2ff3ead8e5d7cb8802a4c05ba20cd7f8f0a7029f72619f9a2ec176c942ae8de4",
+      "sizeBytes": 16640539
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.27.pom",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.pom",
+      "sha256": "324d14d689ba7c9206298734d7f9636b95e947c7241d94ec60f8f1d57bd1b701",
+      "sizeBytes": 5687
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.27.module",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.27/android-sdk-particle-opengl-13.6.1-particle.27.module",
+      "sha256": "403804395f065cef75f1254403edbda67c3a885769acbf6d25e091d37c325910",
+      "sizeBytes": 6999
+    },
+    {
+      "releaseUnit": "reactNative",
+      "name": "navsea-maplibre-particle-rn-13.6.1-particle.27.tgz",
+      "location": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.27.tgz",
+      "sha256": "fdd67210debd8363d4bf72fcc0120ef747dc3037d55b8c0d83330dd98bb0bc5d",
+      "sizeBytes": 29040
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.27/MapLibre.dynamic.xcframework.zip",
+      "sha256": "5dbde28600df35484a7f31e7c7c4780f27b919fc6ec59f6aa88d65d81342448c",
+      "sizeBytes": 4181894
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip.sha256",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.27/MapLibre.dynamic.xcframework.zip.sha256",
+      "sha256": "1dba0b0a2831beeadcc022801622829d630ef0838babdfef4edc4b8bec34e08d",
+      "sizeBytes": 99
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "@maplibre/maplibre-react-native",
+      "version": "11.5.0",
+      "role": "React Native host peer, iOS MapLibreReactNative Pod"
+    },
+    {
+      "name": "React Native",
+      "version": ">=0.80.0",
+      "role": "RN package peer requirement"
+    },
+    {
+      "name": "Expo",
+      "version": ">=54.0.0 (optional)",
+      "role": "RN optional peer"
+    },
+    {
+      "name": "Android Native SDK",
+      "version": "13.6.1-particle.27",
+      "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.27",
+      "role": "OpenGL AAR, arm64-v8a/armeabi-v7a/x86/x86_64"
+    },
+    {
+      "name": "iOS SwiftPM MapLibre",
+      "version": "6.29.0-particle.27",
+      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
+      "role": "Exact version, product MapLibre, Metal ios-arm64"
+    }
+  ],
+  "usage": "release/maplibre-particle/13.6.1-particle.27/README.md",
+  "releaseManifest": "release/maplibre-particle/release-manifest.json",
+  "status": "RELEASED",
+  "validation": {
+    "publicReadback": "PASS - release.sh 27 publish exit 0; six public files byte-compared, SwiftPM tag checked",
+    "androidBuild": "PASS - OpenGL Release four ABI from frozen source 970e3ad606e59873a32e9389e65ef257e1c259bb",
+    "iosMetalBuild": "PASS - Bazel opt Metal ios-arm64 XCFramework, no simulator slice",
+    "reactNativePack": "PASS - npm pack 13.6.1-particle.27; MapLibre RN 11.5.0 peer",
+    "androidDevice": "NOT_TESTED - V27 final release AAR itself on device",
+    "reactNative115HostIntegration": "NOT_TESTED - V27 final release package in NavSea Host",
+    "iosMetalDevice": "NOT_TESTED - V27 final XCFramework; prior slot-9 candidate visual acceptance is not a release binary acceptance",
+    "step119CppGTest": "NOT_TESTED - not run in V27 GSRL release",
+    "note": "GSRL RELEASED certifies source, files, dependencies and public readback, not production runtime or device tests."
+  }
+}

release/maplibre-particle/13.6.1-particle.28/README.md

@@ -0,0 +1,37 @@
+# MapLibre Particle V28 正式发行
+
+Android/RN：13.6.1-particle.28；iOS Metal/SwiftPM：6.29.0-particle.28。
+
+统一冻结构建源码 Commit：4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8；正式 Git Tag：maplibre-particle/rn/13.6.1-particle.28。
+正式来源、依赖及全部六项文件 SHA-256 见本目录 [SOURCE_LOCK.json](SOURCE_LOCK.json)。
+
+## 本次变更
+
+iOS MapLibre Native 在 MLNVectorStyleLayer 新增原 Style Layer Filter 的受控原始 JSON 读取与设置 API。实现采用“无损或拒绝”：无法证明与 Core Filter 往返等价时 fail-closed，不经过有损 NSPredicate 读回。原有 predicate、粒子渲染及 Android Native 功能保持。
+
+Style 成员关系、代次和 revision 由 MLRN Host 核验，Native 不内置 CM95 语义。本功能是双端方案 B 的上游前提，不代表 NavSea Host 或设备已通过。
+
+## 公网产物
+
+| 组件 | 文件 | SHA-256 |
+| --- | --- | --- |
+| android | [android-sdk-particle-opengl-13.6.1-particle.28.aar](https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.aar) | a60818db5987f5305d7f94f7eb64d4f3c757131a432cadc9f60c8c3467303f32 |
+| android | [android-sdk-particle-opengl-13.6.1-particle.28.pom](https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.pom) | 20286294b9b210b225c370c7160ca35a023759d4dae58e091df2657d8d540554 |
+| android | [android-sdk-particle-opengl-13.6.1-particle.28.module](https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.module) | 883c81928d232160f1c80442c8d831fc362807c2ea5a68bded9b599eb844505c |
+| reactNative | [navsea-maplibre-particle-rn-13.6.1-particle.28.tgz](https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.28.tgz) | 16726d076ad1117afd2134d578b24a7466c44e68173fb95fa962b5592bd2accd |
+| ios | [MapLibre.dynamic.xcframework.zip](https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip) | 577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74 |
+| ios | [MapLibre.dynamic.xcframework.zip.sha256](https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip.sha256) | fa52c0e75b04a9e81d4e21f3be4bcfe0586fccfee3dcc242784cbdb85397a91a |
+
+## 使用与安装
+
+- Android Maven：https://pbf.jpcn.ccwu.cc/maven；坐标 cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28，OpenGL AAR 含 armeabi-v7a、arm64-v8a、x86、x86_64。
+- React Native：@navsea/maplibre-particle-rn@13.6.1-particle.28；MapLibre RN 11.5.0，React Native >=0.80.0，Expo >=54.0.0 可选。
+- iOS SwiftPM：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git，Exact Version 6.29.0-particle.28，Product MapLibre，Metal iOS arm64 真机专用，无 Simulator slice。
+
+## GSRL 核验与尚未验证
+
+release.sh 28 prepare/build/publish：PASS；冻结源码提交、Android 四 ABI/Maven Local、RN pack、iOS Metal Bazel opt、NAS 原子发布、六项公网文件逐字节回读及 SwiftPM Tag 均通过。
+
+尚未执行 V28 发行 AAR/XCFramework 的真机安装运行，以及 NavSea Host 的 CM95 Filter 查询/应用/恢复、iOS MLRN Bridge 和正式四档测试。构建/发行通过不等于安全语义或设备测试通过。
+
+接收方需核验 Git Tag、SOURCE_LOCK、全部 SHA-256、依赖及 Host Filter 可信审核门槛。

release/maplibre-particle/13.6.1-particle.28/SOURCE_LOCK.json

@@ -0,0 +1,104 @@
+{
+  "schemaVersion": "gsrl/source-lock/v1",
+  "project": "MapLibreParticleLab",
+  "releaseUnit": "Particle unified Android OpenGL / React Native / iOS Metal",
+  "version": "13.6.1-particle.28",
+  "versions": {
+    "android": "13.6.1-particle.28",
+    "reactNative": "13.6.1-particle.28",
+    "ios": "6.29.0-particle.28"
+  },
+  "source": {
+    "gitRemote": "https://git.eyaku.jp/tei/MapLibreParticleLab",
+    "gitCommit": "4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8",
+    "gitRef": "refs/tags/maplibre-particle/rn/13.6.1-particle.28",
+    "note": "gitCommit是Android/RN/iOS共用的实际冻结构建源码；发行Tag指向含SOURCE_LOCK与Manifest的后续Final Commit。"
+  },
+  "files": [
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.28.aar",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.aar",
+      "sha256": "a60818db5987f5305d7f94f7eb64d4f3c757131a432cadc9f60c8c3467303f32",
+      "sizeBytes": 16640539
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.28.pom",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.pom",
+      "sha256": "20286294b9b210b225c370c7160ca35a023759d4dae58e091df2657d8d540554",
+      "sizeBytes": 5687
+    },
+    {
+      "releaseUnit": "android",
+      "name": "android-sdk-particle-opengl-13.6.1-particle.28.module",
+      "location": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.module",
+      "sha256": "883c81928d232160f1c80442c8d831fc362807c2ea5a68bded9b599eb844505c",
+      "sizeBytes": 6999
+    },
+    {
+      "releaseUnit": "reactNative",
+      "name": "navsea-maplibre-particle-rn-13.6.1-particle.28.tgz",
+      "location": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.28.tgz",
+      "sha256": "16726d076ad1117afd2134d578b24a7466c44e68173fb95fa962b5592bd2accd",
+      "sizeBytes": 29063
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip",
+      "sha256": "577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74",
+      "sizeBytes": 4187287
+    },
+    {
+      "releaseUnit": "ios",
+      "name": "MapLibre.dynamic.xcframework.zip.sha256",
+      "location": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip.sha256",
+      "sha256": "fa52c0e75b04a9e81d4e21f3be4bcfe0586fccfee3dcc242784cbdb85397a91a",
+      "sizeBytes": 99
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "@maplibre/maplibre-react-native",
+      "version": "11.5.0",
+      "role": "React Native host peer, iOS MapLibreReactNative Pod"
+    },
+    {
+      "name": "React Native",
+      "version": ">=0.80.0",
+      "role": "RN package peer requirement"
+    },
+    {
+      "name": "Expo",
+      "version": ">=54.0.0 (optional)",
+      "role": "RN optional peer"
+    },
+    {
+      "name": "Android Native SDK",
+      "version": "13.6.1-particle.28",
+      "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28",
+      "role": "OpenGL AAR, arm64-v8a/armeabi-v7a/x86/x86_64"
+    },
+    {
+      "name": "iOS SwiftPM MapLibre",
+      "version": "6.29.0-particle.28",
+      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
+      "role": "Exact version, product MapLibre, Metal ios-arm64"
+    }
+  ],
+  "usage": "release/maplibre-particle/13.6.1-particle.28/README.md",
+  "releaseManifest": "release/maplibre-particle/release-manifest.json",
+  "status": "RELEASED",
+  "validation": {
+    "publicReadback": "PASS - release.sh 28 publish exit 0; six public files byte-compared; SwiftPM tag checked",
+    "androidBuild": "PASS - OpenGL Release four ABI from frozen source 4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8",
+    "iosMetalBuild": "PASS - Bazel opt Metal ios-arm64 XCFramework, no simulator slice",
+    "reactNativePack": "PASS - npm pack 13.6.1-particle.28; MapLibre RN 11.5.0 peer",
+    "newNativeIosAPI": "COMPILED - rawStyleFilterJSONObjectWithError and setRawStyleFilterJSONObject:error exported in iOS framework headers; no independent device invocation",
+    "androidDevice": "NOT_TESTED - V28 final AAR on physical device",
+    "iosMetalDevice": "NOT_TESTED - V28 final XCFramework on physical device",
+    "navseaHostIntegration": "NOT_TESTED - NavSea MLRN iOS bridge and native app build remain separate",
+    "note": "GSRL RELEASED certifies source, files, dependencies and public readback, not full CM95 runtime or device tests."
+  }
+}

release/maplibre-particle/ios/Package.swift.template

@@ -9,8 +9,8 @@ let package = Package(
     targets: [
         .binaryTarget(
             name: "MapLibre",
-            url: "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/MapLibre.dynamic.xcframework.zip",
+            url: "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip",
-            checksum: "9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a"
+            checksum: "577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74"
         ),
     ]
 )

release/maplibre-particle/ios/README.md

@@ -1,14 +1,14 @@
 # MapLibre Particle iOS 发行
 
-当前正式发行：6.29.0-particle.23
+当前正式发行：6.29.0-particle.28
 
 - Renderer：Metal
 - Product / Module：MapLibre
-- Binary：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/MapLibre.dynamic.xcframework.zip
+- Binary：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip
-- SHA-256：9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a
+- SHA-256：577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74
 - SwiftPM：https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git
-- Exact Version：6.29.0-particle.23
+- Exact Version：6.29.0-particle.28
-- Source Commit：87f3d1c59a52581fb8339f0ea7d106b9f4b94fef
+- Source Commit：4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8
 
 构建命令固定为：
 

release/maplibre-particle/ios/release-manifest.json

@@ -1,20 +1,20 @@
 {
   "schemaVersion": 2,
   "status": "PUBLISHED_PUBLIC_READBACK_PASS",
-  "distributionVersion": "6.29.0-particle.23",
+  "distributionVersion": "6.29.0-particle.28",
   "moduleName": "MapLibre",
   "compilationMode": "opt",
   "artifact": {
     "fileName": "MapLibre.dynamic.xcframework.zip",
-    "sizeBytes": 4147380,
+    "sizeBytes": 4187287,
-    "sha256": "9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a",
+    "sha256": "577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74",
-    "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/MapLibre.dynamic.xcframework.zip"
+    "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip"
   },
-  "sourceCommit": "87f3d1c59a52581fb8339f0ea7d106b9f4b94fef",
+  "sourceCommit": "4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8",
   "swiftPackage": {
     "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
     "requirement": "exactVersion",
-    "version": "6.29.0-particle.23",
+    "version": "6.29.0-particle.28",
     "productName": "MapLibre"
   },
   "notes": "Metal renderer optimized release built with bazel build -c opt --//:renderer=metal //platform/ios:MapLibre.dynamic"

release/maplibre-particle/release-manifest.json

@@ -1,49 +1,49 @@
 {
   "schemaVersion": 2,
   "releaseState": "PUBLISHED_PUBLIC_READBACK_PASS",
-  "particleRevision": 23,
+  "particleRevision": 28,
-  "sourceCommit": "87f3d1c59a52581fb8339f0ea7d106b9f4b94fef",
+  "sourceCommit": "4d9cb0ef69dc4bb946c48377f4e1a5b2ba2bbbe8",
-  "generatedAtUtc": "2026-10-09T14:48:11.461982+00:00",
+  "generatedAtUtc": "2026-10-21T07:17:43.623656+00:00",
   "reactNative": {
     "name": "@navsea/maplibre-particle-rn",
-    "version": "13.6.1-particle.23",
+    "version": "13.6.1-particle.28",
     "artifact": {
-      "fileName": "navsea-maplibre-particle-rn-13.6.1-particle.23.tgz",
+      "fileName": "navsea-maplibre-particle-rn-13.6.1-particle.28.tgz",
-      "sizeBytes": 29009,
+      "sizeBytes": 29063,
-      "sha256": "6d8d2fa2312deee97fe9304c62887cd11490a70bc08e4a90f4ee8cf7ec83ed87",
+      "sha256": "16726d076ad1117afd2134d578b24a7466c44e68173fb95fa962b5592bd2accd",
-      "url": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.23.tgz"
+      "url": "https://pbf.jpcn.ccwu.cc/npm/navsea-maplibre-particle-rn-13.6.1-particle.28.tgz"
     },
     "mapLibreReactNative": "11.5.0"
   },
   "android": {
-    "version": "13.6.1-particle.23",
+    "version": "13.6.1-particle.28",
-    "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.23",
+    "coordinate": "cc.navsea.maplibre:android-sdk-particle-opengl:13.6.1-particle.28",
     "renderer": "opengl",
     "artifact": {
-      "fileName": "android-sdk-particle-opengl-13.6.1-particle.23.aar",
+      "fileName": "android-sdk-particle-opengl-13.6.1-particle.28.aar",
-      "sizeBytes": 16541816,
+      "sizeBytes": 16640539,
-      "sha256": "263821b686a569110ad704f817b288522eb2a153f49bf4162ace2226b28220b7",
+      "sha256": "a60818db5987f5305d7f94f7eb64d4f3c757131a432cadc9f60c8c3467303f32",
-      "url": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.23/android-sdk-particle-opengl-13.6.1-particle.23.aar"
+      "url": "https://pbf.jpcn.ccwu.cc/maven/cc/navsea/maplibre/android-sdk-particle-opengl/13.6.1-particle.28/android-sdk-particle-opengl-13.6.1-particle.28.aar"
     },
     "ndk": "28.2.13676358",
     "gradle": "9.5.1",
     "jdk": "openjdk version \"17.0.20.1\" 2026-08-18"
   },
   "ios": {
-    "distributionVersion": "6.29.0-particle.23",
+    "distributionVersion": "6.29.0-particle.28",
     "renderer": "metal",
     "compilationMode": "opt",
     "moduleName": "MapLibre",
     "artifact": {
       "fileName": "MapLibre.dynamic.xcframework.zip",
-      "sizeBytes": 4147380,
+      "sizeBytes": 4187287,
-      "sha256": "9dbc477458377ab7e207bfd125d8f4106d3d83e7f923499a7bc048e39f74a76a",
+      "sha256": "577d0784f1e436c04b3cf0bd0213ce38fdf14612898367ec6e7c73156b82cd74",
-      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.23/MapLibre.dynamic.xcframework.zip"
+      "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle/6.29.0-particle.28/MapLibre.dynamic.xcframework.zip"
     },
     "swiftPackage": {
       "url": "https://pbf.jpcn.ccwu.cc/swift/maplibre-particle-spm.git",
       "requirement": "exactVersion",
-      "version": "6.29.0-particle.23",
+      "version": "6.29.0-particle.28",
       "productName": "MapLibre"
     },
     "xcode": "Xcode 26.3 Build version 17C529 ",

src/mln/annotation/annotation_manager.cpp

@@ -75,6 +75,9 @@ void AnnotationManager::removeAnnotation(const AnnotationID& id) {
 }
 
 void AnnotationManager::add(const AnnotationID& id, const SymbolAnnotation& annotation) {
+    // Repair an explicitly removed empty helper layer before Map::onUpdate
+    // captures the style. A subsequent real annotation must never be hidden.
+    ensurePointLayer();
     auto impl = std::make_shared<SymbolAnnotationImpl>(id, annotation);
     symbolTree.insert(impl);
     symbolAnnotations.emplace(id, impl);
@@ -101,6 +104,9 @@ void AnnotationManager::update(const AnnotationID& id, const SymbolAnnotation& a
 
     const SymbolAnnotation& existing = it->second->annotation;
 
+    // Even an otherwise no-op update must publish the repaired style.
+    dirty = ensurePointLayer() || dirty;
+
     if (existing.geometry != annotation.geometry || existing.icon != annotation.icon) {
         dirty = true;
 
@@ -173,13 +179,18 @@ std::unique_ptr<AnnotationTileData> AnnotationManager::getTileData(const Canonic
     return tileData;
 }
 
-void AnnotationManager::updateStyle() {
+bool AnnotationManager::ensurePointLayer() {
     // Create annotation source, point layer, and point bucket. We do everything
     // via Style::Impl because we don't want annotation mutations to trigger
     // Style::Impl::styleMutated to be set.
+    bool changed = false;
     if (!style.get().impl->getSource(SourceID)) {
         style.get().impl->addSource(std::make_unique<AnnotationSource>());
-
+        changed = true;
+    }
+    // Source and layer lifetimes are independent. Never replace a layer that
+    // the application has supplied with this ID.
+    if (!style.get().impl->getLayer(PointLayerID)) {
         std::unique_ptr<SymbolLayer> layer = std::make_unique<SymbolLayer>(PointLayerID, SourceID);
 
         using namespace expression::dsl;
@@ -190,7 +201,13 @@ void AnnotationManager::updateStyle() {
         layer->setIconIgnorePlacement(true);
 
         style.get().impl->addLayer(std::move(layer));
+        changed = true;
     }
+    return changed;
+}
+
+void AnnotationManager::updateStyle() {
+    ensurePointLayer();
 
     std::scoped_lock lock(mutex);
 

src/mln/annotation/annotation_manager.hpp

@@ -65,6 +65,7 @@ private:
     void remove(const AnnotationID&);
 
     void updateStyle();
+    bool ensurePointLayer();
 
     std::unique_ptr<AnnotationTileData> getTileData(const CanonicalTileID&);