Files

T

wandering1 045ca7f688 docs(配图): 端到端链路鸟瞰进生成器体系，补大图碰撞审计判据

把 archify 出的交互架构图落回仓内可复现形态，避免 docs/ 里出现「没有生成器的
SVG」：

- 新生成器 tools/arch_diagram/gen_arch_endtoend_svg.py → docs/images/架构总览_
  端到端链路.svg（42 框 / 37 边 / 5 条纵带，线型分数据·命令·屏障心跳三类）；
  数据全部内嵌在 .py 里（generated-fresh 只把单个 gen_*.py 拷进临时目录重跑，
  外部 JSON 输入会 rc≠0 假红），SVG 内不含时间戳/commit/绝对路径
- docs/架构设计/项目架构总览.md 新增 §1.3 挂图并写清与 §1 分层图的分工
  （那张答「谁在哪一层」，这张答「一条数据走到底穿过谁」；纵带只是列分组，
  依赖方向仍以 §1.1 表与 layer-deps 门禁为准），版本 v1.2 → v1.3
- 两处生成器清单登记：tools/arch_diagram/README.md 脚本一览、
  docs/架构设计/图形绘制流程.md 的选型表与产物对照表
- draw-diagram skill 新增 §三b（大图碰撞审计判据 + 两条几何纪律）+
  reference/svg-collision-audit.py（拷进 ci-artifacts 用，刻意不进 tools/）

本窗实测（都已写进 skill）：42 框 37 边的图缩略目检看着干净，解析式审计一眼
报出 23 条——边标签文字盒压到节点框会被后画的节点白底吃掉半个字（「串行执行」
渲染成「行执行」）；根因是同行两框走了「同轴加一段走廊」的通用规则，产出退化
四点折线，把标签落点推到第一半中点。修法：同轴且已对齐直接返回两点线，标签
落点改按总弧长取 50%。

零余量第二遍（用生成器自己的 Box/route/label_at 真值扫，框不膨胀不内缩）又抓到
两处近失：「TRGO 触发」「帧 B 下发」与相邻框只剩 0.7px / 1.5px，缩成「TRGO」
「帧 B」后最紧余量升到 3.5px；同一遍还纠正了审计器自己的错——`hi > y0` 误写成
`hi > x0` 凭空报 3 条穿框，差点重排三条边的走线，所以判据里加了「先验审计器
本身再信 0 条」。

自查：连跑两次产物 sha1 不变；scripts/check_generated_fresh.py rc=0（25 生成器
/ 21 一致 / 4 在只减不增基线内）；碰撞审计 rc=0（0 条）；生成器无 OVERFLOW；
doc-links --sections-strict 逐篇 rc=0；mermaid-syntax / nested-comment /
skill-size / bom-drift 无新发；改动文件字节体检干净；/keil-build 0 错 0 警。

2026-10-30 15:59:24 +08:00

arch_diagram

docs(配图): 端到端链路鸟瞰进生成器体系，补大图碰撞审计判据

2026-10-30 15:59:24 +08:00

font_gen

feat(UI字体): 扩字60字为页面扩充预置, 修复生成器cmap插入顺序缺陷

2026-10-25 03:23:52 +08:00

menu_gen

refactor(编号): UI 菜单层级 L0~L3 → 主界面/一级/二级/三级菜单（批次 3a）

2026-10-28 13:12:06 +08:00

netlist_semantics

为自建代码目录补齐 README，建立目录级导航体系

2026-09-26 12:25:36 +08:00

refgraph

feat(task-worktree): 桥接 DSH worktree 插件——补共享联接、锁归属 pw:<name>、修释放不掉

2026-10-29 07:50:05 +08:00

setview_check

docs(UI方案): 返回系数小数位按可分辨精度修正 + 遥信量落地注

2026-10-25 15:33:44 +08:00

README.md

docs(测试说明): 按用途分六个子目录并同步全库引用

2026-10-30 07:16:07 +08:00

README.md

tools/ — 开发工具

面向开发者的功能性工具（生成器 / 转换器 / 交互工具）。与 scripts/（质量门禁与度量）分工不同：本目录产出资产（图、字体、代码、知识库）。

工具一览

目录	工具	产物	文档
`arch_diagram/`	架构图 SVG 生成器	`docs/images/*.svg`	`docs/架构设计/图形绘制流程.md`
`font_gen/`	中文字库生成	`Drivers/BSP/UI/ui_font_cn_12.c`	`docs/UI设计/UI_中文字体生成与配置.md`
`menu_gen/`	菜单树代码生成	UI 菜单代码	`docs/UI设计/菜单页面设计.md`
`netlist_semantics/`	网表语义分析	引脚知识库 JSON + 网表报告	`docs/硬件平台/`
`refgraph/`	文件引用关系图	`docs/images/引用关系图.*`	`docs/架构设计/引用关系图说明.md`

使用方式

# 架构图（精确布局）
& '.venv\Scripts\python.exe' tools/arch_diagram/gen_memory_svg.py

# 中文字体（含新汉字文案后必须重跑）
& '.venv\Scripts\python.exe' tools/font_gen/make_font.py

# 引用关系图
& 'tools\refgraph\gen_refgraph.bat'

# 串口助手（常驻 daemon）
& '.venv\Scripts\python.exe' .dsh/skills/serial-assistant/scripts/serial_tool.py

⚠️ 约定

生成器的产物与脚本一并提交（如 SVG）；本地预览产物（如 PNG）不提交
图表选型：精确布局图用 arch_diagram/ 生成器；拓扑图（流程/时序/状态机）用 Mermaid； 勿手绘 ASCII 框图（见 docs/架构设计/图形绘制流程.md）
涉及 UI 改动：走 ui-verify skill 五步门禁；涉及字体：走 font-regen skill

README.md Unescape Escape

tools/ — 开发工具

工具一览

使用方式

⚠️ 约定

相关文档

README.md