wandering1
15bcfc7c92
冲突两处与处置 - docs/子系统设计/故障录波设计说明.md §5.2：上游把这张表交给格式化器重排，多出一列 空列，并把「FA_WRITE 竖线 FA_OPEN_APPEND」里的竖线当成分隔符打断，标志位写法已损坏。 取我方四条陷阱版（含实现期复核新增的第四条：搬段途中环被解冻甚至已换段 → 关档后 复检环侧身份判废），并把标志位里的竖线转义（与 运行与自检记录设计说明.md 同一写法）。 上游在表后新增的「取窗竞态的原因」配图不是本任务内容，原样保留未删。 - scripts/size_attestation.json：不手工拼接，改为合并后在主树重新构建再重盖凭证。 顺手修一处上一轮我引入的排版断行 - docs/任务规划/数据可信.md §4.6.5「跨转换器相位」那一行少一个分隔符，三列表渲染成 两列；同时把引用从 §7 精确回 §7.1（链路分段）。合并面 68 个文档、46 张表逐张核对 列数一致，命中 0。 合并态权威构建（主树，本次凭证的来源） - 0 错误 0 警告；Code=243,552 / RO=28,784 / RW=1,972 / ZI=145,388；RW_IRAM1 89,936 B （68.6%）/ RW_CCM 57,376 B（87.9%）——与任务树逐项相同：上游自 merge-base 起对代码 只改了 sample_ring 的注释与函数头，故台账数字无需重排，仅重盖同码凭证。 - 上游 14 个提交带来的门禁与技能改造（skill-size 钩子、五个技能正文外置）与本波正交， 真重叠只有 docs/门禁说明/README.md 与 docs/测试说明/主机单测覆盖率口径.md 两处， 按 hunk 距离自动并上，已逐项核对。 状态与后续 - 台架三条判据（注 1 V/50 Hz 对表、FTP 拉回比对、与 meas 及 104 同表读数）按用户裁定 保持未完成，卡片不销项；本笔交付的是软件闭环。 - 全仓计数清扫（主机单测 41 → 44 套、无专属钩子 19 → 22 套、黄金 60 → 66 张、提交 钩子数口径、两处钩子显示名）另开一笔，不与本笔混编。 - docs/任务规划/** 本应在主工作树改，本波由用户在任务树显式豁免、随本笔合回。
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-verifyskill 五步门禁；涉及字体：走font-regenskill
相关文档
docs/架构设计/图形绘制流程.md— 配图规范与选型docs/架构设计/引用关系图说明.mddocs/测试说明/串口助手使用指南.md、docs/测试说明/串口助手设计说明.md