wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
756 Commits 4 Branches 0 Tags
4ba02212eb45c3eef2a705f41b887c2e0dbd5737
Commit Graph

756 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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 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 a75bc03ab5 docs(任务规划): 菜单树叶数实测复核 42/33/28/5 全部成立，只补判定方法与「当时」口径 
按 ui_menu_tree.txt 文件头规则实测（缩进即层级、每级 2 空格、# 开头为
注释、空行忽略）：节点行 42 = 9 个菜单节点 + 33 叶；叶行行尾带 #page=
的已绑 28、未绑 5（遥信类型 / 遥信防抖 / 双点遥信 / 手动录波 / SNTP设置）。
双源互证：tools/menu_gen/gen_menu.py 的 parse_tree 重跑得
nodes=42 leaves=33 bound=28 unbound=5；生成物 ui_menu_tab.h 的
UI_MENU_TAB_COUNT=42 与 ui_page_registry.h 的 UI_PAGE_MAP_COUNT=28
——两源逐项一致。剔伪命中：grep -c #page= 得 29，多的 1 是文件头第 5 行
注释里的示例行，不算节点行，故真值取 28 而不是 29。

结论：两份规划文档的当前态叶数本来就对，本笔不改任何数字，只补口径与方法：
- UI补齐.md §1 判定新增第 4、5 条：未绑 = 待做 + 不做（0 + 5 = 5）闭合式；
  并写明按文本计数会把头部注释示例行算进来（29 = 28 + 1），真值以生成物为准。
- UI补齐.md §1 三个错算法：21 / 23 两个错数分属 2026-10-27「已绑 21 叶」
  与「已绑 22 叶」两个时点，加「当时」锁口径，并补同一错法今天的重跑值
  （未绑 14、grep 29、去重 29），注明两个 29 只是撞号、都与真值 28 无关。
- README.md §1：同步闭合式 +「42 是节点行数、不是叶数」+ 伪命中提示。
两份文档都没有变更记录表（UI补齐.md §2 明示不留完成史）→ 无历史行可追加。
未动：docs/UI设计/页面补齐规划.md 的「27 空叶子 / 6 叶落地」与
docs/UI设计/页面扩充详细方案.md §1.1 的「已绑 6 叶」都是立项快照，
文内已有 2026-10-28 复核对齐行；id_aliases.json 的「UI 剩余 21 叶」是
退役别名留档；「最坏路径 < 40KB」一类绘制缓冲红线与叶数同数不同义。
并发提示：仓库另有在飞批次（黄金参考张/页口径，含本文件 60 页→60 张一行），
本笔只含叶数相关三处改动，未带走他人内容与他人暂存的文件。
门禁：check_doc_links.py --all --sections-strict 打印「文档路径检查通过
（195 个文档）」；check_ids_new.py 查暂存区 [OK] 新增行无未登记编号。
 2026-10-28 15:03:21 +08:00
wandering1 599f05be22 refactor(编号): 测试验证层级 L0/L0.5/L1/L2/L3 → 语义名（批次 3d·文档层） 
这族是验证层级：静态门禁 / 主机侧纯逻辑单测 / 板端测试套件 / 主机侧回归 / 人工目检。
实测它出现在 **97 个文件**（40+ 个 test/host 的 run_unit_test.py、.gitea workflow、
ci_local.py 的阶段标签、以及十来篇文档）。本批只做**文档层**，代码层单列一批（见下）。

改动：10 篇文档 110 行 + 三处收尾——
  测试开发标准流程 / 实机测试实施指南 / 主机单测覆盖率口径 / 门禁说明 README 与
  host-unit-tests / CI README 与远程CI完整指南 / docs README / 测试与架构专项 /
  pre-commit 使用说明。
映射：L0 → 静态门禁、L0.5 → 主机侧纯逻辑单测、L1 → 板端测试套件、L2 → 主机侧回归、
L3 → 人工目检；`L0b`（ci_local 的内部阶段标签）在文档里写成「提交信息门禁」。
测试层级那张表的「层级」列被删掉（名称列已承载同一信息，留着就是两列重复）。

**未做（代码层，单列批次 3d-2）**：`scripts/ci_local.py` 的阶段标签、`.gitea` workflow、
`test/host/*/run_unit_test.py` 的输出前缀、以及代码头注释里的 L0/L0.5 —— 那些是**程序标识**，
改名要连带 CI 日志格式与文档里对 `[SUMMARY] L0: ...` 的引用，属跨端改动，需单独验证。

验证：三篇主文档的层号残留 = 0；doc-links 通过；mojibake / git diff --check 干净；
表格列数已收敛为 3 列（名称 / 载体 / 抓住什么）。
 2026-10-28 13:20:28 +08:00
wandering1 b9f5df5d28 refactor(编号): 链路延迟分段 L1~L11 → 段名（文档中文名 / C 日志 ASCII 短码，批次 3b） 
这族是延迟测试的分段号（L1 SPI 字节命令 … L11 uiTask 节拍）。特殊之处：**号直接打进
串口日志字符串**，而 C 字符串必须纯 ASCII（AGENTS 铁律）——所以两份落地面用两套名：

  文档（人读）：SPI 字节命令 / SPI DMA / 发送分块握手 / 芯片→线上+PC / 队列往返 /
                请求→首字节 / 整帧 3209B 往返 / 生产路径帧周期 / 连接/重监听 / 日志税 / uiTask 节拍
  C 日志（ASCII）：SPI_CMD / SPI_DMA / CHUNK_WAIT / TO_PC / QUEUE_RT / ECHO_RT /
                FRAME_RT / PROD_CYCLE / RELISTEN / LOGTAX / UI_LOOP

改动：`链路延迟测试说明.md` 84 行（分段定义表的「段」列删掉、名称列即段名；正文与
基线表同步）；`test/board/net_latency_test.c` 61 行（日志串与注释，行数不变、逐行替换）。
标识符一律不碰：`LAT_P13_OP_L5_RECV` / `P13_ST_L5_SEND` 这类宏与枚举仍在（它们是代码符号，
不是给人读的段号）——7 处已核完整。

一次事故：第一版把该 .c 写坏了（整篇被同名表格行覆盖），已 `git checkout` 回滚，改成
「只改命中行 + 行数断言」重做，本次 61 行、1313→1313 行不变。

验证：文档与 C 两侧段号残留为 0；doc-links / mojibake / 新编号门禁 / git diff --check 全绿。
该文件属板级测试套件（产品构建不编译它），本次只动注释与字符串，不改任何逻辑。
 2026-10-28 13:19:04 +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 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 ed997a76a2 refactor(编号): 层内条目号 L1-1…L5-4 清退成语义层名（批次 2） 
这族是保护规划的功能子号（层号-子项号），2026-10-27 已整族退役；本批把残留清掉。
实测：24 个唯一号 / 55 站点，分布极窄——52 站点在变更记录行（冻结历史）、1 行在
相量层单测说明、1 行在技能手册正文举例，其余为 .pre-commit 注释。

判据按《编号规范》§5.5「唯一例外」办：变更记录行里已停发族的号改写成层名/形态描述，
历史事实与数字一律不动。映射：
  L1-* → 语义取数与有效性层     L2-* → 全周傅氏相量层
  L3-* → 保护判据层             L4-* → 出口与记录层
  L5-* → 动作留痕层
并列写法（L1-3/L1-4、L4-4/L4-5、L1-1~L1-3）折叠成一个层名，不留「第几项」。

