wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打

Browse Source 
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。

门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。

test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。

为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。

实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。

基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。

⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。

固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。

.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。

同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
This commit is contained in:
Wanderingss
2026-10-26 12:28:14 +08:00
parent 7635480e06
commit 0f7b5a87fb
253 changed files with 2234 additions and 4541 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Drivers/BSP/NET/net_socket.c
+33 -33
View File
@@ -141,7 +141,7 @@ int net_msg_queue_adopt(osMessageQueueId_t queue_id) {
return 0;
}
/* ================= 错误码存储（E-03 修复：按任务隔离，消除跨任务覆写竞态） =================
/* ================= 错误码存储（按任务隔离，消除跨任务覆写竞态） =================
*
* 旧实现是单个全局 `static int s_net_errno`：netTask 在处理消息时写入本层的
* 「最后错误码」，调用方包装器随后在**自己的上下文**再写一次。两条写路径分属不同
@@ -227,7 +227,7 @@ static uint32_t net_errno_slot(void) {
* 返回值：err 原值（便于写成 `return net_set_errno(NET_ERR_XXX);`）
* 限定条件：无
* 函数说明：1. 只写本任务的槽位，其他任务读不到、也改不了 → 消除跨任务覆写竞态
* 2. N-32 §10 模块化：由 static 提升为**模块间可见**（net_listener.c
* 2. 监听生命周期模块化：由 static 提升为**模块间可见**（net_listener.c
* 也需要设 errno），声明与 NET_ERR_RETURN_1 宏见 net_socket.h
*/
int net_set_errno(int err) {
@@ -332,7 +332,7 @@ static bool s_mac_is_zero(const uint8_t *p_mac) {
* 无关），且违反保留位规定 → 0x09 改 0x08（2026-10-11 定案：官方手册
* V1C/V1E/V2.2/V2.3 的 bit0 全是保留位，官方例程 bit0=0 下 Socket 0~7 照常
* 可用、FTP 例程本身就传 0x08；证据链见 TRAP-NET-15，
* 0x08 下的多 Socket 台架复测登记 N-31） */
* 0x08 下的多 Socket 台架复测登记为 Phase 7 复跑项） */
ch395f_set_fun_para(fun_para);
/* 设置 TCP MSS：维持 1024（512 裕量方案未采纳，当年支撑它的台架判据不可信，
@@ -358,7 +358,7 @@ static bool s_mac_is_zero(const uint8_t *p_mac) {
/* 设置 MAC（手册 §9.2.1 步骤①：SET_MAC 必须在 INIT_CH395 之前——SET_MAC 写芯片
* EEPROM，而 INIT_CH395 会初始化/加载 MAC；顺序反了则本次上电芯片仍用旧 MAC，
* UI 配置的 MAC 不生效（回落芯片内置/上次值），设备在线身份与 UI 显示不符。
* P1-7，2026-10-04）；NULL 或全零 = 保持芯片内置 MAC，不下发；
* 2026-10-04）；NULL 或全零 = 保持芯片内置 MAC，不下发；
* 写 EEPROM，每上电重放同值幂等 */
if (mac != NULL && s_mac_is_zero(mac) == false) {
ch395f_set_mac_addr((uint8_t *)mac);
@@ -572,7 +572,7 @@ int net_poll(void) {
for (int i = 0; i < NET_MAX_SOCKETS; i++) {
if (s_net_socks[i].in_use != 0U) {
(void)ch395f_get_sock_state((uint8_t)i);
/* E-02 收口：驱动 sock_reset 状态机在 net_poll 步进
/* 驱动 sock_reset 状态机在 net_poll 步进
* （驱动头注释契约"在 net_poll 或测试循环里周期调用"）。IDLE 槽位
* 纯 RAM 判返回 0 无 SPI；仅活跃复位机做短 SPI。作用：同步包装
* （net_sock_reset_sync）600ms 放弃后复位机不搁浅，芯片条件满足
@@ -663,7 +663,7 @@ void net_process_messages(void) {
net_send_pending_tick(s_net_socks);
/* TRAP-NET-17 状态对账 + 监听重建合一（单一 100ms tick）：
* 判据读驱动缓存（net_poll 每轮全量刷新），①②⑤ 失同步 + ③④ 重建 +
* U11 重同步全部在此（本层唯一周期重建入口，N-32 P2 单一所有者） */
* U11 重同步全部在此（本层唯一周期重建入口，监听生命周期 P2 单一所有者） */
net_reconcile_tick();
/* 队列排空：超时 0 非阻塞取，每条处理一轮，直到本轮队列为空 */
@@ -758,8 +758,8 @@ void net_process_messages(void) {
break;
}
case NET_MSG_DROP_CONN: {
/* E-02 收口：应用放弃会话的主动拆除（拆连接、保监听）。监听型
* 登记即返（N-17：拆链排渣交 net_listener_tick，本消息不再占用
/* 应用放弃会话的主动拆除（拆连接、保监听）。监听型
* 登记即返（探针窗口心跳缺口修复：拆链排渣交 net_listener_tick，本消息不再占用
* netTask 数百 ms） */
net_sock_t *p_sock = net_get_sock(msg.sockfd);
if (p_sock == NULL) {
@@ -813,7 +813,7 @@ void net_process_messages(void) {
uint32_t notify_val = (uint32_t)msg.result;
/* 失败：回传本条消息**自身**的精确错误码（NET_ERR_WOULDBLOCK 等）。
* E-03 后取的是 netTask 自己的错误码槽位——锁定实现（*_locked）在
* 取的是 netTask 自己的错误码槽位——锁定实现（*_locked）在
* 失败返回前记录的码，不受其他任务影响；未置位时回退通用 NET_ERR。 */
if (msg.result < 0) {
int te = s_net_errno_slots[net_errno_slot()].err;
@@ -909,7 +909,7 @@ int net_socket(int domain, int type) {
p_sock->blocking = 1;
/* 新 fd 不得继承上一条连接的释放原因（TRAP-NET-18 待办 #3） */
p_sock->released_abnormal = 0;
/* N-32（P1）：新 fd 不得继承"上一条会话已结束"电平（否则新建即 EOF，
/* 监听生命周期 P1：新 fd 不得继承"上一条会话已结束"电平（否则新建即 EOF，
* 消费侧连数据都收不到）——与 released_abnormal 同理，显式清零 */
p_sock->session_dead = 0;
/* 新 fd 不得继承上一次的待重试状态（D10） */
@@ -1165,7 +1165,7 @@ int net_listen_locked(int sockfd) {
p_sock->state = NET_SOCK_STATE_LISTENING;
/* 单连接模式：连接断开后由 net 层自动回到 LISTEN（模拟 BSD 监听常驻） */
p_sock->auto_relisten = 1;
/* N-30（TRAP-NET-20）：新监听会话，事件未收到去抖计数清零 */
/* TRAP-NET-20：新监听会话，事件未收到去抖计数清零 */
p_sock->lost_conn_seen = 0U;
/* 监听建立完成 */
@@ -1232,7 +1232,7 @@ int net_listen(int sockfd) {
* 限定条件：Socket 处于 LISTENING 状态
* 函数说明：单连接：监听 Socket 自身在 CONNECT 后已转为 ESTABLISHED
*/
/* ===== N-30 accept 路径"CONNECT 事件未收到补 accept"（2026-10-11 台架实证；
/* ===== TRAP-NET-20 accept 路径"CONNECT 事件未收到补 accept"（2026-10-11 台架实证；
* E14 复核 2026-10-14：事件非芯片侧丢失，是被读清消费——机制不变）=====
* 台架结论（剥离 OS/net/FTP 直接对芯片做受控 close→open→listen→connect 矩阵）：
* 芯片关闭连接后的拆链收尾窗口**变长且不可见**（状态寄存器显示 CLOSED 也不代表
@@ -1274,7 +1274,7 @@ static int net_accept_locked(int sockfd, struct net_sockaddr *addr, int *addrlen
/* 先轮询一次：把状态机刷新到芯片侧最新状态 */
net_poll();
/* N-30（TRAP-NET-20）：监听等待期兼做芯片状态第二信源——CONNECT 事件未收到时
/* TRAP-NET-20：监听等待期兼做芯片状态第二信源——CONNECT 事件未收到时
* 去抖补 accept（台架实证：拆链窗口事件未收到是数据被吞/425 的主根因，
* E14 复核：事件非芯片丢失、被读清消费吞掉；纯事件等待无自愈可能；
* 详见 net_lost_connect_probe 区块注释） */
@@ -1286,13 +1286,13 @@ static int net_accept_locked(int sockfd, struct net_sockaddr *addr, int *addrlen
* （含上一步探针补 accept 的命中）；其余失同步由 net_reconcile_tick()
* 周期对账（带去抖）兜底 */
if (p_listen_sock->state != NET_SOCK_STATE_ESTABLISHED) {
/* N-30（2026-10-11 手册 §5.23⑤ + 生产时间线定案）：
/* TRAP-NET-20（2026-10-11 手册 §5.23⑤ + 生产时间线定案）：
* "closed-but-readable" 接受——STOR 类传输客户端**发完数据立即关数据连接**
* （正常 FTP 行为，Python ftplib sendall 后即 close），芯片按
* FUN_PARA **bit3 SOCKET_CLOSE=1**（`0x08`，§5.52 ②）规格保留 Socket 与 RX 缓冲供 MCU 排空
* （实测 DISCONNECT 后 st=0x05/0x00、recv_len=1027=完整载荷）。
* 若 accept 轮询晚于对端 FIN，盲目 relisten（close+open 清缓冲）会把
* 已到达的数据销毁 → 425（此前 N-30"425/被吞"的主根因，并非芯片杀连接）。
* 已到达的数据销毁 → 425（此前 TRAP-NET-20"425/被吞"的主根因，并非芯片杀连接）。
* 处置：芯片 RX 缓冲有数据 → 接受这条"已关但可读"连接，应用经
* net_recv_locked 快路径（无状态门槛）排空，排空后 EOF 自然触发 relisten。 */
int drain_pending = 0;
@@ -1303,7 +1303,7 @@ static int net_accept_locked(int sockfd, struct net_sockaddr *addr, int *addrlen
} else {
/* 连接已断开（CLOSED）且无残留数据：登记重建请求，下一次 accept
* 即可等待新连接（BSD 风格监听常驻）。
* N-32 P2 修正：**保留本处即时登记** —— 它由消费者调 accept 触发
* 监听生命周期 P2 修正：**保留本处即时登记** —— 它由消费者调 accept 触发
* （消费者正在等新连接），不是周期性抢先；删掉会把 CLOSED 窗口
* 拉长、导致调用方高频空转 accept（实测 [WD] task stall）。
* 单一所有者收口后：动作发生在下一轮 net_listener_tick（≤1ms），非阻塞 */
@@ -1446,7 +1446,7 @@ int net_listener_armed(int sockfd) {
return 1;
}
/* 断连待重建态：**仅当芯片 RX 可能仍有残留数据**时放行，让
* net_accept_locked 的 "closed-but-readable" 接受（N-30，对端"发完即 FIN"）
* net_accept_locked 的 "closed-but-readable" 接受（TRAP-NET-20，对端"发完即 FIN"）
* 仍能拿到该连接。
* ⚠ 无残留时必须返回 0 —— 否则调用方会在整个 CLOSED 窗口内每轮都发起
* net_accept（RPC：入队 + xTaskNotifyWait 回执**无上界**）→ 队列积压 →
@@ -1694,11 +1694,11 @@ static int net_connect_locked(int sockfd, const struct net_sockaddr *addr, int a
* 交给 CONNECT/TIM_OUT 裁定，不得当成失败（否则慢芯片会被误杀）。
* 其余非 SUCCESS 均为明确的命令级失败（VAL/ARG/USE/OPEN/IF/MEM/BUF/RTE…）：
* 此前返回值被直接丢弃 → 本层停在 CONNECTING 干等 recv 30 s 超时才暴露
* （2026-10-12 审计 B2）。按 §9.2.2 ⑧"再次连接需从 ⑤ 重开"回滚。 */
* （2026-10-12 审计）。按 §9.2.2 ⑧"再次连接需从 ⑤ 重开"回滚。 */
if ((status != CH395F_ERR_SUCCESS) && (status != CH395F_ERR_BUSY)) {
DBG_ERROR("[CONN] sock%d TCP_CONNECT rejected by chip: 0x%02X", sockfd, status);
(void)ch395f_close_socket((uint8_t)sockfd);
/* N-32（P1 不变量 I）：命令级失败同样是"本会话已结束"——此前这里只置
/* 监听生命周期 P1 不变量 I：命令级失败同样是"本会话已结束"——此前这里只置
* CLOSED，而 CONNECTING 态从未置 session_dead，挂起的 recv 只能干等
* deadline（B2 审计发现的"停在 CONNECTING 干等 30s 超时才暴露"同源） */
p_sock->session_dead = 1U;
@@ -1891,7 +1891,7 @@ static int net_send_locked(net_sock_t *p_sock, const void *buf, int len,
* 函数说明：1. 数据已在（快速路径）→ 立即读出返回
* 2. 非阻塞（NET_MSG_DONTWAIT 单次覆盖 **或** socket blocking 属性为 0，
* 模式属性）无数据立即返回 -1（NET_ERR_WOULDBLOCK）
* 3. 无数据 + 阻塞等待 → 登记挂起请求（pending 化，E-02 结构演进）
* 3. 无数据 + 阻塞等待 → 登记挂起请求（pending 化，结构演进）
* 4. netTask 零占用立即返回；完成条件（数据/到点[仅显式预算]/断连）由 net_pending_tick 按主循环节拍检查
* 5. 并通知 caller；关闭/网络重建/陈旧重同步由对应路径显式结束（取消必通知）
* 6. CLOSED 状态语义（排空 + EOF + 自动重监听）逐项保留在 tick 内
@@ -1936,7 +1936,7 @@ static int net_recv_locked(net_sock_t *p_sock, void *buf, int len, int flags,
/* 非阻塞且当前无数据：若连接已断开则视为 EOF(0) 并自动重监听，
* 否则返回 WOULDBLOCK(-1) 表示暂时无数据 */
/* 连接已断开（CLOSED）**或**本会话已结束（session_dead）：按 EOF 处理。
* 判据从纯 `state == CLOSED` 放宽为 `|| session_dead`（N-32 P1 不变量 I）：
* 判据从纯 `state == CLOSED` 放宽为 `|| session_dead`（监听生命周期 P1 不变量 I）：
* 抢先 relisten 后 state 已是 LISTENING 而会话确实已结束，旧判据在此
* 恒返 WOULDBLOCK → EOF 永久失踪（新连接被旧会话静默吸收）。
* 有数据时走上方快路径（recv_len>0 优先），本判据只在"无数据"时生效，
@@ -1948,7 +1948,7 @@ static int net_recv_locked(net_sock_t *p_sock, void *buf, int len, int flags,
* ch395f_close_socket → 把正听着新 SYN 的 Socket 当场关掉"（U12 同源
* 事故）。这是**执行侧安全不变量**，不该由每个登记点各自复述——
* 漏一处即事故；收口后 tick 另加"芯片已在听即了结"，结构上不可能再犯。
* N-32 P2 修正（2026-10-12 台架实证）：**保留本处即时登记**——
* 监听生命周期 P2 修正（2026-10-12 台架实证）：**保留本处即时登记**——
* 它是"消费者动作触发"（消费者正在等这条连接的结局），不是周期性
* "抢先"；删掉它会把 CLOSED 窗口从 ~0 拉长到 reconciler 周期+隔离期
* （~100ms），期间调用方高频发起 net_accept（RPC 无上界）→
@@ -2020,7 +2020,7 @@ static int net_close_locked(net_sock_t *p_sock) {
}
/* 清零控制块（memset 0 = 释放本 fd 全部状态） */
/* N-30（TRAP-NET-20）：幽灵甄别基准跨 fd 释放保留（幽灵属芯片 Socket 级状态，
/* TRAP-NET-20：幽灵甄别基准跨 fd 释放保留（幽灵属芯片 Socket 级状态，
* 与 fd 复用无关——close 后新 listen 落在同一芯片 Socket 上仍可能撞幽灵） */
uint16_t keep_peer = p_sock->remote_port;
memset(p_sock, 0, sizeof(net_sock_t));
@@ -2042,11 +2042,11 @@ static int net_close_locked(net_sock_t *p_sock) {
* 出口参数：无
* 返回值：0 - 拆除完成（监听型 fd 已重监听或交 D10） int
* 限定条件：netTask 上下文；p_sock 在用且为 TCP 流
* 函数说明：1. E-02 收口（《网络自愈架构设计》§5.2 E13）：应用放弃的会话若 TCP 仍活
* 函数说明：1.（《网络自愈架构设计》§5.2 E13）：应用放弃的会话若 TCP 仍活
* （PC 内核自动 ACK keepalive，僵尸判不死），单连接监听被永久
* 占住；应用又不得 net_close 监听 fd（毁监听）——本函数补上
* "拆连接不拆监听"的应用侧形态
* 2. 芯片侧拆除（TRAP-NET-18 异常释放语义，N-17 收口改异步）：监听型 fd
* 2. 芯片侧拆除（TRAP-NET-18 异常释放语义，探针窗口心跳缺口收口改异步）：监听型 fd
* = net_listener_settle(QUARANTINE) + REQ_DROP 登记即返，动作全部交
* net_listener_tick（隔离窗内持续排空/关闭正是该机的既有语义）；
* 非监听 client fd = 同步 sock_reset QUARANTINE（600ms 封顶，原形态）
@@ -2064,7 +2064,7 @@ static int net_drop_conn_locked(net_sock_t *p_sock) {
* 在本函数体内**没有任何机器表达**，而函数体是无条件的：置 CLOSED、清
* readable、给监听型 fd 登记重建。也就是说——将来任何新增路径绕过
* NET_MSG_DROP_CONN 的分派门直接调它，就会把一个**健康监听器**当会话拆掉
* （症状是端口偶发不再 accept，与 N-30 一族同源难查）。断言把这条"进来时
* （症状是端口偶发不再 accept，与 TRAP-NET-20 一族同源难查）。断言把这条"进来时
* 必须处于活动会话态"钉成机器可查的不变量，正是"不该发生"而不是"外部输入"。
* ⚠ 分派处（case NET_MSG_DROP_CONN）的三条错误返回原样保留——它们负责真机
* 上把误用变成 -1，本断言负责在测试构建里把误用**当场喊出来**。
@@ -2091,7 +2091,7 @@ static int net_drop_conn_locked(net_sock_t *p_sock) {
* FIN 5/5 的通过版本）。旧形态在本处理器里 net_sock_reset_sync 同步等待，
* netTask 被占用 400ms 底/600ms 顶：串行总线整窗停摆、UI/FTP/对时的 API 回
* 执顺延、NET 与对时位同窗丢 100ms 抽样 → 800ms 停喂声明 stall，距 IWDG
* 最坏超时余量仅 ~0.7s（登记簿 N-17；方向评估与否决论证 → 《网络自愈架构
* 最坏超时余量仅 ~0.7s（探针窗口心跳缺口；方向评估与否决论证 → 《网络自愈架构
* 设计》§4.6）。返回语义随之明确：返回 = 已登记，芯片未必已拆完。
* 非监听 client fd：无监听可保，维持同步确定性排渣（600ms 封顶；全仓
* 零生产调用者，形态原样保留防漂移）。 */
@@ -2105,7 +2105,7 @@ static int net_drop_conn_locked(net_sock_t *p_sock) {
/* 会话簿记收口（保留 fd：不 memset、不动 local_port/auto_relisten） */
p_sock->state = NET_SOCK_STATE_CLOSED;
p_sock->readable = 0U;
/* N-30（TRAP-NET-20）：新会话起点，事件未收到去抖计数清零 */
/* TRAP-NET-20：新会话起点，事件未收到去抖计数清零 */
p_sock->lost_conn_seen = 0U;
if (p_sock->auto_relisten) {
@@ -2293,7 +2293,7 @@ int net_recv_nb(int sockfd, void *buf, int len) {
* 出口参数：无
* 返回值：>0 字节数；0 = 对端关闭(EOF)；-1 = 真错误（errno 可查）；**-2 = 超时无数据**
* 限定条件：非 netTask 上下文；net 层已初始化
* 函数说明：1. E-02 修复配套接口：lftpd 等"等对端下一行/下一块数据"的调用方
* 函数说明：1. 修复配套接口：lftpd 等"等对端下一行/下一块数据"的调用方
* 若无限阻塞 recv，会把 netTask（全部 socket 操作的唯一执行者）长期占住
* 2. 导致其余任务的网络操作整体冻结（M3 实测一次空闲 FTP 登录冻结远端显示 17.7s）
* 3. 用本接口把等待切成 ≤timeout_ms 的片，调用方自行累计总预算：总超时语义不变、单次占用有界
@@ -2335,7 +2335,7 @@ int net_recv_to(int sockfd, void *buf, int len, uint32_t timeout_ms) {
msg.len = len;
/* 阻塞式：netTask 侧轮询至"有数据"或"本片超时"（勿置 NET_MSG_DONTWAIT） */
msg.flags = 0;
/* 本片预算：netTask 最多等待 timeout_ms，保证对 netTask 的占用有界（E-02） */
/* 本片预算：netTask 最多等待 timeout_ms，保证对 netTask 的占用有界 */
msg.timeout_ms = timeout_ms;
/* 记录调用任务句柄，netTask 处理后经 xTaskNotify() 精准回执 */
msg.caller = xTaskGetCurrentTaskHandle();
@@ -2440,9 +2440,9 @@ int net_close(int sockfd) {
* （net 层 auto_relisten 已接管，见 AGENTS 单连接断开语义）
* 函数说明：1. 单连接模型下挂起但 TCP 仍活的客户端会永久占住监听（keepalive
* 被 PC 内核自动 ACK 判不死，《网络自愈架构设计》§5.2 E13）；应用不得
* net_close 监听 fd → 本 API 拆连接不拆监听（E-02 收口）
* net_close 监听 fd → 本 API 拆连接不拆监听
* 2. 监听型 fd：netTask 侧仅登记隔离沉降 + 重建请求即返回（动作在
* net_listener_tick，netTask 零占用，登记簿 N-17 收口）；非监听 client
* net_listener_tick，netTask 零占用，探针窗口心跳缺口收口）；非监听 client
* fd 仍同步排渣（600ms 封顶）。见 net_drop_conn_locked
*/
int net_drop_conn(int sockfd) {
@@ -2886,7 +2886,7 @@ int net_setblocking(int sockfd, int on) {
* 出口参数：无
* 返回值：错误码（NET_OK=0, NET_ERR_xxx=-N）；本任务无失败记录时为 NET_OK
* 限定条件：无（任何上下文可调用；中断上下文读 [0] 槽）
* 函数说明：1. E-03 修复：错误码**按任务隔离**——只读本任务自己的槽位，
* 函数说明：1. 错误码**按任务隔离**——只读本任务自己的槽位，
* 其他任务的 net 调用再也覆盖不了它（旧实现为单一全局量，跨任务竞态）
* 2. 调用成功时**不清零**（保持历史语义，向后兼容既有调用方）
* 3. 超时场景（net_recv_to）请直接用返回码 -2 判定，不要依赖本接口