wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
873 Commits 4 Branches 0 Tags
4a4ad6bc5fbb87cc0e2fef18df196584a0cf1336
Commit Graph

13 Commits

Author SHA1 Message Date
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
wandering1 83011abb16 docs(编号): 测试验证层级文档面清号 + 修上一批改名留下的双写与错族疤（27 篇） 
同族第三道（文档面）。上一批只改了 10 篇测试文档，本笔清掉余下 27 篇的层级号，并修
那批机械替换留下的两类疤。

- 层级号改语义名：各单元测试说明的「**门禁层级** | L0.5 层（介于 L0 静态门禁与 L1
  板端套件之间）」→「主机侧纯逻辑单测（介于静态门禁与板端测试套件之间）」；
  「板端（L1）」「L1/L2」「L3 人工」等表头与列值同批改写；测试文档模板规范的模板
  字段同步（它决定以后每篇测试说明怎么写这一栏）。
- 「模拟器回归」旧号（原文标 L3/L2）**不映射**成新语义名，就地写「模拟器回归」：
  它与「主机侧回归」是两回事，硬映射等于造一处新的口径错。
- 修双写疤 17 处（替换串套替换串的产物）：文档道改完 Lead 点名的 8 处后中途失败，
  Lead 接手余下 9 处——测试开发标准流程 7、CI README 1、门禁说明/host-unit-tests 1、
  任务规划/测试与架构专项 1。
- 修**错族替换疤**（比双写更坏：字面改对、意思改错）：ADC输入层单元测试说明与
  相量层单元测试说明的「介于 L0 静态门禁与 语义取数与有效性板端套件之间」——上一批
  把测试层的 L1 换成了采集链层名；本笔随该行改写一并修正。产品需求 §7.4 同类问题
  在上一笔（代码道）修。
- 变更记录历史行按「行内换号、日期与技术事实不动」处理（与「卡」族先例一致），
  换算表与撞族警示在 scripts/archive/id_gate/编号治理历史.md §10 / §10.1。
- 刻意未动：docs/芯片手册（外部手册原文）、UI 菜单层级残留 2 处与采集链旧层名残留
  （已登记 task-12）、test/board 的链路时延段号残留（task-11）。
- 门禁：check_doc_links --all --sections-strict 通过（195 篇、章节引用 3292 处）；
  id-check-new --worktree rc=0（剩 2 处 WARN 是变更记录行里的已停发测试专项号，
  不拦提交，本笔不越族去动它）；112 个改动文件 U+FFFD=0、无 CR、BOM 与 HEAD 一致；
  git diff --check 干净。
 2026-10-28 17:56:21 +08:00
wandering1 f5d524fdde feat(门禁): 把「钩子跑在谁身上」机械化——ci_local 新增 L0a 解释器预检 + 环境动手术的顺序与回滚 
task-33 诊断结论的落地（道G 执行，环境**一个字节没动**：不装包、不重建、不改 requirements 约束）。

**要防的是什么**：`.git/hooks/pre-commit` 把 `INSTALL_PYTHON` 钉在 `.venv`，而 43 条
`language: system` 用
裸 `python` ⇒ pre-commit 本体走 `.venv`(3.12.4)、钩子 entry 走 PATH 首位(3.14.7，零第
三方包)。今天
不炸是**巧合**（那 43 条模块级 import 全是标准库，唯一要 fontTools 的那条自己解析解释器）。真正的危
险形态是：某条钩子在**跑到它那一刻**才报 `No module named ...`——一次提交里前 14 条已经改写完工作区、
第 15 条才崩，现场最难看，也最容易被误当成代码问题。L0a 把这件事提前到门禁第一段。

**FAIL 判据刻意收窄成三事齐备**：模块级第三方 import + 该脚本不自解析解释器 + PATH 首位那个解释器
真缺包。惰性/条件导入（`make_font` 的 fontTools 在函数体内）只列为**候选**、不判决——否则就是假阳性
（见下）。退出码 2 = 环境错误，已写进文件头退出码段与用法。

**道G 自己推翻过自己两处，都留在文档里没删**：
① 上一版诊断说「42 条里唯一需要第三方包的那条自带解析」是**宽松正则**审出来的（把注释与字符串里的包
   名也算命中），机械口径下按模块级 import 判是 **0 条**，条目数也因 nested-comment 落地从 42 变 43；