改法要点：**只改命中的行**。第一版按整文件做，把无关行的中文间空格也吃掉（6 个文件
被误伤），已整体回滚重做；本版最终 14 行 / 3 文件，并自证「纯空格变化 = 0」。
顺带修掉批次 1 遗留的「测频与遥测快照测频」重复词。

有意不动：docs/测试说明/boot_log_data/ 里的真机日志与说明（现场证据，改它等于篡改）；
docs/硬件平台/ 里的电感/磁珠位号（L1~L4 同形但另一族）。

验证：doc-links --all --sections-strict 通过；mojibake / git diff --check 干净；
新编号门禁自查通过；本批无 C/H 改动，@build 不涉及（上一批代码尺寸未变）。
 2026-10-28 13:08:24 +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 967d29e633 docs(id-check-new): 补一条盲区——--all-files 下它是空转的 
本门禁自己读 git diff，不看钩子传进来的文件名：pre-commit run --all-files
（也就是 ci_local.py 的 L0）把文件当全量传入、暂存区却是空的 → 它打印通过。
这与 §6 第 4 条（未跟踪文件不在扫描面）同源，但后果不同：那条只影响手工自查，
这条会让 L0 全绿被误读成「没有新编号」。写进文档，别让人踩。
 2026-10-28 12:42:15 +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 2f70230646 docs(id-check): 记一条实测盲区——未跟踪文件不在扫描面 
做 ①②③ 第一步时给两根护栏做反向自证（往一个新文件里写自造前缀 + 数字）发现：
第一版探针文件没被 git 追踪，门禁报 0 处——因为 iter_files() 走 git ls-files。
提交时跑不受影响（要提交的文件必然已进索引），但手动在暂存前跑会得到假绿。
补进 §6 限制与盲区第 11 条，免得下次有人拿手工跑的结果当门禁结论。
 2026-10-28 12:18:18 +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 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 11d600572b docs(架构): 补漏——中文字体当前态 122 字/217 字形 → 218 字/313 字形 
UI 补齐批把页数与字数同步进了 UI 设计侧与产品需求文档，架构总览 §3「界面层」这行漏网，
是本轮全仓复扫（210 个文档）里唯一残留的当前态命中；其余 122/217、47→53、53→60
之类命中都在变更记录历史行里，按「冻结不回改」保留。

同步在本文变更记录加一行（升为末行，2026-10-14 之后本文首次改动），
并把口径指向权威处：逐叶清单 docs/UI设计/页面补齐规划.md §2.3、
实测体积与字形数 docs/UI设计/UI_中文字体生成与配置.md §7。字形数 = 字符数 + ASCII 95。

验证（实测）：check_doc_links --all --sections-strict 通过（210 个文档）；
check_ids --strict 校验 1~6 无错误；check_bom_drift / check_mojibake 通过；
git diff --check 干净。纯文档，不涉及构建与真机。
 2026-10-28 12:08:03 +08:00
wandering1 cbb4fdb893 docs(产品需求): UI 现状同步——绑定 28 叶、黄金 60 页、字库 218/313 
补上此前被并行会话丢弃的那轮同步（我在 94b0d790 里改过、随后随未提交稿一起消失），
这次落在当前版本结构上，逐项按实测真值改：

- §8.2 绑定现状：已绑内容页 28 叶 / 未绑 5 叶，页面注册表 UI_PAGE_MAP_COUNT = 28
 （2026-10-28 实测）；未绑 5 叶 = 无开入硬件 3 + 手动录波 1 + SNTP 1，
  取舍与重开条件指向 docs/任务规划/UI补齐.md §5。
- §8.3 内容页：已绑 28 页；分组表补两行——记录查询 5 页（每记录 2 行、空态显无记录）
  与运行报告（13 行分 2 页、四个数逐个挂范围标签）；未绑段去掉已落地的当前执行 6 项；
  像素黄金 53 → 60 页（+7 张，含运行报告第 2 页那张）。
- §8.5 中文字体：当前态改 218 唯一字 / 313 字形（实测 ui_cn_chars.txt 218 个字符，
  字形数 = 字符数 + ASCII 0x20~0x7E 共 95）；122/217、179/274、185/280 标注为历史快照。
- §5.14 FR-SOE-3：由「展示层待补」改「软件面已落地；真机判据待台架」——写清七类文本
  记录 + 二进制 SOE、记录类型即日志 ID 本身、运行报告四个数的真源与下发通道，
  并把软件面已满足（空态与标签由 60 页黄金钉住）与待台架复核（真记录翻页、掉电保持、
  清除后归零、boot_count 自增与四态）分成两段，不混成一个已完成。
- §2.4 立项未排去掉已交付的记录 5 页；§9.1 差距表 UI 记录页行改写现状与去向；
  §9.2 顺序表第 1 行改「清单已清空（2026-10-28）」、第 2 行改「下一顺位（未开工），
  切换条件已满足、开工待用户点头」。§12 变更记录加一行（不 bump 版本号，v1.6 之后）。

验证（实测）：check_doc_links --all --sections-strict 通过（210 个文档）；
check_ids --strict 校验 1~6 无错误，可判定 7006/8039 = 87.15%（基线 86.0%），
不可判定 1033 处（上限 1166，本笔未增加）；check_bom_drift / check_mojibake /
git diff --check 均 rc=0。纯文档，不涉及构建与真机。
 2026-10-28 12:00:33 +08:00
wandering1 e94ce92c9f docs(产品需求·屏板链路): 提交用户的两处删除，并把删除留下的引用衔接补平 
删除由用户本人在并行会话里做，本笔按「整理并收工提交」指令代提交；
Lead 只做引用衔接与形态整理，未改其结论。

产品需求设计文档 §2.4.1 范围外表删掉「屏板（板件本体）」一行后，X 表实为
X1 双核分工 / X2 工具链 / X3 一次设备接口 / X4 独立计量通道。正文里 14 处
仍按旧号引用（旧 X4 指一次设备、旧 X5 指电度、X1~X5、X4 / X5、X1~X3 等），
已逐处按新号改写；变更记录里 v1.2 / v1.3 等历史行按「冻结不回改」保留旧号
（口径 docs/编号规范.md §5.5）。

两处依赖「屏板本体是范围外项」的表述随之改写：屏板链路已从范围外项移入
范围内待做（规格 §5.16，执行规划 docs/任务规划/屏板链路.md），主机侧链路与
参考 1:1 同构、不属替代方案；不在本仓实现的只剩屏板板件硬件本体（独立工程
DTU-LCD）。§9.1 解除表的「算力 / 形态」行同步去掉对已删行的引用。

屏板链路.md：§0 风险表删掉「250 kbps 收发器上限」（已解除）与「PA10 未接线」
（已撤销）两行后，剩余两项重编号为 1、2；表格单元补一个空格成「竖线 空格 号」
形态，与全仓表格写法一致。

验证（实测，纯文档不涉及构建与真机）：check_doc_links --all --sections-strict
通过（210 个文档）；check_ids --strict 校验 1~6 无错误，可判定 7006/8039 =
87.15%（基线 86.0%），不可判定 1033 处（上限 1166；本笔 +3 来自改写后的号提及）；
check_bom_drift / check_mojibake / check_coding_standard 与 git diff --check
均 rc=0。
 2026-10-28 11:48:12 +08:00
