feat: add QBIN2 V4 encoded field ingress
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled

This commit is contained in:
OpenAI Codex
2026-09-13 11:05:57 +08:00
parent b8a629b7b6
commit 83a84452f2
8 changed files with 180 additions and 0 deletions

View File

@@ -0,0 +1,9 @@
# STEP-074 — QBIN2 V4 Encoded Ingress 与 Decoder v1
状态:完成(Core 范围)。开始 HEAD:`b8a629b7b65067f7f561db473312484bd8f0451d`。开始工作区已有 STEP-062 文档修改及历史 untracked 文件,未清理、暂存或提交。
新增独立 `mbgl::particle::ingress::QbinV2Decoder` 和无状态 `EncodedFieldIngress`。其顺序为 QBIN structural decode、构造 `DecodedFieldFrame`、再调用既有 generic `FieldProfileValidator`;未接入 Store、Renderer、Binding、Host 或平台 bridge。
Decoder fail-closed 校验 QBV2 LE header/descriptor、保留字段、FRAME/WebMercator/node 限制、时间/边界/容量、精确 canonical packing 与零 padding、ISO-HDLC CRC(CRC 字段虚拟清零)、single shared validity、invalid-cell raw-zero,以及 per-plane local content identity。numeric payload 保持原始 bytes。
真实 CMake runner 已加入 `ParticleQbinV2Decoder`、`ParticleEncodedFieldIngress`;fixture 仅在 test 范围,涵盖 2×2 与 513×769 构造。

View File

@@ -0,0 +1,13 @@
# STEP-074 QBIN2 V4 Encoded Ingress 与 Decoder Codex 完成报告 v1
## 已完成
- 开始 HEAD:`b8a629b7b65067f7f561db473312484bd8f0451d`;最终 HEAD:待提交记录。任务开始前 dirty/untracked 文件未纳入本任务。
- 独立 ingress decoder、CRC、canonical packing、shared validity、invalid raw-zero 和 decode→contract facade。
- 新增 CMake production/test sources;新增 suites `ParticleQbinV2Decoder` 与 `ParticleEncodedFieldIngress`,共 6 tests。
- 实际重链 `mbgl-test-runner` PASS;新增 filter 实际 Running 6,failed=0;STEP-073 filter 实际 Running 11,failed=0;V3 filter 实际 Running 11,failed=0;`git diff --check` PASS。
## 未完成 / 无法验证
- 受限暂存提交与 push 尚待执行;最终 HEAD/push 结果届时记录。
- 未执行 Android/ADB/Jest/iOS/Metal;范围明确排除 URL/HTTP/gzip/Host/JNI/RN/Renderer/Binding。