MapLibreParticleLab/docs/报告/STEP-074_QBIN2_V4_EncodedIngress与Decoder_Codex完成报告_v4.md

STEP-074 — QBIN2 V4 Encoded Ingress 与 Decoder Codex 完成报告 v4

日期：2026-09-13

结果

已完成：只更新 test/particle/qbin_v2_decoder.test.cpp 中的 AcceptsRawLimitWithCanonicalPaddingExcluded fixture。新的 1101×1890、17-plane canonical QBIN 的数值为：

• rawSum：33,554,352 bytes。
• 32 MiB limit：33,554,432 bytes。
• payloadLength：33,554,448 bytes。
• totalQbinBytes：33,555,104 bytes。

测试直接断言 rawSum <= limit、payloadLength > limit、payloadLength > rawSum 与 totalQbinBytes <= 64 MiB，并调用 production QbinV2Decoder::decode(...)，结果 Accepted。

逐项状态

• 已完成：边界构造覆盖 canonical padding 将 payload 推过 32 MiB，而 decoded raw sum 未越界。
• 已完成：cells=2,080,890（不超过 2,097,152），planes=17（不超过 32），single shared validity、descriptor 合法与 canonical packing 均成立。
• 已完成：真实重建 mbgl-test-runner；Decoder/Ingress Running 24、Runtime/Profile Running 11、Source 回归 Running 11，均 PASS、零失败。
• 已完成：git diff --check PASS。
• 未完成：无。
• 无法验证：Android Gradle/APK/ADB/Jest、iOS/Metal；本任务明确禁止执行，且本轮未涉及这些路径。

范围审计

未修改 production Decoder，未触及 Host、网络、JNI、RN、Binding/Projection、Renderer 或 Store submission。已有 STEP-062 修改及历史 untracked/build 文件原样保留。

Git

• 首个 scoped commit：3274c11a6618a071792fd056680276b9f9868622（test: finalize STEP-074 QBIN2 padding boundary）。
• 首次 push：成功，origin/particle/main 已从 f4a495ff3 前进至 3274c11a6。
• Final HEAD（完成报告记录提交）：bba99f8acfecdfc44e8484785c7a543da173e5b1（docs: record STEP-074 delivery）。
• 最终 push：成功，origin/particle/main 与上述 HEAD 一致；本报告之外未暂存既有 STEP-062 修改、任务书或其他 untracked 文件。