wandering1 155bd5e1e8 docs(任务规划): 新增 RS-485 解锁与门禁口径对账分工说明 
A 线（RS-485 驱动契约）：补两条未修缺陷——单缓冲包撕裂改双缓冲
加帧序号，消费者一次取整帧，对齐临界区原子快照语义；
TX 超时路径先等 TC 再拉 DE，避免尾字节被截；错误码走 bsp_err 通道，
返回值不得裸丢弃（consume-result 会拦）。结论回填问题记录，
并写清解锁条件是否满足。

B 线（门禁口径对账）：把 AGENTS 与《门禁说明》§2 的钩子计数对到实跑；
口径 = YAML 解析后的条目数，声明 / 文档 / 实跑三数同源，
注释掉的候选钩子不计入。

跨线接口先在本文件登记再动手；两线互不编辑对方范围。
本文件只分工、不改行为；接线节奏与建任务 / 抬栈属 Ask first，
是否接线由用户裁定，不由本分工决定。

整理项（Lead 代提交前修的 2 处门禁问题）：两条指向尚不存在产物的引用，
按《文档规范》「计划中」形态在反引号内加 [计划] 前缀——
test/host/rs485/run_unit_test.py 与 docs/问题记录/RS485_Trap_Records.md；
改后 check_doc_links --all --sections-strict 由 2 处失效转为通过。

风险与回滚：纯文档新增，单提交可 git revert，不涉及构建与真机。
 2026-10-28 11:40:44 +08:00
wandering1 02c42dea94 docs(编号): 已停发族的示例编号改形态描述；技能手册按有无机器识别面分两条路 
口径变更（用户裁定 2026-10-28，写进《编号规范》§5.5）：销项冻结的历史行一般不回改，
唯一例外是「变更记录行里已停发 / 作废族的示例编号」——把字面号改写成形态描述，
事实、结论与数字一律不动。本次随之形态化三处：F 前缀三段形态（原写作孤儿号字面量）、
A 前缀 + 数字、字母 U 紧跟一位数字（区间两端即该簇首尾两枚）。§9 加当日变更行。

技能 id-family-semantic-migration 扩写（+147/−44）：Steps 按族的「机器识别面」拆
  成两条路
——字母+数字族走门禁计数与映射表，中文前缀族（如已清退的「数据可信」任务卡号）门禁
咬不到，必须自建带标签扫描器并落地 §4.1.1 一行 + §9.3 换算表 + 叙述同步三处；
另加「三套计数都要挑明」与「不可判定绝对数涨点的净室归因」两节。

验证（实测）：check_ids --strict 校验 1~6 无错误，可判定 7006/8036 = 87.18%（基线
   86.0%），
不可判定 1030 处（上限 1166）；check_doc_links --all --sections-strict 通
  过（210 文档）；
check_bom_drift / check_mojibake / check_coding_standard / git
   diff --check 均 rc=0。

归属说明：这两处的语义出自并行的 RS485 / 屏板道（用户在另一会话里裁定），
Lead 按「整理并收工提交」指令代提交，未改动其口径与结论；文件在提交前后字节一致。
 2026-10-28 11:39:09 +08:00
wandering1 f50e74c63b docs+log: 撤销"PA10 未接线"结论，ORE 机理改为"RX 使能却不读 DR" 
用户反馈：PA10 这个端口是接线的，当年那个分析应该是错的。

核查确认：console_log.c（文件头与 con_uart_reinit() 注释）和
控制台单写者日志设计说明.md 12 节里的"PA10 悬空 / 未接线"是 2026-10-02 的
归因推断，不是实测，且与用户确认的接线状态相反。

ORE 的充分条件本来就不依赖引脚悬空：RX 使能了却从不读 DR，
线上任意一个字节或一个噪声沿使 RXNE 置位后无人读，下一个事件即锁存 ORE
（常伴 NE/FE/PE）；而 ORE 只能靠"先读 SR 再读 DR"清除，所以永不自愈。
引脚悬空只影响发生率，不是必要条件。

当年那场风暴的真因仍待定：接线正常时更常见的是对端波特率不匹配
（适配器不是 115200）或适配器 TX 在 USB 掉线时浮空。下次复现先量
适配器 TX 的空闲电平与波特率，不要再默认"引脚悬空"。

改动：
- console_log.c：函数注释改按正确机理表述；修改记录加 2026-10-28 一条
  说明归因更正。纯注释，Code 236456 B 与上版一致，@build 0/0。
- 控制台单写者日志设计说明.md 12 节：机理段后加更正块，写明观察与缓解
  措施仍成立、只有归因需要改写。
- 产品需求文档：4.2 表 USART1 行改为"PA10 双向均已接线"；5.16.2 的
  "PA10 没接线"警示块整段重写为"旧结论已撤销 + 真正机理 + 两条硬要求"
  （屏板链路必须消费 DR 并在错误回调清 ORE；新日志口仍设 UART_MODE_TX）；
  9.13 前置阻塞由"两条物理前置"改为"一条物理前置 + 一条实现纪律"；
  12 节加 v1.9。
- 屏板链路规划：0 章第 2 行标为已撤销、执行顺序去掉"接 PA10"；
  批 0 由 4 项减为 3 项；批 1 第 3 项判据补"拔插 TX 线制造噪声后能自动
  恢复"；风险表把"PA10 没接"换成"一次噪声后链路永久静默"。
- 任务规划 README 独立轨道行同步为两条前置。

体积凭证随索引刷新（scripts/size_attestation.json），数字未变。
 2026-10-28 10:41:32 +08:00
wandering1 eb2c454aed docs(产品需求): 端口重排——屏板占 USART1，日志迁 RS-232 通道 
用户裁定：现在的日志串口让给屏幕，RS-232 通道以后用来输出日志。

这条裁定把原来的头号阻塞直接消掉了：屏板改走 USART1（PA9/PA10），
是唯一一条 MCU 引脚直出 TTL、不经收发器的通道，所以 U15 = TP8485E-SR
只有 250 kbps 这件事对屏板链路不再构成约束，也不用改任何硬件。

顺带纠正一处算错的波特率分频：
- 旧文写 42 000 000 / 700 000 = 60 -> USARTDIV = 60.0、BRR = 0x3C0，
  漏了 16 倍过采样，照此写实际只有 43 750 baud。
- 正确：USART1（APB2 84 MHz）USARTDIV = 7.5 -> BRR = 0x0078；
  APB1 实例（42 MHz）USARTDIV = 3.75 -> BRR = 0x003C，误差均 0。

端口归属按 V0.1 网表 §4.2 的三对 UART 轮换核实：
RS485#4 = UART4（DE = PA15）、RS232#1 = UART5、RS232#3 = USART2。
所以 rs485_init(&g_rs485, &huart4, ...) 是对的，不动；屏板链路规划 v1
里"网表自相矛盾"那条判断依据错了（拿 V0.0 摘要行对 V0.1 代码），已纠正。

产品需求文档：
- 5.16.2 补端口裁定块与分频更正，重写"主机侧端口选型"为"端口重排"。
- DE 口径改为 TTL 直连无 DE；主机 RX 由"吃 4208 B"改为"只需 6 B"。
- 4.2 外设接口表补 USART2 / UART5 两行，USART1 行注明 PA10 未接线。
- 9.13 新增第 16 条"日志口迁移"，批次表注明 16 必须排在 10 之前
  （两者共用 USART1->DR）；第 10 条改 BRR = 0x0078、无 DE。
- 12 变更记录加 v1.8。

屏板链路规划：
- 0 章由"三个硬约束"改为"一条已解除 + 四条前置"，执行顺序钉死为
  接 PA10 -> 挪台架串口线 -> 迁日志口 -> 再写屏板链路。
