固件：A12 命令处理器 + A13 USB 分帧 + A14 WiFi/MQTT（含 C1 配网）

- A12 单一命令处理器（cmd*.c）：一行 JSON 进出、seq 全局判重（32 条按值）、
  限幅 / 空槽一律拒 / 拒绝记事件；命令号与错误码冻结（进 flash）。新增 power 命令，
  fan 改为只抬不压的下限（t_thermal_set_floor）。rail_set_mv 注明不拿锁，调用方包 xact。
- A13 USB-Serial-JTAG 分帧（ulink*.c）：@C / @R 前缀 + CRC-16，日志行首 @ 垫空格，
  任意切块可切；关掉 USB 副控制台（它绕开驱动写 FIFO）。PC 端客户端 tools/prlink.py。
- A14 + C1（netcfg / mlink / cmd_net）：topic phonerail/<mac>/{cmd,rsp,tele,state}，
  mqtts（evse-ca 编进固件）、1 s 遥测、遗嘱离线；wifi / mqtt 配置只收 USB、存 NVS，
  net 永不回显密码。
- 协议定稿写进需求文档 §10.8（A12 / A13 / A14 三节）；N7 撤销改 D7（机架管理前后端）。

宿主机 23 个 ctest / 400 例全绿；板 B 已烧 0.1.0-a14，经 WiFi → 公网 → 8883 TLS 真连网验过。
固件 0xE2220 / 1 MB 分区只剩 12%，C2 前要重排分区表。

Co-Authored-By: Claude Opus 5.5 <[email protected]>

firmware/main/cmd_priv.h

@@ -0,0 +1,41 @@
+/* cmd.c / cmd_exec.c / cmd_report.c 之间的内部接口。别处不许 include。 */
+#ifndef CMD_PRIV_H
+#define CMD_PRIV_H
+
+#include "cmd.h"
+#include "cmd_json.h"
+
+/* 一条命令的上下文。 */
+typedef struct {
+    const cj_obj_t *o;
+    cmd_link_t      link;
+    cj_writer_t    *w;    /* 成功时的附加字段写这里（以逗号开头） */
+    int             rail; /* 已校验过的路号；0 = 还没有 / 整板命令 */
+    int64_t         bad;  /* 被拒时「越界的那个值」，进事件的 bus_mv */
+} ctx_t;
+
+/* 两份快照的位置（cmd_init 给的）。 */
+const cmd_env_t *cmd_env(void);
+
+/* cmd_exec.c：六条会动东西的命令 + 风扇下限。返回 CMD_OK 时可能往 c->w 写了附加字段；
+   被拒时把越界的那个值留在 c->bad（进事件的 bus_mv）。 */
+cmd_err_t do_set_voltage(ctx_t *c);
+cmd_err_t do_power_cycle(ctx_t *c);
+cmd_err_t do_key(ctx_t *c);
+cmd_err_t do_edl(ctx_t *c);
+cmd_err_t do_vbus(ctx_t *c);
+cmd_err_t do_power(ctx_t *c);
+cmd_err_t do_fan(ctx_t *c);
+
+/* cmd_net.c：网络配置（只收 USB）与网络状态。 */
+cmd_err_t do_wifi(ctx_t *c);
+cmd_err_t do_mqtt(ctx_t *c);
+cmd_err_t do_net(ctx_t *c);
+
+/* status 的正文（不含外层的 `{"seq":..,"ok":true` 与结尾 `}`，以逗号开头）。 */
+void cmd_report_status(cj_writer_t *w, const cmd_env_t *env);
+
+/* events 的正文。先把 RAM 里的事件落盘（`evlog_read()` 只服务已落盘的部分）。 */
+void cmd_report_events(cj_writer_t *w, uint32_t from_seq);
+
+#endif /* CMD_PRIV_H */