Files

T

wandering1 4a4ad6bc5f chore(全仓): @build/@test 旧文档别名清退为技能调用名

现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名，
不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改
  「编译（/keil-build）」「串口回归（/serial-boot-test）」
- keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree
  方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围）
- 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all
rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52
钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。

2026-10-30 13:03:12 +08:00

2.0 KiB

Raw Blame History

name, description, whenToUse

name	description	whenToUse
new-source-file	新增 .c 源文件的双端注册：MDK-ARM/STM32F407-Demo.uvprojx 与 simulator/CMakeLists.txt 均为显式文件列表，新文件必须手动加进两处再双端构建验证。	新建 App/、Drivers/BSP/ 下的 .c 文件，或构建/运行报 undefined reference、"改了代码没生效" 而怀疑文件漏注册时。

新文件双端注册

本工程 Keil 工程与 PC 模拟器都使用显式文件列表（无通配扫描）——新 .c 文件不手动注册就不会被编译；只注册一端 = 另一端静默缺文件（不一定报错，功能悄悄不生效）。

注册步骤

Keil MDK：编辑 MDK-ARM/STM32F407-Demo.uvprojx，在对应 <GroupName> 的 <Files> 中按相邻条目格式插入（..\ 开头反斜杠路径）：

<File>
  <FileName>ui_new_module.c</FileName>
  <FileType>1</FileType>
  <FilePath>..\Drivers\BSP\UI\ui_new_module.c</FilePath>
</File>

现有组：App、Drivers/BSP、Drivers/BSP/UI、Test 等；新文件放语义对应的组。

模拟器（仅当文件需 PC 端编译，如 Drivers/BSP/UI/*.c）：在 simulator/CMakeLists.txt 的 set(UI_SOURCES ...) 列表加一行 ${UI_DIR}/ui_new_module.c。非 UI 模块文件通常不需模拟器注册。
双端构建验证（两端都必须过）：

cmake --build simulator/build --config Debug   # 0 警告
& '.venv\Scripts\python.exe' .dsh\skills\keil-build\scripts\keil_build.py   # BUILD_OK，0 错 0 警

注意

禁止把源文件复制进 simulator/——两端共用 Drivers/BSP/ 原件（UI_界面制作流程.md C7）
只注册 .c（含 .s）；.h 靠 include 路径找到，不加工程
漏注册的典型症状：一端编译失败（undefined reference）或一端行为悄悄停留在旧逻辑
注册完成后跑回归：UI 文件 → ui-verify skill；其他模块 → /serial-boot-test（.dsh/skills/serial-boot-test/scripts/run_boot_test.py）
改过 CMakeLists.txt 后需重新 cmake -B build 配置

2.0 KiB Raw Blame History Unescape Escape

新文件双端注册

注册步骤

注意

2.0 KiB

Raw Blame History