65 Commits

Author	SHA1	Message	Date
wandering1	4ceb5b41e6	docs(任务规划): 故障录波卡片登记簿销项——判据并入设计说明后删除 ... 用户指令（2026-10-30）：确认录波任务完成度，把除实际操作之外的所有 步骤做完，然后删除规划文件，避免已完成的工作被误读为未做。 审计结论：代码面确已全部收口——wave_read.py --selftest 92/92、 三套主机单测 113/170/110 复跑全 rc=0、bench 自抓与 PC 读段脚本在仓、 数据可信/复刻明细/短板评测/UI 两处回写均已做过。**唯一未跑的是 板级台架那一轮（实际操作）**，判据不得丢，故先迁后删： - 设计说明 §9 承接落盘道失败留痕名全清单（13+1 条，打印点现值 default_task.c:816/:831 实测核对） - 设计说明 §10 承接原卡 2/卡 3 的板级段（触发来路一行、回放页 一行）与本波执行顺序图（mermaid，原规划 §3 逐字迁） - §4/§11 头部定位、§11 尾注、§14 关系行改属主口径 - 全库 32 处引用改挂设计说明 §10/§9（18 文件）：任务规划 README 独立行（顺带订正单测数 100→113 为实测）、登记簿、数据可信 ×2、 复刻明细、产品需求 ×2、ADC 注入 ×3、短板评测 ×2、页面补齐规划、 App/algo README、配图生成器注释、录波三套单测注释 ×6 - git rm docs 该规划文件；人类索引任务规划 6→5 个文件（沿革注照 屏板链路先例走裸句，不留反引号死引用） 验证：残留两形态（任务规划/故障录波、裸文件名）全树扫描 0； mermaid 预检新发 0；doc-links 11 个被改文件逐文件 PASS；生成器 注释改动重跑产物逐字节不变（svg 60a0dd39e4）；三套单测与 wave_read selftest 复跑全绿；18 文件 BOM/CR/U+FFFD 全零。 本笔不含固件编译单元（test/host 仅注释行与文档），构建留待合并 轮统一跑；板级轮启动判据与顺序见设计说明 §10。	2026-10-30 18:20:37 +08:00
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	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	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	88601422c3	docs(文档规范): 清空壳变更记录节，例外清单改成可复跑口径 ... 17 篇文档的变更记录（含修订记录、带编号与中文序号标题）节里只剩一句 「不再记流水账」的占位话，整节删掉，连带它前面的分隔线。 仍保留真台账的只有 5 篇（看门狗 / 配置文件设计 / RAM 预算台账 / 内容页架构 / 本地工具路径方案），外加 scripts/archive 归档区。 份数口径改成可复跑的普查：文档规范 §5.1 补自查命令， stale-doc-count-sweep 的速查表与陷阱各加一条——只 grep 裸标题会漏 带编号与中文序号的两种写法，实测 5 篇只数得出 3 篇，差点据此把 全仓正确的份数改错。 门禁：逐篇与全量 check_doc_links 除 simulator/SDL2 联接假红外 0 问题； skill-size rc=0；表格列数与字节体检相对 HEAD 零新增问题。	2026-10-29 21:21:59 +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	d64bbdc57f	feat(wave): 故障录波数据面、接线与单通道回放页（软件闭环交付） ... 数据面（App/algo，纯逻辑，双端编译） - wave_ring：8 路 × 320 点列优先环（1 kHz，预触发 160 + 后触发 160），adcTask 唯一写者；触发/冻结/封存/冷却四态，冻结持续到落盘回执才解冻，滞留 2 s 自弃 兜底——下一次真故障无波可录比丢一段更贵 - wave_store：段头编解码 + 拉模式打包游标 + 自带无表位运算 CRC-16/MODBUS（带 锚点自检）+ 段名与整段长度等式；格式不依赖平台类型宽度 - 段头只存原始码值与封存瞬间生效系数，工程量只当单位标签、不进任何算式 - 三套主机单测（环 113 / 编解码 170 / 触发状态机 110），全部无桩、生产源原样 纳入；新文件补 stddef 是 ARMCC 与主机差异，主机侧照不出这条分叉 - test/host/wave_read.py 是按 §6.2 的独立第二实现（dump/fft/shape/plot），92 条 自洽断言；三份合成段互读双校验全过、哈希钉死，格式面双向闭合 - 三套新单测不加专属钩子，由覆盖率总闸全量真跑（沿用既有裁定） 接线（任务层） - adc_cal：新增生效系数的 32 位定点原值入口（与既有浮点入口共用生效视图）， 段头按最低有效位精确记账，不经浮点回算 - adcTask：每拍压 8 路语义原始码值并推进状态机，封存那一拍同拍交棒封存瞬间事实； 台架定周期自抓走双层编译门，产品镜像里零存在；串口新增一条 wave: 周期行 - defaultTask：卷空闲后一次心跳整段搬完（try 锁 + 256 字节分片 + 一次完整开档到 关档），成败都回执；失败先删半成品再计错，段号只在成功时推进；持锁超 50 ms 补一条告警并记历史峰值（喂狗余量可核） - Lead 复核补第四道并发陷阱：采集任务优先级高于落盘道，搬段中途它可能正好把滞留 超时的本段自弃、甚至封出下一段——数据区校验和是对「实际读到的字节」算的， 半新半旧的段照样自洽，故关档后复检环侧身份判废：删文件、不补账、段号不推进 - Lead 复核抓到触发挂号不是原子操作（旧实现分三个字节写，消费者可在窗口里读到 上一段的触发源与元件号）：已把载荷压进一个字节，越界当场拒且不记任何计数； 段文件字节布局零改动，三份合成段哈希逐字节不变 - protectTask：保护启动上升沿同点请求录波，一拍一次、元件号取最低位；判据本体 零改动 人机（160×160 单色屏） - 菜单树节点 26「手动录波」绑页面 + 记录查询组末新增「录波回放」叶，重跑生成器 得 43 节点 / 34 叶 / 30 已绑，页面映射 28 → 30 - 回放页一屏一路、触发点前后各一周波共 40 点、每点 3 像素阶梯线（只用水平与 垂直两种线段——单色屏斜线会被阈值裁掉）；零点虚线、触发光标、窗口峰值、 单位徽标与形状受限徽标；空态与坏段各一句显式文案，绝不用半截波形冒充数据 - ui_data 新增录波注入通道（六件操作表、三态返回）；执行侧胶水带段头缓存、 手动请求后连缓存一起作废、逐点走全仓唯一的码值换算入口 - 模拟器接真实环与编解码合成两段（含坏段与空态旗标），6 张新黄金参考，既有 60 张逐字节零漂移未用更新模式；字库 218 → 224 字 / 319 字形 - 两份图形配置里图表组件仍为关；零堆分配；页面池水位不变 - 回放读路径的 uiTask 阻塞上界按实码写清：一次渲染 = 段表刷新 + 未缓存段头最坏 22 次小读；已验段只剩一次开窗读 + 40 点解码；无实测数不编，实测归台架、 仪器用已在跑的单轮工作耗时探针，不新加埋点 台账与文档 - 内存台账：录波环与落盘/回放静态逐条入册，三档对照 81,536 → 88,296 → 89,936 字节（62.2% → 68.6%），累计 +8,400；预估 5.9 KB 与实测 +6,760 的差额点名； 散列文件头注释同步；任务栈表核对后无需抬栈；体积趋势行与同码凭证由权威构建 重打（0 错误 0 警告，四项体积与上一轮相同——本轮改动只有注释与声明位置） - 设计说明：§5 补第四条并发陷阱；§6.3 定字段口径（两份独立实现的共同依据）； §7 回填实测；§9 周期行写实；§10 台架判据改两段式且不比绝对相位；§12 补读路径 风险行；抬头状态改成「代码面已交付、未做完的只有板级那一轮」 - 卡片：软件闭环一栏列证据；台架三条按用户裁定保持未完成，不做虚假销项 - 口径同步：数据可信、UI 补齐、页面补齐规划、产品需求、采集短板评测、任务规划 索引与两份 README；陈旧现状句清扫 16 处（带日期戳的历史取数行一律不动） - 门禁说明：nested-comment 记仓库根探测必须兼容 linked worktree 的 gitdir 文件 形态（修前该钩子在任务树里恒报环境错、静默不可用）；coding-standard 记 「函数头注释超过 24 行就把函数功能挤出回看窗口」这条机制与本次现场 - 覆盖率基线登记两个新覆盖模块（套件 41 → 44 套）；环单测重打后该文件有效行 227 → 226、覆盖行 226 → 225，比率仍 99.6%，是分母变小不是覆盖率回退 为什么是单一提交：文档链接、双端注册、生成器幂等（菜单与字库）、内存数字与 体积事实源、编号门禁这五道整仓门禁要求代码、页面、菜单树、字库、文档与台账 同处一个提交才自洽，按数据面/接线/人机/台账拆成四笔必然红其中至少四道 编号门禁新增行 14 处命中已按语义改写：魔数常量按字符命名、段名样例改由格式串 生成、频谱表头改 f / 2x / 5x 并加一行图例；改写后自洽断言 92 条仍全过	2026-10-29 19:23:15 +08:00
wandering1	d0e73d6553	docs: 录波立项波及的口径同步（索引、登记簿、需求与 UI 状态行） ... 任务规划 README 顺序表：录波从「当前不排」移到独立行；动态波形验证让位给录波 数据面（段文件是现成的样本出口）。 登记簿：录波与 104 文件传输拆成两行，前者解除暂缓并指向新文档。 产品需求：立项未排行、录波文件存储行、文件传输行、录波采样率行补偏离登记指针。 UI：页面补齐规划第 26 叶与 UI补齐「不做」表改指故障录波立项，旧重开条件已满足。 短板评测记录链行、ADC前端注入验证流程的读数出口注、图形绘制流程与 tools/arch_diagram/README 的生成器清单同步。	2026-10-29 13:19:12 +08:00
wandering1	5f69f38dfd	chore(term): 并发会话收尾四处——注释术语、引用路径、计数解绑 ... 这四处是并发会话留在工作区的完成态改动，按用户「全部都提交」一并 入库，逐项依据如下。 - App/task/protect_task.c：三处静态变量注释「上拍」→「上一拍」， 纯注释无语义变化。@build 实测 0 错误 0 警告（Code=236456 RO-data=28124 → ER_IROM1 264580，与 scripts/size_attestation.json 同数；RW=1876 / ZI=137084）。 - docs/UI设计/RemoDispBus协议与接收设计说明.md：补术语同义说明 （「远程显示」与「远程画面推送」同义，都指 RemoDispBus 推流）。 - docs/测试说明/m2_data/README.md：对端脚本路径改为 test/host/latency_peer.py——原写的 test\latency_peer.py 已不存在 （实测 No such file，脚本现落在 test/host/ 下）。 - docs/环境与部署/并行任务工作树方案.md:408：索引行改为「提交门禁 钩子逐项详解」，不在文档里写死钩子条数（声明数唯一口径源 = docs/门禁说明/README.md §2，加钩子时少一处必改点）。 门禁：pre-commit run --all-files = 47 根 Passed、0 Failed，rc=0。	2026-10-29 00:58:23 +08:00
wandering1	16be01915d	chore(docs): 补齐文件末尾换行（end-of-file-fixer 实测 18 篇） ... 提交后台跑 scripts/ci_local.py 时 end-of-file-fixer 报 Failed 并就地修复： 17 篇补文件末尾换行、1 篇去掉行尾空行。 内容零变化：git diff --ignore-all-space 只有 1 处空行删除；18 篇均在 上一笔流水清理里被改过，恢复补丁时把上一轮的 EOF 修复冲掉了，这一 笔补回。	2026-10-28 22:12:59 +08:00
wandering1	511fd30cc6	docs: 清理全仓变更记录流水（43 篇整节删 / 23 篇留一行 / 5 篇保留） ... 用户裁定：文档只写现状，历史流水一律删掉，过程查 git log。 - 43 篇「变更记录 / 修订记录」整节删除：继电保护规划 12.6 KB、产品 需求 11.8 KB、项目部署环境 5.5 KB、BSD Socket 指南 5.3 KB、架构 总览 5.0 KB、实机测试实施指南 3.8 KB 等 - 23 篇别处仍有指向：只留节名 + 一行「本文件不再记流水账，过程查 git log」，节号与锚点不位移（doc-links 不因此断链） - 5 篇整表保留（被当唯一证据 / 活台账引用）：看门狗设计说明、配置 文件设计说明、RAM预算台账、内容页架构、本地工具路径环境变量方案 - 规范同步：文档规范 §5.1 改新裁定；测试文档模板规范删示例节与 登记句；测试开发标准流程 / UI 两篇 / 实机测试实施指南 / 四篇单测 说明 / 并行任务工作树方案 / 编号规范 的「登记变更记录」改「写进 正文」 - 技能同步：stale-doc-count-sweep / ui-verify / id-family 三个 SKILL 正文不再要求追加流水行（顺带消掉 SKILL.md:121「产品需求 §12」 失效引用） - 修 5 处悬空指针：采样有效性校验目录锚点、BSD 指南「文末变更 记录」、docs/README 过期描述、网络自愈架构两处指向面 72 篇文档净减 600 余行；check_doc_links --all --sections-strict 可判 定比例 61% → 78%、失效引用 0；静态门禁 passed=50 failed=0；gitlint 10 条历史提交信息 0 failed。 未提交他人在飞改动：.dsh/skills/keil-build/*（%SystemDrive% 守卫）。	2026-10-28 22:00:34 +08:00
wandering1	8f8d97b3d8	docs(编号): 批次六余账文档面——CubeMX 层号、双写疤、采集链旧层名共 61 站点 ... - CubeMX 防丢失三层优先级 L1/L2/L3（批次 3c 漏网 30 处）：看门狗设计说明 25、 门禁说明/cubemx-survival 3（含「优先 L1/L2」→「优先写进 .ioc 与搬进 USER CODE 区」）、ADC通道映射 2。 - 改名遗留的中文重叠双写 14 处：菜单页面设计「一级菜单菜单」×6、「二级菜单菜单」 ×2；README「语义取数与有效性」重复；存储架构「3字节字节地址」；链路延迟 「队列往返队列往返」；继电保护「出口出口与记录层」；产品需求「全周傅氏相量」重复。 - 采集链旧层名 5 处：「L2 相量层」→ 全周傅氏相量、「L0 采样驱动」→ 采样驱动层、 「L2-x 前缀」→ 相量输出标签前缀、「L1 层 v2.3」→ 语义取数与有效性层 v2.3。 - UI 菜单层级 2 处：产品需求「4 级（L0~L3）」→「4 级（主界面 / 一级 / 二级 / 三级菜单）」、「主界面 (L0)」→「主界面」。 - 登记簿条目改名「L5 队列往返基线待重验」→「队列往返基线待重验」+ 引用侧 5 处 同步（登记簿 §1/§7、实机测试实施指南 §7.3 与步骤表、编号规范 §1 好例子清单—— 那个混在短语里的 L5 恰恰是个坏例子）。归档里的历史 note 原文不动。 - 归档 §10.3：四族收口记录 + 边界与裁定（peer JSON 键属冻结证据 schema 不改； REQ2FIRST / FULLFRAME 不并入 FRAME_RT；L1-3/L1-4 属不可还原死号，就地删号留 事实；「原 L2 基线 3/10」按上下文读作主机侧回归的早期基线）。 - 判族保留（永久）：硬件位号与封装尺寸 27 处（网表 L1~L3 磁珠电感、 SOT-23_L2.9-W1.3、CRYSTAL-L3.2）、芯片手册原文 3 处双写；伪命中 4 条没删 （「遥测量 测量值」「已登记登记簿」「谁来监视监视者」×2）——那些是正常词组。 - 门禁：check_doc_links --all --sections-strict 通过（195 篇、章节引用 3292 处）； git diff --check 干净；逐文件 BOM / U+FFFD / CRLF 与 HEAD 一致。	2026-10-28 18:57:03 +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	078a27a096	docs(补漏): 提交后复扫逮到两处——张数口径漏网 + 绑定叶数口径闭合 ... 这一笔是**提交之后**按全部旧形态复扫才揪出来的（复扫是收尾硬步骤）： - docs/任务规划/README.md §1：当前态仍写「内容页黄金参考 53 → 60 页」， 与前两笔刚定的口径（当前态一律报「张」）自相矛盾 → 改报 60 张，并把 换算式写进同一句（张数 = 页面个数 + 分页页多拍的那一张）。 - docs/UI设计/页面补齐规划.md §2.3 复核行：本表说「22 叶已落地」、而 全树实测已绑 28 叶，两个数不同口径却并存在读者面前 → 补闭合式：本表 22 叶 + 立项前就已绑定、不在本表内的 6 叶（装置信息 / 交流量 / 直流量 / 网口设置 / 自检记录 / 运行记录）= 28 叶 = UI_PAGE_MAP_COUNT；本表 未落地 5 叶 = 菜单树未绑 5 叶（33 − 28）。同时把可复核的重算方法写进 文档（按缩进判叶子：有更深缩进后继者即非叶子；再按行内 #page= 数已绑）， 避免下轮再把 42 个节点行当叶子数。 刻意不动（本轮复扫的其余 37 处命中，逐条都能归类）： - 变更记录历史行（27 → 40 → 47 → 53→60 / 59、122/217、179/274、185/280、 183/278）按当日事实冻结，只追加不回填； - 带日期戳的实测已加「当时」（font-charset.md §6.1、generated-fresh.md §7、 check_font_charset.py 注释、UI_自动化测试流程.md §2、主机单测覆盖率口径.md）； - 同数不同义：绘制缓冲红线 < 40KB、网表引脚号 119/122、字节数 262144、 覆盖率分数 97/97、uinav 快检档自己的 18 张参考帧； - Drivers/BSP/UI/ 三个 .c 注释里的「183 字子集」是当时的 font-charset 实测注记：实测「天」「率」至今仍不在 218 字清单里，结论未失效， 而改 .c 注释按 AGENTS 须先 @build 0 错 0 警，不混进文档同步这笔。	2026-10-28 15:45:43 +08:00
wandering1	c0fcf4c4f7	docs(口径): 三处带日期戳的实测只补「当时」锁口径，不臆改成现值 ... 三条命中都不是陈旧值、而是**当时的实测记录**，改成现值等于把历史测量 冒充现状；动作 = 只补「当时」二字（并按需注明现值出处）： - docs/内存管理/RAM使用分析与优化方案.md §4.1.1：2026-10-15 缩池那次的 验证口径里「11 页黄金参考」→「当时 11 页」；该集合现按入库张数报 60 张。 - docs/门禁说明/generated-fresh.md §7：2026-10-26 接线基线里的「183 字」 →「当时 183 字」（现值 = ui_cn_chars.txt 唯一码点 218，ASCII 区 0 个）， 并按日期升序在 §9 末行追加当日一行说明本次只锁口径、没动旧数。 - docs/UI设计/UI_数据供给设计说明.md §9 判据表：2026-10-26 双次逐字节 一致那次写的是「当时下限 27 页」，同句现值改报 60 张（与判据本体同源）。 同数不同义、刻意不动（写明理由）：docs/UI设计/UI_界面制作流程.md 的 「最坏路径 < 40KB」是绘制缓冲红线；docs/硬件平台/V0.1_网表详细分析报告.md 的 119/122 是引脚号；docs/测试说明/CH395F_Test_Guide.md 的 262144/4097 是字节数；docs/测试说明/主机单测覆盖率口径.md 的 97/97 是覆盖率分数。	2026-10-28 15:40:40 +08:00
wandering1	dc214e1426	docs(UI): 内容页黄金参考当前态改报「60 张」，三数按双源实测同步 ... 三数实测真值（每项两个独立来源互证）： - 张数 60：simulator/tests/ref/ 入库 shot_*.bin 实数 60 ＝ check_content_pages.py 的 PAGES 条目数 60（id 逐一对齐）。 - 已绑 28 叶 / 未绑 5 叶：ui_page_registry.h 的 UI_PAGE_MAP_COUNT 28 ＝ ui_menu_tree.txt 剔掉文件头注释示例行后的 #page= 实数（不剔是 29）。 - 字体 218 唯一字 / 313 字形：ui_cn_chars.txt 唯一码点 218（ASCII 区 0 个，ASCII 0x20~0x7E 由生成器子集参数另计、不算进字数）； ui_font_cn_12.c 的 .bitmap_index 条目 314 条含 notdef，剔掉 notdef → 313 = 218 + ASCII 95。 口径更正（数字一律不动）：当前态计数单位由「页」改报「张」——张数 = 页面个数 + 分页页多拍的第 2 屏（runreport_p2 / sparam_p2 两张），两个数 不许互相冒充。同日先前那行「53 → 59 页」是页面个数口径、与判据本体 不同源，原文冻结不回改，只在各文件变更记录末行追加当日更正。 历史一律冻结：变更记录里的 27 / 40 / 47 / 53→60 / 59 与字库 122/217、 179/274、185/280、183/278 都是当日快照，只追加、不回改。 夹带说明：.pre-commit-config.yaml 一并入本笔——pre-commit 要求配置本身 已 staged 才允许提交；该文件的改动是 ui-golden 显示名（60 页→60 张）与 一条钩子计数口径注释（同日 51 → 52 → 51 净零，属另一类，已在此点名）。	2026-10-28 15:33:42 +08:00
wandering1	7e15f49ff3	refactor(编号): UI 菜单层级 L0~L3 → 主界面/一级/二级/三级菜单（批次 3a） ... 这族是菜单深度号：L0 根、L1 一级、L2 二级、L3 三级。用户 2026-10-28：「编号看不懂」， 且与采集链分层的 L1~L5 撞形（同一份文档里两套 L 号，读的人得先猜是哪套）。 改法（生成物走生成器，不手改）： - `tools/menu_gen/gen_menu.py`：加 MENU_LEVEL_NAMES 常量，生成 ui_menu_tab.c 的注释从 `/* 12 L2 */` 变成 `/* 12 二级菜单 */`；重跑生成器，生成物 42 行注释随之更新。 - 文档 4 篇 113 行：菜单页面设计（94）、内容页架构（10）、01_主界面_说明（8）、 中文字体生成与配置（1）。映射：L0 → 主界面（根）、L1/L2/L3 → 一级/二级/三级菜单； `4 级（L0~L3）` → `4 级（主界面 → 三级菜单）`；括号里的 `（L1）` → `（一级菜单）`。 范围纪律：只动 UI 菜单这一族。同名的测试层级族（L0/L0.5/L1/L2/L3，见测试开发标准流程） 与链路延迟分段 L1~L8 不动——那两个属批次 3 的另两族。 验证：@build 0 错 0 警；check_menu_rows 8 状态 PASS（5368 B 池不变）；生成器重跑幂等 （rc=0，生成物只剩注释差异 42/42 行）；doc-links 通过（195 文档）；mojibake / bom-guard / 新编号门禁 / git diff --check 全绿。	2026-10-28 13:12:06 +08:00
wandering1	6daa01aea4	docs(UI): 字体口径更正——218 是不含 ASCII 的汉字/符号数 ... §7「字体体积」原写「218 字（含 ASCII/符号，共 313 字形）」与全仓其余五处口径矛盾： 实测 ui_cn_chars.txt 的 218 个码点**全是非 ASCII**（汉字与 ▶/，/： 等符号）， ASCII 0x20~0x7E 那 95 个字形是 make_font 用 -r 0x20-0x7E 另外打进去的（见同文件 §4 命令行）。 改成本仓统一口径并补上算术：字形数 = 218 + 95 = 313， glyph_dsc 数组实含 notdef 共 314 条（逐条实测计数）。 其余各处在 94b0d790 与本轮同步里已是正确写法（UI_设计架构 §1 表、界面制作流程 C3、 菜单页面设计、simulator/README、架构总览 §3、产品需求 §8.5），本次是消除最后一处反例。 同段旧数 185 字/280 字形、183 字/278 字形（未回填）按历史快照保留不动。 验证：check_doc_links --all --sections-strict 通过（210 个文档）；check_ids --strict 无错误； check_bom_drift / check_mojibake 通过，git diff --check 干净。纯文档。	2026-10-28 12:10:19 +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	b24b2b5f31	docs(计数): 内容页黄金参考 27 → 40 全仓同源改写，含钩子显示名这最后一处不同码 ... 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	b623a406ad	fix(栈·存储·UI 收尾): 断掉临界区↔断言幻影环回到 1,464，标定门控单点化，卷锁五态可观测 ... 这四笔在主树里已经互相纠缠（同一次 @build 编译、同一份 .htm 度量），拆成四笔就不 存在任何一个被真编过的中间态，所以合一笔入库；下面按模块分段陈述，作者与出证归属 逐段写明。 —— 一、崩溃证据路径的整行独占收尾（log-maint-writer，task-26）—— 上午那笔 1d4b6a17 之后，stack_report 报 iec104Task 静态最坏链 1,544 / margin 1,016， 低于 1,024 的 ISR 底线。真因不是新增局部缓冲，而是本模块与内核临界区之间新长出 一条环：taskEXIT_CRITICAL ⇒ vPortExitCritical ⇒ configASSERT ⇒ vApplicationAssertFailed ⇒ dbg_console_write_raw ⇒ 回到本模块。armlink 把这一整坨计入**每一个含临界区的 任务链**（vApplicationAssertFailed 的 Max Depth 由约 40 B 涨到 128 B + In Cycle）， 所以九条链同涨约 80 B——同涨本身就排除了任何单个调用方。 改法两处：① 本模块三处窗口（取凭证 / 还凭证 / 整行入环）改用 CON_CRIT_ENTER/EXIT （PRIMASK 保存恢复到局部变量；注释写全为什么不能直接 __enable_irq()——嵌套时会 替别人打开任务级临界区——以及屏蔽面变宽是有意为之）；② 异常/终点钩子里那对 自证空转的 begin/end 摘掉（异常态 begin 放行但不持有、end 是幂等空操作，调它只有 成本没有收益），任务态 STALL 行保留 begin/end，这个区分写进两处注释与文档 §4.4.1。 实测四棵树逐个 .htm 解析（身份钉 tree + Linker run 时刻 + 产物来源）：A=77779d49 链 1,456；B=1d4b6a17 链 1,464 / margin 1,096 PASS；C=含未提交钩子接线的工作树 1,544 / 1,016 FAIL；D=本轮修复后（Linker run 22:52）回到 **1,464 / 1,096 PASS**， 九条链齐降 80 B。断环图证：vPortExitCritical 由 136 B + In Cycle 变 8 B 且不再 In Cycle，con_tx_release 子树 152→8；Error_Handler 回到 280 + In Cycle = A 树同值 （既有发送环无人拆动）。顺带删掉 Src/freertos.c 崩溃路径里最后一个 HAL_Delay(200) （该文件真实调用现为 0）。 测试：console_log 152→**153** 条（只增不减）；换钉不删防——015 现在钉「PRIMASK 窗口 2 次、深度 1、内核临界区 0 次」，新钉 015c 绝不等待，160 注入点搬到 con_pm_hook，176 强化到未调度路径连 PRIMASK 窗口都不开；红线水位 con_pm_at_tx_max 与 con_uart_crit_at_tx_max 双 0；判据⑦（延后的行与当场直发逐 字节相同）170b/171/178 仍全绿。作者自报并纠正一处：换钉时曾把 TC-CONLOG-015b 改 编号，而 015b 在生产注释与文档里都被引用——已恢复「编号不退役、语义搬过去」。 覆盖率 App/log/console_log.c 199/200 → 256/257 行、21/21 函数（只增）。 —— 二、未标定闭锁判据收成单点访问器（ui-param-writer，task-16）—— 「UA/UN/IA 三相 VALID 全置位才允许跑判据」这条门控原先在两处各自镜像实现 （protect_task.c 的 s_cal_locked 与 ui_data_feed.c 的 feed_cal_block），改一处另一处 静默失效且无门禁可照。现新增 adc_cal_prot_blocked() 落在 App/algo/adc_cal，DTU_BENCH 特例收进一处；两个消费者同批改调、本地副本删除。作者还查实并纠正了我先前一句 错判：全仓 App/app→App/task 的 include 实为 0 条，故访问器不能落在 protect_task。 新增 TC-ADCCAL-018 八条（含冷启动即闭锁），adc_cal 套件 99/99。 —— 三、共享卷锁五态可观测性（ui-param-writer，task-17）—— 原状比登记簿写的更糟：五个可区分态（未调用 / try 超时 / 分片超时 / fail-open / 未持锁却 release）生产侧零留痕，且 vol_lock.c 的返回值注释与代码相反—— fail-open（锁没建成、互斥已失效却在读写盘）被返 1 **谎报成取到锁**，而那正是 vol_lock.h 记录的台架实证故障（并发写坏 FTL → 喂狗点饥饿 → IWDG 误复位）的前置。 锁层加四个 volatile 计数（16 B 静态，零新局部、零新 callee、零日志、零 FatFs）与 不取锁的 vol_lock_get_stats()；13 处 try 调用点一字未动。**刻意不在锁层记时刻**： 记时刻要读 tick，等于给 defaultTask 取锁链添帧——诊断不值那几个字节；消费方若 自盖时间戳，那只能是被观测到的时刻而非发生时刻，.h 里已写明不得写成首次/末次。 四套本地假件各加 s_last_wait_to（字段名逐字一致），把「喂狗点取锁一律 timeout=0」 与「ftpTask 分片一律 100 ms」从注释纪律升级成会 FAIL 的断言；红-绿反证：临时把 sys_log_mcu.c 的 0u 改 50u → TC-SYSLOG-010/012 双红，把 lftpd_io.c 的 100u 改 0u → TC-LFTPIO-034 红，两处按原串改回并用 SHA-256 证明逐字节还原。TC-VOLLOCK-015~019 共 45/45（无新桩）。 —— 四、UI 死接口清理（ui-maint-writer，task-6 收尾）—— 删掉 ui_data_maint_ready()：全仓零消费者、只有它自己的用例在读。**更值得记的是 它为什么能活过一整轮评审**：头注释写的是「页面用它决定这页能不能操作」，而页面 从来没用过它——注释陈述的是意图，评审读的是意图，门禁读的是可达路径，两者都不 反驳「意图未实现」。作者对「连用例一起删」做了显式抗命：TC-UIDATA-025 的 13 条里 只有 4 条读那个死口，另 9 条钉的是真防线（六口未注入安全返回 / 残表整表拒绝 / 被拒不覆盖已生效的好表），故删冗余的 025a、把 025i/025k/025m 换成用 reset_req() 的可观察返回值判定，性质不丢。ui_data 套件 244 → 243（净减 1），黄金 40 页与 池 5448 B 未变（该刀零像素影响，参考图无 diff）。 —— 门禁与未跑项（本笔如实留账）—— cubemx-survival 基线已 --write（漂移 6 项全部是上述意图内区域：断言/栈溢出钩子 实现、看门狗模块行等），基线文件同笔入库，随后 --check 通过。 本笔未跑的钩子只有两条：mem-numbers 与 mem-budget——磁盘 .map 出自 22:52 那次 构建、含尚未入库的 UI 与工具改动，与 HEAD 台账必然不同码；按仓库既有约定允许 --no-verify + 正文留证，回填在紧随的台账一笔统一做（含 ram_baseline --update 与 覆盖率基线两条 [NOTE]：ui_data.c 65→316、iec104_comm.c 36/36）。 两条已挂着的账：① id-check 不可判定引用 1,162 / 上限 1,166，**余量只剩 4**， 主要吃进者是我今天推进的 UI 那笔（68 条文本断言的注释引用），账在 Lead； ② 崩溃注入腿（故意复位）台架复验未跑，需先由代码道提交触发器，且判据只判原子性 不判 [ERR]=0——IPSR 路径的主张归主机侧套件，硬件照不出来。 产物身份（按 D 表要求钉死，避免数字与树脱钩）：本笔包含的固件树就是那张 D 表对应的 那一棵——MDK-ARM/.../STM32F407-Demo.htm 的 mtime = 2026-10-26 22:52:12（.htm/.map 按 约定不入库，故把时刻写进正文）。提交前在本树复跑 stack_report.py：exit 0， iec104Task 1,464 / margin 1,096（42%）PASS、defaultTask 3,040 / 2,080（40%）PASS， 与 D 表逐项一致；本次运行不含任何未提交固件源码之外的新改动。	2026-10-26 23:31:05 +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	77779d49d6	feat(ui+记录): 整定写路径与四类页落地，五类记录写入方补齐 ... UI 面：ui_data 增加深度 4 参数写队列（请求 168 B、队列 .bss 672 B）与状态机 OK/ERR_RANGE/ERR_LOCKED/ERR_BUSY，ui_data_feed 出队后按注入 ops 走「闭锁 → 整批 预检 → 逐项 prot_set_set_sealed」，只提交改动位图；par 帧尾追加 cal_block （口径 = UA/UN/IA 三路 ADC_CAL_F_VALID，与 protect_task 判据同构，不用 rt.eng 反推，V0.1 下 eng 恒 0）、UI_DATA_VER 升到 2。参数/定值/控制字/软压板四叶绑定 内容页（UI_PAGE_MAP_COUNT 12→16，复用四个查看模块，零新增 .c），编辑态按 is_editable 分派，LOCK（写不进去）与「未标定」（仍可改值）两源两通道两词。 记录面：syslog_request_clear/state/apply 三段式删除 API（UI 只发请求，落地在 defaultTask 的 drain 尾部且必须后置，卷锁一律 try，幂等只认 FR_NO_FILE）； 事故/告警/启动/操作/遥控五类各有一个真实写入点，记录类型 = 日志 ID 本身 （一类一个 /log 严格 8.3 文件；64B 定长体没有类型字段位，塞字段会砸掉既有读者）。 为守 protectTask 872 B 静态最坏链另拆 syslog_post_quiet()（无 DBG 的投递核， 丢弃留痕挪到 drain 侧差值补发），syslog_post 对外语义逐字不变。 为什么两道合成一笔而不是各一笔（实测，不是省事）：simulator/main.c 同时消费 两道新增 API（整定 pump 与 logtest 清除用例），按道切文件会让中间提交编不过； RAM 受管快照与体积同码凭证描述的是合并后的 .map，拆开必落在「台账与 .map 不同 码」这条红线上。pre-commit 跑钩子前会 stash 未 staged 部分，这类耦合没法绕。 实测：@build 0 错误 0 警告；Code 228,260 / RO 24,960 / RW 1,440 / ZI 135,976 B； RW_IRAM1 79,992 B = 61.0%、RW_CCM 87.9%（阈值 92%）；九个任务静态最坏链全 PASS， protectTask 872 B / 57% 改前后逐字节不变（记录投递没垫栈）。主机单测 ui_data 82→ 164、sys_log_mcu 106→137、prot_elm 47→60、iec104 141→154、iec104_serv 28→34， 既有断言零删改；48 个钩子 --all-files 全绿；编号门禁可判定 86.34%（基线 86.0%）、 不可判定 1,153 处低于上限 1,166；doc-links 无法判定 0；UI 黄金 18 页扩到 27 页 连跑两次逐字节一致；字库 diff 空。 顺手修掉三处既有缺陷（都是本轮第一个消费者才暴露）：sim_syslog.c 的 s_paths 行宽 16 而 "sim_selftest.log" 正好 16 字符没有 NUL 位（stat/remove 读越过数组尾，此前 靠后面 .rodata 碰巧为 0）；ui_w_setlist 二态行 ENTER 不回绕（控制字与软压板出厂值 全在最后一项，按了像没反应而叠层里已是越界值）；生成物 ui_menu_tab.h 与 gen_menu.py 模板漂移（上一笔改了模板没重跑生成器），现随生成器输出对齐。 未收口（不算完成）：保存后重启值保持与主站 C_RD 读回两条只能上板，台架窗口执行； LOCK 屏显与越界反显的页面侧在模拟器造不出来（模拟器不跑定值自检、无 NAND）， 已由生成侧单测与代码注释点名差距；同类页数与钩子数陈述残留另立待办。	2026-10-26 15:51:12 +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	9d90e00d52	merge: task/uibound-wait 合入 v2-on-ui ... 任务 uibound（1 个提交）经 task-worktree 回收： - fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆（大窗判读 F3）	2026-10-25 18:42:56 +08:00
wandering1	f6e9106f0d	fix(UI): 推流往返返回点喂位——多个慢 RPC 之和不再串成 UI 停摆（大窗判读 F3） ... 道F task-24。机制 = ui_net_sink 新增心跳回调钩子 ui_net_sink_set_beat_cb()，在每 个**可等待 net 往返**（accept / recv_nb / send / close / 重建三件套）的返回处调用； uiTask 注册 task_wd_beat(TASK_WD_UI)。风暴期实测 UI bit4 单任务 8 连击窗（9 条 stall 中唯一的真单任务链）的构成正是「单轮里多个都回来了、但各自 150~250ms 的 往返串行排队，心跳只在轮首」——本改把心跳间隔从整轮往返之和收敛到单个往返： 只要每个往返都会回来，UI 就不该记停摆（看门狗设计说明 §5.3 按位判据抓真挂死）。 【边界（lead 裁定口径）】往返语义零改动：不加超时、不动回执协议（§11.6 否决的 「net_* 裸加有界等待」不重演，请求序号方案与事件驱动 accept 均**不做**，上界 收口归登记簿 E-27/E-28 批 3）。残留暴露：单个往返自身仍无上界，netTask 被单 消息拖过 800ms 时 UI 位连击照成立——那是判据抓对了人，处置在 net 侧。 【分层】回调注入而非 sink 直调 task_wd_beat()：Drivers/BSP 不得 include App 头 （layer-deps 门禁方向性铁律，基线只减不增，本次零新增）。 【零行为变化面】钩子未注册（模拟器/黄金回归形态、ui_task 注册之前）= 与改前 逐字一致；协议/帧格式/门控/兜底节拍全不动。ui-golden（菜单 8 状态 + 内容页 11 页）通过。 【测试】新增主机套件 test/host/ui_sink/（stub 假件驱动生产 ui_net_sink.c，17 断言 全绿）：未注册全协议路径逐字 / 门控零 RPC 零心跳（31 轮无数据全挡、第 32 轮兜底 恰好 1+1）/ accept 失败返回也喂位 / 10 连风暴 accept 心跳逐往返 ==RPC / 重建喂位 点与 close 护栏 / EOF（client==listen）永不关监听 + 风暴 accept 每轮喂位。 suite 由 test-coverage rglob 自动发现（无需改台账）。 【文档】UI_设计架构.md 新增 §5.8（推流心跳边界：现象/处置/边界/分层/残留）+ 变更记录行；ui_net_sink.h 钩子契约注释；ui_task.c v1.4 记录与 :271 注释更新。 【门禁】@build 0/0（Code=224860，vs F2 后：Code +92B / ER_IROM1 →249500 / RW+4 / ZI+4 / RAM 79008）。--all-files 44 绿（含 bom-guard / ui-golden / coverage / id-check / layer-deps / cubemx），红仅 mem-numbers + mem-budget = 台账漂移（文档数字待回填），本票 --no-verify。 gate: only mem-budget/mem-numbers pending lead ledger backfill 【台架（待台架实测，等你排）】两轮各自独立 ≥30min：① 单独 relisten_stress :7003 ② 探针轮。v1.1 判据：stall 行 = 0 为硬判据——F2 后每个 stall 行都是真单任务 800ms 链，本改应使 :7003 churn 窗内的 UI 串消失；若仍有 stall，mask 缺位者即 net 侧真占用者，记给我转 E-27/28 证据。MISS start 为诊断行不计违规。	2026-10-25 18:42:14 +08:00
wandering1	621421f3ca	fix(判据脚本): --walk 存证不进工作树；真机动作需显式持锁确认 ... 票 = task-26（自报缺陷，Lead 批准开树自修）。两处都是我上一笔（导航器入库）留下的： 一条会让工作树变脏，另一条更严重——动到了不属于我的台架。 一、--walk 的存证落点 - 症状：outdir = os.path.join(HERE, "walk")，HERE = <仓库根>/scripts → 真机跑完在 scripts/walk/ 落 12 个帧：git status 立刻脏、done 的并集残留审计会把它当任务遗留物， 下一个窗口还盖掉上一个窗口的证据。我自己刚立过「轨迹只在 --trace 给了路径才落盘」的 规矩，这条路径上被自己破了。 - 改法：默认落 <仓库根>/ci-artifacts/uinav/walk/（已 gitignore，本仓台架产物一贯在此）， --outdir 可改；并加**反向拒绝**——解析后的目录若落在版本控制内且不在 ci-artifacts 之下， 直接 [FAIL] 退出 3、连目录都不建。「跑完记得删」只防得住记得的人（同 bom-guard 立项 理由，也同今天 .map / 缺 lvgl_sim.exe 那一族：事实源不存在就大声失败）。 二、未持锁就注入了按键（实测踩到，已做成参数闸） - 我给「默认落点会打印成什么」做验收时跑了 --walk，脚本在没有任何拦截的情况下连上 7003 并开始注键；而那时台架属于验收窗的准备方，板子停在主干 mega 镜像上。**板端 UI 状态可能 已被推到别处**：只注入了方向/进入/退出类按键，未烧录、未碰串口、未触发任何写操作 （网口设置的保存行走不到——导航器从不在保存行按 ENTER，过密码默认也只走只读查看密码）。 - 根因不是手滑，是「必须持 bench 锁」只写在文档与 print 里：跑的人自认为在跑一次离线 检查，脚本就真去连了。于是把确认做成参数 --i-hold-bench-lock：不给就拒绝（退出码 3， 不碰网络）；脚本不代取锁，也不替人判断「应该没人在用」。 - 给窗口方的处置建议：验收窗前先复位一次，或直接以 --walk 起步（导航器第一步就是回根， 且回根后还补收一次 l 防被裁弹框漏计）——别把我注入后的残留状态当成验收现象。 验收（本机、无板，全部实跑） - --walk --outdir <仓库内目录> → rc=3 + [FAIL] + 目录未被创建； - --walk / --board 未给确认位 → rc=3 且**不触网**（瞬时返回，不再有任何连板可能）； - --selftest-quick rc=0（黄金参考 18 帧 0 错）；check_doc_links 通过； - 一笔提交，未用 --no-verify；工作树仅这 2 个文件改动，无多余产物。 文档同步：docs/UI设计/UI_自动化测试流程.md §7.3 补「存证不进工作树」「真机动作需显式 确认位」两条并把用法示例改对（同一事实只在一处，正文仍在那一节）。	2026-10-25 18:30:41 +08:00
wandering1	c23b21eed8	docs(UI自动化): 新增第七节「板端有状态导航判据」+ 过密码口径指针 ... 票 = task-25 第二半（配套上一笔的 scripts/board_ui_nav.py）。 docs/UI设计/UI_自动化测试流程.md 新增第七节： - 7.1 为什么必须闭环：KEY 空帧 + 盲走 9 帧仅 3 帧名副其实的实测表（含每帧落点与墨量）， 三张证据 PNG 落 docs/测试说明/boot_log_data/（弹框裁切现场、盲走落密码页、盲走停在级联）。 「512 bits 神秘空白态」在表里定名为**密码输入页**——走带 #P 注记的叶子时第一屏是要密码。 - 7.2 认屏三判据（表格：判据 + 为什么这样判）与两条实测纪律（l 收列、#P 注记顺序）。 - 7.3 四种用法与钩子档位：钩子只跑快检档，完整档（含闭环）合入前 / 上板前手工跑；「没跑」 与「跑过且通过」在脚本输出里是两种打印，不互相顶替。 - 7.4 四条已知限度：末两行叶子弹框被裁（真机定位留台架窗口取证，是取证题不是编码题）、 同标题多态不区分、与黄金文案的有意耦合、快检不证导航。 - 7.5 过密码口径：查看 000 / 修改 123，键序与黄金回归编辑态完全一致；只读判据不自动升格。 docs/UI设计/UI_数据供给设计说明.md 追加落地注·五（指针级）：写路径（批 5）必须把「过密码」 当显式状态——快照层不提供「曾否进过某页」，可写性只由 UI 权限态与 par.locked 决定。 纯文档与取证图，无行为改动。取证 PNG 由 simulator/i1_to_png.py 从留档帧转出（4 倍放大，与 其余 UI 证据图同规格）；本笔钩子按各自触发面执行，其中 doc-links 会核对本节新增的两处 相对链接与三张图的存在性。	2026-10-25 18:02:32 +08:00
wandering1	3dc7f4a088	docs(UI方案): 返回系数小数位按可分辨精度修正 + 遥信量落地注 ... 两件事都落在这份方案文档里，合一笔提交（同一文件的两处改动按文件切分提交不干净，故合并说明）。 一、四个返回系数：口径从"我偏离文档"改成"文档原口径错了"（Lead 裁定 2026-10-25） - §3.2.2 表里 4 行小数位 3 → 2 并加 ⚠；落地注改写；同步去掉 ui_w_setview.c 注释与 tools/setview_check/check_setview_limits.py 文档串里的"偏离"措辞。 - 原口径 3 位来自"把 Q10 当成十进制存储"这个误会：Q10 存不下 0.95（0.95×1024 截成 972，真存 0.94921875），按 3 位显示等于多打一位根本不存在的数字；整定单写 0.95 的人看到屏上 0.949 会 怀疑装置、甚至反复重输（重输还是 0.949）。2 位才是这份存储在自己可分辨精度上的正确读数。 - 不改行为，只改文档与注释：屏上显示与行表换算逻辑一笔未动。 二、§3.1.3 落地注（遥信量页落地后回填，含两条命名取舍与一条通用陷阱） - 命名：idx0~3 屏上写「位置1~4」不写「YK1~4 位置」；idx30 写「保护闭锁」不写「闭锁1」；点表未 定义名的行用点号占位，不编造功能名。 - 值映射次序（先无效 → 再单双点 → 后位值）与双点支路"当前无自动化证据"的诚实登记。 - 通用陷阱：把 *_PUT(dst, 字面量) 宏用在 const char *const 表项上，sizeof(源) 变成指针宽度， CJK 名被截而短 ASCII 名恰好完好——只有像素文本断言会报"名字匹配不到而值在原位"。 跳过的门禁（三条同族）：mem-numbers / mem-budget / size-gate（L0c），根因是台账与体积凭证待回填。	2026-10-25 15:33:44 +08:00
wandering1	4332142680	feat(ui-pages): 遥信量 33 行固定名表页接实时快照（新增 yx_dp） ... 批 4 主体（票 task-15；规格 docs/UI设计/页面扩充详细方案.md §3.1.3 方案 A）。V0.1 只有 6 点有 硬件来源，其余 27 点在屏上就是 "--"——这是真实状态，不是页面没做完。 页面与数据 - 33 行固定名表（Flash const）+ 动态分页（8 行/页 = 5 页）。两处命名不照抄文档简写：idx0~3 屏上写「位置1~4」而非「YK1~4 位置」（遥信页出现 YK 前缀会被读成遥控对象，对应关系留在注释）； idx30 写「保护闭锁」（写侧位号注释的语义即此，用编号反而丢信息）。idx4~13、idx31~32 点表未 定义功能名，如实写点号占位（YX5…、YX32），不编造功能名。 - 值映射次序：先判无效 → 再判单/双点 → 最后看位值。无效位上的位值不代表任何事实，次序颠倒就会 把垃圾位画成「复归」。 - 快照新增 yx_dp 双点位图（+8 B）。不教页面"前 4 点是双点"：单双点是 104 点表事实（YX_DP_N / iec104_pts_yx_is_dp），抄进表现层就是第二真相——点表把双点段挪位或改起始下标，屏上不报错， 只会用错词形容同一个点。写侧逐点问 is_dp() 拼位图。 - UI_DATA_YX_N(33) 与 iec104_pts_yx_count() 编译期比不了（那个 #define 在协议层 .c 内），故写侧 留一条一次性 DBG_ERROR（约 90 B Flash，只在真漂移时打一次）。名表行数 = UI_DATA_YX_N 由数组 宽度法编译期守卫钉住（ARMCC C99 无 _Static_assert，本仓惯用写法）。 - 补 include 一条实测坑：DBG_ERROR 是宏，漏 include "dbg_log.h" 时 ARMCC 把它当隐式声明函数放过 编译期，错落在链接期（L6218E Undefined symbol DBG_ERROR）——报错点离根因隔了一整个链接步骤， 已在 include 处写明「DBG_TAG 必须在 include 之前」。 一个只有像素文本断言能抓到的截断 bug - 照抄批 1 的 *_PUT(dst, 源) 宏（长度取 sizeof(源)），但本表源是 const char *const 数组的 **元素（指针）**，sizeof 得 4 → 「故障总」被截成「故」，而 "YX9" 恰好 4 字节看起来完全正常。 编译器 / cppcheck / 编码钩子全不响。定位来自断言：第 2 页「过流Ⅰ段」匹配不到，同一行值列 「复归」却在原位 = 名字被截、值没错位。修法：长度取目标缓冲容量 UI_BUF_STRLEN。同名宏、不同 参数类别（数组 vs 指针），批 1 那处本身是对的，照抄才中招——教训写在宏定义上方。 模拟器与覆盖诚实性 - 固定帧发布 yx_dp = 0x0F，但刻意不把这几位置进 yx_valid：V0.1 无开入硬件，屏上就是 "--"。不用 「让它显示合位/分位」的假数据填满画面，那等于让黄金参考声称本机有开关位置遥信。 - 代价如实登记：合位/分位这条词映射当前**没有任何自动化证据**（像素恒 IV；页面依赖 LVGL 进不了 主机单测）。已写进方案 §3.1.3 落地注与契约落地进度·四，作为开入落地后的台架判据，不假装测过。 测试 - 主机单测 +2 条（TC-UIDATA-009c 双点位图原样透传、不被 valid 掩；009d 点数 33 的独立见证，注明 绊红时要同步改哪四处）→ 85/85。 - 文本断言 +33 条（yx / yxp2 两态，含页码钉住 33/8 = 5 页的分页数学）；两页像素基线单独一笔。 - font-charset 本批零新增字：名表用字全部命中既有 183 字子集——「置/故/障/总/外/部」正属批 1 成组并入 KEEP_EXTRA 的那批字，第二次兑现（当时若按 extract 输出重写字符集，这些字早被洗掉， 上屏是空白，而门禁只会说「字不在清单里」）。 体积（同一棵树、构建前后的实测增量） - Code 224272→224688（+416）；RO 24040→24640（+600）；RW 1324→1328（+4）； ZI 134844→135088（+244）→ Flash 约 +1020 B、RAM +248 B。 - RO 增量主要是 33 行名表与名称串，是"把 33 个真点名上屏"的代价，不是可省开销。 跳过的门禁（三条同族，同一根因）：mem-numbers / mem-budget / size-gate（L0c）——台账与体积凭证 回填是 Lead 单写者，本分支不做静默处理，数值见上。	2026-10-25 15:33:04 +08:00
wandering1	45393be3d5	feat(ui-pages): 参数定值控制字软压板四个查看页接 par 快照 ... 四个空叶子（参数定值 → 查看 → 参数/定值/控制字/软压板）接上 par 通道。页面薄、模型厚： 新建 Drivers/BSP/UI/ui_w_setview.{c,h} 收四张视图表 + Q10 换算 + 越界反显，四个页面各是 一份实例 + 四个跳板钩子；渲染与分页复用批 1 的 ui_w_setlist（查看态 commit=NULL：无保存行、 无编辑通路，§3.2.6 查看列口径）。 行表三项口径全部有真源，一项都不在这份文件里拟定 - id = App/algo/prot_set.h 的枚举序。BSP 不 include App 头（分层门禁），所以行表里是裸数字 + 行尾注枚举名——这份对不上就没人能在 BSP 侧编译期发现，于是从外面钉：见下面的新脚本 - min/max = App/algo/prot_set.c 的 g_prot_set_meta Q10 上下限按该行小数位换算的结果。整定页 下一批复用同一批表，界内界外一处一份，不会出现「查看看着合法、整定说越界」两套边界 - 显示名/小数位/单位 = docs/UI设计/页面扩充详细方案.md §3.2.2~§3.2.5 四张表 一处偏离文档（不是静默偏离，写进三处：代码注释 / 文档落地注 / 本正文） - 四个返回系数按 2 位小数显示，文档写 3 位。理由是量值真实性不是排版：Q10 存不下 0.95 （0.95×1024 截成 972 → 真存 0.94921875），按 3 位显示就多打一位根本不存在的数字；整定单 上写 0.95 的人看到屏上 0.949 会怀疑装置、甚至反复重输（重输还是 0.949）。2 位才是这份存储 在自身可分辨精度上的正确读数——文档的 3 位来自「把 Q10 当成十进制存储」这个误会 - 单位挂在值串尾（10.00A / 500ms）而不是塞进显示名：值列只有数字会让 60000 既是 ms 又是 A。 为此给 ui_w_setlist_row_t 加了 unit 字段（该结构此前无任何消费者，扩展零成本）；只挂在 非编辑态——编辑中是逐位输入串，挂单位会让位光标算错列宽。A/V/ms/Hz 全 ASCII 不占字库 新增可重跑核验：tools/setview_check/check_setview_limits.py - 从外面把三件事钉住：四张表的 id 恰好覆盖 0..39 各一次；数值行 min/max 等于 meta 上下限的 换算；kind 与 meta.is_ctl 一致、dec 查表与行表小数位一致、单位只允许 ASCII。改 meta 不改 行表就红。当前输出：行表 40 行 / dec 40 项 / meta 40 项 -> OK - 写这个脚本时自己踩的两个坑也留在脚本注释里：① 正则用 \w+ 吃不下带引号的单位，会让整行 **静默跳过**（少检一行比检查错更难发现）→ 改 \S+ 并加「行数必须等于 40」硬闸；② 脚本要 打印中文，Windows 控制台按 CP936 写 stdout 会崩在半路（崩在半路 = 一条都没检查）→ 开头 把 stdout/stderr 锁到 UTF-8 两个只有画面才会暴露的错（都不是静态检查抓到的，都记进了注释） - ui_data_par() 的通道是 0=成功 / -1=尚无首帧，我按 bool 反义用了：真机与模拟器上都会「永远 读不到」，整页值列恒 --，而页面看起来完全正常、编译与钩子全绿。看像素图才发现满屏横杠 - 肉眼把 CT 一次额定读成 1000A，字形匹配器证明值列只有 4 个字符位（命中 x=101/107/113/119）： 实际是 100A。断言因此按匹配器能证明的写。顺带一个自洽佐证：PT 10000/100 V 配 CT 100/5 A 正是 10 kV 馈线终端的变比；控制字页默认值天然两两一组（Ⅰ/Ⅱ 段跳闸、Ⅲ 与过负荷段告警）， 行表若整体错位就不可能复现这个组合——这条已进像素断言，成为 id 对齐的机械证据 无数据时的显示口径 - 参数帧未就位：名字照打、值列打 --（不把 0 当定值显示，也不给整页空白让人以为菜单坏了） - 越界反显只在 bad_valid=1 时参与：把「没数据」画成「这行有毛病」是假告警，比不画更糟 - Q10 换算不用浮点也不用 64 位除：整数段 + 小数段拆分四舍五入，满位进位（MicroLIB 软浮点与 __aeabi_ldiv 一进镜像几百字节，模拟器（宿主 CRT）永远照不出这笔代价） 批 1 那个 KEEP_EXTRA 决策在这里第一次兑现 - 本批行表用到的「延时 / 电流 / 压力 / 总 / 配 / 重 / 间 / 未」等字，正是当时成组并入 KEEP_EXTRA 的 35 个「未知冗余」字里的一批；若当时按 extract 输出重写字符集，这些字形已被洗掉，本批 上屏就是白框，而 font-charset 只会报「字在清单里没有」——它报不出「字曾被删掉过」 - 本批 font-charset 直接 Passed，未扩字库、未重生成字体 验证 - @build 0 错误 0 警告；模拟器 0 警告；内容页 19 项 PASS（16 页像素 + 四页共 39 条文本断言）， 其余 12 页逐字节不变；菜单 8 状态 PASS；ui-data 83/83、soe 32/32 - 四页出图逐张肉眼确认：值列右缘不越屏（10000V 最宽）、名值不重叠、第 1 页行槽与页脚不撞； 分页页码正确（定值 18 行 = 3 页、软压板 10 行 = 2 页） - check_setview_limits.py OK；ui_menu_tab.h 等生成物全部由 gen_menu.py 重生成（手改生成物 = 一定 会被覆盖，见批 2 那条），uvprojx/CMakeLists 注册由生成器写入，另手工登记 ui_w_setview.c 两处 - 全量钩子 --all-files：见下一行 gate；红项只有同族三条（台账与同码凭证回填归单写者） 体积（相对 b746a1f 台账 217204 / 21504 / 1256 / 132680） - 实测 Code 221856 / RO 23508 / RW 1300 / ZI 134660 → Code +4652、RO +2004、RW +44、ZI +1980 - Flash 合计 +6700 B、RAM +2024 B（三批累计）。本批 RO +2120 主要是 40 行行表与名称/单位串， ZI +388 是 par 帧缓存（184 B）+ 四个组件实例 + 注册表增量；这是把 40 项真定值上屏的代价， 不是可省开销 待台架实测：装载真定值后的四页读数（含真机 bad_mask 非 0 时的反显行）、翻页节拍、 PT/CT 变比与 104 上位的定值读回（C_RD）一致性。 gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill （同族三条，root cause 一条：台账与同码凭证回填归单写者） 像素基线单独提交（下一笔新增 4 个 shot_v*.bin）：本笔单独 checkout 时 ui-golden 会报缺参考， 属预期拆分；上面的钩子结论取自「本笔 + 下一笔」的合并树。 自查：12 个新增/改动 UI 源文件 BOM 与 HEAD 对齐（本批 edit 又剥掉 4 次，逐次补回）；CR = 0； U+FFFD = 0；C 字面量纯 ASCII（中文只在带 BOM 文件里）。	2026-10-25 14:44:47 +08:00
wandering1	67c469fa40	feat(ui-pages): SOE 记录页接 soe_store 只读遍历（类型 7/8 首次上屏） ... ui_w_soe 组件（task-14 落）此前两端都没绑 reader，只能显示"无记录"空态。本批补齐三件事： App 侧只读遍历、两端 reader 绑定、SOE 记录页与菜单注册。 App/log/soe_store 只读 API（Lead 已放行，本批独占这两个文件） - soe_store_count() / soe_store_read(idx, soe_rec_t*)：与 syslog_count / syslog_get_record 同构——8 条一窗（512 B）整块读、命中窗口零 I/O、卷锁 try（0 超时） 非阻塞；定长记录逐条 open 等于同一扇区开 4 次，SPI NAND 上这个差距是肉眼可见的卡顿 - 读者不得看到半成品记录，三道保障缺一不可（规则写进 soe_store.h 头注，不只是提交信息）： ① 条数只数整条 64 B 槽（写者留下的半条尾槽天然不计入）；② 窗口代数：写者每次成功落盘 / 容量重建在**卷锁区间内**自增代数，读者比对填窗时记下的代数，不符即重填（对齐 32 位读写 在 ARM 上原子，跨任务无需临界区，最坏多读一轮）；③ 单条硬门槛：soe_rec_parse() 校版本 + 校验和，撕裂/半写一律拒收 - 容忍的竞态只有一个：count 与 read 之间新落一条 → 本轮少看一条，下轮重绘（200 ms）自然 追上；所以边界一律用锁内重取的条数，不信调用方传进来的旧值 - API **不带类型掩码**（Lead 裁定 2026-10-25）：5 个记录页怎么分组是界面语义，不进日志存储 层；环容量小、页渲染全扫无成本，真变大了再加带 mask 的优化 API（YAGNI） ⚠ 顺带修掉一颗定时炸弹：菜单生成器与生成物漂移 - 提交里的 Drivers/BSP/UI/ui_menu_tab.h 带着 5 个表查询 API 的规范注释块，而 tools/menu_gen/gen_menu.py 只会输出"声明 + 行尾短注释"——说明历史上有人**手改生成物** 补注释、没回灌生成器。我这次加 #page=soe 后重新生成，等于把那些注释抹掉，bsp-err 立刻 报 5 条 return-doc - 修法不是把生成物改回去（下次重新生成还会再抹一次），而是把注释块**回灌进生成器**； 回灌后重跑 gen_menu.py 产出的 ui_menu_tab.h 与 HEAD **逐字节一致**（git diff 为空）， 漂移关闭。生成物里的手工优化 = 一定会被覆盖的优化，要么进生成器要么别改生成物 时标口径（跨模块陷阱，注释即防线） - 页面时标取记录内的 CP56（事件自己的时标，不是"现在"）。它与运行/自检记录页同口径，靠两条 事实叠出来：sys_clock 的 epoch 域本身就是本地时间（App/util/sys_clock.h 的 sys_clock_set_unix 注明"Unix epoch time (秒，本地时间)"），而 soe_rec.c 的 epoch→CP56 分解不加任何时区偏移。**谁"顺手补 8 小时"，SOE 页就会和文本记录页差 8 小时**；要引显式 时区必须两侧一起改 显示名回正：类型 7 用源词"未标定闭锁" - 组件名字表里原写作"标定闭锁"——缩掉一个"未"字后意思可以读成"把标定闭锁了"，与"因未标定 而闭锁"几乎相反；源词见 App/log/soe_rec.h 与"数据可信"卡 5，UI 表现层无权改写事实词 - 模拟器的 3 条假记录刻意含一条 type 7 + ELM_NONE（非元件支路）：这是 7/8 两个新类型 **真的接上屏**的第一个像素级证据——只有主机断言时，名字表写错也照样一片绿 - 主机测试的宽度护栏随之按"画到哪一列"分列：动作/返回进值列（4 汉字 = 12 字节），其余类型 名进名列（7 汉字 = 21 字节）；原来一刀切 12 字节会把正常名字判成违规 页面与注册 - 新建 Drivers/BSP/UI/ui_page_soe.{c,h}：薄跳板，一条记录两行共用组件内单条读盘缓存， 实例独立（两页共用一份缓存会互相命中对方记录号，task-6 的教训） - 菜单树 SOE记录 加 #page=soe；重生成 4 个生成物，uvprojx / CMakeLists 两处注册由生成器 自动写入（本批 uvprojx 只含这一条新增，无 UV4 抖动） - reader 绑定在两端适配层：真机 App/task/ui_task.c（CP56 → UI 视图 + 容量钳位）， 模拟器 simulator/main.c（固定 3 条、时标固定串，保证黄金参考可复现） 两处被门禁当场抓住的记录（都是有效拦截，不是噪音） - id-check 拦下注释里裸引"P2-10"：编号引用必须可判定归属，代码注释也一样 → 改为指向 App/log/sys_log_mcu.c 与事实本身，不留裸编号 - 又一次 BOM 铁律现场复现：一次编辑剥掉 ui_w_soe.c 的 BOM，ARMCC 立刻报一串 #8/#7/#20 假语法错（missing closing quote 之类），而 MSVC 侧 0 警告完全照不出来；补回 EF BB BF 即 0/0。本批提交前逐文件比 HEAD 做了 BOM 漂移审计（临时脚本，不入库）——建议把这条 审计固化进 ui-verify skill 或门禁（不在本道写域，已回报 Lead） 验证 - @build：0 错误 0 警告；模拟器：0 警告 - 内容页回归 15 项 PASS：新增 soe 页 9 条文本断言（两条时标、过流Ⅰ段+动作、+返回、 未标定闭锁、页码），其余 11 页逐字节不变；菜单 8 状态 PASS、池 5368 B - soe 页刷新黄金参考前出图肉眼确认：6 行两两成对、19 字符时标在 94 px 名列内不越屏、 非元件行的类型名落在名列且值列为空 - test/host/ui_data 83/83、test/host/soe 32/32；13 个代码/文档/注册类钩子（含 coding-standard、bsp-err、id-check、cppcheck、registration-check、layer-deps、 font-charset、doc-links）全 Passed - 全量钩子红项只有同族三条：mem-numbers / mem-budget / size-gate（L0c），root cause 一条： Flash/RAM 台账与同码凭证回填归单写者 → 本批 --no-verify 体积（相对 b746a1f 台账 Code 217204 / RO 21504 / RW 1256 / ZI 132680） - 实测 Code 219712、RO 21388、RW 1288、ZI 134272 → Code +2508、RO −116、RW +32、ZI +1592 → Flash 合计 +2424 B、RAM +1624 B（含本批之前的三页回炉） - 本批新增里约 1064 B ZI 是 SOE 读窗口（512 B）+ static FIL（528 B），一次性投入、页面打开 才用得到；RAM 再紧张可把窗口降到 4 条（256 B）拿回一半，代价是跨窗记录多一次 I/O 待台架实测：真机 /log/soe.log 有记录时的翻页与尾部行为、卷忙时该行退化显示、SOE 页与文本 记录页时标一致性（跨 8 小时口径的现场核对）、记录增长时窗口代数失效后的重读节拍。 gate: only mem-budget/mem-numbers/size-gate pending lead ledger backfill （同族三条，root cause 一条：台账与同码凭证回填归单写者） 像素基线单独提交（下一笔新增 simulator/tests/ref/shot_soe.bin）：本笔单独 checkout 时 ui-golden 会报"缺参考"，属预期拆分；上述钩子结论取自"本笔 + 下一笔"的合并树。 自查：BOM 漂移审计 17 个改动文件全对齐 HEAD；CR = 0；U+FFFD = 0；字面量纯 ASCII。	2026-10-25 14:44:45 +08:00
wandering1	4380098cc1	feat(ui-pages): 装置信息/交流量/直流量三页接 ui_data 快照真值 ... 三页原先的读数是 Flash 里的参考项目字面量（交流量 24 行、直流量 3 行、装置信息 6 行，含 "软件校验 4454""程序日期 2024.08.27""第 10 页"这类与本机无关的假值）。本笔把它们接到 task-14 落地的快照通道：页面只读快照、零 App include（分层方向基线仍 3 条，不增不减）。 装置信息（6 行 → 8 行） - 型号/软件版本/硬件版本/软件校验/程序日期/运行时长取 info 帧；MAC/IP 取 net_cfg RAM 副本 （同层 BSP→BSP，与网口设置页同一个 net_cfg_fmt_ipv4，不另起第二套格式化口径） - 行几何重排：标签去全角冒号、值列左对齐 x=56——原 x=86 是参考图"短值"的产物，容不下 17 字符 MAC（102 px）；8 行按 13 px 行距排到 129，不与页脚（143）相撞 - 页脚从固定"第 10 页"改真页码"第 1 页，共 1 页"（屏上不该出现与本机无关的数字， Lead 裁定 2026-10-25）；副标题属产品口径，本批不动 - 快照定长字符域按**容量扫**而非 strlen：契约写明这些域不保证 NUL 终止，strlen 就是越界 读——模拟器里后面紧跟别的常量大概率侥幸，板端 Flash 布局一变才翻车且不报错 交流量（24 行 → 7 行） - Ua/U0/Ia 走基波相量实例，Ia2/Ia5 走谐波实例（快照 ph[] 按写侧 k_inst[] 序发布），Hz 走 测频新鲜度，第 7 行是量纲口径说明行（eng → 未标定/二次值/一次值，标定闭环自动改口） - 不做 24 行：V0.1 只有 8 路电气量、5 路削顶无采样源、相量实例 5 个，照抄就是 17 行 "--" 的假骨架（docs/UI设计/页面扩充详细方案.md §3.1.1 同一取舍，已补落地注） - 品质位判空：IV/NT/RAW/自检异常/闭锁/越程一律 "--"——削顶通道快照里还留着上一帧的数， 照抄等于把坏数当实测送进人眼；"没有数"与"有数但不可信"在屏上必须同形 - 格式化复用 ui_w_editor_fmt_scaled（定点整数，与整定页同一真源），页面不写 %f：MicroLIB 软浮点打印一进镜像就是几百字节 Flash，而模拟器（宿主 CRT）永远照不出这笔代价 直流量（3 行 → 2 行） - V0.1 板上没有直流采样通道（ADC_SEM 只有 8 路电气 + 温度，104 点表 0x401E/0x401F 亦注 "FTU 无"）→ 温度行取码值并加"码"前缀（把"这不是温度"写进屏上而非注释里），通道行 如实"未配置"；菜单语义与点表一致（§3.1.2 方案①） 三条被现场验证的纪律与一处门禁有效性证据 - 帧缓存按发布序号门控（实时帧 ~200 B 只在序号变化时整帧拷一次），开页 init_cb 复位缓存 ——否则重开页面会沿用上次开页的帧号，首帧前的 "--" 状态可能被永久留在屏上 - 值串落屏统一走 *_PUT 宏（长度取调用点 sizeof）：代码规范 7.5 禁 strcpy，写串与算长同处 - 运行时长过一天的"天"字被 font-charset 门禁拦下（不在 183 字子集，上屏即空白方块）： 为一个运行时才出现的格式字符扩字库要付 27 B RO + 一次字体重生成，改用 ASCII"d"——顺带 成为该门禁有效性的现场证据（这类缺陷平时既无日志也无报错） - 三页每次编辑后重核 BOM：丢 BOM 时 ARMCC 按 CP936 解码，报的是 #18/#274 这类**假语法错** （本笔实测复现一次，修复只补 3 字节 EF BB BF），模拟器（MSVC）完全照不出来 验证 - @build：0 错误 0 警告；模拟器：0 警告 - 内容页回归 14 项 PASS（文本断言逐行核对三页新值：未标定口径、Hz "--"、码2048、真页码； 其余 8 页逐字节不变）；菜单 8 状态 PASS（池 5368 B）；开页-关页往返池 5448 B 不变 - 三页刷新黄金参考前均出图肉眼确认：行不重叠、值列不越屏、口径行可见 - 全量钩子（--all-files，本笔 + 下一笔基线合并后的树）：41 项 Passed；唯一红项是 mem-numbers / mem-budget —— 只因 Flash/RAM 台账未回填（docs/内存管理/** 与 scripts/ram_baseline.tsv 是单写者禁区，归 Lead），故本笔 --no-verify 体积（相对 HEAD 台账 Code 217204 / RO 21504 / RW 1256 / ZI 132680） - Code +1440、RO −512（删三页 Flash 行表与参考遗留串）、RW +12、ZI +484（三页帧缓存 200 B + 92 B + 序号等）→ Flash 合计 +940 B、RAM +496 B - .map 明细：ac_refresh 202 B、dc_refresh 164 B、di_refresh 290 B、di_fmt_uptime 92 B 待台架实测：真机读数与 104 上位机对照、标定完成后第 7 行自动变"二次值"、MAC/IP 与网口 设置页一致、页面只在重绘时取新帧的实际刷新节拍。 gate: only mem-budget/mem-numbers pending lead ledger backfill 像素基线按 Lead 口径单独提交（下一笔 test(ui-golden)）：本笔单独 checkout 时 ui-golden 会 报三页差异，属预期拆分，不是回归——上面的钩子结论是在"本笔 + 下一笔"的合并树上跑出来的。 自查：三页 BOM = EF BB BF、CR = 0、U+FFFD = 0、字面量纯 ASCII（中文只在带 BOM 文件里）。	2026-10-25 14:44:44 +08:00
wandering1	201d713226	feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射 ... 按 docs/UI设计/UI_数据供给设计说明.md 的 D 方案把 App→UI 数据通道落地： App 组帧、BSP 存帧、页面只读；UI 侧零 App include，薄包装只在两端适配层。 本笔是纯增层、不接任何页面 → 零像素变化（菜单 8 状态 + 内容页 11 页黄金 参考逐字节不变，simulator/tests/ref 无 diff，未刷基线）。 新增 - Drivers/BSP/UI/ui_data.{c,h}：实时量 rt / 参数 par / 装置信息 info 三通道存储 + 发布序号盖章 + 只读访问。零 App include、零 LVGL include（分层叶子）； 读写同在 uiTask 上下文串行 → 无锁、无双缓冲、无 seqlock（契约 §5.1）。 - App/app/ui_data_feed.{c,h}：快照唯一填充者。rt/info 每 200 ms 一帧，par 只在 prot_set_checksum() 变化时重发；首轮立即发布，免启动初期闪一下 "--"。 - Drivers/BSP/UI/ui_w_soe.{c,h}：SOE 二进制记录的显示名映射与注入式 reader 契约。未标定闭锁=7 / 标定复归=8 已进表——编号按 App/log/soe_rec.h 与 App/algo/prot_elm.h 现场数过（类型 1..8 + 哨兵 9、元件 0..8、ELM_NONE=0xFF、 FLG_IV=0x80），不采信文档与消息转述。reader 备好但两端未绑定：落盘侧还 没有只读 API（Lead 已裁该 API 归下一工作项），未注入按"无记录"空态渲染。 量纲诚实性（契约 §4.1 同步改成真值口径，不再抄旧码值表述） - eng 不写"0 = 原始码值"：标定层 ROM 系数是引脚侧 LSB，采样环折算出来的就是 ADC 引脚电压（承诺边界 docs/任务规划/数据可信.md §2.6）；电气 8 路 adc_cal_flags() 的 VALID 全置位才升 eng=1 二次值——整帧共用一个 eng，只要 还有一路是引脚电压就不能贴"二次值"标签，宁可整体保守。 - TEMP 不参与线性标定 → 恒带新增品质位 UI_DATA_Q_RAW=0x20，页面不挂单位。 - UB/UC/IB/IC/IN 无基波相量实例（V0.1 削顶）→ Q_IV|Q_OV；未满一周波 → Q_NT。 - 谐波另开 ph[] 相量实例槽带：yc 的语义通道下标容不下同通道的二次/五次谐波。 接线与双端注册 - App/task/ui_task.c：ui_menu_init 之前 ui_data_init + 首帧发布；主循环每轮 ui_data_feed_tick() 排在 ui_port_step 之前（本轮渲染用本轮刚发布的帧）。 - simulator/main.c：发布固定合成帧（无头与窗口两个初始化点，先于建页）； 定值不手抄 40 个数，改为链入 App/algo/prot_set.c 取出厂默认（抄表等于造 第二真相）；build_date 用固定串而非 __DATE__，否则跨天重建会把装置信息页 黄金参考刷掉，而黄金参考是判据本身。 - 注册：uvprojx 加 3 条（App 组 ui_data_feed.c + UI 组 ui_data.c/ui_w_soe.c）与 simulator/CMakeLists.txt；ui_data_feed.c 不进模拟器 → check_registration.py 的 SIM_EXEMPT 加一行（App/app/app_main.c 先例，已报备）。 主机单测与钩子 - test/host/ui_data：82 断言全绿。钉三类事：快照语义（首帧前读 -1、序号由本层 盖章、三通道互不串台、NULL 防御、init 幂等复位）；跨层不透明下标现场一致 （yc 序 = adc_semantic_t、q10 序 = prot_set_id_t，同一 TU 里 include 两侧头）； SOE 编号与名字表现场一致（八类事件都有名、采样/标定四个词互不相同、 名长不超列宽、越界回占位）。 - .pre-commit-config.yaml 加 ui-data-unit-test 钩子（第 43 个，Lead 已批自加）。 - scripts/id_registry.json 建族 TC-HOST-UIDATA（属主登记处 = 单测目录，同 TC-HOST-ADCCAL 先例；不建族则新号被编号门禁判"未登记前缀"）。 体积（相对 HEAD 台账 Code 215744 / RO 21396 / RW 1224 / ZI 131984） - Code +1272 B、RO +108 B（字库 4 字，见上一笔）、RW +24 B、ZI +696 B → ER_IROM1 238520 B（22.7%）、RW_IRAM1 76504 B（58.4%，台账 57.8%）。 - .map 逐项：ui_data.o 488 B（Code 184/RW 12/ZI 476）、ui_data_feed.o 221 B （1034/12/209）；LVGL 池 0 增量；ui_w_soe 未接线不进镜像（.map 无其符号）。 - 台架未跑（本笔零像素、零接线）：首帧时刻、200 ms 刷新、eng 升档与遥信 位图真值全部留"待台架实测"，接线完成后请 Lead 排窗。 遗留与风险（随回报进台账） - 写路径（契约 §6 的 param_request/state）不落：无消费者就是永不执行的死码， 随整定 4 页一起落；届时须先定"UI 整定 vs iec104Task 写 prot_set"的并发口径 （prot_set_set_sealed 的影子区非重入）。 - 公共地址 CA 未下发：固件里 CA 逐帧从 ASDU 头解析，无集中常量可取。 - 遥信位图与 App/protocol/iec104/iec104_pts.c 板端源是两处镜像（该文件位号 写在函数体内未导出，UI 不得 include 协议头），开入采集落地时应并成单源。 - 版本类字段是本文件内的宏（仓库无产品级版本登记表，值沿用页面既有显示 值）；软件校验位在拿到构建期 CRC 步骤前一律显示 "--"，不抄参考遗留值。 gate: 全量钩子（--all-files）40 项通过；cppcheck/test-cppcheck/coding-standard/ layer-deps（基线仍 3 条）/registration/bsp-err（存量 38 条不变）/font-charset/ id-check（增量无新账）/doc-links/ui-golden/主机单测与覆盖率全绿；唯一红项是 mem-numbers 与 mem-budget——两者只因 Flash/RAM 台账未回填（禁区，归 Lead）。 gate: only mem-budget/mem-numbers pending lead ledger backfill 自查：BOM（Drivers/BSP/UI/* 与 App/task/ui_task.c 保持 EF BB BF，新建 UI 两件 同规范；App/app 与 test/host 无 BOM 与本目录一致）；CR = 0 全 LF；U+FFFD = 0； 字符串字面量纯 ASCII（中文只进注释）。	2026-10-25 09:56:22 +08:00
wandering1	8cbc7bc6b6	feat(ui-font): 字库补 SOE 显示名用字 采/样/恢/效（179→183 字 / 274→278 字形） ... 单独提交：按字库独占规矩，缺字改动自成一笔，不与功能改动混笔。 用字来源（下一笔提交的 ui_w_soe 显示名映射）：事件类型"采样闭锁/ 采样恢复/标定复归"与时标行的"时钟无效"。缺字上屏是空白方块、无日志 无报错，只能靠像素回归与门禁照出来。 流程（font-regen 四步，未跳步）： 1. extract_cn 扫出 144 字 < 现清单 179 字：35 字源码已不用但不属 KEEP_EXTRA 那 4 字（异/常/片/芯）——它们是 2026-09 窗口固件写进 /log/selftest.log 定长记录的历史用字，跨固件持久落盘，静态扫描照不出来。故按并集回填， 本笔只加 4 字、不做瘦身：瘦身等于让历史审计记录永久渲染空白且不可逆， 收益（约 35 字 × 27 B RO）与代价完全不对称（同门禁头注"刻意保留 ≠ 未知冗余"的同一判定逻辑）。这 35 字要不要入 KEEP_EXTRA 已回报 Lead 裁决，不在本道写域。 2. make_font.py 重生成 ui_font_cn_12.c：coverage OK，183 字全覆盖；▶/Ⅰ/Ⅱ/Ⅲ 补回字形的单码位 cmap 条目未被宽稀疏 range 吞掉（首命中守卫通过）。 3. 像素回归：菜单 8 状态 + 内容页 11 页黄金参考逐字节不变， simulator/tests/ref 无 diff → 本笔不产生基线变化，未用 --update 刷参考。 4. 构建：@build 0 错误 0 警告（RO-data 21396→21504，+108 B，1bpp 12px 每字 约 27 B 含字形描述符）；模拟器 0 警告。 计数字段同步（同一事实只改数字，不重复抄流程）： - docs/UI设计/UI_中文字体生成与配置.md：产物说明 + 体积档（含 4 字实测增量） - docs/UI设计/UI_界面制作流程.md C3 行 - docs/UI设计/UI_设计架构.md 默认字体行 - simulator/README.md 已知坑第 4 条 自查：BOM/CR/U+FFFD/字面量 ASCII 全树核对通过；全量钩子 40 项通过， 仅台账两条待回填（数字随下一笔的 ui-data 提交一起由 Lead 回填）。 gate: only mem-budget/mem-numbers pending lead ledger backfill	2026-10-25 09:56:10 +08:00
wandering1	c4edf352fe	refactor(UI): 记录页改注入式 reader，layer-deps 基线 6->3(道B task-6) ... B-6 分层收紧（UI_数据供给设计说明.md §7.2 契约原样落地）： - ui_w_records：删 #include "sys_log.h"，改 ui_rec_reader_t 只读函数表 + ui_w_records_bind() 模块级注入（sys_log 读 API 本为全局，函数表共享、 实例读盘缓存仍各自独享——切页陈旧行防御不变）；log_id 换不透明编号 UI_W_REC_LOG_RUN/SELFTEST；缓冲容量宏本地化 UI_W_REC_TS/DESC_LEN （20/29，与 sys_log 契约下限同宽；读失败退化空行防御保留） - ui_page_runlog / ui_page_selftest：去 sys_log include，实例改不透明编号 - 两端薄包装适配层（编号→syslog_id_t 显式映射，错误码 0/-1/-2 直通不改写）： App/task/ui_task.c 与 simulator/main.c（无头+窗口两个 init 点），均在 ui_menu_init 之前 ui_w_records_bind；未绑定窗口组件按空态防御不读野 - scripts/check_layer_deps.py：BASELINE 6→3（--prune 实测恰 3 条 UI 记录 边消失后写回；剩 NETCFG×2 + lftpd_io 与 UI 无关）——道B 独占收紧口径 - 文档同步：门禁说明 layer-deps.md §1/§6/§9 与 README 计数 6→3； UI_数据供给设计说明.md §7.2 加落地注记、§14"计划削减"改"已兑现" - 首提被 id-check 拦下：注释/文档里自造"批卡编号"（B-6/道B-3）命中 "未登记前缀"增量拦截——已全数改回 task-6/道B 普通指称（编号不回收、 禁自造，教训入本提交）；id-check 复跑 RC=0（S10 告警为存量非本改动） 验证： - 模拟器 0 警告；菜单 8 状态 + 内容页 11 页黄金参考逐字节 PASS （记录页数据流经 reader 后像素与基线一致，无基线更新提交） - cppcheck/coding-standard/bsp-err/font-charset/no-mojibake 单跑全绿； layer-deps 复跑：6 处反向 include = 豁免 3 / 基线内 3 / 新增 0， --prune 显示"基线无需收紧（3 条存量全部仍成立）" - doc-links --all 的 35 处告警全为本仓检出路径含空格误扫 SDL2 自带 md （环境问题、非本改动引入；提交门禁按暂存文件名过滤不受影响） - @build 0 Error 0 Warning（终树复跑 BUILD_OK）；uvprojx 无 UV4 抖动、 无新文件不涉注册；其余 38 钩全绿（ui-golden/font-charset/coding-standard/ bsp-err/id-check/cppcheck…单跑复验 RC=0） 增量（A/B 同树 .map，基线 = 合入 c1b425d 后 HEAD）： - Flash：Code +104 B、RO +8 B（两端薄包装代码 + reader 函数表 const） - RAM：RW +4 B（s_reader 指针）/ ZI +4 B（两页实例 struct 枚举改 uint8 本应 -8 B，链接段对齐后净 +4 B）；RW+ZI 合计 +8 B gate: only mem-budget/mem-numbers pending lead ledger backfill - pre-commit run --all-files 实测仅这两条失败（台账/RAM 文档 vs .map 漂移， 根因即上列 Code +104/RO +8/RW +4/ZI +4），其余 38 钩全绿；按 Lead 裁决 （task-4 口径"以后照此办理"，含 Flash/RAM 漂移同例外）--no-verify 提交， 合并后请主树回填台账（scripts/ram_baseline.py --write 由 Lead 侧执行） - 手工自查通过：5 个 BOM 文件 BOM=EF BB BF 齐全、docs/py/main.c 保持无 BOM， 全部 10 文件 CR=0、U+FFFD=0 - 台账增量供回填：Flash Code +104 B、RO +8 B；RAM RW +4 B、ZI +4 B	2026-10-25 05:21:05 +08:00
wandering1	a3f0c60aef	docs(UI设计): 字体字符集计数回填 179字/274字形并登记cmap首命中事故 ... - UI_中文字体生成与配置.md: §3 计数、§4 输出样例与补回规则(cmap 插入 位置/可达性守卫)、§7 体积口径；文末安全流程追加 2026-10-25 实测事故 - UI_界面制作流程.md: C3 计数 + 变更记录行(并校正 2026-10-15 瘦身后 119字/214字形未回填本表的历史计数) - UI_设计架构.md: 关键约束表默认字体计数 + 变更记录行 - simulator/README.md: 已知坑 #4 计数 - .dsh/skills/font-regen/SKILL.md: 步骤2 增 KEEP_EXTRA 并回警示；坑新增 "低于最小码位扩字移动稀疏 range 起点"条目；计数更新	2026-10-25 03:24:06 +08:00
wandering1	1e6996ecd0	docs(任务规划): 波次号 W1~W8 改为语义名，两个任务卡文件改名 ... 用户裁定：W4 这类字母+数字让人难以理解。W 号看着像执行顺序，实际 W8 排在 W3/W4 之前，读者必须先查表才知道谁先谁后；去掉编号后执行顺序就是 §2.0 表 从上到下，少一层映射。 - 波次改语义名：采集保护收尾 / 数据可信 / 预算与内存 / 结构债 / 验证常态 / UI 扩展 / 仓库决策 - 文件改名（git mv）：W1-采集保护收尾.md → 采集保护收尾.md， W8-数据可信.md → 数据可信.md - 删掉只为编号存在而写的两条注记（W2/W3 槽位保留、W3 不重编号） - 并行分道方案的分支 ID 同步：task/W8-scale-doc → task/cal-scale-doc 等 - 编号登记表：WAVE 族标为废止并关闭悬空检查（属主文档已不再定义 W 号）， C-WAVE / D-WAVE 两族 title 补废止说明 - 同步 15 处跨文档引用（README 文件夹地图、产品需求 §9.2、编号规范 §4.1、 报告 §0.3 波次表、RAM 台账、保护规划变更记录等） - 不动的同形异义：网表 W4.0 封装宽度、芯片手册 W1 载带尺寸、MSVC /W4	2026-10-25 01:44:25 +08:00
wandering1	7048e9cb9a	docs(任务规划): 瘦身为只留待办，波次条目改用语义名 ... 任务规划目录只保留将来要做的事：删掉已完成的证据链与已作废的历史快照， 并把波内条目的 C/D 短码全部换成语义名。 为什么删 C/D 短码：它们同字母不同义——C 组在 UI_界面制作流程.md 里是 UI 设计约束（屏幕/字符集/文本/编码），D 组在控制台单写者日志设计说明.md 与配置文件设计说明.md 里是决策记录。同一串短码在三处指三件事，读的人 只能猜，所以条目一律改用一行短语作标识。 - 排期详述.md 重写为「结构债与验证常态」，条目全语义名，出处列留冻结号 - README.md 删修订记录块（本文件自述不留变更记录），波次行改语义描述 - W1-采集保护收尾.md 67→30 行，只留 M3 送检与 B10 卡 - 基线与待确认.md 73→15 行，删已作废的旧栈表与旧余量数字 - 登记簿.md 逐行收缩到未闭环残余，N-29 的 .git 订正为实测 233 MB - 测试与架构专项.md 删 S1-c（106 例已落地，且被覆盖率总闸覆盖） - 并行分道方案.md 删批 0，修两处会返回 rc=3 的 new 命令形态 - 覆盖率口径：套件 16→33、未挂钩子 12→17、墙钟 25s→67s（实测） - 同步 10 处跨文档引用，指向合并或删除后的新位置	2026-10-25 01:35:21 +08:00
wandering1	c0ccd777ae	docs(UI): 页面补齐规划、逐页扩充方案与实时数据供给设计 ... - 页面补齐规划：重算菜单树（42 节点 / 33 叶子 / 6 已绑页 / 27 空叶子）， 27 叶归并为 7 模块 + 2 项前置能力 + 1 数据层，分 4 批。 - 页面扩充详细方案：逐页规格（行表、数据来源、交互、字号），并纠正 已建 6 页里 3 页实为 Flash 字面量。 - UI 数据供给设计说明：选定"快照推送"（App 推 / BSP 存 / 页面只读）， rt 200ms + par 变化触发双通道；单写者同上下文故无需锁；记录页改为 注入 reader，可回收 3 条分层门禁基线（6→3）。	2026-10-23 23:34:44 +08:00
wandering1	1e4f74ba14	merge: task/ui-golden-ui-golden-ref 合入 v2-on-ui ... 任务 ui-golden（1 个提交）经 task-worktree 回收： - chore(ui-golden): 像素黄金参考 ref/*.bin 入库（把门禁改成可移植）	2026-10-23 12:22:02 +08:00
wandering1	504db26698	docs(内存): 阶段子项改层级编号 4.阶段.项，消除与顶层章节同号撞面 ... 根因：`RAM使用分析与优化方案.md` 顶层有 §1 背景 / §2 现状测量（2.1~2.6），而 §4 「方案」下"阶段 N"的子项也用裸号 0.x / 1.x / 2.x——阶段 2 的 2.1/2.2/2.3 与顶层 2.x **完全同号**，阶段 1 的 1.x 又长得像"第 1 章第 x 节"。`doc-links` 对本文自 引用按设计直接放过，于是门禁和人一起看错：AGENTS.md 把"栈余量台账"写成 §1.4， 而 §1.4 其实是阶段 1 的 lftpd 静态化项（上一笔提交的信息里我把它误判成断链， 已 amend 更正）。 改法：阶段子项一律改层级编号，阶段号不变、只加 `4.` 前缀 —— 0.x→4.0.x、 1.x→4.1.x、2.x→4.2.x。共改 14 个标题；文内自引用与实施序列表（S4~S9 那套）、 暂缓清单、§5 预期效果列里的裸号一并补成 §4.x.y。 外部引用同步 15 处：AGENTS.md、lftpd/README ×2、菜单页面设计、RAM预算台账 ×2、 项目架构总览 ×3、FTP_Test_Guide ×3、boot_log_data/README、部署环境要求、审查 报告、ram_baseline.py ×3。最有说服力的两处歧义：审查报告与 RAM预算台账都写 "缩堆见 …§2.2"——既可读成顶层 §2.2（静态大项排行）也可读成阶段 2 第 2 项， 现均为 §4.2.2（阶段 2 第 2 项"缩堆"）。 另修 4 处把 §1.4 当"栈台账"的错指：采样有效性校验设计说明 :441/:593/:650 改 指 §2.3（任务栈配置与实测峰值）与 §4.0.6（静态最坏链与判定）；id_aliases.json 的 note 改指 §4.0.6 并标注"原 §1.4，2026-10-22 层级编号"。 冻结与示例：其它文档**变更记录行**里的旧编号按项目纪律不改写（项目架构总览 :367、RAM预算台账 :98），改在被引文档 §4 开头留一张换算表 + 约定说明；把旧号 当语法示例写的 7 处一并换掉（文档规范 ×3、check_doc_links ×3、rename_ref ×1）， 否则示例本身指向已改名的锚点。主文档版本行 bump 到 v1.3 / 2026-10-22。 门禁：check_doc_links.py --all --sections-strict → 146 个文档 0 问题（章节引用 2513 处、机器可判定 1491）；check_ids.py --strict 增量拦截通过；mem-numbers、 ram_baseline --gate（SRAM1 57.4% / CCM 87.9%）、task-table 全绿；本轮未改任何 .c/.h。16 个文件字节卫生自查 BOM/CR/U+FFFD/行尾空格全清。已提交本地，未推送。	2026-10-22 15:38:14 +08:00
wandering1	a38f862fb9	chore(ui-golden): 像素黄金参考 ref/*.bin 入库（把门禁改成可移植） ... 问题：ui-golden 是逐字节比对（check_content_pages.py 里 data == refdata）， 而基准 simulator/tests/ref/ 整目录被 .gitignore 忽略、从未入库。后果不是 "少几个文件"，而是这条门禁在任何新克隆 / 新并行工作树里必然报「缺黄金 参考」——只在有老副本的机器上它才是真的回归门禁。本会话已两次实测踩到 （并行工作树里只能现场 --update 造基准，而现场造出来的基准恰好失去意义）。 入库前先证明基线可复现，否则等于把一条天天误报的门禁写进仓库： - 主树 ref/ 生成于 2026-10-11，其间合入 B6~B9 与 UI 令牌化等多次改动； 今天用刚重建的 lvgl_sim 重跑 → 11 页 + 开页-关页往返池水位逐字节全过 - 主树与新工作树两份**独立构建**的 lvgl_sim（不同构建目录、不同绝对路径） 各自生成基准 → 11 个 .bin 的 SHA-256 全部一致 即渲染是 CPU 侧确定性输出，可以当仓库内容。 改动： - .gitignore：整目录忽略 → 只忽略派生的目检 PNG。另加一条 !simulator/tests/ref/*.bin 反选——第 115 行的全仓 *.bin 兜底（挡 sim_netcfg.bin 之类运行产物）会把基线一起挡掉，且反选必须排在它之后 才生效 - 不引入 LFS：11 x 3200 B = 34.4 KB（160x160 单色打包）。走 LFS 反而新增 失效面——没拉 LFS 的克隆会拿 pointer 文本去比像素，把"缺基准"换成 "比不中"。.gitattributes 已有 *.bin binary，check-attr 确认 text unset， 不会被行尾转换改写 - 基线不会被改写型钩子毁掉：trailing-whitespace / end-of-file-fixer 声明 types: [text]，位图含 NUL 被判二进制 → 实测 Skipped；索引 blob、磁盘、 主树参照三方哈希 11/11 一致 - 新增 11 个基线；同步 5 份文档与 3 处脚本口径：缺基准的提示从"首次/换机 请加 --update"改为"检出不完整 → git checkout -- simulator/tests/ref/ 取回， 不要用 --update 就地造基准"（旧提示正是自我实现型基准的来源） - 顺带修掉 simulator/tests/README.md 两处与实现不符的描述：基准写成 PNG （实为 .bin）、regen_ref_png.py 写成"重建黄金参考"（它只出目检图，基准 由 check_content_pages.py --update 刷） - .pre-commit-config.yaml 只改注释（原文明确断言 ref/ "永远不会进 git 索引"，已被本改动推翻）；ui-golden 的 files 面覆盖 simulator/tests/， 基线被改即触发回归，刷参考从此在 git diff 里显形 历史口径按纪律冻结：UI_自动化测试流程 2026-09-10 的"整目录不入库"等 6 处 变更记录行不改写，以新行登记反转。 实测：@build 0 错 0 警（Code=213520，与内存台账一致）；ui-golden Passed； pre-commit run --all-files = 36 Passed / 0 Failed（RC=0）。	2026-10-22 06:17:00 +08:00
wandering1	52976bdec3	refactor(编号): 批 4 陷阱号统一为 TRAP-<模块码>-<nn> ... 本批是 ② 形态迁移清的第一族（用户裁定顺序：② 里的 Trap 一族先做） 统一了什么（数字不变、只补模块码，§7.1）——改名工具 23 处 / 11 文件 - Trap 01~07 → TRAP-GD5F-01~07：属主文档 7 个标题行从此成为定义位 - 陷阱 1 → TRAP-RTC-01（SD2506 属 RTC 域，§4.2）、见陷阱 01 → TRAP-GD5F-01 - Trap 21 / Trap 19 → TRAP-NET-21 / TRAP-NET-19（引用的是活登记处 CH395F_Trap_Records.md，号本身不变） - 波及 Drivers/BSP/GD5F2GQ5UE/*（4 处注释）与 test/board/*（2 处）→ 已重编 三处判读后**刻意不改**（写进 §8.3，不让人当成漏网） - docs/环境与部署/并行任务工作树方案.md 的 wip/trap22-fix 是 git 分支名，不是编号； 这类非编号字面量要靠类型处理，与位号 T1、IEEE 负序 S2、gitlint 规则 ID 同一批 - docs/UI设计/菜单页面设计.md 变更记录行的「陷阱 3」按 §8.1 冻结不改写 - docs/硬件平台/V0.0、V0.1 网表报告里 6 处 Trap05 语义确指 TRAP-NET-05，但该目录 是门禁与改名工具共同的排除语料 → 不越界动笔，盲区登记进注册表 TRAP 族 cursor_note 两处不是改名、是改错话（映射表类工具的典型失效：字面对了、意思错了） - scripts/README.md 原写「Trap 19 从未存在」；改名后字面变成 TRAP-NET-19，而它是 **真实条目**（SET_MAC 必须在 INIT_CH395 之前）→ 那句话成了假话，改用站得住的例子 - docs/编号规范.md 同一处事故叙述补准确说法：当年裸形不在册 ≠ 这个坑不存在 - 菜单页面设计.md 的「见 §8.2 陷阱 1」本就不是 TRAP-* 族的号（指本文小节第 1 条）， 改写成「见本文 §8.2 第 1 条（lv_text_get_width 的 length=0 陷阱）」 关闸第一次真拦人：咬的是自己家的审计表 - scripts/rename_maps/batch3-trap.json 里必然写着 Trap 21 / 陷阱 1 等旧形态， 被当成 6 类「台账外新账」→ 提交被拦（拦得对，但表不是语料） - 第 4 次同一类自循环（前三次：别名表、注册表、债务台账）→ 整个 rename_maps/ 目录入 excluded_paths；这条规律写进 §8.4：**登记号的表一律不得当引用语料** 实测变化 - 错误级 659 → 632（−27）；② 空格/中文形 Trap 残余 2 处（都是上面刻意保留的） - ③ 悬空错误 44 → 42：TRAP-GD5F-01/05/06 三处历史悬空引用自动落地为已定义 - 编号字面量 8277 → 8312（识别面没有缩水，这是改名最容易踩的坑）； 可判定比例 82.92% → 82.99%（基线 82.6%）；⑦ 定义无引用 100 → 103（如 TRAP-GD5F-02 只有定义位无人引用，如实挂 warn 不压掉） - 台账 --prune-backlog 收掉已还清 42 条，剩 298 条（只减不增）；--strict 通过 另修：core.autocrlf=true 把 SD2506_Trap_Records.md 检出成 CRLF（41 处）→ 还原 LF， 该文件 diff 只剩 1 行实质改动（仓库权威行尾是 LF，见 .gitattributes） 验证（全绿） - @build：0 错误 0 警告（Program Size Code=213356 RO=18580 RW=1184 ZI=131480） - ci_local.py：L0 + L0.5 全过（16 runner / 1104 断言） - check_doc_links.py --all：143 篇文档 0 失效、0 待确认 - 改动文件字节卫生逐项与 HEAD 对比：BOM / CR / U+FFFD 异常 0 审计轨迹与文档 - 映射表 scripts/rename_maps/batch3-trap.json（含作用域切分理由与刻意不改清单） - 别名 11 条全部带 scope；docs/编号规范.md §7.1 行状态、§8.3 批 4 行 + 说明段、 §8.4 自循环第 4 条、变更记录	2026-10-21 12:32:13 +08:00
wandering1	301c3e5183	feat(门禁): 编号门禁 id-check 落地（36→37 钩子）+ 批 1 编号单词化改名 ... 新增门禁本体 - scripts/check_ids.py：实现 docs/编号规范.md §8 八项校验；默认 warn-only， 唯一硬拦项是「可判定比例跌破基线」（防回退的本体） - scripts/id_registry.json：66 个前缀族，逐项来自 §4 总表 + 全库实测游标， 偏差一律写进 cursor_note，不凭记忆编造 - scripts/id_aliases.json：旧号 → 新号 / 作废标记（照搬 section_aliases.json 范式） - 顺带收编 check_test_traceability.py：正则补齐大写后缀与无模块码形态， 比对范围扩到 test/host 与 7 篇「单元测试说明.md」，另加 --board-only 回退旧口径 批 1 改名（用户授权解禁「不改写存量号」） - 代码规范条款 S1~S19 → CODE-RULE-nn：78 处 / 2 文件 - UI 像素回归状态 S0~S7 → MENU-STATE-nn：61 处 / 3 文件（冻结在 07） - 两族属主登记处 = 脚本自身的规则表 / STATES 表，文档只作引用方 - 新增 scripts/rename_ids.py（§7.3 规划脚本）：映射表驱动、显式 scope、默认干跑、 自动写 scoped 别名，跳过 [示例]/[计划] 行与变更记录表，按原字节读写保 BOM 行尾 - 已应用映射表存档 scripts/rename_maps/batch1.json 作审计轨迹 有牙实测（证明门禁不是空转） - 注入 Z-99 / 裸形 / 悬空 / 越游标 / 未紧邻 / 跨文档重复定义 六例， 分别被校验 1/2/3/5/6/4 点名，--strict 退出码 1；临时档删除后工作树干净 验证与同步 - 可判定比例基线 82.3% → 82.7%（已 --update-baseline 入档）；错误级 1312 → 1291 - ci_local.py 全绿（L0 + L0.5 共 1104 断言）；ui-golden Passed； check_doc_links.py --all 无法判定 0 - 未改任何 C/H 源文件，故本次不需 @build - 文档：AGENTS.md 与 pre-commit使用说明.md 计数 36→37 并新增 §2.25 详解； 编号规范 §4.1 补两行、§8.1 落地记录、§8.2 规范与仓库偏差、§8.3 迁移批次记录	2026-10-21 09:33:54 +08:00