From a583c36a88a91068956bb292b3c19f07c84abc64 Mon Sep 17 00:00:00 2001
From: Wanderingss <1624155937@qq.com>
Date: Wed, 28 Oct 2026 08:05:21 +0800
Subject: [PATCH] =?UTF-8?q?docs(=E9=97=A8=E7=A6=81=E8=AF=B4=E6=98=8E):=20?=
 =?UTF-8?q?=E8=A1=A5=E5=85=85=20nested-comment=20=E7=9A=84=E8=A7=A6?=
 =?UTF-8?q?=E5=8F=91=E9=9D=A2=E5=8F=A3=E5=BE=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

本次只改一处中文 Markdown，未触碰 C 源码、头文件与 Keil 工程档案。
因此不跑 @build；提交门禁按文档口径只跑 doc-links 与 pre-commit 命中的钩子。
只暂存这一个 Markdown 文件，让 51 个钩子按 files 与 types 只命中文档相关那几根。
工作区另有两份文档的在飞改动与两份未跟踪脚本，一律不纳入本次提交。
提交正文由 UTF-8 无 BOM 文件承载，经 git commit -F 传入仓库，不走 -m 参数。
原因是 Windows 终端代码页会对命令行参数转码，中文可能变成不可逆的乱码。
正文按每行不超过 80 字符书写（.gitlint 口径），标题不超过 100 字符，中间空行。
正文行不以 # 开头，否则会被默认的注释清理规则删掉；行尾统一 LF 且无尾随空格。
Markdown 改动用精确子串替换落盘，保留文件原有 BOM 状态与行尾，不整文件重写。
落库前后都按字节统计 EF BF BD，结果必须为 0，不信终端与编辑器的渲染结果。
---
 docs/门禁说明/nested-comment.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/门禁说明/nested-comment.md b/docs/门禁说明/nested-comment.md
index 8c104168..586e69f3 100644
--- a/docs/门禁说明/nested-comment.md
+++ b/docs/门禁说明/nested-comment.md
@@ -53,6 +53,7 @@
 钩子用 `types: [c]`（即 .c/.h），第三方与生成物由配置顶层 exclude 挡掉。
 脚本的 `--all` 与钩子喂进来的文件集**刻意同口径**（2026-10-27 实测 403 个文件）——
 手跑面与提交面不一致，就会变成「两个数」，本仓已经为这种事返工过好几轮。
+纯文档（.md）或纯 Python 的提交不会命中本闸——`types: [c]` 只喂 .c/.h 两类文件，想确认全仓干净就手跑本节的自查命令。
 
 单独自查：`& .venv\Scripts\python.exe scripts/check_nested_comment.py --all`