0edbfaf08b
T0 降噪 + T1 单一所有者:四处重建触发(recon/accept/eof/drop)与 pending 第五处统一走 net_listener_request(),由 net_listener_tick 单点执行; 沉降重试日志改"只留首末"(E0 口径),每次恢复少打 3 行重复行。 force open 降级为只留痕(E19 反事实 A/B 实测):芯片未回 CLOSED 时强行 open 注定吃 USE 错(TRAP-NET-09),放行与不放行的端口恢复时刻同一分布 (放行 +512 / 不放行 +505·533 / 降级后 +509 ms)——恢复由芯片何时回 CLOSED 决定。真正兜住"监听器永久失效"的是 D10 预算到期 + 对账形态④ 重新登记,不是放行。新增 s_relisten_capped[] 使上限留痕只打一次, 隔离标志不清 → 下一轮继续排空残渣(构建 B 实测每 30ms 两行会刷屏)。 负向注入三轮打靶(E18,注入代码不入库):形态① 吞掉 DISCONNECT 后 4/4 救回、③ 空闲监听器静默失位两轮独立复现、⑤ 开盲区吞掉芯片自发中断 + 收回 LISTEN 后 -> resync 命中且挂起 recv 被取消 → 三条均不可降级为 只留痕。顺带稳定复现 [ERR] relisten retry budget exhausted = 对端不配合 拆链的签名,非回归。 台架:boot PASS;ftp_abort_probe RST 10/10 + FIN 5/5;relisten_stress :21 50/50(p50 507ms);n30_repro 30/30。构建 0 错 0 警 Code=212316; netTask 静态最坏链 1920→1912 B;RAM 台账受管区已 --write 同步(RW +8B)。 文档:E17/E18/E19 三行 + §4.1 常态 0 命中归因 + §4.3 兜底归属改正; 登记簿 N-31 销项(结论沉淀进 §4.3 与 E19)。
tools/arch_diagram/ — 架构图 SVG 生成器
用 Python 脚本精确生成架构类 SVG 图(分层、内存布局、协议帧、屏障等), 产物放
docs/images/。用于"必须精确布局"的图;拓扑图(流程/时序/状态机)改用 Mermaid。
脚本一览
| 脚本 | 产物 | 用途 |
|---|---|---|
gen_arch_svg.py |
架构分层图 | 六层分层结构 |
gen_memory_svg.py |
内存布局图 | RAM / Flash 分区 |
gen_storage_stack_svg.py |
存储栈图 | FTL / dhara / FatFs 三层栈 |
gen_net_stack_svg.py |
网络栈图 | BSD 网络栈分层 |
gen_barrier_svg.py |
就绪屏障图 | Event Flags 屏障模型 |
gen_frame_svg.py |
协议帧格式图 | RemoDispBus 帧结构 |
gen_cfg_arch_svg.py |
配置引擎架构图 | 配置分层与持久化 |
gen_partition_svg.py |
分区图 | 存储分区 |
gen_watchdog_svg.py |
看门狗心跳模型图 | IWDG + 任务心跳位图(置位→判定→喂狗 + 时间轴) |
使用方式
& '.venv\Scripts\python.exe' tools/arch_diagram/gen_memory_svg.py
产物统一输出到 docs/images/;脚本与生成的 .svg 一并提交。
⚠️ 约定
- 颜色/字体遵循
docs/架构设计/图形绘制流程.md的规范 - 中文用 SVG
<text>直接写(需注意字体族声明) - 改图改脚本再重跑,不手改 SVG(保证可复现)
相关文档
docs/架构设计/图形绘制流程.md— 配图规范、选型与检查清单