② 第一版 L0a 把 font-charset 判成 FAIL，他拿真解释器实跑反证（`C:\Python314\python.exe
   scripts/check_font_charset.py` = exit 0，因为 fontTools 的导入在函数体内、加载期不执行）
⇒ 判据改窄。
**红-绿自证**：临时假仓库三条钩子（要 fontTools 且不自解析 / 同样要但自解析 / 纯标准库）→ 坏的那条判
FAIL、好的判 OK、整体 rc=2；真实仓 → 43 条、forced 缺包 0、候选 fontTools、exit 0；同一预检在 .venv 与
PATH 首位两个解释器下都 exit 0。

文档 §5 重排成**依赖表(§5.2) → 动之前死顺序(§5.3) → 遗留账(§5.4)**（原文按追加顺序把失效顺序插成了
§5.4，读起来先结论后依据；重排时同步修掉块内那条会指错的「见下面 §5.3 第三条」，以及 ci_local 里指向
死顺序却写着 §5.2 的指针——这两处 doc-links 都**静默放过**，因为本文恰好有同号小节，见 §3.5 盲区）。
四种现场（删/换 `.venv`、只换包、换 PATH 首位、改 requirements 约束）逐行钉死「第一现场 / 症状 / 还能
动什么」，回滚按现场分条不混用：freeze 备份放仓外、只 `--force-reinstall --no-deps` 单包不 `-U`、
`pre-commit clean` 会重建别人的钩子环境所以必须先要窗口、最后手段才删 `.venv`（删前记住基底是 Anaconda，
换机复制不出来）。

⚠ 一条与本笔无关的既有红灯（道G 报出，我核过成因）：`check_size_gate.py --local` 现在 exit 1 —— 它按
**git 索引 blob** 生成代码指纹，而工作区正有 comm 道在飞的 `App/protocol/iec104/iec104_comm
.{c,h}` 未入
索引，「同码」必然不成立；**该脚本不是 pre-commit 钩子**（只挂在 ci_local），所以不拦提交，但别人跑
ci_local 会看到它，别误判成 L0a 新加的东西。台账回填等这批在飞代码提交后统一做一次。

自查：py_compile 0、`--preflight-only` exit 0（两个解释器下都是）、`check_doc_links --a
ll` exit 0（198 篇）、
本篇 `--sections-strict` 通过、`id-check --strict` exit 0 且不可判定绝对数 **978 未变**
（写文档没吃余量）、
mojibake / bom(81) / nested-comment(409) 全 0、尾随空白 0。
 2026-10-27 09:42:20 +08:00
wandering1 d286b69a2d chore(工具,文档): 台架 rc 语义与导航硬闸用例、门禁环境诊断、护栏还债算法、mem-budget 跨树口径 
四条道的收尾件同笔（全是 python 工具与文档，零固件源；各段归属按道署明）。

· **台架（bench-runner）**：verify_log.py 新增 classify_measurement() 与 measureme
nt.* 字段，零行/零锚点
  判 exit 2 并打 [MEASUREMENT-BROKEN]，**但同帧有 Forbidden 命中或自检故障仍判 1**（专门造了「零锚点 +
  [ERR] MEMFAULT」的陷阱日志实测——崩溃不许被降级成「没数据」）；--selftest 16 → 22 条。board_ui_nav.py
  把两条执行页安全闸做成 7 条常驻用例接进提交钩子跑的快检档，作者把自己用例**证伪三轮**（测试强制上限、
  清单清空时是崩不是判定、出厂默认被翻允许也照样绿）后三条危险改动逐条能红。台架卫生清单落 §7：每圈复位
  前 open + 断言 ready + 看 rx 增长（今晚 daemon 死了 status 自愈把它遮住）、**Forbidden 令牌不得落在
  英文单词内部**（裸 Fault 命中 default 两次假红）、改判定语义前先 grep 消费者。
· **环境（ui-param-writer）**：证伪卡片前提两处——identify 那个版本根本没有 tags 模块（RECORD 与磁盘逐项
  一致，pre-commit 自己也从 identify.identify 取 ALL_TAGS，全仓零引用），真问题是 44 条 system 钩子里
  42 条 entry 用裸 python → PATH 首位那个零第三方包解释器，今天没炸纯靠两件事同时成立。交付是**新增 entry
  硬规则 + 修复死顺序与回滚并标注等静默窗口**，没有动共享环境（此刻重装会让别人的钩子在半途换解释器）。
