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

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 仅测试工具准备完成。