MapLibreParticleLab/docs/50_Step记录/STEP-065_MapLibreParticleLab_V3通用ScalarVectorField架构冻结_v1.md

STEP-065 MapLibreParticleLab V3 通用 Scalar / Vector Field 架构冻结

状态：冻结

目标与基线

在 2e3ab262 对当前真实实现做只读调查，冻结 V3.0 generic Scalar/Vector Contract 和迁移路线；不实现。开始与结束均为 particle/main，开始时 HEAD == origin/particle/main == 2e3ab262。

必做项结果

• 读取全部规范、STEP-064 基线，复核 branch/HEAD/origin/dirty worktree。
• 调查 descriptor/snapshot/adapter、WIND/GLOBAL、Timeline/MIX/window reuse、WeatherColor speedMps、Particle velocity m/s、RN→Android→JNI→Core。
• 只读核对 WeatherV2 Wind/Tide/Rain/Wave NSFT 语义。
• 冻结 0/1 scalar + 0/1 vector + shared validity、FieldValueSource、VectorSemantics、独立 plane file refs。
• 冻结 maplibre-particle-field/v2、v1 thin normalize compatibility、分批路线和单次 Android 综合验收。
• 生成调查、设计、Step、报告并追加开发记录。
• 确认未修改生产代码、WeatherV2、NavSea、STEP-062 或历史无关 untracked 文件。

允许/禁止与验证

仅新增/更新任务指定文档；不改 C++、shader、JNI、Android、RN API 或 fixture，不生成 AAR/tgz。未执行 Android Gradle、APK、ADB、Jest，原因是任务明确禁止。执行只读代码/文本审计与 git diff --check/精确 staged 文件审计；不宣称构建或设备 PASS。

当前结果与下一步

详见调查及设计文档。下一任务建议：STEP-066 V3-02 Core Contract + Scalar Snapshot/Adapter，只实现 v2/v1 normalize 与 Core fixture/验证，先不进入 GPU 或 Android。未解决风险：v2 具体 Kotlin/JNI ABI 形态、plane 总内存预算、direction 视觉 scale 默认值须在实施前用目标设备约束量化。