- 决策一、二 标记已裁定；批 0 换成"腾位置"4 项；批 1 的 DE 项降为
  条件项，新增"日志口迁移"的改动点与判据。
- 5 章台架步骤补第 0 步；6 章风险表换成迁移期的新风险；7 章加判据 0。

任务规划 README 的独立轨道行同步为"端口已裁定、剩三条物理前置"。
 2026-10-28 10:22:37 +08:00
wandering1 fec0052865 docs(任务规划): 新增屏板链路执行规划，并记下 700 kbaud 的硬件阻塞 
新增 docs/任务规划/屏板链路.md：让主机跟 DTU-LCD 屏板真正通信的
执行级规划（需求侧仍在产品需求文档 5.16 与 9.13，不重复）。

核查后发现三个必须先解决的硬约束：

- 本板唯一 485 收发器 U15 = TP8485E-SR，手册上限 250 kbps，而屏板
  固件写死 700 kbaud，差 2.8 倍。这是唯一可能让整件事搁浅的点。
- 4208 B 帧在 250 kbps 下需 168.3 ms，已占满屏板 200 ms 应答窗口的
  84%，无实用余量；留 50% 余量需 >= 500 kbaud。
- 现有 rs485 驱动装不下长帧：RS485_RX_BUF_SIZE 与 RS485_TX_MAX_LEN
  都是 256，4208 B 会被直接判 BSP_ERR_PARAM。

规划要点：
- 四个决策（波特率与收发器、端口、宿主、键值 9/10 语义），其中
  波特率给 A 换器件 / B 屏板降速 / C TTL 直连三条路及代价。
- 分 4 批共 18 项任务，每项带改动点与判据。
- 端口建议：USART2 软件最优（DMA1_Stream5/6 空闲），USART3 硬件最顺
  （U5 子板连接器直连 TTL）但 TX DMA 被 SPI2 占用。
- 宿主用 xTaskCreateStatic（configSUPPORT_STATIC_ALLOCATION=1），
  不占已满的 RTOS 堆；栈 768 B，不进看门狗必需位掩码。
- 主机侧 RX 只需 16 B（屏板只发 6 B 召唤帧），别照抄屏板的 4208 B。
- 台架五步，先用 TTL 把软件全部跑通再等硬件决策。
- 复用 ui_net_sink_get_lcdmem / ui_net_sink_inject_key，不改
  ui_net_sink.c，也不改 rs485.c 的常量。

同步：
- 产品需求文档 5.16.2 补 700 kbaud 硬件阻塞警示与出处。
- 产品需求文档 9.13 加执行细则指针。
- 任务规划 README 导航表与 2.0 顺序表加独立轨道一行。
- docs/README.md 索引计数 5/6 -> 6/7 个文件。
 2026-10-28 10:11:36 +08:00
wandering1 11b4b2af70 docs(产品需求): 单色口径——删除多色协议，INIT 应答 29 B 改 16 B 
屏板是单色面板，多色协议不对齐。核查参考源码后确认这不是让步，
而是删死字段，三处证据：

- RemoDispBus.h:46 CN_RDISP_TYPE_MONO = TRUE，LCD_TYPE =
  CN_MODE_GREY_MONO、MEMSIZE = (X>>3)*Y，链路显存本就是 1 bpp。
- RDisp_Form_InitInf 的 CN_RGB_RED/GREEN/BLUE 是编译期常量，不是
  逐帧数据，每次召唤都发同样的 12 B。
- RDisp_LcdColor_To_Mono() 对 CN_MODE_GREY_MONO 直接 return TRUE
  不转换；RDisp_Lcd16B_To_Mono()（RGB565 转单色）挂在
  CN_MODE_COLOR_16B 下，本构建永不进入，是死代码。

改动：
- 5.16.5 INIT 表 29 B -> 16 B（宽 2 + 高 2 + 显存 4 + 8 键值表），
  删 1 B 颜色位与 12 B RGB，附证据块。
- 6.2 命令集 INIT 行同步，加单色口径注。
- 5.16.6 第 6 条注改为"该函数在参考单色构建下就是空转"。
- 5.16.9 第 1 行改为"补 8 B 键值表 -> 16 B、颜色 13 B 不对齐"，
  新增约束补单色一条，警示改为 16 B 与 29 B 不可互换。
- 5.16.10 判据第 1 条改 16 B 且不得出现颜色字段。
- 9.13 第 2 条改 16 字节且不加颜色位与 RGB，第 9 条客户端按 16 B
  解析，破坏性变更警示改后 8 B。
- 2.4.1 补"多色显示不在不可移植项内"——参考同样单色。
- 8.1 色深行补无灰度无彩色，渲染行改双出口。
- 2.5.2 第 20 项、9.1.2、9.12、10.3 第 13 项同步。
版本 v1.6 -> v1.7。
 2026-10-28 09:55:44 +08:00
wandering1 ec77c899e5 docs(产品需求): 屏板源码到手——串口通道协议定版并补状态灯下行 
依据屏板固件工程 DTU-LCD（STM32F103ZE + UC1698U）重写 5.16.2 / 5.16.3，
v1.5 遗留的"四项未知"全部消解：

- 物理层：RS-485 半双工、700000 8N1、软件 DE；APB1 42 MHz 下分频
  零误差（BRR=0x3C0）。
- 角色反转：屏板是 Modbus 主站（主动召唤），主机是从站 0x01。
- 帧 A（6 B 召唤）：01 03 type key CRC_H CRC_L，KEY_CMD=0 /
  RT_CMD=1，CRC-16/MODBUS 只覆盖前 4 B 且高字节在前。
- 帧 B（4208 B 应答）：3200 显存 + 4 B 状态灯 + 4 B info + 998 B
  填充 + 2 B CRC。readme 写 3208 B 与代码实参 4208 B 矛盾，以代码为准
  并标注待台架复核。
- 状态灯下行：info[0..3] 为 32 位小端位掩码，ID 0 电源灯恒亮、
  ID 1~19 对应 bit1~19；位到业务状态的映射参考源码没有，须自定。
- 键值：KEY_TYPE 0~10，实物仅 7 键（可达 1/2/3/4/7/8/9），且 9/10
  语义与参考的 F1 / F1+ENT 冲突，需先裁定。
- 时序：275 ms 周期召唤、200 ms 应答超时、约 5000 s 屏板自复位。

同步改动：5.16 开篇、5.16.1 注、5.16.8 tTimerLCD 行、5.16.9 差异表与
新增约束、5.16.10 判据扩到 15 条、9.13 任务扩到 15 条（新增状态灯映射
与 LOGO 下发，第三批不再解冻 UART4）、5.8 两套 LED 边界、5.6 FR-UI-1
双出口、6.2 口径注、2.4.1 X3、2.5.2 第 20 项、9.1.2、9.12、10.3、12。
版本 v1.5 -> v1.6。
 2026-10-28 09:48:23 +08:00
wandering1 ead8cc3a50 docs(产品需求): 补串口屏板通道——显示信息不只走网络 
参考是"一份显存、两个出口"：串口屏板通道为主（LCD_LED_Update 变化驱动 +
WriteScreenByByte 500 ms 兜底），TCP 7003 为镜像。上行同理：getRs485Key
物理键号 1~10 为主，g_tRemoteKey 为镜像，两者在 Key_Read 汇合且本地优先。

v1.4 把串口写成"随 RS-485 簇冻结"，等于降级成可选，是错的。

