wandering1
5a806d8a26
用户裁定「全部修」。第 1 轮修复跨三名队友、写范围互斥、零越界；
11 条登记现状 → 10 条已处置 + 1 条撤销（非阻塞 recv 「看不见 EOF」是误报：
net_recv_locked:1885 的非阻塞分支已把 CLOSED||session_dead 判成 EOF(0)，
动手前读码才发现，误报比漏报更贵）。
存储与日志（App/log/sys_log_mcu.c、soe_store.c、cfg_file_store_mcu.c、sys_log.h）
A 卷忙整批丢日志：批量路径补 rc==-2 分支整批回投（不计故障/不打日志/
保序）；此前一批最多 8 条既不落盘也不回投，而文档写着「条目不丢」
B rc==-1 文案与行为相反：改 write fail, requeue + 正常→故障节流
C 删永不可达的截断支；容量契约写死 sys_log.h（不足一律 -1、不写调用方字节）
D 自愈触发集违规（比原报告更严重）：新增代码侧唯一入口 s_is_selfheal_code，
触发集收敛为 {DISK_ERR,INT_ERR,NO_FILESYSTEM,DENIED}，移出名字/参数类码——
旧集合在 8.3 同名同因下每轮删一次自己的历史日志且永不自愈，正是存储架构
§10.1 第 10 条严禁的归集；soe_store 侧同源取更保守子集（打开失败绝不 unlink）
E 注释里的 FR_NO_SYSTEM 不存在，改 FR_NOT_READY / FR_NO_FILESYSTEM
F syslog_post 满态留痕节流（A 修好后「队列常驻满」成必然场景，不修等于用
新刷屏换掉静默丢）；丢弃语义一字未改
NET（net_socket.c/.h、net_types.h、net_socket_sim.c、lftpd.c）
IP 字节序统一到 POSIX 网络序：改 net_inet_addr（&s_addr[0]==第一段）+ 出向
IP 数组按内存字节顺位拆装（进与出同时换族→芯片侧数组净效果不变，550h 钉住）
+ 模拟器逐字同步；ntoa 函数体未动，只改对它注释里取了废弃族值的例子——
那正是两套约定长期共存不被发现的原因。lftpd 两处算术核对确认无需改
UDP 绕过 netTask：两入口加执行任务上下文守卫，新码 NET_ERR_NOT_IN_NETTASK
(-12，重试永远无意义)；结论口径=危险面已结构性关掉、串行化改造仍未做。
附带关掉第二条更隐蔽的路：非 netTask 自旋 recvfrom 期间控制块被 close 并
把同一 sockfd 分给新会话→旧自旋者消费新会话数据报
控制台（console_log.c/.h）：冷却改独立 s_con_cooling 标志（旧写法在 tick==0 那
拍冷却等于没记）；con_append 的判空位+推进 head+整行拷贝收进同一临界区（旧
为区外 check-then-act，环 >95% 满时可静默覆盖且既不打 [ERR] 也不计 dropped）；
Instance==NULL 与僵尸通道分诊（未初始化绝不 reinit）；三本账分离 + 新读口
dbg_console_tx_timeout()；[ERR] 行改为发成功才销账
测试：net_socket 452、console_log 127、sys_log_mcu 104、soe_store 27、
cfg_file_store_mcu 34；回归 net_listener 34 / net_events 34 / net_pending 43 /
net_select 22 / lftpd 35 / lftpd_inet 28 / lftpd_io 33 / iec104_serv 28 /
nand_port 149 / vol_lock 33 / soe 32 / cfg_file 151 全绿。原「按现状钉住」的
用例全部翻正向；console_log 用「逐条退回旧实现」做变异自证，失败集合单调增长
6→11→18→22（把一条本来空转的断言逼了出来）。
游标抬升：TC-NETSOCK-545→560、TC-SYSLOG-100→107、TC-CONLOG-135→167。
文档：控制台设计说明 §4.1 口径与 §13-O2 销项 + v1.5；运行与自检记录 §4.4/§4.5
四条；存储架构 §10.1 第 10 条推论（指向 s_is_selfheal_code）；TRAP-NET-21 后续
条目；BSD 指南新增 §9.0 s_addr 唯一约定；覆盖率口径 §9「第 1 轮修复处置」表 +
后续项 5 条 + 台架复验 7 条 + 新坑 8 条 + 变更记录。
后续项（本轮刻意不做，理由见 §9）：UDP 改走 netMsgQueue（需 per-task 结果槽，
net_msg_t 按值拷贝、禁止加回传字段，且要真机回归）；sim_syslog.c 同源不可达
支（本轮编译验证不到，不交没编译过的改动）；syslog_post 丢弃计数；
dbg_console_tx_timeout() 读端接线（STALL 行是被解析的证据行，加字段要连解析端
与台架判据一起改）；104 来源地址日志（现网无输出点）。
gate: @build 0 errors 0 warnings（Code=213720 RO=18860 RW=1204 ZI=131500）。
pre-commit run --all-files -> 39 hooks, 36 Passed; failed = mem-numbers +
mem-budget（受管快照与本树首次构建产物的漂移，非本批增量）+ id-check（已修，
现 0 台账外新账，可判定 84.63% > 基线 82.6%）。实测水位 RW_IRAM1 57.4%、
RW_CCM 87.9%，均低于 92% 红线；RAM/Flash 本批增量为数个 static 变量。
test-coverage / cppcheck / coding-standard / bsp-err / layer-deps / doc-links
全 Passed；全量覆盖率 33/33 套件、line 89.3%、func 92.3%、逐文件下降 0。
按仓内分支约定 --no-verify 提交，台账 --write 回填留待主工作树合并后。
App/log/ — 日志子系统
两类日志：持久化运行日志（
sys_log，落 NAND）与控制台日志（console_log，走串口）。 两者都遵循单写者模型，避免多任务交错输出。
文件一览
| 文件 | 作用 |
|---|---|
sys_log.h |
日志接口（平台无关）：定长 64B 记录写入 /log/run.log·selftest.log |
sys_log_mcu.c |
sys_log 的 MCU 端后端实现（NAND + FatFs） |
console_log.c/h |
控制台单写者日志：多任务日志经队列汇入唯一写者，避免串口输出交错 |
soe_rec.c/h |
SOE 记录纯编解码（B9）：64B 定长记录（CP56Time2a 时标 + 类型 + 元件号 + 单调序号 + 值 + sum8 撕裂校验），零 I/O 零 OS 依赖，主机单测覆盖 |
soe_store.c/h |
SOE 落盘胶水（B9）：/log/soe.log，protectTask 投递（零文件系统）→ defaultTask 排空落盘 |
关键机制
syslog（运行/自检记录）
- 唯一写者 = defaultTask；其它任务只投递，不直接写盘
- 单记录定长 64 B，循环写；待机页可显示记录
- 内核启动前的日志走无锁静态缓冲
s_preboot[8]暂存（因为内核启动前不能建队列）， 内核启动后由syslog_drain惰性创建真队列并排空 - ⚠️ 写盘必须校验
f_write返回的字节数（该 FatFs 移植在簇分配失败时返回FR_OK+ 短写， 不报错误码）；追加写必须FA_WRITE|FA_OPEN_APPEND（FA_OPEN_APPEND单独用不含写位）
console_log（控制台单写者）
- 多任务的生产者 → 单写者消费者，消除任务间日志行交错
- 设计详见
docs/子系统设计/控制台单写者日志设计说明.md
soe（SOE 事件顺序记录，B9）
- 记录 = 64 B 定长二进制（
soe_rec.h布局），落/log/soe.log； 与 run.log 分文件——run.log 是文本记录、有 UI/主机读取方，二进制 SOE 混入会破坏读取器；分文件保持"定长 64B + 条数=fsize/64 + 满删重建 + FTP 下载 + 主机解码"同一套先例 - 生产者 = protectTask（元件动作/返回、软压板投退、采样闭锁/恢复六类
边沿）：
soe_store_post()纯 RAM（取时标 + 组记录 + 队列/待发环）， 零 NAND I/O；⚠️ post 内禁DBG_*——会把 protectTask 静态最坏链 垫高一帧（实证 872→1192 B FAIL），丢弃留痕由 drain（defaultTask）差值上报 - 唯一写者 = defaultTask：挂
syslog_drain()尾部（继承其卷就绪门）， 50 ms 节拍 → SOE 落盘延迟 ≤50 ms；写盘纪律全套照 syslog（卷锁 try /FA_WRITE|FA_OPEN_APPEND/ 校验字节数 / 满删重建 / 失败留痕去重）， 绝不把名字/参数类错误码归入卷损坏触发集 - 时标口径：sys_clock 秒域时基 → CP56 ms 域 = 秒×1000（亚秒恒 0， 不造假）；墙钟未建 → IV 位如实置位；seq 仅上电生命周期内单调 （容量重建不重置，仅复位重置——主机解码按 boot 段分段断言）
- 主机侧：
test/host/soe/decode_soe.py解码 + 断言（校验和/seq 单调/ CP56↔epoch UTC 交叉）；⚠️ 交叉校验用calendar.timegm，不是本地时区的dt.timestamp()（+08 机差 28800 s，首跑实证坑）
相关文档
docs/子系统设计/控制台单写者日志设计说明.mddocs/子系统设计/运行与自检记录设计说明.md- FatFs 陷阱：
AGENTS.md「平台约束」