· **门禁（gate-docs-fixer 已入库的 51 号钩子）**：本篇带上 host-unit-tests 的裁定句落点说明。
· **内存（comm-config-writer）**：mem-budget skill 补跨树测量身份口径（脚本按 __file__ 定位产物、什么才算
  一次新测量、多链同涨同一数值的共享帧/幻影环归因法）+ 看门狗说明的指针行。

实测：verify_log --selftest 22/22、board_ui_nav --selftest-quick rc=0（硬闸 7/7）、
doc-links --all exit 0、
check_ids --strict exit 0 且绝对数 1,156 **未被本笔吃掉**；全部文件 LF / 无 BOM / U+FFFD=0
；本笔零固件源,
随上一批权威构建验证过（0 错 0 警），故不再单独 @build。
 2026-10-27 05:16:58 +08:00
wandering1 ba40cc0d20 远程 CI 文档独立成 docs/CI/：两篇重叠指南合并为一篇，AGENTS.md 压成一行指针 
动因：远程 CI 只跑在本机一台 runner（win-stm32-ci）上，其他机器与项目都不涉及，
但内容散在 4 处约 2000 行——两篇高度重叠的指南躺在「环境与部署」里与换机核对清单
并列，AGENTS.md 提交门禁节还塞了 4 条 runner 运维经验，导致每次会话都被这些机器
专属细节干扰。

结构：新建 docs/CI/，README.md 作唯一入口（适用范围 + 章节速查 + 常用命令），
远程CI完整指南.md 为合并稿。

- 合并：CI配置指南 477 行 + Gitea_Runner部署指南 917 行 → 一篇 1300 行；骨架内容
  逐行比对核实无丢失（仅章节重编号与相对链接按新位置改写），重复段按"留新版"去重，
  独有内容全部搬入（下载/config.yaml 字段语义/不能用 Windows 服务的根因/内网 action
  三种处置/check_env 自检/TL;DR/排障表 13 条独有行/MySQL 直查核验）
- 再分配：测试流程 §9.2 两个 job 的步骤细节并入指南 §5.5、§9.4 部署前置表并入 §0.2；
  测试流程 §9 只留测试分层视角（覆盖哪些层、触发与 paths-ignore、本地等价、
  "CI 不替代本地门禁"）
- AGENTS.md：4 条 CI 经验（看门狗 / gitlint stage / UTF-16LE / CI 概览）压成 1 行指针
- 引用同步 6 个文件：docs/README 目录树与索引、项目部署环境要求 3 处、本地工具路径
  环境变量方案、待处理内容、scripts/README（补登 3 个 CI 脚本并标注为本机专属）

验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。
两篇旧文档以 git rm 删除（历史仍在 git 中）；各文档变更记录的历史行按仓库惯例不改写，
只新增 2026-10-12 行。
 2026-10-12 14:03:44 +08:00
wandering1 5009a844a9 收敛 reset.bat 到 stlink-flash skill 并删除该批处理
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details 
stlink_flash.py 新增 hard 子命令（-c SWD RM=Hrst -HardRst PULSE=100），
RM= 被 CLI 拒绝时自动降级为系统复位并打印 RESET_NOTE；至此 reset.bat 的
全部子命令（复位/hard/halt/run/list/flash/cmp）均已由 skill 覆盖。

删除 MDK-ARM/reset.bat（git rm）。@build/@download 两条旧批处理入口至此
全部收敛到 .dsh/skills/ 下的 skill，一个能力一个实现。

同步更新引用：AGENTS.md、README、MDK-ARM/README、7 篇 docs、4 个 skill
（stlink-flash/serial-boot-test/new-machine-setup 及 config.example.json）。

真机验证：hard 子命令 RM= 被拒 → RESET_NOTE → 回退系统复位 → STLINK_RC=0。
 2026-10-10 16:41:46 +08:00
wandering1 5defabcabb build: 删除 MDK-ARM/download.bat，烧录收敛到 stlink-flash skill 
- test/run_all_suites.py 是唯一执行它的地方：DOWNLOAD_BAT 改为 STLINK_FLASH
  （.dsh/skills/stlink-flash/scripts/stlink_flash.py）；直烧改
  [py, STLINK_FLASH, "flash"]（原先把 .bat 包给命令行解释器执行）；
  --flash-cmd 改由同一常量拼出，不再硬编码 .bat 路径
- 机制变化（须知晓）：原 download.bat 走 UV4 -f（CMSIS-DAP），现走
  ST-LINK_CLI -P <hex> -Rst -Run —— 与 .serialtest/config.json 的
  flash_cmd、AGENTS.md 烧录铁律、回读 -CmpFile 要求同源；6.5s/1MB
  也快于 UV4 路径
