feat(net/udp): UDP 数据面并入 netMsgQueue 串行执行（#73）

前置来自 #57 SNTP 调研：旧 net_sendto / net_recvfrom 由调用方直调
SPI 且无限自旋收包，既违约「netTask 是芯片唯一访问者」，又把 IWDG
预算吃在自旋里。

改造面
- 新增 Drivers/BSP/NET/net_udp.c/.h（真机专属，模拟器不编译）：
  bind/set_peer/sendto/recvfrom 四条执行体 + 挂起收包表 + tick；
  net_msg_type_t 加四型，公开 API 一律「入队 → 睡在通知上」。
- 源地址出参不搭 net_msg_t（按值拷贝，AGENTS 禁加回传字段）：改住
  net_udp.c 的 per-fd 槽，netTask 就地写回调用方内存，通知值只带
  结果码；每条出口都清槽，泄漏 = 该 fd 永久 BUSY。
- 发送复用 net_send_locked，不写第二份分块逻辑；「会话是否已死」
  收成一条判据 net_send_state_down()（TCP 看 ESTABLISHED、UDP 看
  UDP_OPEN），原先 4 处各写一遍。
- 顺带修掉真缺陷（新条 TRAP-NET-22）：旧 sendto 把 DesIP 写成具体
  IP，芯片静默切 UDP Client，而旧 recvfrom 无条件剥 8 字节 → SNTP
  这类 48 B 应答丢载荷前 8 字节并交出垃圾源地址。加 udp_mode（塞进
  原有 padding，sizeof 不变）、bind 恒 SERVER、显式对端 sendto 切
  CLIENT、set_peer(fd, NULL) 轻量回 SERVER，仅 SERVER 且 avail >= 8
  才剥头。
- 截断定案：一次调用交付一个数据报，buf 装不下的尾巴用 64 B 栈上
  scratch 排空（不用 clear_recv_buf——它连后面已到达的包一起丢）。
- 取消点接齐：net_init 重建 cancel_all、net_socket 分配 fd clear、
  net_close settle_close + clear、重 bind 前先结算等包者，
  net_process_messages 第 5 个 tick 位挂 net_udp_tick。
- 收紧两处契约（原实现无生产调用者）：UDP 未 bind 一律 -5；
  net_recv / _nb / _to 拒 DGRAM（绕过剥头就是静默吃 8 字节）；
  NET_ERR_NOT_IN_NETTASK(-12) 退役为历史常量并写明原因。

验证
- 主机单测 test/host/net_socket 全套 616/616 绿（改造前 470）：新
  分片 ns_s7_udp.c 20 组，改写 440 / 555 / 560 组；覆盖率
  net_udp.c 234/236（99.2%）、net_socket.c 956/969（98.7%），
  scripts/test_coverage_baseline.json 随本提交登记新文件。
- 测试抓到 4 个被测码真 bug：自等守卫误用调用侧谓词、芯片长度被读
  两次、槽指针取在 fd 合法性检查之前、重 bind 静默作废等待者。
- Keil ARMCC 0 Error(s) 0 Warning(s)；net_udp.o Code 1,358 / ZI 224
  （8 fd × 28 B，其余模块零增长），全仓 RW_IRAM1 72.2%；内存台账
  受管区按门禁提示用 --write / --update 机器回填，未手改数字。
- pre-commit 全量钩子（含 doc-links、coding-standard、mem-budget、
  generated-fresh、bsp-err、registration、nested-comment）全绿。

限度
- 本轮无板子：真机回归 5 条（两端互通、set_peer(NULL) 能否恢复收
  广播、截断排空后下一包完整性、挂起 recv 期间 IWDG 余量、bind 写
  DesIP 与 open 先后的真芯片效果）已写进覆盖率口径「台架必验」。
- scripts/stack_report.py 退出码 1 是 10-26 起挂在账上的 iec104Task
  栈债（margin 1,016 < 1,024，见 docs/代码规范/pre-commit使用说明.md:
  122）；本轮只让 net_bind 的 UDP 分支多一层静态帧（1,544 → 1,600），
  netTask margin 1,888 与 timeSyncTask 1,152 不受影响。抬栈要过
  mem-budget 台账，不在本分支自行处理。
