 wandering1
|
2525c2d948
|
docs(104): 端口口径统一成「工厂默认」，登记「改后立即重 bind」待办
用户裁定两条：① 剩余裸写端口的地方加「工厂默认」限定词，不改固件行为；
② 生效语义按需求口径「保存即生效」定，现实现（端口下次重 bind 才生效）是
要改的一侧 → 建任务登记，本笔不动代码行为。
限定词（24 处 / 17 文件）：AGENTS 数据主线、App/protocol/README、根 README
文档索引、Src/freertos.c 三处任务注释、docs/README、项目启动顺序管理、存储
架构说明、软件架构与运行时规格（2）、RAM 使用分析、产品需求设计文档（5）、
项目架构总览（3）、test/host/README、iec104_master 流程注释、IEC104 上行设
计说明、继电保护功能复现规划。配图两张同批重跑：gen_arch_svg.py 与
gen_memory_svg.py（脚本与产物同一笔）。
两处陈旧计数（都做过双源核证）：
- 测试开发标准流程 像素层「60 内容页」→ 内容页黄金参考 66 张（64 页）；
双源 = simulator/tests/ref/shot_*.bin 实数 66 与 check_content_pages.py
的 PAGES 66 条（含两个 _p2）。
- .pre-commit-config.yaml 的 uinav-selftest 注释「18 张黄金参考」→ 写成
「接线当时 18 张、现 66 张」：git log -S 定到 6a904c1b（2026-10-25），那
天 ref 目录确实 18 张，写时为真，但它描述的是钩子现有行为，属当前态。
口径修正与登记：
- 页面扩充详细方案「通讯设置 = 无配置模型（端口与 CA 都是 #define）」→ 标
「当时」，并写明现已在 /config.ini 的 [comm] 段可配、UI 通讯设置页可改。
- 产品需求 §通讯配置：删掉「改后需重启生效」这句把两件事混为一谈的话，改成
需求要求「保存即生效」+ 现实现（公共地址重启、端口下次重 bind）+ 指向登记簿。
- docs/任务规划/登记簿.md §1 新增「104 端口改后立刻重 bind」：含隐性耦合
—— .serialtest/config.json 的必检锚点写死 listening on 2404，端口一改串口
回归必假失败；改行为时要么锚点只查 listening on，要么由脚本注入端口。
复扫（旧形态归零判据）剩 20 处未带限定词，逐条定性为刻意不改：默认值定义处、
出厂模板与断言、usage 与 argparse default、UI 黄金参考显示值、台架主站地址
（同数不同义）、串口锚点、叙事句、引用关系图坐标。逐条理由见一次性台账。
门禁：check_doc_links --sections-strict 对 16 篇改动 .md 逐个 rc=0；
check_mermaid --all 31 文件 62 围栏新发 0；check_nested_comment --all 449
文件新发 0；check_bom_drift --all 99 个名单内文件无漂移；
check_generated_fresh PASS（25 生成器 / 21 一致 / 4 只减不增基线）；字节体检
无新增 BOM / CR / U+FFFD / 行尾空格（三连空行与 HEAD 逐项相同 = 存量）。
/keil-build 0 错 0 警，Program Size Code=246720 RO=29836 RW=2052 ZI=149708
与凭证同码：本笔只碰注释与配图文字，无固件行为变更。
|
2026-10-30 15:40:27 +08:00 |
|
|
wandering1
|
e4d70f9fcb
|
docs(真值): 勘查 13 条文档/代码不一致全部处置（10 改 3 核实）+ 补 3 处
证据源 = 主树 ci-artifacts/archify/architecture-dtu-overview-20261030-095132/
evidence.md §11。该目录不入库，故把每条的判据与实测源抄进正文，别让证据只活在
一台机器上。处置口径：能改的改成与代码同源，核实后确认文档没问题的明确写「不改」。
判停点与就绪屏障（条 1、条 3）
- AGENTS 原写 `protect_task.c:98` 直接停走判据：`:98` 是 `s_prev_cal_lock` 变量，
判停点是 `App/task/protect_task.c:268 if (adc_cal_prot_blocked() != 0u)`，
判定本体在标定层 `adc_cal_prot_blocked()`、protectTask 只是消费者 → 改引用，
同步 `ui_task.c:240` 页面注释与 `docs/任务规划/数据可信.md` 的同一处行号。
- `SYS_EVT_FTP_READY` 有生产者（`Src/freertos.c:490`，注释自陈预留）无消费者；
`SYS_EVT_TIMESYNC_READY` 全仓无生产者也无消费者（只有定义与测试桩）。
AGENTS、`sys_events.h` 位注释、屏障配图（生成器 + 产物）三处从「四个就绪位
并列」改成「bit0/bit1 在用 + bit2/bit3 预留」，并指向
`docs/架构设计/项目启动顺序管理.md` §3.2 的逐位对照表。ftpTask 实际等的是
`NET|STORAGE`（`Src/freertos.c:477-479`，WaitAll|NoClear，100 ms 分片喂狗）。
/log 不是「三本」（条 5）
- `App/log/sys_log_mcu.c` 的 `s_paths[]` = run / selftest / accid / alarm /
start / oper / yk 七本 64B 定长文本 + `soe.log`（64B 定长二进制）+ `wdev.log`
（变长取证行，`App/fs/vol_lock` 侧投，不走定长格式）。
→ AGENTS 两处、总览 §2.1 与 §4 的「三本」改成「七本 + SOE（+ wdev 取证行）」。
主机单测 44 套 → 47 套（条 2，两把机器尺互证）
- `scripts/check_test_coverage.py --list` 打印 47 行；`ls -d test/host/*/` = 48 个
一级目录，唯一没有 `run_unit_test.py` 的是 `common/` ⇒ 47 套。
- 差额三名 = 屏板链路套件：`sb_proto`、`sb_link`（2026-10-29 入库）、
`sb_led_map`（2026-10-30 入库）。专属钩子仍是 22 根 ⇒ 无专属钩子的从 22 套变 25 套。
- 同步面：AGENTS、`docs/门禁说明/README.md`、`host-unit-tests.md` §6 台账（名单补
三名）、`docs/代码规范/pre-commit使用说明.md`、`主机单测覆盖率口径.md`（含耗时句）、
`scripts/README.md`、总览目录树、`.pre-commit-config.yaml` 三处注释、
`test/host/sys_log_mcu/sys_log_mcu_test.c` 一处注释。
- 带日期戳的历史测量值按纪律冻结不动：28 套、41 套 ~105 s、40 套/18 套那三处。
本仓 LVGL 版本（条 6）
- vendored 版本 = `Lib/lvgl/lv_version.h:9-11` 的 9.3.0；总览两处「LVGL v9.2」与
`gen_arch_svg.py` 图内文字改 v9.3 并重跑产物（脚本与产物同一笔，`generated-fresh`
逐字节核）。
- **刻意不动**：`docs/内存管理/RAM使用分析与优化方案.md` 两处「LVGL v9.2 文档」+
GitHub `release/v9.2` 分支 URL ——那是对外游某分支文档的引用，不是本仓版本声明。
触发口径与栈值（条 4、7、9、10）
- ADC 映射 §1「ADC1 为软件触发」是旧口径：`Src/adc.c:53` 实为
`ADC_EXTERNALTRIGCONV_T3_TRGO` → 改成 TIM3 TRGO，并补一句「TIM3 与 TPAFE 的
CONVST 之间没有硬件耦合，仍不构成共同采样触发」，缺陷结论本身不变。
- 同文档 adcTask 栈 512 → 640 words（`Src/freertos.c:159 .stack_size = 640 * 4`）。
- `docs/UI设计/UI_设计架构.md` 的 uiTask 栈「16384 words」是单位错：
实为 4096 words = 16384 B（`Src/freertos.c:218`），顺手补上行号。
- `App/app/app_main.c:197` 注释「DE = PD0」陈旧：`:198` 实传 `ST_DIR4_*`
（V0.1 实板 PA15，V0.0 才是 PD0）→ 注释改指 V0.1 网表报告的引脚迁移表。
- 两处已退役编号 `N-18`（ADC 映射、V0.1 网表报告）换成登记簿条目名
「双转换器无共同采样触发」。
核实后确认「文档没问题」的三条（条 8、12、13）
- 黄金参考「菜单 8 状态 + 内容页 66 张」：`simulator/tests/ref/` 实测 66 个
`shot_*.bin`，与 `ui-golden` 钩子显示名一致 → 不改。
- `App/task/rs485_task.c` 存在但 `Src/freertos.c` 不创建它（grep 无 rs485）：
AGENTS 与总览都已写明「尚未接线 / 暂缓」，图侧画成「实现待接线」→ 不改。
- 104 端口 `:2404` 是工厂默认、可经 `/config.ini` `[comm]` 改 → 总览索引表补
「默认」二字；「uiTask 10 ms 节拍」核实 = `ui_tokens.h:65 UI_TASK_TICK_MS 10` ✓。
并行勘查会话的同族发现（它扫「文档声明数 vs 真值」，逐处独立复验后采纳 3 处）
- `App/protocol/iec104/iec104_link.h` 头注释写「端口：TCP 2404（§1.5 B0 定义）」，
同文件下方已写「服务端口真源已迁 [comm] 段」= 自相矛盾 → 补「工厂默认」并指回
[comm] 与「下次重 bind 即生效」。
- `scripts/gen_task_table.py` 的 iec104Task 描述「:2404 监听」→「工厂默认 :2404
监听」，`--write` 重生成 README 任务表（AGENTS 表无描述列，实测未被改写）。
- `App/log/README.md` 五行写入点行号全漂：事故 181→188、告警 184→191、启动
176→183（`App/task/protect_task.c`）；操作 `iec104_pts.c` 574/602→582/610、
`default_task.c` 242→266、`sys_log_mcu.c` 646→682；遥控 573/576/582/586/596/
598/609 → 581/584/590/594/604/606/617（宿主 `sim_syslog.c:245` 原值正确、未动）。
- **撤销一条**：我早先记的「`docs/算法/继电保护功能复现规划.md:225` 声称记录本已
有消费者」与原文不符——:225 实为规划表里「动作/SOE 记录 | 复用 `sys_log`」一行，
属能力复用口径、不是当前态断言 → 不改。教训：**改引用前逐处读现文，别照自己
上一轮的笔记盲替**（这条比改中的每一处都值钱）。
- 同一批勘查还报了约 12 处「`2404` 缺『工厂默认』限定词」（AGENTS、`App/protocol/
README.md`、`Src/freertos.c` 注释、5 篇 docs、`test/host` 工具，含一张配图生成器
要连产物同批重跑）与 `测试开发标准流程.md`「像素层 60 内容页」、
`.pre-commit-config.yaml` uinav 注释「快检档 18 张黄金参考」（后者写时为真、
描述的却是钩子现有行为）：**本笔刻意不做**，另开任务空间处理——那批要同时动
AGENTS.md 与 `.pre-commit-config.yaml` 两处单写者面，与并行会话撞车的代价更高。
- 端口生效语义（用户裁定 2026-10-30）：产品基线写「公共地址与端口可配…改后需重启
生效」，代码 `App/task/iec104_serv.c` 是「ca 改后要重启；port 下次重 bind 才生效」
——裁定**按代码语义要改**处理（改了端口应立刻重 bind），属固件行为变更，另开任务
且需真机验证；`.serialtest/config.json` 写死 `i104: listening on 2404` 必检锚点
是同题（现场改端口会让串口回归假失败），一并留给那条任务。
自查（任务树内）
- `check_doc_links.py --sections-strict`：12 个改动 .md 逐个 rc=0；
`check_mermaid.py` 改动 .md 全 rc=0；`check_generated_fresh.py` PASS
（25 个生成器 / 21 一致 / 4 存量基线）；`check_nested_comment.py --all` PASS
（449 文件，新发 0、存量 2）；`check_bom_drift.py --all` 99 个名单文件无漂移。
- 编译：`.dsh/skills/keil-build` 退出码 0（0 错误 0 警告），
Program Size Code=246720 RO=29836 RW=2052 ZI=149708 —— 与本树凭证同码，
证明这批改的确实只有注释与文档。
- 字节体检：23 个文件无 CR / U+FFFD / 行尾空格 / 缺末行换行；`ui_task.c` 被编辑后
丢的 3 字节 BOM 已补回（bom-guard 复验通过）；5 处「三连空行」逐文件与
HEAD 比对确认是存量（Python 生成器的 PEP8 双空行与个别 C 文件原有空行）。
- 一次性工具 `ci-artifacts/fix_docs2.py`：断言式规则表，按文件读一次、在演化文本上
逐条替换、一次写盘。第一版写成「每条规则各自从启动时快照起算」，同一文件后一条
把前一条整体覆盖，只有每文件最后一条活下来——靠「改完再全仓复扫旧形态」当场抓到，
这条判据本身已值得写进流程。
- 待办：`git add` 后需重跑 `ram_baseline.py --update`（体积凭证按 git 索引内容生成，
未 staged 的文件不在凭证里，`check_size_gate.py --local` 现在因此报红）。
- 未 commit、未 push（AGENTS.md 边界：提交属 Ask first）。
|
2026-10-30 14:19:35 +08:00 |
|
|
wandering1
|
aed842e1f2
|
Merge branch 'v2-on-ui' into task/archsplit-sw-hw
# Conflicts:
# docs/架构设计/软件架构与运行时规格.md
|
2026-10-30 13:32:52 +08:00 |
|
|
wandering1
|
00fe66a029
|
docs(架构设计): 系统架构与硬件规格拆为软件与硬件两档，软硬件分治
用户裁定（2026-10-30）：合档拆成两部分，软件与硬件不混排。
- 软件侧（新 §1~§6）= 分层 / 任务模型 / 就绪位表 / 启动时序 / 线程通信 /
工具链与工程约束 → docs/架构设计/软件架构与运行时规格.md
- 硬件侧（新 §1~§5）= 主控内存 / V0.1 引脚表 / 存储器件 / 版本兼容 /
能力边界 H1~H5 与量纲口径 → docs/架构设计/硬件规格与能力边界.md
- 旧 2.1 的 RTOS / 工具链 / CubeMX 三行迁入软件档 §6.1；旧 2.5 五条工程
约束归软件档 §6.2，SDIO 一条归硬件档 §5 H5（同事实不再两处并存）。
- 存储器件小节的 BBT / 单写者 / FatFs 三条细则不与权威档重复，改为指向
存储架构说明与软件档 §2。
- 引用重挂：AGENTS 引脚行→硬件档 §2；docs/README 3 处；需求档 7 处
（「架构硬件档」别名一分为二「软件架构档 / 硬件规格档」）；复刻明细
2 处；section_aliases.json 两键改四键。
- 两档尾部各留裸号换算注（旧档号不带 §，避免与本文编号体系混淆、且
doc-links 自引用 strict 必拦）；旧档名全仓零引用。
门禁：树内 check_doc_links --all --sections-strict 剩 35 处全部为
simulator/SDL2 联接「名称含空格」假红（主树同命令 rc=0 干净），本笔
文件新发 0；mermaid 预检新发 0；七文件 BOM/CR/U+FFFD 全零。
|
2026-10-30 13:08:44 +08:00 |
|
|
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
|
dc964090ea
|
docs(产品需求): 需求基线拆薄为三档（大厂标准），doc-links 增别名解析
产品需求设计文档.md v1.9 → v2.0（2691 → 1816 行）：
- 新增 §2 背景·目标用户·典型场景·成功指标，§3.2 产品级非目标表，
§4 P0/P1/P2 需求总览（19 行）；§9 收窄为缺口清单与推进顺序。
- 拆出 docs/产品需求/参考产品复刻明细.md（803 行）：复刻基线 +
定值/遥测/开入开出/事件/元件/录波/记录/规约逐项差额与完成判据。
- 拆出 docs/架构设计/系统架构与硬件规格.md（215 行）：运行时架构
（就绪位表/机制表/启动时序）+ V0.1 硬件规格；与项目架构总览
定分工——位表/机制表/时序图/引脚表以新档为准。
引用同步：AGENTS.md 引脚表指针改指系统架构与硬件规格 §2.2；
docs/README.md 目录树与索引四处重写；故障录波三处「录波采样率」
行指针改指复刻明细 §7；PRD §11 补两新档指针。
门禁工具：check_doc_links.py 裸名解析增别名后缀匹配（「见需求档
§5.16」形态），§ 链遇紧邻已登记别名换目标；section_aliases.json
登记 需求档 / 架构硬件档 / 复刻明细(档) / 产品需求设计文档 /
系统架构与硬件规格。
终验：doc --all rc=0（3038 处 / 可判定 80%）；mermaid --all 64 围栏
0 命中；改动文件字节卫生全过；新旧逐行差集审计无丢行。
|
2026-10-30 12:36:31 +08:00 |
|
|
wandering1
|
f8e62a9ba2
|
feat(门禁): 新增 mermaid-syntax 钩子，围栏内确定性语法提交前必拦
- scripts/check_mermaid.py（纯标准库）：R0 围栏未闭合 / R1 图类型头缺
错 / R2 -. 后直接跟管道（确定性语法错误形态）/ R3 subgraph 与
sequence 块的 end 计数配对；--all / --selftest（5 形态）/ --prune；
排除面与 doc-links 同口径；零语料空基线
- 接线 .pre-commit-config.yaml（doc-links 后），docs/门禁说明/
mermaid-syntax.md 专篇（八段结构含限制与盲区），README 索引与
AGENTS.md 计数 51→52、提交期实跑 48→49
- 门禁说明 README 顺带修正两处历史矛盾：gitlint 实际就在本配置
（commit-msg 阶段），旧文「52−3−gitlint」与「gitlint 不在配置里」
均过时——锚定口径 52 = 47 pre-commit + 3 manual + 1 commit-msg，
加钩后 48 + 1 = 49；三处 grep 争执例句改抽象表述（例句里的数字
自己会过时）
- docs/子系统设计/屏板链路设计说明.md:38 修复触发本钩子的坏图：
-. 后直接跟管道不是合法边 operator，改为 -.->|label| 形态
实测：YAML 解析 52 / commit 阶段枚举 48 行全 Passed（含新钩子）/
check_mermaid --all 29 文件 60 块围栏 0 命中 rc=0 /
check_doc_links --all rc=0（215 文档）/ 六文件无 BOM/CR/U+FFFD。
|
2026-10-30 11:03:58 +08:00 |
|
|
wandering1
|
2be49dc9dd
|
docs(skills): 明确 @build/@test/@task 为文档别名并新增 precheck/postmerge 命令
CI / 静态门禁 (pre-commit) (push) Failing after 3m45s
CI / 主机侧单测 (MSVC) (push) Failing after 43s
AGENTS.md「构建与验证」新增总口径：@build / @test / @task 都是本仓库的
文档别名、不是 shell 命令（2026-10-30 实测：bash 敲 @task / @build 即
command not found，dsh task 被解析成 profile 名报错）；`=` 后的命令行
才是可执行形态，DSH 会话显式调用为 /keil-build、/serial-boot-test、
/task-worktree。
- AGENTS.md / docs/README.md / 并行任务工作树方案.md：@task 三处定义位
由「短命令」统一改为「文档别名」，并写入两种实测失败形态
- keil-build / serial-boot-test SKILL.md：定义位点破别名性质；@test 在
skill 内原先没有定义句，补口径 blockquote
- task-worktree SKILL.md 与 reference/：whenToUse、标题、症状表、插件桥
去 @task 前缀改指 list / 本 skill；frontmatter 能力清单同步
- task_worktree.py 新增 precheck（树内只读自查：BOM 漂移 / CR / U+FFFD、
docs 逐档门禁、--msgfile 消息 BOM/CRLF/行长/禁词检查，自动补
ci-artifacts/）与 postmerge（主树体积凭证自动诊断：新鲜跳过、红先短链
再只读复检裁定是否升全链；check_doc_links --all；列文件不代提交）
- done 快路径打印与门禁拦截提示均指向 postmerge
实测：precheck 对坏消息文件抓到 CRLF、行长 95>80、禁词×3（rc=1）；
postmerge 端到端「凭证同码新鲜→跳链→doc --all 绿（2967 章节引用 /
214 文档）→列 dirty 文件」rc=0；check_skill_size.py 与 py_compile 通过；
frontmatter 改动后 DSH 已用新值真加载过一轮。无 .c/.h 改动，不涉及体积。
|
2026-10-30 10:25:05 +08:00 |
|
|
wandering1
|
f754d59218
|
docs(测试说明): 按用途分六个子目录并同步全库引用
分层：流程与规范/ 单元测试/ 板级测试/ 专项验证/ 测试工具/ 测试数据/，
顶层只留新增的目录导航 README.md（归层判据 + 硬约束 + 本次处置记录）。
- 搬迁 28 个路径：测试数据三个目录 58 个文件为纯改名（R100，内容逐字节不变）
- 全库引用同步 124 个文件：AGENTS / docs 索引 / skills / 门禁注释 / scripts
- 门禁面：scripts/check_test_traceability.py 的 glob 改 rglob
（分层后不递归扫描＝追溯门禁直接瞎掉）
- scripts/rename_ref.py：收尾的 ℹ 提示在 GBK 代码页抛 UnicodeEncodeError，
让进程以退出码 1 收场而改写其实已落盘（RC 与真实结果相反）；改为把
stdout/stderr reconfigure 成 UTF-8，与 check_doc_links.py 等同法
- docs/文档规范.md §1.1 补「子目录文件过多时再分一层」；§3.6 补 rename_ref
搬整目录的两个实测坑：① 会改写目录内部文件的内容 ② 内部文件的 ../ 出链
不补层级（本次 23 个被误改的证据文件已按 HEAD 原始字节逐字节还原）
- docs/README.md §6 改为与六个子目录一一对应，并补登原先漏登记的
「启动日志原子性复验流程」一行
- .cubemx_survival_baseline.json：App/util/task_watchdog.c 的注释路径也随分层更新，
该文件是存活审计的 watchdog-module 漂移锚点，按脚本自己的提示跑 --write 重建基线
（实测重建后仅 watchdog-module 一条哈希变化）
- 铁律 4 例外（本次在任务树里改了单写者文件）：AGENTS.md 与
.pre-commit-config.yaml 只被 rename_ref 改写路径字面量（后者全在注释行），
任务表块与钩子声明一字未动
验证：check_doc_links.py --sections-strict 覆盖全部 88 个改动 .md 全绿；
check_test_traceability.py 输出与主树逐行一致；196 个文本文件无 BOM、无新增
CR、无 U+FFFD、无行尾空白；陈旧引用面由主树 25 处降到 6 处（无新增断链）。
|
2026-10-30 07:16:07 +08:00 |
|
|
wandering1
|
20617a33f7
|
docs(编号规范): 编号一律停发——§4.1 五族也不再发新号，只读存量
用户裁定（2026-10-29）：「啥号都不发」= 任何族都不再新增编号，
含 §4.1 那五个原本"有脚本按字面量匹配"的存量族；既有号只读引用，
族里新增内容一律写语义行名。
规范本体：
- §1 由「先问三句」改成「默认答案：不发号」，三问表换成场景对照表；
- §4.1 由「允许用号的族」改成「存量族」，第四列改「既有号被谁读 /
新写怎么办」，逐行写明新写怎么做（TRAP 写语义行名、FR 用 §5 行名、
CODE-RULE / MENU-STATE 先问用户、P-n 只读存量页号）；
- 末框四条对照 + 唯一例外入口（确需机器按字面量匹配 → 先问用户）；
- 新增族 = 一律不许；批准后顺序：本文 §4.1 → 属主文档 → 才动 registry。
跨文件同步（12 份）：门禁说明 id-check-new / id-check / host-unit-tests
（把"校验 5/3 拦新号"这类现状叙述历史化）、两份 TRAP 记录的编号口径、
开机账本用例号说明、AGENTS 两处、id-family 技能与其 steps-alpha 模板、
归档 README 与两份归档脚本 docstring。
AGENTS 主题表那行原写「允许用号的 7 个族」，与规范的 5 行本就对不上，
旧计数一并消掉。
未做：pre-commit 的 default_stages 一行——用户对该项未置可否。
验证：py_compile 与 check_ids_new.py --self-test 均 rc=0；逐篇
check_doc_links.py --sections-strict rc=0（编号规范 70 处引用 /
68 可判定 / 无法判定 0）；13 份改动文件表列数与字节体检相对基线零新增。
|
2026-10-29 21:31:42 +08:00 |
|
|
wandering1
|
f8d795c387
|
docs(编号规范): 按机器面退役改写规范正文
依据（逐条回配置核实）：三处配置里 id_registry / check_ids /
id_known_backlog 命中数全为 0，没有任何活物再读编号登记；
check_test_traceability.py 存在但没被任何配置跑；变更记录例外
清单实测只剩 5 篇。
改写要点：TC 框把「registry 带游标所以允许发」改成裁定留痕并
明写别把不报错读成允许发号；删掉探针行与自相矛盾的 7 行；
§4.1.1 四处现在时（已冻结 / 越游标即拦 / 发号口已关闭 / 校验
错误级）改历史口径，中文前缀族改成「从来没有机器面」；§4.3
点明冻结前缀是档案不是闸门；§5.1 三步改成「族落在 §4.1 之
内 → 属主登记处写定义行 → 才允许引用」；§5.5 删掉「门禁已
豁免」口气并不再复述份数；§8 标题改「一道也没有」；§8.5 由
退役路线流水表整体替换为「手工普查与恢复机器面」（两条归档
命令 + 恢复成本三步 + 退役理由与 WAVE00 误拦），§8 / §8.5
编号刻意保留以免外部引用断链。
指针同步：AGENTS.md 与配置注释里的「§8.5 路线」改成新节名；
id-family-semantic-migration 的 SKILL.md 与两份 reference 把
§9 事实源指针改指归档、把「门禁咬不到」措辞改成「连归档扫描
工具都咬不到」。
校验：本篇逐篇 check_doc_links --sections-strict rc=0（60 处
引用 / 58 可判定 97 % / 无法判定 0）；check_skill_size rc=0；
表格列数 0 处不一致；无 BOM / CR / 乱码 / 行尾空格，单 LF 收尾；
YAML 解析钩子声明数仍 51（配置只改注释）。
|
2026-10-29 20:53:26 +08:00 |
|
|
wandering1
|
d56c6ce862
|
docs(AGENTS): 补回删除枚举项时吃掉的一个空格
退役 id-check-new 那笔删枚举项时，锚点尾部的分隔符吃掉了
「`mem-numbers` + `lv-conf-sync`」之间的空格；枚举各项重新可逐项相加。
钩子口径不变（声明 51 / manual 3 / 提交期实跑 48）。未 push。
|
2026-10-29 20:24:30 +08:00 |
|
|
wandering1
|
51d89cf9d3
|
gate: 按用户裁定整体退役编号门禁 id-check-new（钩子 52 → 51）
配置：摘掉该钩子，原位置留一条退役注记（不复述数钩子数的字面量）。
YAML 解析口径实测：声明 51 / 带 manual 3 / 提交期实跑 48。
脚本：git mv 进 scripts/archive/id_gate/check_ids_new.py，与已退役的
check_ids.py 同档；docstring 改退役口径，REPO_ROOT 因归档位置深两级
改取 parents[3]，失败提示与自述路径同步改写。从归档位置实测：
--self-test 5 正例拦下 / 29 反例放行 rc=0；--worktree 与暂存区模式 rc=0。
文档（七份）：AGENTS.md 六处——总数、加钩流水（顺带补上 2026-10-29
漏记的 skill-size 一笔）、枚举项删除、本行相加数、提交期实跑、门禁索引
与主题表两行；门禁说明 README 八处——声明数、实跑数、计数流水、grep
陷阱的举例数、§2 标题、姿态表「只查新增」行、两行索引状态；编号规范
七处——引导块改「本文即唯一事实源」、族总表一处、§8 标题与正文、
§8.5 补第④步、④ 之后无机械牙那段、速查；门禁说明 id-check-new.md
整篇重写为退役留档（查什么 / 落地前的噪声回放 / 退役五条理由 / 手工
跑法 / 此后靠什么 / 认下丢了什么）；门禁说明 id-check.md 与归档目录
README、check_ids.py 里「现行门禁 = id-check-new」的指针同步改写。
技能（三份）：id-family-semantic-migration 一行、stale-doc-count-sweep
的 pitfalls 与 steps 各一行改手工跑法（steps 第 5 条那笔历史计数例不动）。
此后编号形态没有机器面：判据只剩 docs/编号规范.md §1 三句自问、§4.1
族总表与人工评审；2026-10-14 那类"销项删行后号被重新取走"不再有提交期
警报——这条代价已写进留档，别当成"检查没了随便写"。
纯文档与门禁配置，未跑 @build。全程未 push。
|
2026-10-29 20:22:47 +08:00 |
|
|
wandering1
|
557f1d042a
|
docs(计数): 录波落地后的全仓计数同步（套数/钩子/黄金/菜单/字库）
机器面先定真值，再逐处对齐文档；带日期戳的取数行只加「当时」不改数。
六个数（每条两个以上独立机器源互证）
- 主机单测套数 41 → 44（find test/host -name run_unit_test.py / 覆盖率总闸 --list /
基线 modules 条目三源一致；目录数 46 = 44 + common + __pycache__，两个数分开写）
- 有专属钩子 22 根（YAML 解析 -unit-test 后缀）⇒ 无专属钩子 19 → 22 套，并把
wave_ring / wave_store / wave_trig 逐名列进门禁台账 §6 第 4 条，18 / 19 / 22 三个数
改标「裁定当时 / 2026-10-28 / 2026-10-29 现值」
- 内容页黄金参考 60 → 66 张（simulator/tests/ref/shot_*.bin 实数 / PAGES 条目 66，
其中 2 个分页 → 页面 64）；钩子显示名与门禁索引表成对改
- 菜单 42 → 43 行（9 菜单 + 34 叶）、已绑 28 → 30、未绑 4（ui_menu_tab.h 宏 +
g_menu_tab[] 末行 / ui_page_registry.h 的 UI_PAGE_MAP_COUNT + #page= 计数剔示例行）
- 中文字库 218 → 224 唯一字、313 → 319 字形（清单唯一码点 / .bitmap_index 条目数
含 notdef；224 + 95 = 319 成立）
- 钩子口径 52 声明 / 49 提交期实跑：只核不改，核对 AGENTS 与 YAML 解析一致
Lead 追加四处（wave-algo 按「AGENTS 只核不改」的指令交回我裁的部分）
- AGENTS.md 提交门禁节：41 套 → 44 套（两处）、19 套 → 22 套（两处，并把「与录波
三套」写进括注）、ui-golden 条目 60 张 → 66 张；52 / 49 的口径叙述与历史括号原样
- scripts/board_ui_nav.py 的自述 docstring：60 张 → 66 张
- test/host/sys_log_mcu/sys_log_mcu_test.c 注释：全量门禁 41 套 → 44 套（纯注释）
- 产品需求 FR-UI-2：需求原文「42 节点」保留不动，在实现行注「2026-10-29 实到 43
节点，42 是 V0.1 立项数」——需求基线不由实现方回改
刻意不动的（冻结面）
- 带日期戳的实测行（自动化测试流程、字库差集门禁、覆盖率口径里的 67 s / 25 s /
45 s / ~105 s 四个耗时）、保留变更记录的文档历史行、页面补齐规划里自写「完成即
冻结」的立项快照表、2026-10-28 那份分工说明、级联框总览.svg（42 节点时代所画，
无生成器，重画另开一笔）、三处伪命中（字体数据行、芯片手册、m2/m3 数据目录）
自查（真实退出码）：check_doc_links.py --all RC=0（215 个文档、章节引用可判定 80 %，
合并后第一次全库零红）；check_generated_fresh.py RC=0（22 张图 17 一致 / 5 条既有
BASELINE 豁免，生成物零改动）；编号门禁 add 后复扫 RC=0；17 + 4 个改动文件字节体检
全绿（无 BOM / LF / 无 U+FFFD / 无尾随空白 / 单个尾换行）。
|
2026-10-29 20:04:24 +08:00 |
|
|
wandering1
|
c63bd029a9
|
feat(门禁): 新增 skill-size 钩子——SKILL.md 不得超插件写侧上限 65536
dsh-mnemon 的 MAX_SKILL_BYTES = 65536 只在写侧校验，加载侧从不检查，
所以正文越界的技能照常加载、却永远生成不出草案：同日两次卡死
（83194 字节与 72601 字节）都是这个形态，复位台账无效，只能瘦身。
故把上限机械化，越界与悬空指针在提交期就拦下。
- scripts/check_skill_size.py：纯标准库（裸 python 也能跑，故不解析
.venv）；FAIL >65536、FAIL reference/ 指针悬空、FAIL UTF-8 BOM、
WARN ≥49152（75%——实测一次「采纳」把主文从 49821 顶到 62806）；
总是全树扫，只拿 reference/x.md 触发的提交正是漏网场景；
--root 可复指到用户级 ~/.dsh/skills；--selftest 五形态（干净 0 /
临界 0+WARN / 超限 1 / 悬空+BOM 1 / 根不存在 2）全过
- .pre-commit-config.yaml 加 skill-size，files: ^\.dsh/skills/
- 新增 docs/门禁说明/skill-size.md，含盲区：拦不住插件自身的采纳写盘、
用户级技能目录不在触发面、不解析 frontmatter、不查 U+FFFD
- 计数同步 51 -> 52（实跑 48 -> 49，索引 28 -> 29 篇）：AGENTS.md 与
门禁索引，另 7 处文档旧计数改写、CI 指南带日期实测行只加注
本笔先落地，技能正文的渐进展开拆分在下一笔。
|
2026-10-29 15:02:23 +08:00 |
|
|
wandering1
|
21c68521ff
|
feat(task-worktree): 桥接 DSH worktree 插件——补共享联接、锁归属 pw:<name>、修释放不掉
诉求最初是升级 dsh-task-worktree：实测已装 0.4.6 = npm dist-tags.latest，无需升级；
真正的缺口是本仓 skill 看不见插件建的树（.dsh-worktrees/），故按用户追加指令把两套
系统接起来。回收方向刻意不打通：本 skill 永不删插件的树。
脚本 task_worktree.py：新增 plugin 子命令 list/adopt/unadopt，事实源是 git worktree
list（不是插件 manifest，免得被绕过）；adopt 只补缺失的 .venv 与 simulator/SDL2
联接，已有联接跳过、实体目录绝不碰；锁归属用 pw:<name> 前缀；new 顺带提示另有 N 棵
插件树、不占活跃上限 3。
一并修一处真 bug：lock release --bench-pass 在任务无台账时先 EnvError 退出、锁释放
不掉，导致每个任务的 done 收口连坐失败；现在改为警告后仍然释放。
keil-build：default_lock_task() 增加 .dsh-worktrees/ 反推分支，插件树内的构建归属
pw:<name> 而不是兜底的 build-cli（主树行为未变，本次 @build 实测仍走 build-cli）。
.gitignore 预先忽略 .dsh-worktrees/，让插件的 ensureIgnored() 找到同一字面量、不再
改写这份受控文件。check_doc_links / check_layer_deps / gen_refgraph 三处扫描面同步
排除：仓里再放一份仓会让 doc-links 假红、并让生成的配图字节漂移到 generated-fresh。
文档：并行任务工作树方案新增 §3.4 两套系统边界对照；SKILL.md 加 §F 共存一节，同时把
§B 从 53 行压到 29 行（净 +39，用户此前在飞的改写已 rebase 保留、未被覆盖）。
验证：@build 0 错误 0 警告；scripts/ci_local.py 48 根提交期钩子与 gitlint 全绿；
check_doc_links --all --sections-strict 通过（2596 章节引用、无法判定 0）；id-check-new
通过；改动文件字节体检无 BOM、CRLF 与 U+FFFD。桥接行为在临时 scratch 仓端到端跑过
（adopt 建两个 reparse、unadopt 只摘联接、pw 锁取放、缺台账也能释放、越界 name 退 2）。
|
2026-10-29 07:50:05 +08:00 |
|
|
wandering1
|
41670a1cc6
|
docs(gates): 主机单测套数复点同步——41 套 / 无专属钩子 19 套
第 41 套 boot_stats 由 728d6067（2026-10-27 11:29）入库，全仓写的
「40 套 / 18 套无专属钩子」从那天起过期；本轮按实测复点同步。
真值双源互证：test/host/*/run_unit_test.py 实数 41（43 个目录，除
common 与 __pycache__）＝ scripts/check_test_coverage.py 自报
suites=41/41。专属钩子 22 根（YAML 解析 id 以 -unit-test 结尾，
22 条全对得上有 runner 的目录）⇒ 无专属钩子 19 套 = 41 − 22。
改当前态共 18 处：AGENTS.md 提交门禁节三处、.pre-commit-config.yaml
test-coverage 注释、docs/门禁说明/host-unit-tests.md §6 第 4 条六处
（无钩子名单首位补 boot_stats、目录数 42→43、裁定句改「裁定当时
18 套，2026-10-28 现值 19 套」）、docs/门禁说明/README.md、
docs/代码规范/pre-commit使用说明.md 两处、docs/编号规范.md、
scripts/README.md、docs/任务规划/分工说明-20261028 一条、
docs/测试说明/主机单测覆盖率口径.md 追加 2026-10-28 = 41 套 ~105 s
新实测点、test/host/sys_log_mcu/sys_log_mcu_test.c 注释行。
刻意不动：带日期戳的历史耗时与套数行（只追加新的实测点，不覆写）、
host-unit-tests.md 里「22 根 / 40 套 / 18 套无专属钩子」这句复核原文
（只在后面追加更正）、scripts/archive/id_gate/ 留档两处、
同数不同义的五处（40KB 级 / −20~40% / 不到 40 行 / 18 断言点 /
板端 RTC 套件）。钩子数 51、专属 22 根、提交期实跑 48 根本轮实测
未变，相关句一字未动。
门禁：doc-links --all --sections-strict / id-check-new --worktree /
no-mojibake / bom-drift / validate-config 全 rc=0，
test/host/sys_log_mcu 单测 rc=0；改后复扫「40 套」仅剩 3 处
（1 处刻意保留 + 2 处留档）、「42 个目录」0 处、「18 套」仅剩 2 处
（都带「当时」口径）。
|
2026-10-29 00:58:23 +08:00 |
|
|
wandering1
|
295eb9911f
|
ci(gates): 覆盖率总闸与全量 cppcheck 移到远端 CI 强制（提交期实跑 48 根）
用户裁定 2026-10-28：慢钩子不再压在每个 git commit 上，由远端
CI 强制；本地等价入口 = scripts/ci_local.py 的 manual 段。
实测三根耗时：cppcheck 20.5 s、test-cppcheck 38.1 s、
test-coverage 105.2 s，合计 ~165 s ≈ 一次带代码提交耗时的
三分之二（test-coverage 的 files: 覆盖 App/，改一行就跑光 40 套）。
- .pre-commit-config.yaml：cppcheck / test-cppcheck /
test-coverage 加 stages: [manual] + 理由注释；替换掉
test-coverage 上方「没写 stages → 所有阶段都跑、输出出现两次」
的旧坑注释（固定 manual 后不再有这一坑）。
- .gitea/workflows/ci.yml：static-gates job 在静态门禁步之后
新增「手动阶段门禁（覆盖率总闸 + 全量 cppcheck）」步，
if: always()，逐根 --hook-stage manual（pre_commit run 不支持
多 id），日志 ci-artifacts/manual-stage.log + 归档 + STEP_SUMMARY，
rc≠0 即失败；run 块纯 ASCII。
- scripts/ci_local.py：新增 MANUAL_STAGE_HOOKS 与 run_manual_stage()
（静态段之后默认跑），删 run_coverage() 死代码，--coverage
降级为兼容别名。
- AGENTS.md + 12 篇 docs/scripts/README：三数同源口径改为
声明 51 / 提交期 --all-files 实跑 47 / +gitlint = 48，
其余 3 根在 manual 阶段；历史测量数字只加「当时」不回改。
验证：pre-commit run --all-files = 47 Passed / 0 Failed rc=0；
manual 三根 Passed（test-coverage line 89.8% func 93.2% 41/41 套）；
ci_local.py --static-only 全绿；check_doc_links --all
--sections-strict rc=0、mojibake / bom-drift / id-check-new rc=0；
ci.yml yaml.safe_load 通过。未改任何 .c/.h，故未跑 @build。
|
2026-10-28 23:04:59 +08:00 |
|
|
wandering1
|
842d711ed6
|
refactor(编号): 测试验证层级去号——CI job / 门禁输出 / 命令行旗标换语义名 + ASCII 段名
用户裁定「我不想看到编号」。测试验证层级这一族的整族清退分三道并行：本笔是**代码与 CI 道**
（CI 步骤与门禁输出面），代码注释面另走、文档面由文档道走。
口径（旧 → 语义名 → ASCII 段名，段名只进日志/旗标/job id/文件名）：
L0 静态门禁 static ｜ L0a 钩子解释器预检 preflight ｜ L0b 提交信息门禁 commitmsg
L0c 体积门禁 size ｜ L0.5 主机侧纯逻辑单测 host-unit ｜ L0.5c 覆盖率 coverage
- scripts/ci_local.py 43 站点：段标题与 [SUMMARY] 标签改 ASCII 段名（static: /
host-unit:），函数 run_l0/run_l05 → run_static_gates/run_host_unit_tests，
收尾「已跑：」列表用段名。旗标改 --static-only / --host-unit-only，**旧旗标
--l0-only / --l05-only 保留为 argparse 别名**（肌肉记忆与既有脚本片段不断档，
实测 --help 两名列出）。
- .gitea/workflows/ci.yml 42 站点：job id l0-gates → static-gates、
l05-host-unit-tests → host-unit-tests；步骤名与 step-summary 标题改语义名；
日志名 l0-pre-commit.log → static-pre-commit.log、l05-<模块>.log →
host-unit-<模块>.log；::error::/::notice:: 文案同步。yaml.safe_load 核过
两个 job id 与步骤名。
host-unit-tests；步骤名与 step-summary 标题改语义名；日志名 l0-pre-commit.log →
static-pre-commit.log、l05-<模块>.log → host-unit-<模块>.log；::error::/::notice::
文案同步。yaml.safe_load 核过两个 job id 与步骤名。
- 门禁脚本 18 站点：check_registration（登记簿理由串 7）、check_test_coverage 5、
README 8、check_generated_fresh 2、ram_baseline 2、check_size_gate 1、
ci_find_python.ps1 2、ci_runner_bootstrap.ps1 2、.pre-commit-config.yaml 2、
requirements.txt 1（保持纯 ASCII）。
- skills 7 站点：task-worktree（含 [SUMMARY] 样例两行）、mem-budget、ui-verify、
task_worktree.py 的实跑标签。
- AGENTS.md 3 站点：CI 段「只跑静态门禁 + 主机侧纯逻辑单测」、自查命令段、
「2026-10-11 静态门禁全灭」事件名。
- 归档：编号治理历史.md 新增 §10 换算表 + **撞族警示**（同形 L0/L1/L2/L3 还属 UI 设计
令牌层 / UI 菜单层级 / 采集链 / 链路时延段 / CubeMX 三层 / 硬件位号与 FTP 应答字面量
等六个族，其中 6 处在字符串字面量里，改了就是改行为——故全程只按行内置换、先判族）。
- docs/产品需求 §7.4 测试分层表：去号 + 顺带修掉上一批**错族替换疤**（该表 L1/L2 行曾被
采集链层名「语义取数与有效性 / 全周傅氏相量」「保护判据」顶替，现按内容改写为板端测试
套件 / 主机侧回归两行）。同文档 §1.5 G5 判据行同步。
门禁：ci_local --help 两面旗标并列；py_compile 7 个 .py 全过；yaml 解析通过；
check_ids_new --worktree rc=0；git diff --check 干净；17 个改动文件 FFFD=0、无 CR、
BOM 与原文件一致（含 requirements.txt 纯 ASCII）。本族无机器识别面（单字母+数字是
新增行门禁的自述盲区），口径来自自建逐行扫描器，复扫本族形态归零。
- 交接说明：文档道 teammate 在改 CI 指南时中断，剩余 9 处双写疤与 29 处 CI 标识
（job id / 日志名 / 汇总行字面量）由 Lead 接手改完，逐处仍走断言式行内置换。
|
2026-10-28 17:46:52 +08:00 |
|
|
wandering1
|
6b2c6ced1b
|
chore(repo): 仓库根清场——一次性脚本与提交信息草稿移出，补落位口径
- 删除根目录 5 个未跟踪的一次性产物：sweep_golden_append / count / final / last 四
个脚本与 commitmsg_a.txt。它们是 2026-10-28「内容页黄金参考计数 页→张」口径同步
留下的映射表驱动改写脚本，本轮实测确认已全部耗尽：旧串全仓命中 0、变更记录新行
已在各文件末行，产物入库见 dc214e14 / c0fcf4c4 / 4ba02212 / 078a27a0；全仓按脚本
名前缀 grep = 0 引用（无任何门禁、文档、skill 提到它们）。
- 副本移入 ci-artifacts/oneshot_2026-10-28_golden_count_sweep/（已忽略目录）留可
追溯，附 README 记录来源与「零命中 = 无剩余工作」的复跑证据。
- 同批删除：__pycache__/（两个陈旧 pyc，其中一个文件名被某次重定向写坏）、
%SystemDrive%/（约 1 MB 字体缓存库，已核实非 junction，真系统目录未受影响）、
sim_run.log 与 sim_selftest.log（模拟器陈旧输出，main.c 下次跑自动重建）、
tmp_save.bin（3200 字节全零 = 一帧 160×160 单色绘制缓冲，全仓零引用的孤儿）。
- .gitignore：把「不入库」升级成「而且不落仓库根」并写明本次实测到的 5 个 ??；
新增 /commitmsg*.txt 兜底反选（实测该命名已命中规则）。不给一次性脚本加忽略——
忽略等于掩盖，正解是别让它们长在根目录。
- AGENTS.md 目录地图补同口径一句，让 agent 侧每次在场。
- 保留 ui_cn_chars.txt 与 ui_menu_tree.txt（生成器按仓库根定位、全仓 69 / 67 处
引用、README 目录树已列）与 sim_config.ini（模拟器配置后端声明的运行文件）。
- 门禁：check_ids_new --worktree rc=0；check_doc_links --all 195 篇通过；
git diff --check 干净；两份改动 U+FFFD=0、无 BOM、无 CR、无行尾空白。未碰 C 代码。
|
2026-10-28 16:39:46 +08:00 |
|
|
wandering1
|
4ba02212eb
|
docs(门禁): 钩子计数与门禁索引同步到实测口径（51 / 50+1 / 22 / 28 篇）
实测口径（三数同源）：
- YAML 解析后的 hook 条目数 = 51（不是文本 grep 声明行）。
- gitlint 未声明 stages（实测 stages = None）→ 按默认属全阶段计，
pre-commit 阶段 50 + commit-msg 阶段 gitlint 1 = 51。
- 带 -unit-test 后缀的专属钩子实测 22 根（AGENTS 的 Lead 裁定 2026-10-27：
不补第 23 根）。
- docs/门禁说明/ 下除 README 外实测 28 篇（上一轮加钩子没同步篇数）。
逐处：AGENTS.md 补齐 2026-10-25 道E 三根钩子的逐项枚举（补齐后该行
各项相加才等于 51）；docs/代码规范/pre-commit使用说明.md 两阶段表
49/50 → 50/51、§5 文件表 40 → 51 并注当日 51 → 52 → 51 净零；
docs/门禁说明/gitlint.md 的 --no-verify 跳过面 39 → 50（= 51 减自身）；
docs/门禁说明/README.md 索引 27 → 28 篇、grep 自查口径改为锚定行首的
实测结果、硬拦截行 16 → 22 个主机单测；test/host/README.md 16 → 22 两处；
docs/环境与部署/并行任务工作树方案.md 30 / 40 → 51；
docs/测试说明/测试开发标准流程.md 那条 2026-10-11 审计的「18 个钩子」
加「当时」锁口径、不臆改成现值；两份 skill 正文里的 id-check 说法改为
「已于 2026-10-28 退役、现行只查新增行」。
|
2026-10-28 15:37:02 +08:00 |
|
|
wandering1
|
0f0158508a
|
refactor(编号): CubeMX 防丢失三层 L1/L2/L3 → 写进 .ioc / 搬进 USER CODE 区 / 审计兜底（批次 3c）
这族只在两处出现：AGENTS 的「平台约束 / CubeMX 与 Fault」段与 `cubemx-regen` skill 全文。
含义是重生成防丢失的三层优先级，与采集链分层 / UI 菜单层级 / 延迟分段三族都不同。
改法：层号直接换成动作短语，层级顺序用「第一层/第二层/第三层」交代——
L1 写进 .ioc → 写进 .ioc（第一层，权限最高）
L2 搬进 USER CODE 区 → 搬进 USER CODE 区（第二层）
L3 审计兜底 → 审计兜底（第三层）
另有 `L1/L2/L3 方法论` → 「这三层方法论」、`（L1 检查）` → 「（第一层检查）」、
「L3 清单已清空」→「审计清单已清空」等 8 处措辞跟着落。skill 的 description 也改了，
否则目录里还挂着编号（本次会话的技能目录快照已同步显示新描述）。
验证：doc-links / mojibake / bom-guard / 新编号门禁 / git diff --check 全绿。
本批不涉及 C 代码，@build 不必重跑（上一批 0 错 0 警的构建仍有效）。
|
2026-10-28 13:15:05 +08:00 |
|
|
wandering1
|
593c5d0c84
|
refactor(编号): 采集链分层 L1/L1.5/L2/L2.5/L3/L4/L5 → 语义名（批次 1）
用户裁定（2026-10-28）：L1/L1.5/L2/L2.5/L3 这套层号「谁能看懂」，改用语义名。
映射（同一批定稿，含 L4/L5）：
L1 → 语义取数与有效性
L1.5 → 标定折算
L2 → 全周傅氏相量
L2.5 → 测频与遥测快照
L3 → 保护判据
L4 → 出口与记录
L5 → 动作留痕
实测规模：384 站点 / 62 文件（App/algo、App/task、test/host 六个套件、docs/算法、
产品需求、架构总览、启动顺序、ADC 采样节拍、IEC104 上行、采集短板评测、内存管理、
AGENTS.md、README.md、docs/README.md、.pre-commit-config.yaml 与 scripts 里的注释）。
改法（不是全局替换，逐模式有上下文规则）：
- 先吃同位语再落裸词：L1 有效性校验 → 语义取数与有效性校验、L2 相量层 → 全周傅氏
相量层、L3 保护 → 保护判据、L2.5 遥测快照 → 测频与遥测快照，避免「保护判据保护判据」
这类重复（第一版就是这么坏掉的，已整体回滚重做）。
- .c/.h 只改注释：先把字符串字面量切出去（引号数为奇数的跨行注释按整行处理），
C 字符串里的 L2-in ring 之类原样保留——AGENTS 铁律「字符串字面量必须纯 ASCII」。
- 层内条目号（L1-3 / L2-3 这类）**本批不动**，属批次 2；另外三族（UI 菜单层级
L0~L3、链路延迟分段 L1~L8、CubeMX 防丢失三层）也不动，属批次 3。
- 顺手修的措辞：范围写法 L1~L3 → 「分层（语义取数与有效性 → 保护判据）」、
CI 段「不含 L1/L2/L3」→「不含采集链分层」、目录地图里同一处并列表述。
验证：@build 0 错 0 警（Code=236456，与改前逐字节同尺寸——纯注释改动）；
内存布局配图已按新脚本重生成（自检通过）；doc-links --all --sections-strict 通过
（195 文档）；mojibake / bom-guard / coding-standard / 新编号门禁自查 全 rc=0；
git diff --check 干净。
|
2026-10-28 13:04:02 +08:00 |
|
|
wandering1
|
89b6132c1f
|
docs(编号): 瘦身——58 KB/473 行 → 22 KB/222 行，过程记录进归档
用户裁定 A 方案：这份文档的「规范体系」部分已随门禁退役而死，但四件仍活着的东西
只有这里写着——① §1 政策（默认不发号 / 先问三句）；② §3.3 语义标识怎么写；
③ §4.1 族总表 + §4.1.1 已停发栏（现行门禁白名单的机器投影源头）；
④ §4.4 这些不是编号（防把 YX15 / 元件位号当垃圾清）。再留 §5.5 销项、
§8 门禁现状与 §8.5 退役路线、§10 速查。
其余 16 节逐字搬进 scripts/archive/id_gate/编号治理历史.md（40 KB）：
1.2 / 2 八条原则 / 4.2 / 4.5 / 6 模块码表 / 7+7.1~7.3 / 8.1 基线 / 8.3 批次 /
8.4 台账 / 9+9.1~9.3（含「数据可信」任务卡号换算表），以及原变更记录 17 行流水。
归档文件带「这不是现行口径」横幅 + 归档目录，写清哪些节对应哪段历史。
两处刻意的选择：
- 节号沿用旧编号、不重排——外部文档与脚本引的是 §4.1 / §8.5 这些号，重排等于
制造一批假链接；文首加「本文范围」说明跳号去哪了。
- 文首那段「机器面才是事实源」改写：现行机器面是 check_ids_new.py 的两张
前缀级白名单（KNOWN_DASH / KNOWN_BARE），旧的 registry / 别名表 / 八项校验脚本
已随全库审计退役进归档，只在手工复查存量时才用。
引用重修（6 份文档、10 处）：AGENTS 的 §9.3 换算表、数据可信 §9.3 ×2、
门禁说明 id-check 与 host-unit-tests、docs/README 的 §4.5、技能手册的 §9、
以及正文里 §4.2 / §4.5 / §8.1 / §8.3 / §8.4 / §1.2 的裸引用。
验证：doc-links --all --sections-strict 通过（195 文档）；mojibake / bom-guard /
git diff --check 全 rc=0；新门禁 --worktree 自查通过；钩子数仍 51。
|
2026-10-28 12:51:17 +08:00 |
|
|
wandering1
|
1668842d61
|
chore(id-check): 退役全库编号语料审计（钩子 52 → 51）
第三步（用户裁定跳过观察期直接做）。第一步 bf2a5c21 把两根护栏转报告制，
第二步 a5832788 立起只查新增行的新门禁，本笔把旧的全库语料审计整体退役：
语义标识已是默认形态，这套 99 族语料不再有人需要维护。
移动（保留可复现性，不再进提交门禁）：
- scripts/check_ids.py → scripts/archive/id_gate/check_ids.py
- id_registry.json（87.6 KB，99 族）/ id_aliases.json（187 KB）/ id_known_backlog.json
一并归档；新写 archive README：为什么退役、现在用什么、怎么手工跑、归档纪律。
- 归档脚本改了自定位（仓库根往上 4 层、语料与脚本同目录）与一行退役横幅；
从新路径实跑：811 文件 / 8,051 字面量，--strict rc=0。
钩子：删 id-check（52 → 51）。现役编号门禁只剩 id-check-new（只查新增行、零语料）。
声明数 51 = commit 阶段 50 + gitlint 1，三数已对齐（AGENTS / 门禁索引 / YAML）。
连带改动：
- rename_ids.py 的别名表路径指向归档（改名工具本身没退役）；
- check_ids_new.py 排除面加 scripts/archive/（语料里全是编号字面量，天经地义）；
- doc-links 跳过 .mnemon/ 与 ci-artifacts/（本地记忆状态与草稿，非项目文档）——
语料搬家后这些目录里的旧路径引用会假红，它们本来就不该参与文档门禁；
- 全库 .md 里的旧路径引用改指 scripts/archive/id_gate/（含两份 skill 手册）；
- id-check.md 加退役横幅并保留原文作留档；门禁索引把该行标成已退役；
- 编号规范 §8 改成「现行只有一道门禁」+ §8.1~§8.4 标为退役留档 + §8.5 ③ 置已完成；
各加一条 2026-10-28 变更记录行。
验证（实测）：YAML 口径 51 个钩子、id-check 不在其中；doc-links --all --sections-strict
通过（194 文档）；mojibake / bom-guard / coding-standard / git diff --check 全 rc=0；
新门禁自检 5 正例 + 29 反例仍全过。
|
2026-10-28 12:38:38 +08:00 |
|
|
wandering1
|
a5832788e9
|
feat(id-check): 编号门禁第二步——新增行拦截（零语料）
背景：第一步（bf2a5c21）把两根护栏转成报告制，但全库语料审计仍在跑。
它真正的用途只有一个——拦住「新写一个自造编号」；这件事不需要 99 族语料。
所以本笔落第二步：只查 git diff 的新增行，判据收窄成两张前缀表。
新增 scripts/check_ids_new.py（241 行，零语料）：
- 破折形态：首段不在 KNOWN_DASH（活族 + 标准名，11 条）→ FAIL；
在 RETIRED_DASH（已停发族）→ 只 WARN，提示改语义短语。
- 裸形态：前缀不在 KNOWN_BARE（外设/器件/协议/点号，约 90 条）→ FAIL。
- 单字母 + 数字一律放行（元件位号与层次号同形，显式盲区）。
- 算术排除（SIZE-2 / LEN-1 这类是减法不是编号）；跳过 [示例]/[计划] 行；
行内 [编号豁免] 为最后手段。默认查暂存区，另有 --worktree / --range / --self-test。
接线：新钩子 id-check-new（钩子数 51 → 52，AGENTS 与门禁索引已同批改），
与 id-check 双跑一个观察期；观察期后按 docs/编号规范.md §8.5 ③ 退役旧语料。
旧门禁的排除面加上新脚本（它必然写着示例令牌，否则自己拦自己）。
白名单是按真实数据调出来的，不是拍脑袋：回放最近 80 笔提交，未知形态只有 15 种，
其中 12 种是设备/协议名（RS232、RS485、OVER8、YT/YH 点号等，已进白名单）、
3 种是已停发族（P-8、N-1、F-NET-*，只 WARN）→ 调好后回放误报 0。
自证（实测）：
- 自检 5 正例全部拦下、29 反例全部放行（含 TC-NET-204 / TRAP-ADC-01 / TPAFE5160 /
GD5F2GQ5UE / C12 / U15 / L3 / SIZE-2 / GPIO_PIN_5）。
- 端到端：暂存一个自造前缀 + 数字 → 钩子 FAIL；清理后 Passed。
- 反向：本页文档里举的反例自己也被拦过一次，改成带 [示例] 标记后才过——
这条正好证明它没有「文档路径」的例外面。
- 两条门禁互不干扰：old-gate rc=0、new-gate rc=0、doc-links 通过（211 文档）。
|
2026-10-28 12:27:57 +08:00 |
|
|
wandering1
|
bf2a5c21b0
|
chore(id-check): 两根护栏转报告制——编号门禁减负第一步
背景（用户裁定 2026-10-28）：语义标识已是默认形态，编号体系本身不再产生价值，
而门禁每次都花时间。实测拆账：单次运行只有 1.8 s，但 近 80 笔提交里 61 笔 改了
id_registry.json / id_aliases.json / check_ids.py / docs/编号规范.md；语料共 99 族
（78 族已冻结、8 族快照、21 族未冻结），registry 87.6 KB + 别名表 187 KB。
结论：贵在养语料，不在跑检查。故先摘掉语料审计的强制面。
本笔只做第一步（①②③ 路线见 docs/编号规范.md §8.5）：
- 护栏 1（可判定比例基线）与护栏 2（不可判定引用绝对数上限）改为 只打印、不影响退出码；
输出标签由 [比例] 改 [比例·报告]，越线打 [报告] 两行并指向 §8.5。
--update-baseline 保留（只用来把当前值记成新记录基线）。
- 校验 1~6 不动：台账外新账照旧拦提交，这是本次减负的边界。
- 同步改口径文档：docs/编号规范.md §8 表与 §8.1 护栏行 + 新增 §8.5 退役路线，
docs/门禁说明/id-check.md §1 表 + §6 限制第 7 条 + 新增 §7.6.1，AGENTS.md 门禁段，
id_registry.json 两条 note，各加一条 2026-10-28 变更记录行。
自证（实测）：
- 把 decidable_ratio_baseline 临时改 99.9、undecidable_total_ceiling 临时改 1 →
两护栏必然越线，实跑 退出码 0，只出 [报告] 两行；字节级还原 registry 后复跑正常。
- 反向自证牙还在：往一个新文件写一个自造前缀 + 数字（让 git 看见该文件）→
校验 1 报 1 处错误 + 增量拦截 FAIL，退出码 1。
- 全门禁：check_ids --strict 校验 1~6 无错误（可判定 87.15% / 不可判定 1033，仅报告）；
doc-links --all --sections-strict 通过（210 文档）；mojibake / bom-guard /
coding-standard / git diff --check 全 rc=0。钩子数不变（替换口径，不加不减）。
|
2026-10-28 12:18:00 +08:00 |
|
|
wandering1
|
94b0d79026
|
feat(ui)+chore(docs): UI 补齐清单清空；数据可信销项与「卡」号清退
本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里，
拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）：
一、UI 补齐（清单清空）
- 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk
复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存），
记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面；
ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签
（自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。
- 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用
boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据
（差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。
- 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28；
字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。
- 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言
425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录
（模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。
二、数据可信销项 + 「数据可信」任务卡号整族清退
- 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在
docs/硬件平台/ADC通道映射说明.md §8.1 与
docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。
- 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语，
代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。
这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。
验证（实测）
- @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084；
RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%，
体积同码凭证与 RAM 台账已回填。
- check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）；
check_content_pages 60 页 rc=0；check_font_charset / registration /
coding-standard / bom-drift / mojibake / doc-links --all / layer-deps /
nested-comment 全 rc=0；check_ids --strict 无错误；主机单测
ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。
未做（不是遗漏）
- 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、
拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1）
已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。
- docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含；
其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。
|
2026-10-28 07:23:16 +08:00 |
|
|
wandering1
|
a275539c17
|
docs(全仓): 内容页黄金 47 → 53 的当前态同步——含钩子显示名，登记簿口径另笔
task-9 让内容页黄金从 47 涨到 53（通讯设置页六态），本笔只做**当前态陈述**的同步；真值全部本轮实测：
`simulator/tests/ref/*.bin` = **53**；`git diff 31ca4a1f..HEAD` 对该目录 = **
6 个新增、零修改** ⇒ 存量 47 张
逐字节未变（这条是关键：新增页不该让旧页重生成，否则回归基线就失去意义）。
**四类命中各走各路，这是本笔的全部难点**（分类比替换重要得多）：
· 当前态 → 改，25 处页数，落在 16 只文件（AGENTS、钩子显示名、导航器 docstring、`lvgl-simulator` s
kill、
门禁索引与 `ui-golden` 详解、UI 自动化流程、内容页架构、页面补齐规划与扩充方案、数据供给、自动化测
试流程、覆盖率口径、测试开发标准流程、模拟器两份 README）；
· 变更记录历史行 → **一条不动**，另在其下一行插入当日「47 → 53」新行 6 条（含判据与零漂移证据）；
· **同数不同义 → 不动**：覆盖率口径里的「47 个 .c」「47 = 13+5+29」、ram_report 的表行号 47、`#47-D`
诊断号、LSI 47kHz、47,360 栈字数、像素哈希 3476/3474 —— 一并替换就会毁掉六个不相干的事实；
· 带日期戳 / 自declare 冻结的快照 → 不臆改（数据供给篇那句上一笔已加「当时」，页面补齐规划里那张
「2026-10-25 复核…剩 21 叶」的表自带「完成即冻结不回改」声明）。
复扫残留当前态 47 = **0**。⚠ 顺手纠一条**会教错方法**的陈旧：naive 计数 `grep -c '#page='` 上一笔写的是
22，现在真值是 **23**（文件头示例行也算一次）——旧文档里那个 22 **恰好等于新的正确 bound 数**，不改的话,
下一个人用错算法还能碰巧对上，比错更糟。
⚠ `AGENTS.md` 里本次有两件事同行相邻（本笔的内容页 53 页 + 批次三那句 `TC-*` 停发），**分两句说明**：
前者是计数同步，后者是昨天那条「批次三不坐」裁定的入口文案，二者不是同一件事。
钩子显示名改在 `.pre-commit-config.yaml`（47 → 53）。**这条必须与代码同批入库**：配置脏而未 stage 时
pre-commit 会直接报错挡住全仓任何提交（今天已实测两次），所以本笔先落它，把后面几笔的路清开。
自查：`check_doc_links --all` rc=0（203 篇）、`check_ids --strict` rc=0 且不可判定绝对
数 **979 未变**（新增
文本里的提交号与 `#page=comm` 没推高它）、`gen_task_table --check` 0、`check_bom_drift`
0、18 只文件 noBOM /
LF / U+FFFD=0；行数变动 +49/−47 全部可归属（插 6、删 2、并 1），其余为 1:1 等行替换。登记簿销项与叶数
（`UI补齐.md` + `docs/任务规划/README.md`）**不在本笔** —— 那是口径变更不是计数同步。
|
2026-10-27 13:54:05 +08:00 |
|
|
wandering1
|
4c74cfa825
|
refactor(编号·批次二): 文档侧 194 处保护功能号改成功能名，定义表 7 张首格改语义标识
批次二文档半（道 gate-docs 执行）。先纠三个数的口径账，别再拿任何旧数当准：**234 处是准数** —— 卡片写
52（Lead 用了门禁 Checker 的引用集合，它**刻意排除属主文档内部的定义位**）、道里先报 265（裸正则把
`SDL2-2.32.10` 里的 `L2-2` 当成功能号，误报 10 处）。最终边界口径 = 带左边界 + 跳过反引号代码段。
· 19 只文件 HEAD 共 234 处 → 现 40 处，**40 处 100% 落在变更记录行**（冻结历史，按 Q3 一条没动），
非变更记录残留 **0**；改写 163 行 / 16 只文档。站点最多：规划文档 110→37、相量层单测说明 25→1、
采集与数据处理短板评测 21→0、App/algo/README 26→0。
（`App/algo/README.md` 由上一笔代码提交带上车，路径归属已在该笔正文注明，内容是本批改写）
· **定义表首列由编号改成语义标识**（编号规范 §3.3「表首格就是短语」的完全形态）：首列原为编号的表
共 **7 张**（不是 5 张），删掉与之重复的「语义名」列；表头标签按域词区分——三张 L3 保护**元件**表
保留 `| 元件 |`，四张 L1/L2 表用 `| 功能名 |`（把「元件」统一洗成功能名会丢掉领域信息）。
七张表逐张核：表头竖线数 == 分隔行 == 首条数据行 == 列数+1；与 HEAD 逐块对拍**净新增不一致块 0**，
并且正是这个对拍抓到第一版「三张表数据行已删列、表头没删」的破表。
· 7 处删号留下的残词/重复解释括号人工收口（如「L1-5（通道标定）」→「通道标定（一次系数 + 零漂）」），
复扫待收口站点 0；措辞逐字取自映射表，无第二种说法。
· tools/arch_diagram 三只生成器 4 处（3 处 docstring + 1 处图形文案）与产物同批：重跑后**只有位图那张
变 2 个 text 节点的换行位置**，画布 1580x740 与总行数不变，另两张逐字节未变；改前先干跑对照证明三张
svg 原本与生成器一致（不在 stale 基线里）——`check_generated_fresh --only docs-svg` PASS。
本笔另含 **F-* 半批的文档面**（同一轮 `git add docs tools/arch_diagram AGENTS.md` 一并收进
，非误伤）：BSD
函数调用关系里 9 处反引号紧邻指针、属主文档 §7 的停发句与导读行（**12 条定义行原样保留、不删登记族**）、
以及 `gen_net_instability_svg.py` 与它的产物 `网络不稳根因总览.svg`（「唯一读者红线」那条的框宽自适应
526 → 551，右缘 1411 未越界，画布 1560x1468 不变）——该半批的**代码注释面**在下一笔。
⚠ 因 `docs/任务规划/登记簿.md` 与 `docs/任务规划/UI补齐.md` 正被另一张卡（UI 叶数复核）改动，本笔**不含
那两只文件**，批次二的 §9 存量收尾与它们同批提交。
|
2026-10-27 09:05:24 +08:00 |
|
|
wandering1
|
31ca4a1faa
|
docs(计数): 内容页黄金参考 40 → 47 页全仓同步，登记簿剩余项与顺序一并更新
上一笔 UI 落地时我把「文档计数与真值同源」这件事留在了别人身上（setpage 的移交项写得很明白：内容页 40→47
的全仓计数改写由 Lead 派）。这一笔把它做完，**只改当前态陈述，历史不动**：
· **改成 47 的判据**：simulator/tests/ref/ 实测 47 张 .bin（7 张新增、存量 40 张逐字节零漂移），共 1
6 处当前态
陈述跨 11 只文件同步——含 AGENTS 的 ui-golden 条目、**钩子显示名**（.pre-commit-config.yaml）
、门禁索引与
ui-golden 详解的标题与正文、UI 自动化流程的页数与 PASS 文案与快检张数、内容页架构回归段、覆盖率口径的
「不做 UI 单测」理由、启动自动化流程回归段、导航器脚本 docstring。
· **不改的两处，理由写明**：5 只文件里的历史变更记录行「27 → 40 页」是当天事实，原样保留，只在各文件
变更记录顶部加一行 2026-10-27 的 40 → 47；UI_界面制作流程 的「< 40KB」是绘制缓冲红线，与本数无关，
属扫描误报，不动。
· **一处加限定语而不是改数**：UI_自动化测试流程 的「文本断言 310 条、覆盖 40 页中的…」带 2026-10-26 实跑
日期戳，那是那天的测量口径 ⇒ 改成「覆盖**当时** 40 页」，310 条不臆改，等下一次实跑回填真值。
顺带同步 docs/任务规划/README.md（登记簿销项，用户授权）：开篇「第一项是实现 param_request 写路径、然后做
整定 4 页」早已完成 ⇒ 改为剩余三项「通讯设置 → 记录 5 页 → 运行报告」；§2 顺序表「按 §1 的 1→5 推进」改为
「剩余 3 项按 1→3 推进（原第 1、2 两项已落地）」，与上一笔 UI补齐.md 的销项结果对齐。
三数同源自查：AGENTS 钩子数 51（YAML 解析口径）、内容页 47 页、门禁索引 27 篇均与配置一致；
check_doc_links.py --all exit 0、check_ids --strict exit 0 且不可判定绝对数 **1,156
未变**（本笔没吃余量、
没新增编号引用）；13 只文件全部 noBOM / LF / U+FFFD=0 / 结尾换行齐。本笔零固件源，不改构建产物。
|
2026-10-27 07:16:32 +08:00 |
|
|
wandering1
|
1d39571114
|
feat(门禁): 第 51 条 nested-comment——把 ARMCC #9-D 的按包含者刷屏拦在提交前
动机是今天一天复发三次的同一形态：在块注释里写作用域路径，那个 `/*` 被 ARMCC 当第二次注释起点（诊断 9-D），
而且**按包含者数量刷屏、只在重编译那个 TU 时才暴露**——本仓的诱因就是「注释里写 Drivers/BSP/UI/**」。
AGENTS 早就写了这条铁律（写全目录或用尖括号），但它一直是纯口头纪律，所以同一天还是复发三次。
新脚本 scripts/check_nested_comment.py：纯标准库、只读、五状态机（代码 / 行注释 / 块注释 / 字符串 / 字符
字面量），**只有块注释体内的 /* 才算问题**——字符串里的、行注释里的、未闭合判定都不误报。口径上刻意与钩子
的 types: [c] 对齐（403 个 .c/.h 同面），避免「手跑面 ≠ 提交面」这类我们今天就踩过的错位；零第三方依赖是
刻意的，为了让 generated-fresh 那天的解释器假红不长第二遍（实测 .venv 与机器级 C:Python314 两种解释器结论
一致）。
存量口径：全仓实扫**新发 0、存量 2 处**（test/host/common/ch395f_fake.h:7 与 fatfs_fake.h:9，同一形态
「注释里写作用域 test/host/**」）。两份假件头不参与 MCU 构建所以今天不报，一旦被 include 进板端 TU 就会
按包含者刷 9-D——属 test/ 写域，作者**没代改**，而是钉进 BASELINE 走只减不增，**其余零豁免**。
自证有一条必须写清的诚实边界：作者想「拿旧字节回放今天那三处真复发」，实测**做不到**——近 150 个提交里被
改过的 281 份 .c/.h 旧字节**零命中**，因为那三处同类从来没有一处在 HEAD 里留过字节（全靠人工编译后清掉）。
于是改测**形态**（这是能证的部分）：10 项形态电池 10/10，含把已入库的尖括号写法退回星号形态 → 命中 1 处；
另用现存两份真字节做双跑：空基线 → 2 条 [NEW] + exit 1，加基线 → exit 0，证明**基线只决定算不算新的，
不掩盖有没有**。编译器侧原文（run_par.c(267) #9-D）冻结抄进新文档 §2.1——构建日志每次 @build 被覆盖且不入库，
所以文档里刻意没写「最近一次日志里仍有」这种会过期的话。
计数三处同批：AGENTS「共 **51** 个钩子」、门禁索引「51 个 hook → 27 篇 + 1 指针 + 1 外置」、配置声明；并记
文本 grep「 - id:」= 52 的成因（第 65 行被注释掉的 clang-format 候选），收紧行首口径 = 51。作者顺带自打了
一次：在配置注释里复述了那个 grep 字面量 → 文本计数当场虚高 1，已改写并把「配置注释里别复述字面量」写进
README §2 与 AGENTS。
同笔带上 task-28 的裁定句（AGENTS 一只文件里两卡改动天然混在一起，拆开会多两次改写与一次风险）：不补第
23 根 ui-sink 专属钩子——22 根的唯一意义是秒级归因，而 ui_sink 失败面全落在 test-coverage 总闸必跑路径、
失败照样拦；读「这套跑没跑」去看总闸输出，别数钩子。
实测与本笔自查：validate-config = 0；nested-comment --selftest 4/4、--all = 403 / 新发 0 /
存量 2 → exit 0；
doc-links --sections-strict（4 篇）= 0；gen_task_table --check = 0；generated-fresh
PASS（5 处存量走 WARN）；
check_ids --strict exit 0，**不可判定绝对数全程未被本闸吃掉**（作者开工 1,162、写完新闸与新文档仍 1,162；
现 1,156 是队友还清的）；全部改动文件 noBOM / LF / U+FFFD=0。未跑 pre-commit --all-files（只跑本闸）。
**本笔使用 --no-verify 的凭证（唯一允许的两条之一，按 MEMORY 台账例外口径）**：把本批 6 只文件单独
staged 后跑 `pre-commit run --files <这 6 只>` → **13 条 Passed / 1 条 Failed**
唯一失败的是 `mem-budget`
（RAM 92% 阈值，**全树检查**）。本批**零固件源、零 .map 变更**，该红来自其他队友在飞的固件改动造成的 .map
漂移（当前树 Code=231,952 / RW=1,528 / ZI=136,264，在库台账 231,712 / 1,504 / 136,216
差 = run_par setter
与 vol_lock 计数两笔，均未提交）；台账回填由我在树能编后统一 `--write`，不在分支上跑（避免多分支同改受管表）。
gate: only mem-budget pending lead ledger backfill。字节卫生本笔自查：6 只文件均 noBOM / L
F / U+FFFD=0，
新脚本纯 ASCII 输出路径无关，AGENTS 与索引两处计数与配置 YAML 解析口径 51 一致。
另收一条今天反复出现的元教训（Lead 与作者各错过一次、方向相反）：**`pre-commit run` 与 git 钩子不是同一根
探针**——config 处于 modified-unstaged 时只有后者 [ERROR] 拒绝，前者与 validate-config 都 Passed
。它与「stash
只覆盖已跟踪未暂存」「未跟踪文件永不进 stash」同族：手跑的探针不能替真提交的探针作证。
|
2026-10-27 03:44:18 +08:00 |
|
|
wandering1
|
b24b2b5f31
|
docs(计数): 内容页黄金参考 27 → 40 全仓同源改写，含钩子显示名这最后一处不同码
CI / L0 静态门禁 (pre-commit) (push) Failing after 49s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 45s
UI 三页落地后机器真值变了，文档却还写着 27 页——这不是笔误，是会骗人的现在时。
作者（batch-auditor）先自己从机器面取数再动笔：git ls-files 里 ref/*.bin = 40、
PAGES 40 项、TEXTS 37 页 310 条、ABSENT 16 页 29 条、池 5448 B 与常驻堆 5368 B 未变、
字库 183 字未扩。**它还纠了我一个数**：我报 ABSENT +19，实测 11 → 29 = +18；作者按
实测写文档，并且不在文档里写 ABSENT 总数，免得把我这个差 1 的数固化成第二真源。
改写面（现在时陈述，共 12 + 3 处）：AGENTS.md 的 ui-golden 半句、门禁说明 ui-golden.md
（标题与「拦不住什么」段）与索引行、simulator/tests/README.md、simulator/README.md 两处、
UI_自动化测试流程.md（310 条 / 40 页 / PASS 文案 / 覆盖面）、内容页架构.md、页面补齐规划.md、
主机单测覆盖率口径.md、自动化测试流程.md、测试开发标准流程.md，外加
.pre-commit-config.yaml 里 ui-golden 的显示名——那是「声明 / 文档 / 实跑」三数同源的最后
一处不同码：AGENTS 与门禁说明都已 40，配置里还写着 27。
两条纪律作者都自证了，不是口头：
· **历史数字一律保留**：8 处变更记录行里的 27 / 242 / 24 / 11 原样未改；两处带日期的
验证记录只加限定语（「该下限此后已扩至 40 页，双次逐字节一致需按同口径重跑回填」），
没有把 27 改成 40 去造连续性。
· **同名不同义的数字不许全局替换**：页面补齐规划.md:12 与 :157、页面扩充详细方案.md:649
里的「27」是**空叶子口径**，与黄金参考数无关——三处故意没动。这条比改对更值钱。
· 余量自证（回退名下 12 文件复跑同一扫描器）：refs +0 / dec +0 / und +0 / 比值 +0.00pp /
错误 +0，本笔零消耗，也未新增任何编号引用；simulator/tests/ref/ 下 40 个 .bin 零改动。
闸线现状照实挂着：id-check 不可判定 1,162 / 上限 1,166，**余量只剩 4**（吃进者是今天
UI 那笔的注释引用，账在 Lead）。清账之前任何人新增编号都可能直接撞闸。
|
2026-10-27 00:16:07 +08:00 |
|
|
wandering1
|
0f8b88337e
|
docs(门禁): 主机侧单测覆盖面改写成口径陈述，第三处计数不同源一并修
「22 根专属钩子」是**口径**不是缺口：test/host 实测 42 个目录去掉 common/__pycache__
= 40 套带 run_unit_test.py，配置里带 -unit-test 后缀的只有 22 根 ⇒ 其余 18 套
（含 ui_sink、console_log、net_socket、lftpd 三兄弟、sys_log_mcu、iec104_serv、
task_prof…）没有独立 files: 触发面，但每次提交都被 test-coverage 总闸全量真跑，
失败照样拦——执行面无洞的证据核到源码：check_test_coverage.py:134 用 rglob 发现
全部 40 套，:44-46 的退出码语义写死「有单测失败即 1」。缺的只是秒级归因。
补钩子的判据也现成：pre-commit 4.x 移除了 always: true，没有 files: 触发面就等于
永不跑，所以**不能**靠"补第 23 根"解决，要补就得先给该模块划触发面。
顺带查出同类的第三处不同源（也在 docs/门禁说明/ 内）：host-unit-tests.md 自己还写
着「16 个钩子 / 另有 12 套 / 总闸跑 28 套」，三个数全部过期，已改成 22 / 18 / 40，
§1 表补齐 2026-10-25 增补的六行，§6 第 4 条重写成覆盖面台账，§9 留变更记录。
另用 git log -S 核实原句「23 个 / 含 ui-sink 七个」是双重错：ui-sink-unit-test、
iec104-serv-unit-test、console-log-unit-test 在配置历史里**从未存在**过。
页数不变（26 篇），钩子数不变（声明 50 / 实跑 50 / 专属单测钩子 22）。
|
2026-10-26 19:27:01 +08:00 |
|
|
wandering1
|
7d9db33a25
|
chore(门禁+文档): 生成器幂等钩子落地，文档真值与 UI 清单销项同步
新增 generated-fresh 钩子（scripts/check_generated_fresh.py，只读）：把 gen_menu.py、
中文字库链、tools/arch_diagram/gen_*.py 拷进系统临时目录重跑，与工作区逐字节必须
一致；钩子本身不写仓库、不 stash 别人在飞的改动。实证起点是上一笔 0f7b5a87 改了
模板文字却没重跑生成物，接线前实测另有 5 张 docs/images 配图已漂（文档挪目录只改了
生成器里的路径）——那 5 张按既有范式钉成只减不增基线，业务生成物零豁免面。
计数三数同源核查：文本 grep 配置得到 51 是把第 63 行**注释掉的** clang-format 候选
算进去了，口径统一为「YAML 解析后的 hook 条目数」= 50（实跑 49 + gitlint = 50），
AGENTS 与 docs/门禁说明/README.md §2 用同一条自查命令。顺带更正「主机侧单测 23 个
（含 ui-sink）」：实为 22 个，test/host/ui_sink 有 run_unit_test.py 却没有 per-module
钩子，只有覆盖率总闸跑得到它（已另立待办，不当既成事实写进文档）。
文档真值一批（都按脚本/仓库实测取数，不抄旧文档）：内容页黄金 11/18 页 → 27 页
（8 处，含 ui-golden 钩子显示名）、文本级断言 50 条 → 242 条、池容量 4784/4864 →
5368/5448（含菜单页面设计.md 与同文档 1.5 节自相矛盾的那处）、页面补齐规划的立项
快照加限定语（日期按该文档自身标题 2026-10-23，不臆造现值）。变更记录里的历史数字
（11 页、50 条、老基线时代的绝对峰值）一律不改；无法实测的绝对峰值改成增量口径并
标注「待按新基线重测」。
销项（用户裁定 2026-10-26）：UI补齐.md 与 README §1 删除「param_request 写路径」
与「整定 4 页」两行并重排序号，叶数口径 12/21/16 改 16/17/12；定值项数按
App/algo/prot_set.h 的 PS_ID_COUNT 更正为 40（原写 31 是旧口径）；「主站地址白名单」
移入当前不做并写明理由：CH395F 单连接 socket 上「拒绝即 close+重 listen」等于给扫描
风暴开门，且该值现在没有任何既有消费点。
台架证据入库（像 = 77779d49，仓外 detached worktree 只读出像）：启动日志、仅复位不
重烧日志、104 定值写读腿、控制台交错一手字节证据与四张板照，boot_log_data 台账登记。
.gitignore 兜一条 %SystemDrive%/：子进程环境缺 SystemDrive/ProgramData 时 UV4 会按
字面量在仓库根建字体缓存目录，本会话实测复发两次，不兜住某次 git add -A 就进历史。
自证：改前后编号门禁 refs / 不可判定 / 比例 / 错误级逐项差值为 0（未把可判定引用改成
散文）；check_doc_links --all 无法判定 0；文档路径检查通过 177 篇。
本笔不含三条在飞源码道与板端导航脚本修复，它们各自单独一笔。
为什么本笔走 --no-verify（按仓库既有约定，非偷懒）：本笔内容是**纯文档 + 门禁脚本/配置 +
台架证据**，不含任何业务代码；而工作树里同时压着三条在飞源码道（UI 装置维护 3 页、
[comm] 配置段、控制台行级原子性）。pre-commit 跑钩子前会 stash 未 staged 改动，那
等于把别人未完成的代码算进本笔账——console_log 套件的属主自己就报告过「当前还没跑过
该套件」。逐条相关门禁已单独实跑：check_doc_links --all（无法判定 0）、check_ids
（余量差值为 0）、generated-fresh 用 .venv 解释器直跑 PASS（4 项 / 一致 3 / 存量基线
1 / 报错 0）、validate-config 0、BOM 漂移与 mojibake 干净、YAML 解析条目 50 与文档
及实跑三数同源。唯一会红的是 mem-budget：磁盘上的 .map 含上述在飞代码，与 HEAD 台账
不同码；台账与体积凭证由我在源码道全部落地后统一重建回填。证据文件：
ci-artifacts/commitA2.log（上一次尝试的完整钩子输出）。
另记一条本笔实测到的坑（已写进 AGENTS「Python 环境」与 docs/门禁说明/generated-fresh.md
§4）：钩子 entry 的裸 python 会被 pre-commit 解析成机器级解释器（本机 = C:\\Python314，
无 fontTools）→ 字体链生成器报 No module named fontTools、generated-fresh 假红。修法
是脚本内自己按「显式 var > 当前解释器 > 仓库 .venv > PATH」解析并做探针校验（装了
pre-commit 不等于装了 fontTools），但 entry 不写死绝对路径，否则门禁被绑死在一台机器。
这与 scripts/ci_local.py 文件头记的 2026-10-11「L0 全灭」是同一族问题的第二次发作。
台架证据补两行：板端 UI 导航脚本修复的真机冷启动闭环 PASS（首帧待机页 UNKNOWN →
按 e → 9 步到 view_set，终帧墨量与黄金 shot_vset 一致），存证同目录；该脚本本身的
改动留给下一笔。
|
2026-10-26 18:26:47 +08:00 |
|
|
wandering1
|
0f7b5a87fb
|
chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。
门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。
test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。
为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。
实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。
基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。
⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。
固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。
.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。
同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
|
2026-10-26 12:28:14 +08:00 |
|
|
wandering1
|
68cbf8ea75
|
docs(任务规划): 按现状重排波次——UI 补齐转为当前波次，数据可信转收口态
用户要求按现状重新规划。盘点后现状与文档已有实质偏差，本次一并纠正。
一、盘点结论（2026-10-25）
- 批 1 / 批 2 / 批 2.5 全部收口，工作树清零、两锁空闲。
- 数据可信：软件侧 100%（卡 1~11 全销项；M4 ②③④⑥、M5 ①②③、M6 全达成），
只剩卡 0（万用表）/ 0b（子板变比）/ 12（标准源）三张台架与外部卡。
- UI：33 叶已绑 12、剩 21。原口径「余批 5 = 整定 4 页」按页面批次统计，
漏了批 1 剩的 3 页（时钟/复归/清除记录）与批 3 的 12 页，实际差 17 叶。
- 结构债：剩 net 收口、白名单、性能簇、dhara、卷锁、USART1 六项。
- 工具链 S12 / A-5 / P1-10 / S1-c 全销项。
二、关键发现：保护整条链现在是闭锁态
protect_task.c:98 要求 UA/UN/IA 的 ADC_CAL_F_VALID 全置位才走判据，而 VALID 只在
两点标定写入 [adc_cal] valid 后才置位（adc_cal.c:338）。产品构建（非 DTU_BENCH）
下保护不动作——这是卡 5 的有意设计，但意味着核心功能当前关闭，解锁只有
卡 0 -> 0b -> 12 一条路。已写进 README §1.1、数据可信 §3、采集保护收尾、AGENTS.md。
三、三条用户判断（2026-10-25）
1. 台架不在手边 -> 卡 0 顺延，本波整体不占编码道。
2. 保护保持未标定闭锁到标准源到位，不用万用表标定走捷径。
3. 下一波只做 UI 补齐，结构债押后。
四、新波次顺序（README §2.0）
采集保护收尾 -> 数据可信（收口态）-> UI 补齐（当前）-> 结构债（押后）->
预算与内存（暂缓）-> 验证常态 -> 仓库决策 -> 暂缓 -> 硬件改版。
排序原则补一条元规则：优先级只在「能开工」的项之间比较——高优先级波次全被
外部资源或硬件代次卡住时，按「现在能整波闭环」重排，阻塞原因写进「为什么在这」列。
五、新增 UI补齐.md（当前波次任务卡）
21 叶按数据源就绪度分三梯队：第一梯队 9 叶零依赖（整定 4 + 维护 3 + 遥测 2）、
第二梯队 4 叶需新配置段（通讯设置 + 遥信 3，后者无开入硬件不立卡）、
第三梯队 6 叶需写入方或计数器（记录 5 + 运行报告）；不排 2 叶（手动录波 / SNTP）。
共 7 张任务卡，单道串行——ui_menu_tree.txt 与 ui_page_registry.c 是单写者生成物。
六、顺带清掉的文档漂移
- 排期详述 §1/§2 还挂着 3 条已销项条目（日志管线 N-2、写回 flush N-22、
探针心跳 N-17），与 README §2 自相矛盾 -> 删除并补销项说明。
- 测试与架构专项：§1 P1-10 与 §2.1 S12、§2.3 A-5 已销项却仍留详述 -> 压缩成证据指针。
- README §1「网络 4」只列 3 条（漏 N-30）-> 补齐。
- docs/README 文件夹地图与登记簿卷首仍称「数据可信 = 当前波次」-> 改指 UI补齐.md。
- 页面补齐规划的就绪度表：遥测死区/系数随卡 10/卡 2 已具备数据层、SOE 页已落地，
三行状态更正；统计口径改为「27 叶中 6 叶已落地，剩 21 叶」。
七、踩到的坑（写进日志备查）
测试与架构专项卷首那段「已完成事项的证据沉淀」清单是 S4/S5/S7/S9/S11 的**定义出处**，
压缩时一并删掉会让校验 2 在 6 个文件上爆 14 类新账（实机测试实施指南 S4x7/S5x5、
check_test_traceability.py S4x5 等）。清单已原样恢复——它看着像历史，实际是门禁的锚点。
八、门禁
check_ids --strict 通过（可判定 9306/11003 = 84.58%，基线 84.0%）；
check_doc_links --all --sections-strict 通过（180 文档 / 2684 处章节引用）。
|
2026-10-25 22:07:29 +08:00 |
|
|
wandering1
|
e2d3f5114e
|
docs(波次): 批 2 主体收口注记（并行分道方案）+ AGENTS 现状句补快照层
并行分道方案：批 2 从"在途"改"主体已收"（卡 8~11 销项、黄金 18 页、
道F 三销项 + F2/F3 已合入待台架两轮判据 + R1 附修），批 2.5 尾单与
批 3 未开明示。AGENTS 现状句链路补 L2.5 遥测快照与遥测/UI 消费者
（与数据主线行同口径）。
|
2026-10-25 19:22:59 +08:00 |
|
|
wandering1
|
ceb753bd44
|
docs(波次): 批 2 道D 销项四卡 + F2/F3 修复态与台架待判 + AGENTS 采集链补快照层
- 数据可信 §5：卡 8~11 销项删行（meas 9c2653c / pts+freq 969fc5c / run_par
7bbcc9c / 快照消费 969fc5c），台架钉证汇总（大窗 S1/S1b 24 项 + 验收窗
walk 10/12、SOE 真时标、PN 守卫、持久化）；README 数据可信行 7→3 卡在途
- 网络行：F2 按位分账已合入 66f862e、F3 sink 往返喂位已合入 9d90e00，
两条语义标识改为"修复已合入、待台架两轮 30min 双零才销"
- UI 行：批 1~4 落地摘要（黄金 18 页），余批 5 = 整定 4 页 + 写路径
- AGENTS 数据主线采集行：L2.5 遥测快照（meas 200ms 双区）入链，
消费者标注 104 与 UI 同源
|
2026-10-25 19:00:51 +08:00 |
|
|
wandering1
|
1a624b1fae
|
chore(ledger+stubs): uibound（F3）合入回填台账；ui_sink stub 随格式钩子修净
merge 9d90e00（F3 sink 往返喂位）后 @build 0/0 重编：Code=224,860 /
ER_IROM1 249,488 / RW=1,332 / ZI=135,100，lane-f 申报（+92B、RAM 79,008）
一致；凭证重盖、内存两账回填、覆盖率基线含新 ui_sink 套（39→40 套，
AGENTS 单测计数 22→23 同步）。stub 五头的空白/末行改动为格式钩子
（trailing-whitespace / end-of-file-fixer）在合并现场落笔，非语义变化。
|
2026-10-25 18:48:37 +08:00 |
|
|
wandering1
|
e771a8ea21
|
docs(门禁计数): 钩子 48→49、单测行 16→22、uinav-selftest 上索引
navtool 合入（3e03375）带进第 49 个钩子 uinav-selftest（快检档，专篇待补、
指针指向 UI_自动化测试流程 §7.3 正文）；门禁 README 索引头 42/25 系批 2
两批钩子未追平，本次一并核账为 49/26+1 指针，主机单测行 16→22（含批 2
六新套）；AGENTS 两处计数与新增括注同步。纯计数与索引，无口径变化。
|
2026-10-25 18:10:44 +08:00 |
|
|
wandering1
|
7099c56c34
|
chore(ledger): pages 批 1~4 合入后回填凭证/覆盖率并同步黄金参考计数
task/pages-ui 合入（merge dea7591 + 修复 498cc60）：三页回炉 + SOE 页 +
四查看页 + 遥信 33 行页 + ui_data 三通道 + soe_store 只读 API + 字库与
门禁配套共 12 笔。凭证重盖（Code=224,688 / RW_IRAM1 78,992 B=60.3% /
CCM 87.9%）；覆盖率基线 39/39 套件复算。ui-golden 黄金参考 11→18 页
随批 4 扩容，AGENTS 门禁行/索引行与门禁说明两处、覆盖率口径一处同步；
两篇新详解（bom-guard/setview-check）已由道E 交付、索引去"待补"。
memset 隐式声明一条教训：分支树增量构建"0 警"不覆盖未重编文件，
done 主树全量重编才是终判。
|
2026-10-25 15:49:42 +08:00 |
|
|
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 |
|
|
wandering1
|
42b47aa5ac
|
chore(ledger): runpar 合入后回填台账/凭证/覆盖率并同步计数
task/runpar-par 合入（merge 7bbcc9c）：卡10 运行参数段 [run_par] 9 键 +
104 映射 0x8030~0x804F + 死区真源收编 + SYS_EVT_RUN_PAR_SAVE 落盘链。
@build 0/0：Code=219,620 / RO=22,036 / RW=1,280 / ZI=132,864；
RW_IRAM1 76,720 B（58.6%）、CCM 87.9%。Flash +1,912 B、RAM +8 B 与
lane-d 申报一致，--no-verify 欠账清。meas.c 静态更名越界照准（同 TU
撞名 C2369 的最小修）。run_par.c 入覆盖率基线（39/39 套件）；钩子
45→46、单测钩子 21→22、总闸 38→39（AGENTS + 门禁 README）。
|
2026-10-25 13:21:39 +08:00 |
|
|
wandering1
|
adeef7d21b
|
chore(ledger): meas 与 n17 两笔合入后回填台账/凭证/覆盖率并同步计数
task/meas-snap 合入（merge 9c2653c，meas 快照层，分支树冲突由 lead 并集
手工解：id_registry 三族 UIDATA/VOLSYNC/MEAS 共存，JSON 校验过；该合并
提交按 mem 域例外 --no-verify，理由=合并树 .map 滞后，回填本笔兑现）。
task/n17-probe 合入（merge 969fc5c，drop 路径异步化 Flash +16 B/RAM 0）。
合并后 @build 0/0：Code=217,828 / RO=21,600 / RW=1,264 / ZI=132,840；
RW_IRAM1 76,664 B（58.5%）、CCM 87.9% 不变。覆盖率 38/38 套件基线登记
（meas.c 入账）；凭证按最终 .map 重盖。计数：钩子 44→45、单测钩子
20→21、总闸 37→38 套（AGENTS + 门禁 README）。
|
2026-10-25 10:37:05 +08:00 |
|
|
wandering1
|
b746a1ff00
|
chore(ledger): ui-data 合入后回填台账/凭证/覆盖率并同步门禁计数
task/ui-data-feed 合入（merge 98664a1）：ui_data 三通道快照 +
ui_data_feed 装配 + ui_w_soe 显示名 + 字库 +4 字（采/样/恢/效，
179→183）。合并后 @build 0/0：Code=217,204 / RO=21,504 /
RW=1,256 / ZI=132,680；RW_IRAM1 76,512 B（58.4%）、CCM 87.9%。
lane-e 分支侧 --no-verify 欠账清；覆盖率基线登记 ui_data.c
（37/37 套件、tested 41）；凭证重盖（L0c 恢复序列）。
AGENTS/门禁 README 计数 42→44 钩、18→20 单测钩子（n22+ui-data 两笔带进来）。
|
2026-10-25 10:07:15 +08:00 |
|
|
wandering1
|
8c28f3bfdd
|
docs(收口同步): 批 1 落地后 AGENTS/104/算法层口径更新 + SOE 7/8 消费面补齐
- AGENTS.md：钩子 40→42、主机单测钩子 16→18（adc-cal/prot-dim）、
覆盖率总闸 28→35 套、layer-deps 基线 6→3（记录 reader 注入兑现）
- IEC104上行设计说明.md：遥测读数改工程量口径 + 死区额定 0.5% 重定
已落地（卡 6）；§8 第 4 条改写、变更记录追加行
- 采集与算法层设计说明.md：状态行/红线③/幅值门三处由「标定未实现」
更新为「折算已落地、精度复核待卡 12 注入」
- App/log/soe_rec.h 类型注释表补 7/8 两行（lane-a 口误 6/7 已勘误，
真值按枚举链 SAMPLE_RESUME=6 连续计数）
- test/host/soe/decode_soe.py：TYPE_NAMES + docstring 补 7/8——
否则台架 FTP 下载校验会把标定闭锁记录判 bad type 误红（隐藏消费边）；
soe 套件 32/32 复跑绿
|
2026-10-25 05:55:00 +08:00 |
|
|
wandering1
|
744a1cb086
|
ci(gates): 接线 test-coverage 覆盖率总闸（FAIL 语义），并修三处已成假话的门禁文档
用户裁定 2026-10-24：缺 mscoverage 组件时**失败**，不做 skip。于是 P1 之后那个
"钩子只挂 16/28 套"的缺口关闭了。
为什么挂这一根而不是补 12 根 per-module 钩子：本闸跑**全部 28 套**，并且守
"已覆盖行只增不减"的基线台账。这是 per-module 钩子结构性做不到的——删掉一套
测试，它那根钩子只会因为"没有文件要检查"而静默跳过（Skipped 不等于失败）。
实测接线代价：45 s（28 套，含 28 次 MSVC 编译与插桩运行）。
FAIL 语义已按本仓"合成自证"的纪律验证（不是只测绿的那一半）：把
DTU_MS_COVERAGE 指到一个不存在的文件 → 钩子 Failed、脚本退出码 2、并打印可
执行的 [ENV] 提示（说明该 exe 装在哪、怎么覆盖）。脚本对显式环境变量刻意
"不做自动探测回退"，所以指错会被点名，而不是悄悄换一份工具跑出另一本账。
顺手修掉三条**现在已经不成立**的文档说法（门禁文档最贵的就是骗人）：
- 口径 §7 第 8 条：原写"只有 BuildTools 且没勾代码覆盖率工具的机器会退出码 2"。
实测本机 Community 18.10 与 BuildTools 18.9 **两份安装都自带**该 exe（mtime
2026-09-15 02:30 / 2026-09-05 16:17，都是各自安装当日，不是后来补勾）→ VS 18
的 BuildTools 默认就带它。真实风险面只剩：裸 MSVC 无 VS 的机器、环境变量指错、
以及靠 PATH 兜底的环境。
- 门禁说明 host-unit-tests.md 盲区第 4 条：原写"没有对应钩子的模块 = 零回归"——
如今 12 套新模块由总闸兜住，这句话已经不成立，改成两种口径并写清触发面。
- 同篇第 6 条：原写"无覆盖率统计"。行/函数覆盖**已有**度量（本闸出 Cobertura 并
守基线），仍无的只是分支覆盖——那是用户裁定 2026-10-23 记下的**已接受缺口**，
不是待办，改口时把这个区分写清楚。
钩子计数同步（新增 1 根 → 声明 40 根 / pre-commit 阶段 39 根 + commit-msg 的
gitlint，已用脚本核对，不是手数）：AGENTS.md（总数、枚举、索引表）、
pre-commit使用说明.md（66 / 91 / 234 三处，含清点日期）、门禁说明 README
（正文与索引标题，另加一行索引指向口径文档——23 篇不变，同一事实不在两处维护）、
门禁说明 gitlint.md（--no-verify 跳过的"其它 38 个"→39）、并行任务工作树方案。
自查：end-of-file-fixer 与 trailing-whitespace 复跑 Passed（首轮 --all-files 只
因末行空行红过一次，已按钩子自身规范化）；doc-links --all --sections-strict 通过
（178 个文档）；id-check --strict 零台账外新账；8 个改动文件 U+FFFD = 0、无 CRLF。
零代码改动，故未跑 @build。未 push。
|
2026-10-24 07:50:53 +08:00 |
|
|
wandering1
|
6505cef9df
|
feat(门禁): coding-standard 加 CODE-RULE-20 禁 C 库堆分配（销 §4.8 空白 ②）
规则：在**掩码后**的文本上匹配 malloc/calloc/realloc/strdup/strndup/
free/aligned_alloc 调用。三条判据都是踩过坑之后定的——
- 大小写敏感：pvPortMalloc / vPortFree（唯一允许的配对）不会误报；
- 词边界 \b：dhara_nand_is_free(、buf_alloc( 这类同形后缀不误报；
- 用掩码：注释与字符串字面量里写 malloc 不报（规范示例就踩过这种）。
覆盖名比 AGENTS 列的五枚多带上 strndup / aligned_alloc——同族同类，
漏一个就等于留后门。
出处不在规范 V1.0，在平台约束：MicroLIB 的 C 堆由 startup_stm32f407xx.s
的 Heap_Size EQU 0x200 只有 512 B，KB 级分配必返 NULL，而模拟器（宿主
CRT 堆）完全正常、**照不出来**——配置引擎 2026-09-18 那次堆分配纠偏与
lftpd 的 malloc 隐患都是**先上线才发现**的那类，靠评审等于没管。
落地前按 门禁说明/coding-standard.md §8 的纪律先全库普查：钩子范围内
C/H 共 151 个文件，命中**只有** simulator/sim/cfg_file_store_sim.c 两行，
即 cfg_store_alloc/cfg_store_free = **平台分配后端的宿主侧实现**（设计依据
写在 docs/子系统设计/配置文件设计说明.md 的"MCU 端 = pvPortMalloc、
模拟器端 = 宿主 CRT"）。所以零基线、直接硬拦截；豁免用脚本里的
HEAP_ALLOC_ALLOWLIST（**文件路径 + 函数名**双条件），刻意不做目录级豁免：
下次谁要碰 C 堆就得往这张表加一行，评审看得见。
自证：临时样例文件里 malloc/calloc/free 各报一处，pvPortMalloc/vPortFree/
buf_alloc(、注释、字符串五种陷阱形态全部不误报；
pre-commit run coding-standard --all-files → **Passed**（= 全库零存量）。
顺带修三处口径不一致：
- 规范 V1.0 §6.1 的示例自己写着 malloc/free（通用 C 模板遗留）→ 已在示例
下加"本仓例外，别照抄"批注，事实源指向 AGENTS.md 平台约束；
- docs/门禁说明/mem-budget.md 里"这条纪律只靠 AGENTS 铁律与评审"已过期 →
更正为由 CODE-RULE-20 机器拦截；
- AGENTS.md 平台约束条加"已机器拦截 + 唯一豁免"一句；scripts/README.md
补登 check_test_coverage.py（上一个提交漏登记）。
另：本次一并修好上一处编辑事故——报告 §4.8 曾被我的脚本调用截成半句
（只落第一行、丢掉 malloc 那半句），已重写为"两处空白均已闭合"。
自查：pre-commit run --files（9 个改动文件）适用项全 Passed；
check_doc_links.py --all = 35 处，与主干同数（本分支贡献 0）；
check_ids.py --strict 通过（裸编号 P0-1 改平实说法，避免记成新账）；
9 个文件 BOM/CR/U+FFFD/行尾与 HEAD 逐项一致。本轮零 .c/.h 改动，未跑
@build、未占 build/bench 锁；分支已 rebase 到 v2-on-ui，覆盖率脚本全量
回归仍 16/16、line=2552/2893 不变。
|
2026-10-23 23:44:46 +08:00 |
|
|
wandering1
|
6822726b2c
|
docs(门禁说明): 手册 §2 收敛为通用机制与查号表，逐项详解归一到 23 篇
用户一句"现在门禁都在干什么，我一概不知"引出的收尾。原手册 §2 有 27 个逐钩子小节，只回答
"拦了什么、怎么配"，回答不了"什么时候会骗我"；docs/门禁说明/ 已把逐项详解（含"限制与盲区"
一节）建好，本笔做收敛：同一事实只留一处（docs/文档规范.md 的要求）。
**先搬后删**（否则收敛等于丢事实）：旧 §2 里独有条目逐篇折回，共 18 处插入、15 篇受益。折回的
东西包括：六套主机单测的来历与用例规模（13/36/82/46/32/149 断言，含 nand-port 的"与旧算法
对照"）与"改动公共骨架 unit_test_harness.py 会同时触发 16 个钩子"；UI 页面**两层注册**（构建
注册 vs 框架注册：枚举 + s_defs[] 描述符表）与"豁免不整目录一刀切"；lv-conf-sync 首次落地清掉
26 个 LVGL 9.3 不存在的选项、3 处重复定义、10 项隐式开关显式化，以及 ALLOW_DIFF 端专属白名单
与必须穿过 lv_conf_internal.h 里那层 KCONFIG 包裹；cubemx-survival 的 16 项清单、断言前先剥
C 注释（本仓注释刻意引用历史代码，不剥就恒定误报）、旧手册"自造标记区"建议与看门狗文档实测
教训之间的优先级；id-check 顺带收编 check_test_traceability.py、裸形同字母多义属**显式承认的
盲区**、--update-baseline 只许涨；layer-deps 的注入自证与报错时三条修法（注入回调 / 上层递数据
/ 才谈 ALLOW）；coding-standard **nand_ftl.* 也在排除清单**（我先前那篇漏了）；test-suite-switch
的剥注释判定与派生宏白名单；mem-budget 两类软提醒不拦、退出码 2 是解析失败不是通过；doc-links
的排除目录与状态词 ±40 字符距离；task-table 改栈三步；gitlint 报错样例；no-mojibake 的修复路径。
**顺带抓到旧文档两处错**（记进文档，不悄悄改）：一是 check-added-large-files 的阈值旧手册写
"单个文件 > 1MB"，按本机安装的钩子源码实测是 --maxkb 默认 **500**（500 KB）——已更正，并把
"本目录任何默认值都以实测或安装的钩子源码为准"写进 end-of-file-fixer 当反面教材；二是
**ui-golden 在旧手册里连小节都没有**，只活在配置注释里：除了"有基线不等于有门禁"，这是另一种
失踪——有钩子、没文档。
手册 §2 改写为三节：迁移说明 / **旧编号 → 新文档 查号表**（历史引用靠它读，旧号按"冻结历史不
回改"保留）/ **跨钩子通用机制**：两阶段与换机必须重装 hooks 才带 commit-msg、stash 陷阱、
always: true 已废、改写型与只读型豁免不对称、增量拦截三段式且刻意没有 --write、没有 .map 是
"跳过"不是"通过"、改配置的验收是看目标钩子出现在输出里且不是 Skipped、新增门禁三步必须做
注入自证且"限制与盲区"不许留空，另有快速自查入口。手册 707 行 → 273 行。
引用**按内容**重指（只核编号存在与否不够，同号小节会被当本文自引用静默放过）：编号规范、
scripts/README（顺带更正那里过时的 warn-only 说法，早已关闸为增量拦截）、RAM 使用分析与优化
方案、测试开发标准流程、lvgl-simulator skill、AGENTS 文档表（拆成"每门禁一篇详解"与"通用
机制"两行）、.pre-commit-config.yaml 头注释、docs/README.md 描述、手册自身 §5.5 与 §6 的两处
内部引用。另：表格里的裸节号会被 doc-links 判成本文自引用，查号表统一写成不带 § 的形态。
写说明过程又被自家门禁拦一次：gitlint 篇里引用报错样例时写了两个规则号字面量，被判形态不合规
→ 改成中文描述，没有往台账里塞 reason 解决。
验证：纯文档与注释改动，不动代码，Program Size 不变，故不跑 @build/@test；
check_doc_links --all --sections-strict **171 篇 0 问题**；id-check 增量拦截通过；
pre-commit run **RC=0 / 13 项 Passed**；28 个改动文件字节卫生 **0 异常**（无 BOM、无 CR、
无 U+FFFD、均 LF、无行尾空白）。
|
2026-10-23 11:44:21 +08:00 |
|