refactor(NET): 源码注释去阶段化 + 网络两份文档重构 + 不稳根因图更新

- 源码注释：删去自愈收敛阶段 1/1.5/3等 scaffolding 称谓，改为语义引用（E-02 收口 / F-NET-2/3/4 / docs/网络/网络自愈架构设计.md §5.2 E13）；涉及 net_socket/.h、net_events、net_listener、net_pending、net_types、 net_config、ch395f、time_sync、iec104_serv、ui_net_sink、lftpd、 simulator/sim/net_socket_sim、board/host 测试与探针 - 文档重构：网络自愈架构设计.md 与 Net层阻塞模型架构设计.md 改为现状口径（删历史节与阶段叙事），NET/README.md、docs/README.md 同步 - 工具与配图：gen_net_instability_svg.py 与 docs/images/网络不稳根因总览.svg 随源码口径一并更新 - 门禁：@build 0 错误 0 警告
2026-10-14 22:05:53 +08:00
parent cea2b51efb
commit d770e36c7c
30 changed files with 574 additions and 682 deletions
@@ -151,8 +151,8 @@ int net_pending_active(int sockfd);
 *          ⚠ **调用方铁律**：`sent < len` 是调用侧必须保证的**前置条件**，不是本函数的
 *          兜底。`sent == len` 表示"全部字节已交付芯片、无剩余块可挂起"——此时超预算
 *          应**直接返回 sent**，不得调用本函数；本函数会按参数非法拒绝并回 -1，
- *          把一次完整发送报成失败（net_send_locked 末块等待 2026-10-14 台架实证，
- *          见《Net层阻塞模型架构设计.md》 §9.1）。
+ *          把一次完整发送报成失败（net_send_locked 末块等待即此情形，
+ *          见《Net层阻塞模型架构设计.md》 §5.5 末块边界）。
 */
 int net_send_pending_register(int sockfd, const void *buf, int len, int sent,
                              TaskHandle_t caller);