Files
MapLibreParticleLab/docs/报告/STEP-074_QBIN2_V4_EncodedIngress与Decoder_Codex完成报告_v2.md
OpenAI Codex 56b8dab90f
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
fix: close STEP-074 QBIN2 decoder audit
2026-09-13 11:26:13 +08:00

2.0 KiB
Raw Permalink Blame History

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

已完成

  • 开始 HEAD:83a84452f23d019cbb143630eac04631552fef89;任务前已有 dirty/untracked 未纳入。
  • production 问题 A:identity 按 raw payload 与 descriptor 的固定 Little Endian canonical bytes 作 FNV;float 以 IEEE754 bits 编码,不依赖 host endian/object representation,也不含 packing offset。
  • production 问题 B:限制语义改正为 QBIN 整体 <= 64 MiB、Plane raw bytes 总和 <= 32 MiB;后者返回 LimitExceeded,文件长度错误返回 LengthMismatch。
  • production 问题 C:BITSET 仅可作为 VALIDITY,VALIDITY 必为 BITSET;accepted 前执行 frame structural self-check。
  • fixture builder 明确写 uint16/32/64、float32、float64 的 Little Endian,未成为 production writer。
  • corruption matrix、CRC、padding、枚举、时间/边界、capacity、validity 与五种 numeric dtype invalid-cell 场景均进入实际 decoder runner;identity 有固定 golden 75930fed16c969a7,四 Plane 独立性已验证。
  • 513×769 fixture 校验 U/V/validity raw byte-for-byte、canonical payload、共享 validity storage。
  • Ingress 覆盖 valid、missing/invalid Contract、missing required plane、known Core conflict、unknown opaque Scalar Contract;未写 EncodedFieldStore。

验证结果

  • Linux OpenGL mbgl-test-runner 重新构建及重链:PASS。
  • ParticleQbinV2Decoder.*:ParticleEncodedFieldIngress.*:实际 Running 18 tests,18/18 PASS(v1 为 6)。
  • STEP-073:11/11 PASS。
  • 既有 V3:11/11 PASS。
  • git diff --check:PASS。
  • 禁止范围:未执行 Android Gradle、APK、ADB、真机、Jest、iOS/Metal;未修改 Renderer、Binding、Projection、Store submission、Host、网络或平台目录。

未完成 / 无法验证

  • 无协议 Core 范围内未完成项。
  • Android/iOS 与网络链路明确不在本 Step 范围,未验证且不据此作任何声明。
  • 最终 commit HEAD 与 push 结果在 Git 收尾后补充。