- §5.16 标题改为「屏板链路：串口主通道 + 网络镜像」并重写开篇
- §5.16.1 重写：显存基址 0xC1F00000，三条下行 / 两条上行路径对照表
- 新增 §5.16.2 本产品串口通道：V0.1 端口盘点，默认 USART3(PB10/PB11)
- 新增 §5.16.3 屏板侧接口一览 + 列出源码推不出的四项（波特率/帧格式/
  方向控制/是否分片），在拿到实测前不得声称"按参考协议实现"
- §5.16.9 差异表 10 → 14 行：新增串口通道整条缺失、双出口并发缺失等
- §5.16.10 判据 7 → 12 条：新增串口侧键号注入/500ms 出帧/并发不串帧/拔插恢复
- §9.13 任务 10 → 13 条：原 RS-485 屏板一条拆为物理层定版、下行显存、
  上行按键、并发回归四条；第三批改为独立立项，不随 §5.10 冻结
- §5.16.8 / §2.5.2 / §9.1.2 / §9.12 / §10.3 / §6.2 同步
 2026-10-28 09:36:44 +08:00
wandering1 463d7be135 docs(产品需求): 更正屏板口径并补远端屏与按键逐字节复刻规格 
参考工程主机侧无任何屏/键 GPIO：KeyGet、WriteScreenByByte、
LCD_LED_Update、getRs485Key、anyNewKey 全树只有声明无实现；
按键轮询函数名为 Key_Rs485_Process，屏板插槽号 CN_SLOT_DISP=0。
即屏与键都在独立屏板板件上、靠链路传输，本产品与之同构而非替代。

- §2.4.1 X3 由「本地人机」改为「就地屏板（板件本体）」并补更正说明
- §2.5.2 补第 20 项「远端屏与按键链路」，能力计数 19 项 → 20 项
- 新增 §5.16 远端屏与按键链路（FR-HMI）：两条链路对照、帧格式、
  INIT 应答 29 B 逐字段偏移、续传与拒绝语义、按键状态机、三个定时器
- §5.16.7 列 10 项与参考的差异（INIT 8 B vs 29 B 为最大一条）
- §6.2 按参考源码重写：INIT 长度、KEEPLIVE 改为不应答、键码补 F1/F2
- 新增 §9.13 屏板链路复刻任务规划：10 条任务 + 三批划分 + 破坏性变更警示
- §9.1.2 / §9.12 / §10.3 同步补条目
 2026-10-28 09:24:18 +08:00
wandering1 15111eaec3 docs(硬件): 外设引脚口径由 V0.0 更正为 V0.1 
README 外设接口表与部署环境要求 3.2 节长期停留在 V0.0 引脚，
与 Inc/main.h（CubeMX 已迁 V0.1）不符。按 main.h 与 V0.1 网表
报告 §4.1 更正三处：

- TPAFE 控制组 7 线：PD3/PD4/PD7 + PF13/14/15 改为
  PC6 FRSTDATA / PC7 BUSY(EXTI) / PC8 RD / PC9 CONVST /
  PA8 OS2 / PA11 OS1 / PA12 OS0（原表漏 FRSTDATA 且 OS 顺序反）
- RS-485：UART5（PC12/PD2/PD0）改为 UART4（PC10/PC11/PA15），
  依据 app_main.c 的 rs485_init(&g_rs485, &huart4, ...)
- LED1/LED2 驱动脚：PC4/PC5 改为 PC5/PB0（PC4 让位给 ADC17），
  并补网名与丝印 LED(n+4) 倒序提示

产品需求设计文档 4.2 节随之删除该「文档遗留」标注（已闭环）。
README 补 RTC/SWD 两行，两处均加「口径 = V0.1」与权威来源。
 2026-10-28 09:11:07 +08:00
wandering1 4974321f2d docs(产品需求): 新增 9.4~9.12 缺口逐项明细 
把 9 章从"缺口清单"补成"逐项明细"：每个定值、每个点、每个模块
差在哪，以及怎么算做完。

- 定值：40 项去向对账（覆盖参考 35 + 本地 5），差额更正为 214 项；
  23 单元差额表 + 已覆盖 35 项逐项对照 + 未覆盖 163 项清单
- 遥测：31 点逐点对照，缺 22 点按依赖分三批
- 开入开出：138 = 软遥信 104 + 硬件 27 + 双点 6 + 多态 1；
  31 开出 = 出口 11 + 信号 20
- 动作事件：33 条（421~453）逐条对照，覆盖 9 条
- 保护元件：模块级 45 -> 8，37 个缺失模块逐个给出后果与依赖，
  差额由 +35 更正为 +37
- 录波：14 项硬指标与复刻所需四件东西
- 记录体系：13 类队列容量表，覆盖 8 类
- 规约栈：12 种逐种链路与工作量特征，四层排期
- 新增 9.12 复刻完成判据（12 条可验证判据）
 2026-10-28 09:01:10 +08:00
wandering1 f10869f048 docs(产品需求): 改为 1:1 复刻口径并补参考源码实测清单 
参考工程 Scatter_P_HV03.01_SV01.01 的源码常量表是唯一需求清单，
不再引用其分析文档（实测有两处不准：元件 89 vs 实为 45、
定值约 260 vs 实为 249）。

- 2.4 范围反转为参考能力全集，只允许 5 项不可移植项落在范围外
- 2.5 重写为 1:1 复刻基线：19 项能力清单、104 八段地址表、
  定值 23 单元分布、45 元件九类归集、规约全集、差异归因
- 更正 104 段基址笔误：参考 Rly_IEC104.h 为 1 起编，
  遥测 0x4001、遥控 0x6001（旧文档写 4000H+ / 6000H+）
- 9 重写为复刻进度与路线图，缺口分阻塞型与规模型两表
- 5.9~5.15 补全采集链与 104 需求，6.8 点表摘要补差额说明
 2026-10-28 08:55:21 +08:00
wandering1 5e0c702369 docs(文档规范): 第 2 节补一行 run_code 正文写法口径——落点选在乱码行之后，唯一锚点可断言 
第 2 节的表原来只讲编码、换行、行尾空白、文件尾、乱码五件事，
把长中文正文写进 run_code 程序体这一路一直没有口径，同一族写法事故在一个会话里复发八次。
现象分三类：混用引号或正文里塞进 ASCII 双引号，报 Expected 逗号 got ident；
反引号与 shell 专有量（状态数组、退出码变量）混进程序体同样解析失败；
字段名位置误用全角冒号，也是同一类语法错。
而解析一失败，同一程序里其后的写文件与提交全部静默零落地，只留下一个从未存在的临时文件，
下一轮复用它就以 ENOENT 或提交 128 退出收场，返工成本整轮落在这条链上。
现补第 6 件：整个程序只用一种 ASCII 引号定界，中文引号一律「」，反引号字符现取再拼，
正文逐行进数组，落盘后打印 bom、crlf、超 80 字符行数与占位残留四个卫生数复核。
本笔只加这一行，零编号增删，门禁口径与钩子计数都不动。
 2026-10-28 08:17:01 +08:00
