# STEP-055 Android 真实 WeatherV2 风场综合可视化 v7

状态：**IMPLEMENTED / WAITING_ANDROID_VALIDATION**

Starting HEAD：`d9a9c8ed57605abca86893ba7fb3b5265db3c0dc`

## Zoom 下 Viewport 粒子密度调整

- `configured particleCount` 不随 zoom 改变，仍由既有用户设置控制；本次没有按 zoom 重建 State slot，也没有新增均匀网格铺点。
- C++ 使用当前 viewport 四角的 unwrapped Web Mercator AABB，水平和垂直各扩展 15%，再与 canonical Field bounds 取交集，作为稳定相机时的 `respawnBounds`。
- shader 保留 `u_field_bounds` 作为唯一 Field 采样/UV 映射范围；新增独立 `u_respawn_bounds` 和 `viewportDensityActive`（`u_field_scale.z`），防止把可视范围误作数据有效范围。
- camera moving 期间 `viewportDensityActive=false`，普通 invalid/age 生命周期仍在 full Field 复生，State 不 reset、Field 不重提、Timeline 不重置。稳定至少 150ms 后才启用 viewport domain。
- stable 后，位于 expanded viewport 外的 slot 成为额外 respawn 条件；新出生 slot `age=0`、alpha=0，因此不会产生跨屏 segment。viewport 内的正常粒子不被统一重置。
- 若四角 AABB 无效、交集为空或 extent 过小，安全回退 full Field bounds；日志为 `ParticleDensity mode=FIELD_FALLBACK fallback=true`，不会产生 NaN/inverted bounds。

## 保持的边界

State A/B=Float、Trail A/B=UnsignedByte、previousPosition→currentPosition、zoom-aware visual speed、wall-time lifecycle、time-based fade 与 camera Trail invalidate/stable resume 保持。canonical U/V=m/s、WeatherV2 assets、Host Submission、Timeline、Runtime Field Window、WeatherColorLayer 与 REAL WEATHER UI 未修改。

## 验证

- shader generator：PASS。
- Linux OpenGL 精确编译 `render_particle_validation_layer.cpp`：PASS。
- 既有非 Jest `style_layer.test.cpp` 精确编译：PASS。
- `git diff --check`：PASS。
- Android Gradle/APK/ADB/设备和 Jest：未执行。

下一步由用户按人工验收 v7 检查 z2–3/z5/z8–9 密度、相机稳定后的补充行为和 Timeline boundary 回归。