docs(android): close FZG native runtime audit with placement finding

docs/50_Step记录/STEP-105_FZG1-2_MapLibre13.6.1运行验收记录_v1.md

@@ -0,0 +1,13 @@
+# STEP-105 / FZG1-2 MapLibre Native 13.6.1 实机运行记录 v1
+
+- 日期：2026-10-09 JST。
+- 设备：FZG1-2 Android 13 x86_64，ADB 192.168.200.139:5555。源码：upgrade/android-native-13.6.1-20261009 / c30add4d335c5c02aadac5756c1606b5bc497269。
+- PASS：粒子页面启动和用户观察、Cache 开关、Pan/双击 Zoom 后存活与缓存边界失效、STEP-101 单次重建、STEP-101 流式 Logcat 20 次 Native reset 完整配对、STEP-099 R-C-R 底层复用、QBIN V4 Golden 时间控制六项、STEP-102 T1 Symbol 安全回退、默认界面恢复。
+- STEP-101 T2 证据：20 请求、20 Native reset enter/complete、40 Renderer reset enter/complete、21 ready、crash buffer 0；最初的环形缓冲被覆盖测试不计正式 PASS。
+- STEP-099 T4：动态 GeoJSON 71 次更新，R0 buildDelta=0、reuseDelta=3677、invalidationDelta=0。
+- STEP-102 T1：R0 buildDelta=0、reuseDelta=3683、invalidationDelta=0；R1 包含 Symbol，gate=false、Live/Fallback，符合预期。
+- FAIL：STEP-102 T2_TWO_FREE 的 R1 持续 placementCapable=true、gate=false、Live/Fallback，reuse=0、invalidation 增加 3682；按 fixture R1 为 Fill，理应支持 retained；R0 reuseDelta=3682、buildDelta=0、invalidationDelta=0。无 crash，不证明错绘或确定回归起点。
+- 疑点：运行时注入的 Annotation Symbol、真实 Style Layer Index 或 Segment 范围；应先提取完整诊断和旧 .21 对照，保留 fail-closed，不直接改 Core 公共语义。
+- 证据目录（不提交 Git）：artifacts/maplibre-particle/step105-fzg-runtime-20261009/。截图、UI XML、Logcat、crash buffer 齐备。
+- 恢复：ADB 冷启动默认粒子页 GLOBAL/ACTIVE/EAST/MIX0%/256，当前 FZG 前台 Test App 13.6.1，Crash Buffer 0。
+- 状态：PARTIAL / T2 EXPECTATION FAIL。未编译、未执行 Jest、未更改源码或 NavSea，下一 Gate 是 T2 定向调查修正后回归。

docs/报告/STEP-105_FZG_MapLibre13.6.1运行验收_RDC执行报告_v1.md