wandering1 aa9f4cbfe4 docs(id-check): 批次六收口复测——在册旧号活引用归零，账面不动基线 
把两类别名（retired-to-phrase 与 void）当探针做全库复扫，口径同《门禁说明》的 id-check 篇第 9 节：
排除 excluded_paths、门禁自身语料与变更记录行。
命中 22 个文件 / 86 行，真编号活引用 0 处；余下命中面全部落在变更记录行（第 4.3 节不回改）、
元器件位号与 Socket 状态组合（第 4.4 节判非编号）以及属主文档的历史对照列。
账面决定：不重打《编号规范》第 8.1 节两根护栏基线——那些数随在飞改动漂移，属各自批次的收口；把某天的实测值钉进正文表格，
等于自造一条会过期的断言，本轮第一次尝试就撞了一次。
当日实测与命中清单写入 ci-artifacts 下的仓库外口径台账（被 .gitignore 挡住、不进语料），正文只留结论与口径。
本笔零编号增删、零语料增删：可判定比例只许涨、不可判定绝对数只减不增，两根基线均未下调。
改动面：《编号规范》第 9 节批次表补第六行收口记录；《门禁说明》id-check 篇追加当日变更行，自证本轮未并行派单。
同篇第 7.7 节的当日构成表按冻结证据原样保留，不随今日数字重打。
提交前按《门禁说明》README 第 2 节的实跑口径统一走一遍只读检查（文档链接、编号门禁、BOM 漂移、乱码、
git diff --check）。
风险与回滚：纯文档改动，不涉及构建与真机；单提交可逆（git revert），无需数据迁移。
 2026-10-28 08:14:48 +08:00
wandering1 a583c36a88 docs(门禁说明): 补充 nested-comment 的触发面口径 
本次只改一处中文 Markdown，未触碰 C 源码、头文件与 Keil 工程档案。
因此不跑 @build；提交门禁按文档口径只跑 doc-links 与 pre-commit 命中的钩子。
只暂存这一个 Markdown 文件，让 51 个钩子按 files 与 types 只命中文档相关那几根。
工作区另有两份文档的在飞改动与两份未跟踪脚本，一律不纳入本次提交。
提交正文由 UTF-8 无 BOM 文件承载，经 git commit -F 传入仓库，不走 -m 参数。
原因是 Windows 终端代码页会对命令行参数转码，中文可能变成不可逆的乱码。
正文按每行不超过 80 字符书写（.gitlint 口径），标题不超过 100 字符，中间空行。
正文行不以 # 开头，否则会被默认的注释清理规则删掉；行尾统一 LF 且无尾随空格。
Markdown 改动用精确子串替换落盘，保留文件原有 BOM 状态与行尾，不整文件重写。
落库前后都按字节统计 EF BF BD，结果必须为 0，不信终端与编辑器的渲染结果。
 2026-10-28 08:05:21 +08:00
wandering1 97049a4bf0 docs(plan): 采集链与上送链台架联调分工 
新增 docs/任务规划/分工说明-20261028-采集链与上送链联调.md（45 行）：
只分工不改行为。A 线走采集链 L1→L2→L2.5，B 线走上送链 L2.5→104/UI，
两条线各自验收后合并，不交叉编辑对方文件。

- A 线交付：App/algo/README.md 补「快照时序」一节；adc_input 主机单测
  增帧序号回绕与双缓冲半帧两个用例；ADC采样节拍说明 §5 按实测节拍回填。
- B 线交付：meas 双区快照的单写者与多读者一致性说明；ui_data 补陈旧
  代次（generation）用例；新增 .c 时双端注册 Keil 工程与 CMakeLists。
- 禁区写进正文：CODE-RULE-20 禁 C 库堆分配、V0.1 禁跨转换器做相位与
  功率运算、layer-deps 不许 BSP 反依赖 App、UI 源文件带 BOM 须原样补回。
- 验收表：台架一次烧录须 -Rst -Run 并回读校验（No difference found），
  串口日志不得出现 [ERR]——四个 Fault 的崩溃日志都以它开头。

随笔修一处：正文第 31 行举例引用的 §4.2 在目标文档里已不存在，改指现有
小节 §10.1，否则 doc-links 门禁拦提交（编码 BOM、LF 与乱码均无变化）。
本笔只动这一份文档，代码与门禁配置零改动；上一笔 94b0d790 的页面接线与
任务卡号清退不在本笔内，其未做的六页真机判据已登记在登记簿 §7。
另记一笔待办：文中写的 MDK-ARM/STM32F4-Base.uvprojx 与实际工程文件名
（STM32F407-Demo.uvprojx）不符，留给该线负责人校正，本笔不代改。
 2026-10-28 07:30:05 +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 8f7c141a0b docs(data-trust): 卡 0 注入验证闭环——标 ✅ 保留行，不按"完成即删" 
卡 0（已知电压注入验证）2026-10-27 台架六项判据全 PASS，但**不删行**。
`数据可信.md` 卷首明文规定：卡 0 被 `App/task/adc_task.c` 的 v3.3 修订行与
`adc:` 行注释引用为口径出处（"「数据可信」卡 0 注入验证的唯一连续读出口"），
删行会让代码头注释失去出处——这是"完成即删"在该文件的既定例外。

- 状态图例新增 ✅ 已闭环，限定"仅限被代码头注释指称的卡，保留行不删"；
  §5 标题同步注明例外。
- 卷首"只剩三项"改为"只剩两项"（0b / 12），并说明卡 0 为何保留。
- §5 表：卡 0 状态 ⬜ → ✅；表下补"闭环结论"块（零点 0~5 码、R²=0.9999997、
  斜率 6544.2 码/V 偏差 −0.14 %、映射一一对应、极性对称性 ≤0.34 %、
  frames 1000 Hz），并记两项残差（最小二乘残差与 IB 零点贴上限）。
- §3 M4 行：① 已达成（原"① 与 ⑤ 待卡 0"），只剩 ⑤ 的台架面待卡 12。
- §2.6 首帧 ~1000 码的疑问结案：实测零点 0~5 码，首帧是上电瞬态，
  且 TPAFE ~11450 / STM32 ~1000 是两个转换器各自的零位。
- §6 顺序图与斜率规则：卡 0 标 ✅；补记实测偏差 −0.14 % 未触发规则，
  并说明该规则此次的真实价值是反向排除 2:1 分压（若分压斜率会掉到 ~3277）。
- §7 已定案：注入点修正为**串联电阻子板侧（`AINn` / `U5` 排针，③ 段的端子侧）**，
  原"在 ADC 引脚侧"作废——`U5` 排针才是可安全接触的最低一级。
- §8 风险表：ROM 默认系数风险解除（理论 LSB 被实测支持），
  加压烧板行改为"卡 0 已按 ≤2 V 执行完毕，端子级额定值仍须等 0b"。
- `ADC前端注入验证流程.md` §5.6 第 3 条：把"删行不留记录"改为记录实际处置。
 2026-10-27 21:35:46 +08:00
wandering1 87615b2e99 docs(adc): 补节奏判据（注入前后 1000 Hz），删步骤 3 并重排编号 
节奏：注入前（20:58 开机）与注入后（21:29）各取两行相隔 10 s 的
frames= 心跳，两边都是 Δ9998 码 / 约 10.0 s ≈ 1000.1 Hz，
idle=0、adc1_rc=0、adc1_err=0。卡 0 判据 5 的口径正是「注入前后」
帧计数仍严格 1000 Hz，故达标。adc1_gap/tgap/skip 为开机以来累计值，
10 s 内只增 3/2/1（约 0.03 %），属正常漏检量级。

至此六项判据全部 PASS：零点、线性、斜率、映射、极性、节奏。

删除 §5.4 步骤 3（逐通道映射）：步骤 1 零点本身就是逐路独立激励，
短接哪路就看那路塌不塌，与「注入哪路只动哪路」是同一件事，重复做
没有增量信息。删除的唯一代价（原方案还含「其余七路仍在零点附近」
的串扰检查，而步骤 1 时其余七路浮空且本身在漂）已压进第 6 节判据表
的「映射」行括注，不单独占一节。

