.pre-commit-config.yaml

@@ -608,9 +608,11 @@ repos:
       #    口径 / 分母 / 基线 / 盲区详解都在 docs/测试说明/主机单测覆盖率口径.md，本处只留接线事实。
       #    触发面**含门禁自身**（.pre-commit-config.yaml）：不带自身就等于谁改坏这根闸的 files:
       #    模式，它就再也不跑且无人察觉（同 lv-conf-sync / bsp-err 的既有做法）。
-      #    待证（不要把下面三行当结论；本次提交就是判定实验，结果确定后改写）：改 files:
-      #    的配置管辖**——所以"删掉自触发"这一刀会被旧配置拦住（旧模式仍含本文件，钩子照跑），
-      #    而新加的模式要等下一次提交才生效。方向正好是对的：加固会迟到一步，拆除不会漏网。
+      #    ⚠ 读输出的坑（2026-10-24 连踩两次才定位）：本钩子没写 stages: → 默认属于**所有阶段**，
+      #    于是同一次提交的输出里它出现两次：pre-commit 阶段那一遍才可能实跑；commit-msg 阶段
+      #    那一遍的"文件"是提交信息文件，几乎必然 (no files to check)Skipped。**只看输出结尾会
+      #    把"实跑通过"读成"根本没跑"**——判它跑没跑要认**第一次**出现的那一行。
+      #    实跑证据：只改本文件的提交（e327636 / c4ca292）里 test-coverage 与 bsp-err 都是 Passed。
       - id: test-coverage
         name: 主机单测覆盖率（增量拦截：已覆盖行只增不减）
         entry: python scripts/check_test_coverage.py

docs/代码规范/pre-commit使用说明.md

@@ -89,6 +89,11 @@ git commit
 | 机制 | 口径 |
 |---|---|
 | **两个阶段** | pre-commit 阶段 39 个钩子 + commit-msg 阶段 `gitlint`；`default_install_hook_types: [pre-commit, commit-msg]` 是显式声明的——换机后 `pre-commit install` 才会带上 commit-msg 钩子 |
+| **一根钩子在输出里出现两次** | 未声明 `stages:` 的钩子**默认属于所有阶段**，pre-commit 与 commit-msg
+  两遍都会列出它；第二遍的"文件"是提交信息文件，几乎必然 `(no files to check)Skipped`。**只看
+  输出结尾会把"实跑通过"读成"没跑"**——判某钩子跑没跑要认它**第一次**出现的那行（实测
+  2026-10-24：只改 `.pre-commit-config.yaml` 的提交里 `test-coverage` 与 `bsp-err` 都是 Passed，
+  尾巴那一遍是 Skipped） |
 | **stash 陷阱** | pre-commit 跑钩子前会 stash 未暂存改动，钩子看到的是"没有你中间状态"的树。**改代码 + 同时更新基线/受管区的，必须先 `git add` 再跑钩子**，否则会拿到假报警（本仓踩过，`docs/门禁说明/bsp-err.md` §4 记了现场） |
 | **`always: true` 已废** | pre-commit 4.x 对 `local` 钩子里这个键**只告警 `Unexpected key(s)` 然后忽略** → "想总是跑"只能把 `files:` 写全（教训 → §5.5） |
 | **改写型与只读型的豁免不对称** | YAML 锚点 `&cubemx-generated` 只豁免 `trailing-whitespace` 与 `end-of-file-fixer`；`cppcheck` / `no-mojibake` / `cubemx-survival` / `task-table` / `mem-numbers` **仍覆盖** `Src/`、`Inc/` |