- 登记簿销项按仓库约定留给主工作树，本分支不动 docs/任务规划/**。

test/host/common/ch395f_fake.h

@@ -67,6 +67,9 @@
 #define CH395F_FAKE_QUEUE_LEN     24
 #define CH395F_FAKE_LOG_LEN       96
 #define CH395F_FAKE_GLOB_QUEUE    24
+/* 写内容捕获容量（测试自用，真实头无此宏 → 不参与假芯片常量对齐门）：
+ * 256 够覆盖"一个小数据报全文"与"分块发送首块的前 256 字节"两类断言。 */
+#define CH395F_FAKE_WRITE_CAP     256
 
 /* ===== 扩展区（2026-10-24，net_socket 主机单测批次；**纯新增**，上面既有宏/字段/函数
  *       一字未动，net_listener / net_events / net_pending 三套的语义不受影响）=====
@@ -266,6 +269,20 @@ typedef struct {
      * 就还会再报一次。net_socket.c 的多块发送要的就是这个稳态，没有它就只能
      * 造"写完一块就再也等不到空闲"的假死形态。 */
     uint8_t  sint_sticky[CH395F_FAKE_SOCK_MAX];
+    /* —— 2026-11-03 UDP 队列化改造追加（默认全 0 → 既有行为逐字不变）—— */
+    /* GET_RECV_BUF 的**流式读**开关：UDP 一个数据报 = 8 字节信息头 + 载荷，
+     * 生产代码是**两次**读（先剥头再读载荷），而 set_recv_bytes 每次都从预置
+     * 内容第 0 字节交付——那样"剥掉头"与"把包头当载荷"在断言里长得一样。
+     * 本开关让交付内容带游标：第二次读拿到的是第 8 字节往后的载荷。 */
+    uint8_t  recv_stream_en;
+    uint16_t recv_pos;                 /* 游标：已交付字节数（截断排空要断言它） */
+    /* WRITE_SEND_BUF 的**内容捕获**开关：假芯片原本忽略 p_data（既有用例只数次数），
+     * 但 UDP 发送要钉"写进芯片的是不是调用方那份字节、分块边界对不对"。
+     * 默认 0 → 既有"内容不可断言"的行为一字不变。 */
+    uint8_t  write_cap_en;
+    uint8_t  write_cap[CH395F_FAKE_WRITE_CAP];   /* 按写入顺序拼接的字节（够 2 块 1KB 的前 256B） */
+    uint16_t write_cap_n;              /* 已捕获字节数（超出容量后只计数不存） */
+    uint32_t write_bytes;              /* 芯片收到的总字节数（含未捕获部分） */
 } ch395f_fake_ext_t;
 
 typedef struct {
@@ -310,6 +327,12 @@ void ch395f_fake_push_glob(uint16_t v);   /* 预置全局中断返回序列 */
 void ch395f_fake_set_sint_sticky(uint8_t sock, uint8_t mask);
 /* 预置 GET_RECV_BUF 交付的字节（n=0 撤销预置）；p 可为 NULL（表示填 n 个 0xA5） */
 void ch395f_fake_set_recv_bytes(const uint8_t *p, uint16_t n);
+/* 同上并**开启流式读**（游标归零）：UDP 用例要的是"头 8 字节 + 载荷"两次读
+ * 各自拿到正确片段，而不是每次都从第 0 字节重交。 */
+void ch395f_fake_set_recv_stream(const uint8_t *p, uint16_t n);
+/* 开启 WRITE_SEND_BUF 内容捕获（g_fx.write_cap / write_cap_n / write_bytes）：
+ * 默认关 → 既有"内容不可断言"的行为一字不变。 */
+void ch395f_fake_enable_write_capture(void);
 /* 顺序断言辅助：清空调用日志 / 找某个短名第一次出现的位置（-1=没调过）。
  * 刻意提供"清零日志"，否则一次长轮询（如 sock_reset 的几十轮 'x'）会把 96 格
  * 环形外的顺序信息挤掉，让后续场景的顺序断言失真。 */