 wandering1
|
3965eb3f28
|
feat(门禁): bom-guard 机械化 BOM 漂移，附 setview-check 行表一致性
把 AGENTS 铁律第 2 条从"人工逐文件比 HEAD"变成提交硬闸：HEAD 有 EF BB BF 而工作区没有 → FAIL。
2026-10-25 一天之内道E 在 task-15 里连踩 4 次、道B 批 1 踩过 1 次，此前全靠人记得做审计兜底——
人工审计只防得住记得做的人，这正是它该变成门禁的理由（票 = task-20）。
scripts/check_bom_drift.py（纯标准库）
- 判定只有一条：HEAD 前 3 字节是 BOM 而工作区不是 → 列出文件与补救动作，不含二义措辞。
- 两条刻意不报（票面要求的边界，--selftest 逐条自证）：① HEAD 里根本没有的新文件无 BOM 不误报；
② HEAD 无 BOM 而工作区加了 BOM 也不报——那是另一个方向的改动，可能是有意的（把文件纳入名单），
报红只会逼人 --no-verify，而"养成绕门禁的习惯"比漏检一次贵得多。
- 一条刻意不做：不自动补 BOM。正确修复是在文件最前面加 3 个字节；脚本整文件重写会按系统默认编码
重打中文，把可修的丢 BOM 变成不可修的 U+FFFD（AGENTS 铁律第 1 条那条更大的坑）。补救文案里把
这句完整写出来了——报错信息的作用是让踩的人当场做对动作，不是让他知道有人不高兴。
- 名单三处互指：AGENTS 铁律名单 / 本钩子 files 正则 / 脚本内 BOM_LIST，每次运行核一次；单独改任何
一处都会在别人的提交里被拦下。名单散在三处而无人同步，等于没有名单。
- --selftest 在临时 git 仓库里跑 4 条判定（含上述两条边界 + 主用例 + 名单外文件不参与），全过。
setview-check（Lead 指令：并入 task-20 同窗机械化）
- 核 Drivers/BSP/UI/ui_w_setview.c 的四张视图表与 App/algo/prot_set 枚举序、
g_prot_set_meta 上下限是否同一份口径：id 恰好覆盖 0..39 各一次 / 数值行 min-max
等于 meta 换算 / kind 与 is_ctl 一致 /
单位纯 ASCII / 小数位查表与行表一致。机械化的理由不是"多一道保险"：BSP 侧看不到 App 头，
行表里的 id 是裸数字 + 行尾注名，这条对齐在编译期**物理上无法自证**；而页面上只有当前可见
的 8 行会被像素断言看到，错位要翻到第 2、3 页才可能被人发现——那时它已被黄金参考钉死了。
- 跨分支先后写成注释：脚本文件随 task-15 分支合入主干；在此之前 files 永不命中 → 钩子自然 skip
（skip 不是失败），合并后自动生效，不需要任何人再动这条配置。
AGENTS.md（票面授权：只加一句机械化标注；下面实际动了两处计数，一并申报）
- 铁律第 2 条末尾加"已机械化：bom-guard 钩子"+ 三处互指一句。
- 钩子计数 46 → 48 两处同步（不同步就是让 AGENTS 说谎）；并在文档索引行标出"bom-guard /
setview-check 两篇待补"，把欠的详解篇目挂在明面上，不留沉默债。
验证
- 本笔**未用 --no-verify**：全量 pre-commit --all-files 46 项 Passed、0 Failed（含两条新钩子）。
- 端到端实测（不止 --selftest 自证）：真把 Drivers/BSP/UI/ui_w_records.c 的 BOM 剥掉并 stage →
bom-guard rc=1 并打印补救动作；还原后该文件与 HEAD 逐字节相同，工作树干净。
- 顺带发现并行开发方案的一条空白（本笔未修，写域之外）：全新工作树没有 .map，mem-numbers 会因
"找不到 .map 真实源" FAIL，跑一次 @build 才绿。门禁隐含的"本树必须先构建过"前提在
docs/环境与部署/并行任务工作树方案.md 里没写；已回报 Lead 定夺归属。
- 自报一条：本笔第一次提交被 gitlint 拦下——正文有一行 92 > 80，**我量出来了却仍然按了提交**。
记在这里是给下一篇门禁详解留素材：这条门禁拦下过的人里也包括写门禁的人自己，而「拦下过
什么真事」那一栏不该只挑别人的事写。
|
2026-10-25 14:36:50 +08:00 |
|