# M06-C 协议适配器和消息幂等

- 日期：2026-06-22
- 起始 commit：`c96045f`
- 工程 commit：`e795cdb`
- ENGINEERING_DELTA=YES
- 子阶段状态：DONE（可独立工程范围）；PDF 原件复核为外部阻塞

## 工程增量

- 实现 `MqttTransport`、`JilianControlBoxAdapter`、`JilianSub1GLockAdapter`、`JilianSmartSocketAdapter`。
- 严格保留 `ConctolPower`、`Crldoor`、`CrlLED`、`PlayTTS`、`CtrlDevice` 等厂商拼写。
- Zod 校验控制箱读取/控电/门锁/TTS/LED/任务、Sub-1G 配对控制、插座读取/开关/本地任务。
- 建立 13 位命令 ID、命令持久化、发布状态、ACK/失败/超时状态推进。
- MQTT 消费校验 Topic、DeviceID 和 JSON；原始/标准化 payload 分开保存。
- QoS 1 重复消息只增加接收次数，不重复推进命令或设备状态。
- 非法 Topic、未知设备、非法 JSON/字段进入可去重死信表，消费循环不崩溃。

## 验证

- Windows `npm test` 与 `scripts/dev/windows/test-all.ps1`：退出码 0。
- WSL MySQL 8.4.9 原生临时副本：`up → verify → down → up → verify` 通过。
- 迁移语句：up 102、verify 74、down 96。
- 实测同一 ACK 投递两次：事件行 1 条、`receive_count=2`、命令只推进一次至 `ACKED`。
- 非法 Topic 实测进入 `qipai_iot_dead_letters`。
- 工程 commit 已 push，`HEAD == origin/main == e795cdb6935568611a5d27d78991bf9e7ee2f7df`。

## 资料边界

当前工作区与现有压缩包未找到 V5.4 点名的两份协议 PDF。实现依据为 V5.4 已固化的协议章节；PDF 页码级复核登记为 `ISSUE-013/BLOCKED_EXTERNAL`。

## 后续

执行游标进入 M06-D：控制箱和门锁业务能力。