super_agent_bot
3a2f9b21fb
SNTP 客户端已随 #73/PR #77 上线合入（merge 2b848c4a），用户裁定
8888 对时任务退出历史舞台（gitea:77 线程原话，跟踪 Issue #78）。
生产侧（App/sync/time_sync.c v2.0，任务入口名不变，freertos.c 零改动）：
- 删除 :8888 监听、TIME 包重组、sys_clock 写入、OPER 落痕、
net_drop_conn 队头自救整条链（TIME_SYNC_PORT 宏随退役删除）
- 任务体收敛为：就绪屏障（100ms 分片、osFlagsNoClear）→
200ms 校时节拍 task_wd_beat → time_sntp_run(net_get_generation())
→ 分片延时；喂狗节奏（TASK_WD_TIMESYNC=5，required_mask）不变
- 时钟写入口自此 = SNTP / UI 手工 / 104 C_CS，双写竞态（后写者赢）
随之消失（墙钟说明 §15 退役公告、§16 现势口径）
工具与测试：
- 删除 test/host/time_sync_server.py（对时源）与 e02_probe.py
（队头阻塞探针，载体随监听退役；判据脚本 v5_log_gap_report.py
保留供旧日志解读）
- time_sync 主机单测重写 v2.0：33 断言覆盖分片延时 / 屏障 /
SNTP 节拍与网络代次当轮交接 / 未出网守门；stub 的
net_socket.h 裁剪至 net_get_generation 作编译期绊线
- 覆盖率基线 --update-baseline 收口（time_sync.c 101→20 行为刻意
缩减，全仓 48/48 套绿）
文档与图：墙钟说明 §15 改退役公告（教训保留：CH395F FIN 丢未读
缓冲）、§16 单一网络来源；产品需求 FR-TIME-2 退役注记、§6.3 重写；
架构总览 / 软件架构规格 / 网络配置 / 网络自愈 §9.3 / BSD 指南 /
看门狗说明心跳与白名单行 / 实机测试指南 / 部署环境 / 继保规划 /
UI补齐时基口径 / 页面补齐规划 SNTP 页行 / 任务规划 README 叶数与
暂缓项行（SNTP 叶已绑、UI_PAGE_MAP_COUNT=31 口径）等约 30 处现势
口径同步；arch / net_stack 两图生成器与 SVG 同笔重跑。
台账：ram_baseline --update + check_mem_numbers --write + 体积凭证
（Code 254,648→253,428，−1,220 B）。静态链复测发现 timeSyncTask
1,904 B / iec104Task 1,600 B 低于 ISR 硬线：master 2b848c4a 同判据
timeSyncTask 即 2,056 B（本 PR 只减不增，−152 B 旧任务自身帧），
双 FAIL 为 #74/#77 后既有债；抬栈属 Ask-first 未擅自执行，登记簿
新增「静态链硬线双 FAIL」待台架复采，复测快照入 docs/内存管理/data。
验证：keil-build 0 错 0 警；time_sync/sntp 主机单测绿；
ci_local 全绿；doc-links --all 0。
tools/arch_diagram/ — 架构图 SVG 生成器
用 Python 脚本精确生成架构类 SVG 图（分层、内存布局、协议帧、屏障等）， 产物放
docs/images/。用于"必须精确布局"的图；拓扑图（流程/时序/状态机）改用 Mermaid。下面这张表是配图产物的唯一真值清单——入库的 32 张
docs/images/*.svg逐张列出：谁生成它、 它答什么问题、改哪一段数据能重跑、被哪篇文档内嵌。选型判据与绘制流程 →docs/架构设计/图形绘制流程.md， 画图时的操作入口 →draw-diagramskill。
产物清单（按主题分组 · 32 张全量）
「挂在」列只认 Markdown 图片链接 ，格式 文档:行号；行号会漂，现查勿背：
grep -rn "图名.svg" docs/ --include=*.md。零内嵌的图在单元格明写「零内嵌」，它要么只被正文文字提到、
要么就是挂了但没人挂图——改图的人顺手把这条也核对一次。
图（docs/images/） |
生成器 | 这张图答什么 | 顶部数据区（改这里 → 重跑） | 挂在 |
|---|---|---|---|---|
| 架构与启动 | ||||
项目架构总览.svg |
gen_arch_svg.py |
六层分层结构与跨层依赖——「谁在哪一层」（不含数据流边、不含片外硬件） | LAYERS / ROWS / FOOT |
docs/架构设计/软件架构与运行时规格.md:14、docs/架构设计/项目架构总览.md:11 |
架构总览_端到端链路.svg |
gen_arch_endtoend_svg.py |
端到端链路鸟瞰——一个电气量从引脚走到 104 报文 / 显存 / 记录文件穿过谁、与谁在什么时候换锁；42 框 37 边 5 条纵带，线型分数据 / 命令 / 屏障心跳 | NODES（id / 列 / 行 / 标题 / 副题）+ EDGES（出入框方位与 f / g / my / gx 旋钮）+ BANDS；三条独占通道 CHAN_B / CHAN_78 / CHAN_SLOTS 与走廊 GUT_C4C5 在几何区 |
docs/架构设计/项目架构总览.md:53 |
就绪屏障.svg |
gen_barrier_svg.py |
Event Flags 屏障模型：位 → 生产者 → 消费者三栏对齐，哪些位真在用、哪些是预留 | BITS / PRODUCERS / CONSUMERS / FOOT |
docs/架构设计/软件架构与运行时规格.md:63、docs/架构设计/项目启动顺序管理.md:48、docs/架构设计/项目架构总览.md:85 |
配置文件分层架构.svg |
gen_cfg_arch_svg.py |
配置引擎分层与持久化：谁解析 [section]、落盘走哪条链 |
ROWS 分层清单 + 标题 / 脚注文案 |
docs/产品需求/产品需求设计文档.md:331、docs/子系统设计/配置文件设计说明.md:144 |
| 采集与算法 | ||||
ADC前端电路.svg |
gen_adc_frontend_svg.py |
端子 → 串阻 → 转换节点 → 转换器引脚；含差分负端与 STM32 侧对照 | SUB1 / NOTE_* 等文案常量 + 面板坐标（电路拓扑固定，网表变了才重画） |
docs/测试说明/专项验证/ADC前端注入验证流程.md:31、docs/硬件平台/ADC通道映射说明.md:161 |
ADC码值刻度.svg |
gen_adc_code_scale_svg.py |
「码」的直观定义：两片转换器的刻度尺对照（16 位双极性 vs 12 位单极性） | PANELS（码范围 / LSB / 实测码标记位置）+ FOOT（换芯片才重画） |
docs/测试说明/专项验证/ADC前端注入验证流程.md:104 |
ADC直流标定与交流验证.svg |
gen_data_trust_dc_ac_svg.py |
上排直流注入链、下排信号发生器正弦验证，中间列只有正弦能证的六件事 | BOXES_A / BOXES_B 两条泳道 + CHIPS 六件事 + NOTES 红线与"证不到"清单 |
docs/任务规划/数据可信.md:294 |
数据可信台阶.svg |
gen_data_trust_ladder_svg.py |
采集数据可信度的五级台阶：现在踩在哪一级、下一级挡什么 | STEPS 五级台阶（状态 / 问题 / 依据）+ BAND_LABEL_1 / GATE_LABEL / FOOTNOTE（台阶状态变了才重画） |
docs/任务规划/数据可信.md:21 |
采样有效性校验数据流.svg |
gen_adc_health_flow_svg.py |
观测计数 → 快照 → 判定 → 位图 → 消费者：三条量车道（TPAFE / STM32 / 时基）平行流过五个阶段 | STAGES 五阶段 + LANES 三条车道 + COLS + FOOT |
docs/算法/采样有效性校验设计说明.md:81 |
采样有效性位图与掩码.svg |
gen_adc_health_bitmap_svg.py |
出口位图与消费者掩码对照——同一 bit 在三张位图与四个掩码里落同一列（Mermaid 控不住列位，故必须等宽网格） | GROUPS 位图组 + C_LEVEL / C_LATCH / C_EVENT / C_MASK 四类位 + WARN / FOOT |
docs/算法/采样有效性校验设计说明.md:303 |
采样有效性判定时间轴.svg |
gen_adc_health_timeline_svg.py |
四个工况的时序与门限（100 ms 门限线、静默计时线、电平位与锁存位的存续区间——按时间比例画，Mermaid 只画拓扑不保比例） | PANELS 四工况 + T_MAX / V_MAX 比例轴 + WARN / FOOT |
docs/算法/采样有效性校验设计说明.md:212 |
采样环缓冲_为什么需要.svg |
gen_sample_ring_why_svg.py |
上游 1 kHz 覆盖写只交"最新一帧" vs 下游相量要一整周波（20 点）：缺口 19 点与三个消费者 | SUB1 + CARDS 对照卡 + FOOTNOTE |
docs/算法/采集与算法层设计说明.md:162 |
采样环缓冲_环形布局.svg |
gen_sample_ring_layout_svg.py |
40 格环里哪 20 格是本窗、写指针指"下一格"而不是"最后一格"、整窗随每次写入右移一格与三条设计不变量 | START / SUB3 + CARDS 三件事 + FOOTNOTE |
docs/算法/采集与算法层设计说明.md:192 |
采样环缓冲_窗首下标.svg |
gen_sample_ring_start_svg.py |
窗首 start = head − n 的圆周走法，与"直接减 / 16 位回绕 / 先加 DEPTH"三种写法对照 |
START / SUB1 + ROWS 三种写法 + FOOTNOTE |
docs/算法/采集与算法层设计说明.md:203 |
交流六轮速查.svg |
gen_ac_rounds_svg.py |
交流（正弦）动态验证六轮的总览卡：每轮注什么波形（六张波形缩略图）、判据一句话、主读数出口 | SUB1 / SUB2 + CARDS 六轮卡 + FOOTNOTE |
docs/测试说明/专项验证/ADC前端注入验证流程.md:296 |
交流定数取中位数.svg |
gen_ac_median_svg.py |
为什么交流轮必须"连取 10 行心跳取中位数"：机理（全周窗逐拍滑动 → 单行带拍频跳）与操作（中位数 vs 平均 vs 单行对真值） | SUB1 + VALS 两栏数值 + OPS_NOTE / FOOTNOTE |
docs/测试说明/专项验证/ADC前端注入验证流程.md:431 |
| 网络与协议 | ||||
BSD网络栈分层.svg |
gen_net_stack_svg.py |
BSD socket 分层在本仓落到哪一层（CH395F 之上） | ROWS 分层清单 + 标题 / 脚注文案 |
docs/网络/BSD_Socket_API_使用指南.md:56 |
Net层阻塞模型.svg |
gen_net_pending_svg.py |
挂起（pending）请求模型：调用方两栏 + 主循环横带 + recv 五路 / send 四路判定带 | CALLER_STEPS / FAST_PATH / LOOP_STEPS / PHASES / FOOT |
docs/网络/Net层阻塞模型架构设计.md:77 |
网络不稳根因总览.svg |
gen_net_instability_svg.py |
自愈架构复盘：左列七个误会（问题环）、右列对应拆法，水平箭头一一对应、竖箭头表示"叠加累积" | RINGS 七对 + SUM_LEFT / SUM_RIGHT 两个总结盒 + FOOT |
docs/网络/网络自愈架构设计.md:233 |
RemoDispBus帧格式.svg |
gen_frame_svg.py |
协议帧字节级布局：字段宽严格 ∝ 字节数 + 逐字段标注 + 偏移标尺 | FIELDS / TITLE / SUB / FOOT |
docs/UI设计/RemoDispBus协议与接收设计说明.md:60、docs/产品需求/产品需求设计文档.md:1204 |
| 存储与内存 | ||||
存储栈分层.svg |
gen_storage_stack_svg.py |
存储栈三层：dhara FTL / FatFs / 应用落点（gen_arch_svg.py 的单栈副本） |
ROWS（层数据在 L_* 常量）/ TITLE / SUB / FOOT |
docs/产品需求/产品需求设计文档.md:299、docs/架构设计/STM32F4-Base存储架构说明.md:7 |
物理分区布局.svg |
gen_partition_svg.py |
SPI NAND 物理分区：分区宽 ∝ MB 数 + 偏移标尺（帧图生成器的 MB 计量副本） | FIELDS / TITLE / SUB / FOOT（MB 计量） |
docs/架构设计/STM32F4-Base存储架构说明.md:11 |
内存布局_RAM.svg |
gen_memory_svg.py |
192 KB SRAM（SRAM1/2）+ CCM 的分区归属与占用 | RAM1_CATEGORIES / RAM2_CATEGORIES |
零内嵌——只在 docs/内存管理/RAM使用分析与优化方案.md:772 与本表被文字提到 |
内存布局_FLASH.svg |
gen_memory_svg.py |
1 MB Flash 的段划分与代码 / 常量占比 | FLASH_CATEGORIES / FLASH_CODE_SUB |
docs/内存管理/RAM使用分析与优化方案.md:239 |
任务栈预算.svg |
gen_memory_svg.py |
9 个任务的栈配额与内核静态占用合计 | TASK_STACKS / KERNEL_STACKS |
docs/内存管理/RAM使用分析与优化方案.md:101 |
| 时间 / 看门狗 / 录波 | ||||
看门狗心跳模型.svg |
gen_watchdog_svg.py |
IWDG + 任务心跳位图：置位 → 判定 → 喂狗，配一条时间轴 | TASKS / REQ_BITS / POLL_STEPS / T_AXIS / TIMELINE / FOOT |
docs/产品需求/产品需求设计文档.md:397、docs/子系统设计/看门狗设计说明.md:151 |
故障录波数据流.svg |
gen_wave_record_flow_svg.py |
录波段数据的四个所有者与四条「不许」：谁独占写、谁只能读、标志怎么过界 | CHAIN 主链四段 + EDGE 跨边界标签 + TRAPS 三条陷阱 + FORBID 四条红线（所有权、段形态或红线变了才重画） |
docs/子系统设计/故障录波设计说明.md:165 |
| UI | ||||
菜单树总览.svg |
gen_menu_tree_svg.py |
菜单树 43 节点的层级 / 绑页 / 密码门鸟瞰 | 内嵌 NODE_SRC（= ui_menu_tree.txt 的 43 行节点）+ X_COL 版面常量；在仓库里跑会与真值逐行互验、不一致 exit 1（临时目录读不到真值 → 用内嵌表，保证输出逐字节一致） |
docs/产品需求/产品需求设计文档.md:1537 |
级联框总览.svg |
无生成器（手工 SVG） | 横向级联子框总览（主界面 → 参数定值 → 整定）的显示几何示意 | 直接改 SVG 文本（2026-09-08 入库 891c9ef0，2026-09-11 随配图规范收拢 2429955d）；只作显示几何示意，不承载菜单树事实 |
docs/UI设计/菜单页面设计.md:442 |
级联框几何计算.svg |
无生成器（手工 SVG） | ui_menu_view_frame_build() 逐框坐标推导：行剖面定框宽 → X 贴父框右缘 → Y 顶对齐选中行 → Y 溢出上移 |
同上；坐标公式变了要重算重画，别在 SVG 上描字 | docs/UI设计/菜单页面设计.md:500 |
| 引用关系（另一个工具） | ||||
引用关系图.svg |
tools/refgraph/gen_refgraph.py（graphviz） |
文件级引用图（项目代码视图） | 跑 & 'tools\refgraph\gen_refgraph.bat' 重生成，svg 与改动同一笔提交，别只更新 .dot |
零内嵌——docs/架构设计/引用关系图说明.md:47、tools/refgraph/README.md:23 以表格条目列出 |
引用关系图_模块.svg |
同上 | 模块级概览图（目录 / 库聚合，边上 ×n = 引用条数） | 同上 | 零内嵌——docs/架构设计/引用关系图说明.md:48 |
OVERFLOW不算「数据区」：它是生成器末尾的溢出预检累加器（非空即打OVERFLOW:并 exit 1）， 不是给人改的内容。判据与预检用法 →draw-diagramskill §三。本表怎么保持不漂：新增生成器 = 同批在本表加一行（本目录的约定，也是
draw-diagramskill §五第 6 步）； 图换挂载文档 = 同批改「挂在」列。门禁只兜幂等性不兜本表——scripts/check_generated_fresh.py的docs-svg条目按tools/arch_diagram/gen_*.py自动发现重跑逐字节比对，不必登记；只有需要外部 seed 的条目（menu-gen/cn-chars/cn-font）才在GENS里显式登记 →docs/门禁说明/generated-fresh.md§8。
使用方式
& '.venv\Scripts\python.exe' tools/arch_diagram/gen_memory_svg.py
产物统一输出到 docs/images/；脚本与生成的 .svg 一并提交。
⚠️ 约定
- 颜色/字体遵循
docs/架构设计/图形绘制流程.md的规范 - 中文用 SVG
<text>直接写（需注意字体族声明） - 改图改脚本再重跑，不手改 SVG（保证可复现）；上表标「无生成器」的两张级联框图是例外面，
再多一张先说清为什么不能用生成器 →
docs/架构设计/图形绘制流程.md§2.1 - 表里没有的
docs/images/*.svg就是漂移——按grep -rn "gen_" tools/arch_diagram/*.py与ls docs/images/*.svg对账补齐本表，别另起一张
相关文档
docs/架构设计/图形绘制流程.md— 配图选型（什么图用什么工具）、绘制流程与检查清单docs/文档规范.md§4.4 — 配图与生成物的入库纪律（类别级在册清单，不逐脚本登记）docs/门禁说明/generated-fresh.md— 幂等性门禁查什么、盲区在哪draw-diagramskill — 画图时的操作入口（含大图碰撞审计判据）