- AGENTS.md / 环境与部署 3 篇 / ST-LINK_CLI 复位说明（原文写"正式流程仍以
  download.bat 为准"，已反转）/ 自动化测试流程 / 串口助手设计说明 /
  链路延迟 / m2_data / README / MDK-ARM/README：引用改指 skill
- .gitignore：download_log.txt 条目保留并注明 legacy（他机残留物不变
  untracked）；build 日志注释同步
- 保留 MDK-ARM/reset.bat：其 hard/halt/run 子命令是 skill 没有的
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-15（史实）
- 验证：run_all_suites.py --dry-run 解析出 skill 路径；doc-links 123 通过
 2026-10-10 16:28:58 +08:00
wandering1 c77c5824f9 build: 删除 MDK-ARM/build.bat，@build 完全收敛到 keil-build skill 
- test/run_all_suites.py 是唯一真正执行它的地方：BUILD_BAT 常量改为
  KEIL_BUILD（.dsh/skills/keil-build/scripts/keil_build.py）；两处构建点
  改传 --timeout（脚本内超时先于 _run 超时触发，超时得 rc=1 + BUILD_FAIL
  文案，而不是被 _run 杀掉）
- AGENTS.md / keil-build SKILL.md / new-machine-setup SKILL.md：删除
  "等价原生入口"口径，改为注明该文件已于 2026-10-10 删除
- 环境与部署 3 篇 / 项目架构总览 / README / MDK-ARM/README /
  download.bat 注释 / check_mem_numbers.py 提示串：移除 build.bat 引用
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-14 / N-18
  （历史审计条目；doc-links 不校验裸文件名，保留不影响门禁）
- 验证：keil_build.py --timeout 300 -> BUILD_OK / rc=0；
  run_all_suites.py --dry-run 正确解析 skill 路径；doc-links 123 文档通过
 2026-10-10 16:23:54 +08:00
wandering1 7a54fdbc73 docs(build): @build 统一为 keil-build skill，build.bat 降为等价原生入口 
- AGENTS.md 构建条：@build = keil-build skill（写明 UV4 解析链、退出码
  0/1/2/3、日志路径）；MDK-ARM/build.bat 明确为等价原生入口，并列出
  它相对 skill 缺的三项（无超时保护 / UV4 只认 DTU_KEIL_UV4 / 失败 dump 整份日志）
- keil-build SKILL.md「本仓库」段同步：skill 即 @build 口径
- 3 个 skill（new-source-file / ui-verify / new-machine-setup）与 8 篇
  docs、README、MDK-ARM/README、环境与部署 3 篇：命令示例与 @build
  标识统一改指 skill
- scripts/stack_report.py 的构建提示串改指 skill
- 环境与部署：DTU_KEIL_UV4 使用方补 keil_build.py；反向测试期望的报错
  文案对齐 skill 实际输出（BUILD_ENV_ERROR: ... is set but not a file）
- 刻意未改：docs/问题记录/项目审查与优化建议报告.md 的 P2-14/N-18
  历史审计条目（属史实记录）；test/run_all_suites.py 的 BUILD_BAT
  常量（是代码、非文档，改动需另做验证）
 2026-10-10 16:19:14 +08:00
wandering1 554b2e88da 方案文档改造为机制说明：删除规划/盘点/阶段/风险/任务拆分章节，保留变量清单/解析语义/配置方法/验收判据，外部引用同步重编号 2026-10-02 23:21:25 +08:00
wandering1 bf025e6f10 模拟器构建修复：CMakeLists配置引擎引用同步至App/cfg/与test/board/（重构遗留），--cfgtest四场景PASS，跨机验证清单⑤行更新 2026-10-02 23:09:53 +08:00
wandering1 401908c062 环境文档增补跨机验证清单：项目部署环境要求新增§2.12（变量配置+六步验证链+反向fail-fast测试+通过判定），方案文档待办项交叉引用
CI / L0 静态门禁 (pre-commit) (push) Failing after 25s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 29s
Details
2026-10-02 22:29:49 +08:00
wandering1 33a4aa4945 本地工具路径DTU_*环境变量改造落地：10处调用点去硬编码+变量优先解析，本机全链路验证通过，文档同步收口，requirements补pre-commit 2026-10-02 22:14:49 +08:00