重排编号：5.5→5.4、5.6→5.5、5.7→5.6；步骤名同步 步骤4→3、5→4、
6→5，使「§5.N = 步骤 N-1」的对应关系恢复；第 4 节读数出口表里
「步骤 5 的节奏判据」同步改为「步骤 4」。全仓无其它文档引用本文
步骤号（已 grep 确认）。
 2026-10-27 21:30:38 +08:00
wandering1 6b72b7c64f docs(adc): 前端注入验证实测结果——零点/线性/斜率/映射/极性五项 PASS 
2026-10-27 台架首次完成直流注入验证，结果全部达标：

零点（8 路短接 AGND）：0~5 码，折算 TPAFE ≤4.6 mV、STM32 ≤4.0 mV，
远小于零点补偿上限 ADC_CAL_B_MAX(8192)。IB 最贴边（2~5 码，上限 5），
余量最小，日后若变大先查 R49 / AIN9 那侧。

三点线性（UA，TPAFE）：0.300/1.001/2.004 V 对应 1954/6547/13106 码。
最小二乘 R² = 0.9999997，斜率 6544.2 码/V（期望 6553.6，偏差 -0.14 %），
截距 -7.2 码（约 -1.1 mV）。残差 -2.0/+3.5/-1.4 码，无系统性弯曲。
这是「③ 段变比 = 1:1」在台架上的第一次直接证据。

极性（TPAFE 三路）：-1.0 V 点 -6566/-6568/-6566，相对 -6554 偏
0.18~0.21 %；对称性偏差 0.27~0.34 %（判据 2 %）。补码符号位解释正确。

逐通道映射：原 5.4 步骤 3 已并入步骤 1，不再单独执行——步骤 1 本身就是
逐路独立激励，与「注入哪路只动哪路」是同一件事。已记录唯一代价：串扰
未单独证（步骤 1 时其余七路浮空且本身在漂，小幅串扰看不出来），
日后若怀疑串扰再恢复本节。

步骤 5 节奏本轮未取数（现场只读了 adc: 行，没记 frames=），记「待补」，
不算 PASS。故 docs/任务规划/数据可信.md 卡 0 判据 5 仍未闭环，本次
不销项。

另：6 判据汇总表新增「2026-10-27 实测」列与「总体结论」段。
 2026-10-27 21:26:21 +08:00
wandering1 03721aafc4 docs: 新增 ADC 采样陷阱台账（TRAP-ADC-01/02） 
把 2026-10-27 排查出的两个 ADC 采样陷阱沉淀成正式台账，按
docs/编号规范.md 的 TRAP-ADC-<nn> 编号，属主文档
docs/问题记录/ADC_Trap_Records.md。

TRAP-ADC-01：ADC 使能后闲置数秒才挂 DMA，导致 DMA 乒乓缓冲整体
+2 格相位旋转（槽 i 装的是 rank ((i+1) mod 9)+1）。全程无任何
编译或运行错误，只是数据整体错位两格，表象与「映射表写错」完全
一致，历史上据此误判过三轮。

条目重点记了那条判读陷阱：adcr[CH_i] == adcb[i] 成立不能证明通道
映射正确——它只证明拷贝循环是恒等映射，缓冲整体旋转时拷贝照样
恒等。判映射只能靠按通道号索引的独立真值（无 DMA 单通道读）。
附 9 行同开机对照证据表、5 种固件形态的 A/B 对照、修复方式、
回归判据与未证部分（微架构为何恰好丢 2 拍仍未证）。

TRAP-ADC-02：RTOS 运行期校准被 TIM3 TRGO 打断，adc1_calibrate()
返回 0xFFFF 超时哨兵。记了指纹判读要点（truth=65535 且 min 大于
max 是哨兵，不是满量程）与修法（校准期间屏蔽 EXTEN）。

关联登记三处：
- docs/README.md 7.3 问题记录表新增一行
- 设计文档 4.5 节加反向链接到 TRAP-ADC-01（代码 -> 设计 -> 台账）
- scripts/id_registry.json 的 TRAP 族 cursor_note 补 ADC 域 01~02

纯文档改动，不涉构建。
 2026-10-27 20:55:04 +08:00
wandering1 859be6975c docs(adc): TPAFE 零点判据由 ≤10 放宽到 ≤30 码，并附实测依据 
首次实测（2026-10-27）TPAFE 三路短接 AGND 后残差 UA -14 / UN -15 /
IA -13 码，约 2 mV，已超出原判据 <=10 码（约 1.5 mV）。

原 <=10 是定判据时按经验拍的，没有实测依据，比实测噪声还紧，
按它判必然失败。按 16 位 / 10 V 跨度算，2 mV 只有 0.02% FS，
属正常零点残余，故 TPAFE 档放宽到 <=30 码（约 4.6 mV）。

保留兜底：残差若继续增大（>30 码）说明前端确有真实失调
（R32 侧接地断、TPAFE 失调），那时必须回前端查，不得再放宽。
STM32 档 <=5 码不变（其短接列尚未取得可归属的实测值）。

同步四处：
- 测试说明/ADC前端注入验证流程.md 第 4 节判据说明（写明放宽理由
  与不可再放宽的边界）
- 同文档 5.2 节记录表 UA / UN / IA 三行判据列
- 同文档第 6 节判据汇总
- 任务规划/数据可信.md 卡 0 判据 3

固件里没有硬编码该判据（ADC_CAL_B_MAX=8192 是标定接受上限，无关），
故本次只改文档，不涉构建。
 2026-10-27 20:49:23 +08:00
wandering1 1166ab1c2e fix(adc): 挂 DMA 前关闭 ADC，消除乒乓缓冲 +2 格相位旋转 
问题：ADC1 在 MX_ADC1_Init() 里使能，而 DMA 在 app_main_init() 步骤
4b 才挂载，中间隔着 GD5F 全片 BBT 扫描（数秒）。台架同一次开机内用
无 DMA 单通道逐路取真值、与 DMA 路径对照，得 9/9 完美置换：乒乓缓冲
从 rank 3 开始搬，槽 i 装的是 rank ((i+1) mod 9)+1，整体错开 2 格。
表象是"接地 AIN2、UB 却读到别的通道的值"，极易误判为映射表写错或
注入点标签不对。

修法：新增 adc1_disable()（Src/adc.c 的 USER CODE BEGIN 1），在
app_main_init() 步骤 4b-pre 调用，把 ADC 置为关闭态，使能动作交给
HAL_ADC_Start_DMA() 内部完成（它自己 __HAL_ADC_ENABLE + 等 Tstab
约 20 us，紧接着开 CR2.DMA 并启流），使能与搬运之间不留可观测间隔。
顺序不可调换：本调用必须严格早于 adc_input_init()。

台架验证：在 MX_ADC1_Init() 末尾关闭 4/4 次、在 4b-pre 调本 API
3/3 次，均 UB=0；同开机对照差值 <=4 码（修前 7/7 次 UB=783~786）。

文档：ADC采样节拍设计说明.md 新增 4.5 节（9 行证据表、判据陷阱、
根因与修法）与设计铁律第 8 条。

台账：Flash 261,764 -> 261,928 B（+164，新增函数），RAM 无变化；
CubeMX 存活审计基线重建（adc1-calibration-impl / adc1-dma-link
两项漂移均属本次有意改动，锚点已逐条复核在位）。
 2026-10-27 20:42:06 +08:00
