MapLibreParticleLab/docs/50_Step记录/STEP-087_QBIN_V3解码与13.4.1-particle.9升级_v1.md

STEP-087 QBIN V3 解码与 13.4.1-particle.9 升级

状态

CLOSED / PASS

已完成

• 已将用户提供的《WeatherV2 QBIN V3 通用天气场二进制格式与 React 独立 Render Binding 设计 v2.2 最终冻结稿》保存到 docs/30_设计/，原文件内容与 SHA-256 保持一致。
• 新增独立 QbinV3Decoder，生产 Block Geometry 冻结为 16×16。
• EncodedFieldIngress 改为 QBV2 / QBV3 显式 magic 分流；QBV2 兼容链保留。
• RasterArraySource::submitEncodedField() 改为统一走 EncodedFieldIngress::decodeAndValidate()。
• CMake / Bazel Core 已注册 V3 decoder；CMake test 已注册 V3 decoder tests。
• 新增 8 个 Current / Rain / Wave / Wind QBIN V3 Golden Fixtures、manifest 与中文校验脚本。
• 新增 C++ 定向测试，覆盖 block boundary、Direction wrap、all-invalid、非最优 Rice-K、CRC/descriptor/validity corruption、Rice padding、残差越界、Node grid 与 ingress 分流。
• Mac clang 定向构建并运行 8 个 V3 tests：8/8 PASS。
• Native / RN 版本声明已统一升级到 13.4.1-particle.9。

Block Geometry

真实 8 帧 benchmark：16×16 数值 payload 为 2,470,419 bytes；32×32 为 2,514,288 bytes，32×32 增加约 1.7758%。32×32 的 decode 总时间仅减少约 2.67 ms / 8 帧，因此最终冻结 16×16。详见 docs/30_设计/MapLibreParticle_QBIN_V3_Decoder与BlockGeometry实施决策_v1.md。

最终验证与发布

• verify-qbin-v3-golden-fixtures.py：PASS（8 files，block=16×16）。
• QBIN V3 C++ 定向 tests：PASS 8 / FAIL 0。
• Android Release 四 ABI：armeabi-v7a、arm64-v8a、x86、x86_64 全部构建通过。
• iOS Metal MapLibre.dynamic：PASS；device-arm64 XCFramework 已生成并发布。
• RN tgz：已生成并发布。
• Android Maven / RN tgz / iOS XCFramework 公网 readback：PASS。
• SwiftPM 6.28.0-particle.9：已发布。
• Release tag：maplibre-particle/rn/13.4.1-particle.9。
• Release Final HEAD：63047540cba703c8efeae0df71e759e165315f85。
• Android APK / ADB 仍按项目规则由用户手工执行，不属于本次自动发布门槛。