@@ -0,0 +1,57 @@
+# STEP-105 FZG1-2 MapLibre 13.6.1 实机 ADB 验收报告 v1
+
+## 1. 结论
+
+整体状态：PARTIAL。Android x86_64 OpenGL 升级候选已在 FZG 上完成多组运行验收；STEP-102 T2_TWO_FREE 仍 FAIL。不得以已安装、可显示粒子和无崩溃代表升级全部 PASS。
+
+## 2. 环境和范围
+
+- 2026-10-09 JST；Mac RDC/ADB；FZG1-2 Android 13，serial 192.168.200.139:5555。
+- Test App org.maplibre.android.testapp / versionName 13.6.1，已安装 APK SHA-256 为 77bc0b238fb476494410a603443030b104d78f97a737307be52460bf5a68f5aa。
+- Git 升级分支 upgrade/android-native-13.6.1-20261009，测试源码 HEAD c30add4d335c5c02aadac5756c1606b5bc497269。
+- 仅 ADB UI/手势/Intent/Logcat/截图；没有 Codex、Gradle、Jest、NavSea 修改、iOS、其他 ABI 或正式发布。
+
+## 3. 验收表
+
+| 实测项目 | 证据 | 结论 |
+|---|---|---|
+| 初始粒子显示 | 用户看到粒子；UI GLOBAL/ACTIVE/EAST/MIX0%/256；两帧截图 | PASS（初始显示） |
+| Cache ON→OFF→ON | 状态回读，runtime-disabled 后恢复 CACHE ON | PASS |
+| 地图平移/双击缩放 | App 存活；camera-or-boundary 缓存失效，后续复用 | PASS（基础运行） |
+| STEP-101 T1 单次重建 | destroy enter/return、Native reset、new Renderer ready、DONE | PASS |
+| STEP-101 T2 20 次重建 | 流式日志20请求、20 Native reset进入/完成、40 Render reset进入/完成、21 ready、crash buffer0 | PASS |
+| STEP-099 T4 R-C-R | 71次动态源更新，R0 build2→2、reuse5696→9373、invalidation35→35 | PASS（R0 locality） |
+| QBIN V4 Golden | T0/T1 ACCEPTED_INSERTED，6项播放控制 ACCEPTED | PASS（操作契约） |
+| STEP-102 T1_FREE_SYMBOL | R0 composite reuse +3683；R1 symbol placement gate false，Live | PASS |
+| STEP-102 T2_TWO_FREE | R0 reuse +3682；R1 placementCapable=true、Live/Fallback、reuse0 | FAIL（预期双 Retained） |
+| 最终恢复 | 默认 GLOBAL/ACTIVE/EAST/MIX0%/256；前台 Test App 13.6.1；crash buffer0 | PASS |
+
+## 4. 关键数字及诊断
+
+STEP-101 T2 首轮虽完成20次但设备环形 Logcat 丢失了前15次。该轮不记完整 PASS。第二轮使用 Mac 实时流式日志，从场景启动前持续记录到 DONE，完整包含：20 RESET_REQUEST、20 MapView destroy enter、20 destroy return、20 nativeReset entered、20 nativeReset completed、40 resetRenderer entered、40 completed、21 NEW_RENDERER_READY、1 SCENARIO_DONE，Crash Buffer 0。
+
+STEP-099 T4 R-C-R（底层 Retained/中央粒子 Continuous/上层动态 Retained）在 tick8 至 tick130：R0 build=2→2、reuse=5696→9373（+3677）、invalidation=35→35；动态 GeoJSON 共71次更新。上层 R1 因 static-placement 保守 Live 回退。该 PASS 仅针对独立 R0 的 Source-scoped 缓存隔离。
+
+QBIN V4 Golden 录得 t0=ACCEPTED_INSERTED、t1=ACCEPTED_INSERTED，后续 action=3 Seek25、4 Seek75、1 Play、5 Speed2、2 Pause、7 Clear，均 result=ACCEPTED；最终 UI 显示 V4 CLEARED。这不是天气场颜色和方向的像素级数值证明。
+
+## 5. T2_TWO_FREE 阻塞事实和归因限制
+
+T1：R0 placementCapable=false/gate=true/actual=composite，build1→1、reuse196→3879、invalidation6→6；带 Symbol 的 R1 placementCapable=true/gate=false/actual=live，符合保守安全设计。
+
+T2：R0 placementCapable=false/gate=true/actual=composite，build1→1、reuse197→3879、invalidation5→5；R1 即使 fixture 指定 Fill，仍 placementCapable=true、gate=false、actual=live、fallback=static-placement，build0→0、reuse0→0、invalidation202→3884。最终 symbolFadeChange≈0.997、placementTransitionActive=true、crossSourceCollisions=true。两窗口 tick8/130 一致；无 FATAL/ANR，Crash Buffer 0。
+
+只读源码：renderSegmentHasPlacementCapableLayer 只要分段内出现类型 symbol 即判 true，而测试 fixture T2 的自定义上层为 Fill。应调查运行时完整 Style Layer 列表、默认 Annotation Symbol 注入、segment begin/end、source/layer 归属。其它场景的 dependency 中曾出现 org.maplibre.annotations，但尚未证明在 T2 中造成该问题。缺少旧 .21 的 T2 运行对照，因此不应把该差异直接断言为 13.6.1 新引入的回归。
+
+现象是保守 Live/Fallback 与复用能力未达预期，不是已证实的错绘或 GPU 资源错误。禁止为凑 PASS 关闭 Placement 安全门。需先核实是场景/区段定义问题还是实现问题，再在授权范围内修复并重新验收。
+
+## 6. 原始证据、范围与收尾
+
+Mac Git 忽略目录：artifacts/maplibre-particle/step105-fzg-runtime-20261009/，共含 01-baseline、02-cache、03-camera、04-teardown-t1、05-teardown-t2、06-locality-t4、07-qbin-v4、08-step102-t1、09-step102-t2、10-restored；保存截图、UI XML、原始流式 Logcat 与 crash buffer。其中 STEP-101 T2 正式证据为 05-teardown-t2/stream-complete.log。
+
+本轮未做严格像素对比、长时间性能曲线、bearing/pitch 数值校验、Vulkan、RN 11.5.0、iOS、NavSea SDK 接入或正式发布。
+
+结束前将 FZG 的 Test App 重新冷启动至普通粒子状态 GLOBAL / ACTIVE / EAST / MIX 0% / 256，前台运行、版本仍 13.6.1，设备 Crash Buffer 为空；NavSea 没有被安装或覆盖。
+
+下一阶段：STEP-102 T2 的只读诊断与旧版 .21 对照，确定是否默认 annotation layer 被归入 R1，必要时明确修正场景/索引或源码，并在用户手工 Android 编译后由 RDC 重跑 T1/T2、T4 R-C-R 与 STEP-101 20次 reset。未完成前 Android Native 功能 Gate 保持 PARTIAL。
+
+此报告没有业务代码提交。根目录 recoder_step.md 追加事实，中文阶段记录与 Git 远端状态通过 RDC 单独收尾。