wandering1 e6d3e5a1be docs: 零点步骤补「rail 位图判短接是否到位」 
只看某一瞬间的 adc: 行判断不了短接是否真的接触上——探针虚接时读数
停在半路，看起来像"接了地却没塌"。cal: 行末尾的 rail 是本次开机以来
"连续 20 ms 贴码值轨"的锁存位图，虚接锁存不上，才是权威判据。

2026-10-27 实测就靠它分清：UB/IB/IC 短接成功（rail=0x062），而 IN
从没到过地（bit7 缺席，读数稳定停在 610 码）。
 2026-10-27 18:50:47 +08:00
wandering1 105422cfef docs: 零点记录表增「端子侧节点」列 
表里只有通道名，现场还得翻回 §3 才知道要短哪个焊盘。把端子侧节点
（`AINn` + U5 脚位）并进记录表，一行内齐活。

节点值逐字取自 §3 注入点清单，8 路已交叉校验一致；同时说明该列就是
本步要短接的焊盘，别按通道名猜位置。
 2026-10-27 18:35:05 +08:00
wandering1 69d70af4cf docs: 零点记录表改为与 adc 日志同序，补实测数据 
台架首次实测暴露一处抄数陷阱：adc: 日志列序是 UA UB UC UN IA
IB IC IN，而记录表按语义分组排成 UA UN IA / UB UC IB IC IN。
照日志从左往右抄进表格从上往下，UN/IA 就填成了 STM32 的 ~1000、
UB/UC 填成了 TPAFE 的 ~11450 —— 而 UN/IA 属 TPAFE、UB/UC 属
STM32，这两个量级在物理上不可能，看起来像"数据全错"。

- 记录表行序改为与 adc: 日志完全一致，并加"转换器"列，量级对不上
  时一眼能看出来
- 表前加警示，把这次踩坑的经过写成具体例子（不写"注意顺序"这种
  空话，写清错在哪、错成什么样）
- 补"怎么抄短接后的数"：只抄该路那一列，别贴整行；塌到 0 的不是
  你以为那一路，属映射问题转 §5.4，不是零点问题
- 补一句"短接后读到 0 是短接到位，不是取数失败"
- 记 2026-10-27 首次实测空载值（按日志列序归位）：UA 11429 /
  UB 1044 / UC 954 / UN 11453 / IA 11451 / IB 1040 / IC 1062 /
  IN 980，与 18:04 烧录后开机日志一致

§8 已知坑按属主决定删除，不再保留。
 2026-10-27 18:33:18 +08:00
wandering1 00f9958cbb docs: ADC 注入流程记录表并入各步，删 §9 与变更记录 
原来"§5 步骤"只给判据、表格集中在 §9，台架现场要来回翻页；
现在每步末尾就是该步的填表处，边做边填。

- §5.2 零点：参考表与记录表合成一张，8 路逐行留空
- §5.3 三点线性：目标/实测/码值/反算 + 两片转换器期望码同表
- §5.4 逐通道映射：8 行，含"是否符合预期"列
- §5.5 极性：三路 × 正负两点 + 对称性偏差
- 删 §9「记录表」整节与「变更记录」小节，章节回到 1~8
- §4 与 §5.4 里指向 §9 / 附录表的引用改为"本节记录表"
- docs/README.md 目录描述同步为"每步自带现场记录表"

变更记录虽按 docs/文档规范.md 表格属"建议"保留项，但本文是台架
作业指导书，历史沿革查 git log 即可，正文只留当前有效动作。
 2026-10-27 17:57:11 +08:00
wandering1 2b4c0e97c2 docs: ADC 注入流程 §4 补码值刻度图 
§4 的「码」定义表只有文字与数字，台架现场容易把 TPAFE 的
152.59 µV 与 STM32 的 805.66 µV 混着用。新增一张刻度尺对照
图（docs/images/ADC码值刻度.svg），上下两把尺子分别标出
11430 码 ≈ 1.744 V 与 1000 码 ≈ 0.806 V，把"同一整数在两片
转换器上代表不同电压"变成可见的；正文补一句两把尺子差 5.3
倍、§9 每格必须写明所属通道。

生成器 tools/arch_diagram/gen_adc_code_scale_svg.py 沿用图形绘制
流程 §3.2 约定（纯标准库 / html.escape / newline="\n" /
ElementTree 自检 + 文字溢出预检）；码制与 LSB 数据集中在
PANELS 常量，换芯片才重画。已登记到 tools/arch_diagram/README.md
与 docs/架构设计/图形绘制流程.md 的生成器表 + 变更记录。

目检用无头 Chrome 截图完成（cairosvg 未装，截图不入库）。
 2026-10-27 17:25:51 +08:00
wandering1 e50d2b5cf0 docs(adc): §4 补「码」的定义与两片转换器的刻度对照 
用户反馈"码这个单位第一次见"。补一张刻度对照表：
- TPAFE5160 16 位双极性，−32768~+32767，1 码 152.59 µV
- STM32 ADC1 12 位单极性，0~4095，1 码 805.66 µV

带换算示例（11430 码 ≈ 1.744 V，与 cal: 行 1743 mV 自洽），
并写明本文为何一律用码：固件打印的就是码，且把码换成伏正是本次
要验证的事，先换算等于默认了未验证的系数。
 2026-10-27 17:19:13 +08:00
wandering1 c92d503851 docs(adc): 修 §5.2 表格渲染，讲清零点这步怎么填 
原表单元格里写了未转义的竖线（绝对值符号），被 GFM 当成列分隔符，
整张表渲染成乱码，看不出要填什么。§6 判据汇总同病同修。

同时把这一步的操作讲清楚：
- §5.2 补"做什么"四步：断电短接 → 上电读 adc: → 抄进 §9.1 → 断电换下一路
- 明确本节只给判据，要填的表在 §9.1（原表看着像表单，实际是参考值）
- §9.1 记录表加"空载码值（浮空）"列与填法说明，让空载与短接两个数都留痕

表格列数已用脚本复检三份相关文档，全部对齐。
 2026-10-27 17:17:03 +08:00
wandering1 dc9ae01f50 docs(adc): 更正步骤 0 判据——端子对 AGND 不是 1 kΩ 
原判据写"端子侧应量到 1 kΩ 量级（串阻 + 转换器输入阻抗并联）"，两处错：

1. 端子到 AGND 是串联通路：R31(1k) → AIN_7P → 芯片内部 1 MΩ →
   AIN_7GND → R32(1k) → AGND，合计约 1.002 MΩ。1 kΩ 只在串阻两端成立。
2. 芯片输入阻抗是 1 MΩ 恒定（TPAFE5160 手册 "Analog Input
   Impedance" 节），量级上与 1 kΩ 并联不出 1 kΩ。

改为三行分测表：串阻两端 ≈1 kΩ / TPAFE 侧对 AGND ≈1 MΩ /
STM32 侧对 AGND 高阻不定量。并写明本步只排除短路、不验收正确性。

顺带把手册的匹配要求写进去：AIN_nP 与 AIN_nGND 两侧外接源阻抗
要相等以抵消失调误差，R31 / R32 各 1 kΩ 即为此——这就是 R32 的
存在理由（匹配，不是分压），补强"本板无分压"的结论。

ADC通道映射说明.md §7「前端偏置」行同步补 1 MΩ 与匹配依据。
 2026-10-27 17:12:54 +08:00