docs(配图): 菜单树总览改由生成器画,登记钩子扫不到的图
- 新增 tools/arch_diagram/gen_menu_tree_svg.py → docs/images/菜单树总览 .svg:43 节点 = 9 菜单 + 34 叶,30 已绑页 / 4 未绑 / 16 叶带密码门, 最深 4 级;读数由脚本现算,不在文档里另抄一份 - 生成器内嵌 NODE_SRC(= ui_menu_tree.txt 的 43 行节点):在仓库里跑会 与真值逐行互验、不一致 exit 1;generated-fresh 在临时目录重跑读不到 真值 → 用内嵌表,输出逐字节一致(实测临时目录产物同 sha256) - 产品需求 §8.2 原先挂的是级联框显示几何图(画的是示例级联,从来不含 整棵树的节点),换成这张树图,并删掉「该图仍是 42 节点时代所画」的 补丁注 - 图形绘制流程新增 §2.1:登记 generated-fresh 扫不到的四张图 —— 两张 tools/refgraph 产物(引用关系图 / _模块,不在 gen_*.py 命名面里)+ 两张手画稿(级联框总览、级联框几何计算)。钩子只扫 tools/arch_diagram/gen_*.py,这些图改了不会有人报警;再多一张先说清 为什么不能用生成器 - arch_diagram README 脚本一览加行
This commit is contained in:
@@ -54,6 +54,22 @@
|
||||
| `gen_data_trust_ladder_svg.py` | `docs/images/数据可信台阶.svg` | `STEPS` 五级台阶(状态 / 问题 / 依据)+ `BAND_LABEL_1` / `GATE_LABEL` / `FOOTNOTE`(台阶状态变了才重画) |
|
||||
| `gen_data_trust_dc_ac_svg.py` | `docs/images/ADC直流标定与交流验证.svg` | `BOXES_A` / `BOXES_B` 两条泳道 + `CHIPS` 六件事 + `NOTES` 红线与"证不到"清单 |
|
||||
| `gen_wave_record_flow_svg.py` | `docs/images/故障录波数据流.svg` | `CHAIN` 主链四段 + `EDGE` 跨边界标签 + `TRAPS` 三条陷阱 + `FORBID` 四条红线(所有权、段形态或红线变了才重画) |
|
||||
| `gen_menu_tree_svg.py` | `docs/images/菜单树总览.svg` | **内嵌 `NODE_SRC`**(= `ui_menu_tree.txt` 的 43 行节点)+ 版面常量;仓库里跑会与真值逐行互验,不一致 exit 1(临时目录里读不到真值 → 用内嵌表,输出逐字节一致) |
|
||||
|
||||
### 2.1 钩子扫不到的图:refgraph 产物与历史手画稿
|
||||
|
||||
`generated-fresh` 的 `docs-svg` 条目只把 `tools/arch_diagram/gen_*.py` 拷进临时目录重跑逐字节比对。
|
||||
上表没列到的 `docs/images/*.svg` 就是下面这几张,**它们全都不在这条钩子的扫描面里**——改了不会有任何
|
||||
人报警,这就是「42 个节点的旧图挂在 43 个节点的标题下」能一路活到今天的原因。
|
||||
|
||||
| 图 | 谁画的 | 用在哪 | 维护口径 |
|
||||
|---|---|---|---|
|
||||
| `docs/images/引用关系图.svg`、`docs/images/引用关系图_模块.svg` | `tools/refgraph/gen_refgraph.py`(graphviz,不在 `gen_*.py` 命名面里) | `docs/架构设计/引用关系图说明.md` 的产品 | 改了代码引用就跑 `tools\refgraph\gen_refgraph.bat` 重生成,**svg 与改动同一笔提交**,别只更新 `.dot`;口径 → `docs/架构设计/引用关系图说明.md` |
|
||||
| `docs/images/级联框总览.svg` | 2026-10-26 手画 | `docs/UI设计/菜单页面设计.md` §4.1(级联框显示几何:根框 + 整定子框) | 只作**显示几何示意**,不承载菜单树事实;树的结构 / 层级 / 绑页 → `docs/images/菜单树总览.svg`(有生成器) |
|
||||
| `docs/images/级联框几何计算.svg` | 同上 | `docs/UI设计/菜单页面设计.md` §5.3(逐框坐标推导) | 同上;坐标公式变了要重算重画,别在 SVG 上描字 |
|
||||
|
||||
新增精确布局图一律走 `tools/arch_diagram/gen_*.py`(`docs-svg` 条目自动发现,**不必登记基线**);上面这几张
|
||||
是这套纪律的**例外面**,再多一张先说清为什么不能用生成器。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user