recoder_step.md

@@ -57,3 +57,18 @@
 - FZG 原版 APK 备份：`artifacts/maplibre-particle/step105-native1361-fzg/rollback/MapLibreAndroidTestApp-original-13.4.1-particle.21.apk`（不纳入 Git），SHA-256 `999f773276b29fffae05c1edc977e19df6cebecd94e4a4095508d0c5e97e07c2`。
 - 当前 FZG 前台依旧 `com.navsea.app/.MainActivity`；本轮不自动启动 Test App，未进行 Particle/RenderSegment GPU 画面或功能回归。
 - 结论：**APK_BUILD_PASS / FZG_INSTALL_PASS / INSTALLED_FILE_SHA_PASS / RUNTIME_NOT_RUN**。下一步单独进行 FZG Test App 启动、粒子/QBIN、Pan/Zoom/Rotate、RenderSegment/Style/卸载的真机运行验收。
+
+## 2026-10-09 / STEP-105 / FZG 实机运行验收
+
+- 基线：Android Native 13.6.1，升级分支源码 c30add4d335c5c02aadac5756c1606b5bc497269，FZG1-2 x86_64 / Android 13，ADB 192.168.200.139:5555。Mac RDC/ADB 执行，不重新编译、不改 NavSea。
+- 默认界面：用户目视看到粒子，ADB 确认 GLOBAL / ACTIVE / EAST / MIX 0% / 256，启动及基线日志无崩溃。
+- Cache ON/OFF/ON PASS：控制状态与诊断回读一致；关闭出现 runtime-disabled，重新开启恢复 CACHE ON。
+- 平移及双击缩放基础存活 PASS：Activity 未退出，诊断出现 camera-or-boundary 失效后继续复用；未进行视图精确像素比较。
+- STEP-101 单次销毁重建 T1 PASS。循环 T2 首次因设备 Logcat 环形缓冲丢失早期记录，不记正式 PASS；第二次改 Mac 流式 Logcat，真实记录 20 requests、20 destroy enter/return、20 Native reset enter/complete、40 Render reset enter/complete、21 renderer ready、DONE1；Crash Buffer 0，PASS。
+- STEP-099 T4 R-C-R PASS（仅限无关底层 R0）：71 次动态 GeoJSON 更新，窗口 tick8/130，R0 build 2→2、reuse 5696→9373（+3677）、invalidation 35→35；R1 安全 fallback static-placement。
+- QBIN V4 Golden PASS：T0/T1 两片均 ACCEPTED_INSERTED；Seek25/Seek75/Play/Speed2×/Pause/Clear 六项均 ACCEPTED；最后 UI 为 V4 CLEARED。未验证像素级场值。
+- STEP-102 T1_FREE_SYMBOL PASS：无 Symbol 的 R0 build 1→1、reuse 196→3879（+3683）、invalidation 6→6，composite；带 Symbol 的 R1 placement gate=false，live 安全回退。
+- STEP-102 T2_TWO_FREE FAIL：底层 R0 build 1→1、reuse 197→3879（+3682）、invalidation 5→5；测试 fixture 上层只有 Fill，实际 R1 仍 placementCapable=true、gate=false、live、fallback=static-placement，reuse=0、invalidation 202→3884，不满足两个 Retained 区段均可复用的用例预期。无 crash，不能据此认定错绘，也不能认定相对 .21 已证实回归。
+- 候选原因：需要核实 Style 中默认注入的 annotation/symbol layer 是否被划入 R1，以及 Segment 范围；不要移除保守安全 gate 来凑 PASS。
+- 收尾：已恢复正常 GLOBAL/ACTIVE/EAST/MIX 0%/256 默认粒子页面，FZG 前台 Test App 13.6.1，进程存活，Crash Buffer 0。整体状态 PARTIAL / T2 EXPECTATION FAIL。
+- 原始证据保存在 Git 忽略目录 artifacts/maplibre-particle/step105-fzg-runtime-20261009/01-baseline 到 10-restored。未执行 Gradle、Jest、NavSea、iOS；下阶段先解决 T2 再复测。