Files

T

wandering1 96a3d15efc chore(gate): 门禁钩子改走 gate_python 启动器，worktree 统一插件模型

门禁解释器解耦
  44 条 language: system 钩子此前把解释器写成仓库检出的绝对路径，换机、
  换克隆目录都要重写。改为 entry 只写 scripts/gate_python.py + 脚本名，
  由启动器按候选链解析：$DTU_GATE_PYTHON > <仓库>/.venv >
  <仓库>/.gate/python > PATH。启动器用 execve 替换自身，并把选中的
  解释器经 DTU_GATE_PYTHON 传给子进程，保证脚本内再调 Python 时一致。
  实测 pre-commit 4.6.2 不展开 ${VAR}；language: script 的 shebang 只做
  纯 PATH 改写，会把决定权交给 PATH 首个 python，故不采用。
  ci_local.py 预检识别启动器并报出解析结果。

并行工作树统一
  task-worktree 新增 bench-gate（强制台架验收）与 merge（编排式合并），
  删除 new/abort，done 标 DEPRECATED；台架通过记录改存
  .agents/worktrees/.bench-pass-log。keil_build.py 的 plugin_tree_owner
  识别 .agents/worktrees/<name> 并返回 pw:<name>。
  check_doc_links / gen_refgraph / check_layer_deps 的扫描排除面补上
  .agents；并行任务工作树方案重写为单一模型（7 节），取消工作树数量上限，
  删历史实测记录节，两处 §7.3 悬空引用改为按语义引用。

文档与约定
  本地工具路径环境变量方案 §5 重写为四节：谁跑在哪个 Python 上、写新钩子、
  预检对号入座、动环境五步。文档规范的变更记录例外名单由 5 篇减为 4 篇
  （本篇实际没有该节）。AGENTS.md 补委派验收口径三条。

验证：pre_commit run --all-files 48 钩子全 Passed；ci_local.py
--preflight-only 报 44 条经启动器 -> 仓库 .venv；keil-build 0 errors
0 warnings；check_doc_links --sections-strict 全通过。

2026-11-15 19:39:56 +08:00

arch_diagram

docs: 删任务规划两份已完成文档，数据可信内容迁入算法层/硬件平台/登记簿

2026-11-09 16:13:57 +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

chore(gate): 门禁钩子改走 gate_python 启动器，worktree 统一插件模型

2026-11-15 19:39:56 +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