MapLibreParticleLab/docs/60_测试/STEP-055_Android真实WeatherV2风场综合可视化_人工验收指令_v1.md

STEP-055 Android 真实 WeatherV2 风场综合可视化人工验收

状态：等待用户手工 Android 验收。Codex 不执行本文件中的 Gradle、APK 或 ADB 操作。

Windows 11 构建与安装

在 Windows 11 项目目录执行既有 Android OpenGL Debug 构建命令，并保留 plain 控制台输出，例如：

./gradlew :MapLibreAndroidTestApp:assembleOpenGLDebug --console=plain

安装、启动和日志均显式选择设备：

adb -s 192.168.1.146 install -r <APK_PATH>
adb -s 192.168.1.146 logcat -c
adb -s 192.168.1.146 logcat | findstr /I "REAL_WEATHER WEATHER_COLOR HOST_FIELD ParticleTimeline FIELD_REUSE FIELD_UPLOAD ParticleRender simulationRebuild trailCleared"

入口

进入 Particle Core Layer Validation：

1. MORE → REAL WEATHER。
2. 等待地图自动 fit 到 112.5–157.5E、0–55.776573N；应看到 OSM 底图、半透明风速色场及其上的运动粒子。
3. TIME → PLAY / RESTART。真实 validTime 保持 6 小时步长；没有额外 Android 加速机制，可使用现有 SPEED 2x，或用 STEP NEXT 检查边界。

V1–V8 视觉与行为矩阵

项	操作	期望
V1	REAL WEATHER	出现真实日本/西北太平洋覆盖范围、OSM 底图、风速色场和粒子；无黑屏/crash。
V2	比较色场与粒子	色场强弱分布与粒子移动方向同源；U=eastward、V=northward，无明显横纵交换/符号反转。
V3	PLAY	Timeline READY 后 PLAY 成功；MIX 自动推进，颜色与粒子同时连续变化。
V4	两次自动边界或 STEP NEXT	T0/T1→T1/T2→T2/T3；日志有 OLD_T1_TO_NEW_T0 / FIELD_REUSE，只出现一个 NEW_CONTENT upload。
V5	连续播放观察	正常 boundary 为 simulationRebuild=false、trailCleared=false；不得 style reload/layer rebuild。
V6	Pan/zoom/rotate/viewport resize	底图、色场和粒子均保持地理对齐；旋转/恢复后自动可见，不按任何恢复按钮。
V7	MORE → HOST DUPLICATE	对当前 Host window 得到 Duplicate NOOP，field upload/reset count 无增量。
V8	MORE → HOST INVALID	Host canonical invalid 被拒，最后有效 field、色场/Renderer 持续，无黑屏/crash。

必要日志

正常加载必须可见：

REAL_WEATHER_DATASET_LOAD
HOST_FIELD_SUBMIT_REQUEST / HOST_FIELD_SUBMIT_ACCEPTED
HOST_FIELD_INITIAL_WINDOW_READY
ParticleTimeline: event=READY
REAL_WEATHER_INITIAL_WINDOW_READY
WEATHER_COLOR_FIELD_READY
REAL_WEATHER_COMPOSITE_READY

播放/边界检查：

PLAYBACK_PLAY
TIME_MIX_UPDATE or PLAYBACK_TICK
WINDOW_BOUNDARY
FIELD_REUSE from=OLD_T1 to=NEW_T0
FIELD_UPLOAD reason=NEW_CONTENT
simulationRebuild=false
trailCleared=false

负向检查：

HOST_FIELD_SUBMIT_REJECTED
ADAPTER_REJECTED
result=NOOP

请保存上述日志、V1–V8 结果，以及任何色场与粒子错位、黑屏、旋转后不可恢复或 crash 的时间点。MIX 文本显示可能滞后属于既知 NON-BLOCKING observability，不应替代 Core log 判断。