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

881 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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 b79ae0abfc chore(台账): docfix 合并后回填体积同码凭证 
合并提交 1b5b2f6b 让主干源码索引变了码，`/keil-build` 实测 0 错 0 警、
Program Size 逐项未变（Code=246720 RO=29836 RW=2052 ZI=149708，
RW_IRAM1 94,336 B / RW_CCM 57,376 B）——这笔合入只碰注释与文档，
体积数字与合并前一致，故只重写凭证、不新增趋势行。

- 工具：`task_worktree.py postmerge`（短链 `ram_baseline.py --update`）
- 复检：`check_size_gate.py --local` 绿（同码 ✓ 受管区 ≤92% ✓）
- 顺带：`check_doc_links.py --all` 全库绿（218 文档 / 3058 处章节引用 /
  机器可判定 81% / 失效 0）
 2026-10-30 14:26:47 +08:00
wandering1 1b5b2f6b7e merge: task/docfix-doc-truth-sync 合入 v2-on-ui 
任务 docfix（1 个提交）经 task-worktree 回收：
- docs(真值): 勘查 13 条文档/代码不一致全部处置（10 改 3 核实）+ 补 3 处
 2026-10-30 14:22:07 +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 8d8ecd9c56 chore(台账): archsplit 合并后回填体积同码凭证 
done 的门禁跑在 @build 之前（已知时序坑）：合并落主干 3cce00a7
后 postmerge 重写凭证——build 0 错 0 警（Code=246,720 B /
RW_IRAM1 72.0% / RW_CCM 87.9%），索引指纹 b3a7b7fb 同码凭证
scripts/size_attestation.json 与趋势行 scripts/ram_baseline.tsv。
doc-links --all 218 文档 0 问题；受管区一致。
 2026-10-30 13:37:33 +08:00
wandering1 3cce00a7cb merge: task/archsplit-sw-hw 合入 v2-on-ui 
任务 archsplit（2 个提交）经 task-worktree 回收：
- Merge branch 'v2-on-ui' into task/archsplit-sw-hw
- docs(架构设计): 系统架构与硬件规格拆为软件与硬件两档，软硬件分治
 2026-10-30 13:33:11 +08:00
wandering1 aed842e1f2 Merge branch 'v2-on-ui' into task/archsplit-sw-hw 
# Conflicts:
#	docs/架构设计/软件架构与运行时规格.md
 2026-10-30 13:32:52 +08:00
wandering1 00fe66a029 docs(架构设计): 系统架构与硬件规格拆为软件与硬件两档，软硬件分治 
用户裁定（2026-10-30）：合档拆成两部分，软件与硬件不混排。

- 软件侧（新 §1~§6）= 分层 / 任务模型 / 就绪位表 / 启动时序 / 线程通信 /
  工具链与工程约束 → docs/架构设计/软件架构与运行时规格.md
- 硬件侧（新 §1~§5）= 主控内存 / V0.1 引脚表 / 存储器件 / 版本兼容 /
  能力边界 H1~H5 与量纲口径 → docs/架构设计/硬件规格与能力边界.md
- 旧 2.1 的 RTOS / 工具链 / CubeMX 三行迁入软件档 §6.1；旧 2.5 五条工程
  约束归软件档 §6.2，SDIO 一条归硬件档 §5 H5（同事实不再两处并存）。
- 存储器件小节的 BBT / 单写者 / FatFs 三条细则不与权威档重复，改为指向
  存储架构说明与软件档 §2。
- 引用重挂：AGENTS 引脚行→硬件档 §2；docs/README 3 处；需求档 7 处
  （「架构硬件档」别名一分为二「软件架构档 / 硬件规格档」）；复刻明细
  2 处；section_aliases.json 两键改四键。
- 两档尾部各留裸号换算注（旧档号不带 §，避免与本文编号体系混淆、且
  doc-links 自引用 strict 必拦）；旧档名全仓零引用。

门禁：树内 check_doc_links --all --sections-strict 剩 35 处全部为
simulator/SDL2 联接「名称含空格」假红（主树同命令 rc=0 干净），本笔
文件新发 0；mermaid 预检新发 0；七文件 BOM/CR/U+FFFD 全零。
 2026-10-30 13:08:44 +08:00
wandering1 4a4ad6bc5f chore(全仓): @build/@test 旧文档别名清退为技能调用名 
现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名，
不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体
run_boot_test.py 的真实调用。

- AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改
  「编译（/keil-build）」「串口回归（/serial-boot-test）」
- keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree
  方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围）
- 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入
  等 41 行历史证据保留旧名
- gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑
- 顺手补并行方案同行漏网计数 51→52 钩子

验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all
rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52
钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。
 2026-10-30 13:03:12 +08:00
wandering1 dc964090ea docs(产品需求): 需求基线拆薄为三档（大厂标准），doc-links 增别名解析 
产品需求设计文档.md v1.9 → v2.0（2691 → 1816 行）：
- 新增 §2 背景·目标用户·典型场景·成功指标，§3.2 产品级非目标表，
  §4 P0/P1/P2 需求总览（19 行）；§9 收窄为缺口清单与推进顺序。
- 拆出 docs/产品需求/参考产品复刻明细.md（803 行）：复刻基线 +
  定值/遥测/开入开出/事件/元件/录波/记录/规约逐项差额与完成判据。
- 拆出 docs/架构设计/系统架构与硬件规格.md（215 行）：运行时架构
  （就绪位表/机制表/启动时序）+ V0.1 硬件规格；与项目架构总览
  定分工——位表/机制表/时序图/引脚表以新档为准。

引用同步：AGENTS.md 引脚表指针改指系统架构与硬件规格 §2.2；
docs/README.md 目录树与索引四处重写；故障录波三处「录波采样率」
行指针改指复刻明细 §7；PRD §11 补两新档指针。

门禁工具：check_doc_links.py 裸名解析增别名后缀匹配（「见需求档
§5.16」形态），§ 链遇紧邻已登记别名换目标；section_aliases.json
登记 需求档 / 架构硬件档 / 复刻明细(档) / 产品需求设计文档 /
系统架构与硬件规格。

终验：doc --all rc=0（3038 处 / 可判定 80%）；mermaid --all 64 围栏
0 命中；改动文件字节卫生全过；新旧逐行差集审计无丢行。
 2026-10-30 12:36:31 +08:00
wandering1 6ffbb7d5b5 docs(测试说明): 交流动态验证轮次加四张导读图（两 SVG 生成器 + 两 Mermaid） 
§8 开头插「六轮速查卡」：3x2 面板，每轮注入信号缩略图数据驱动
（正弦 / 同峰值方波三角 / UA·UN 异相 / 扫频 / 负半周钉 0 / 谐波叠
加），一卡给接法、判据一句话、主读数出口，先立轮廓再进执行卡。

§8.5 插「为什么连取 10 行取中位数」概念图：左栏机理（定宽 20 拍
窗逐窗滑动 → 读数拍频跳），右栏操作（中位数 / 平均 / 真值三线
错位对照 + 毛刺行标注）——取数口径 4e4d597e 刚定，此图补原理。

§8.3 / §8.5 各加一张 Mermaid：接线拓扑（端接高阻、万用表并接、
单点共地、STM32 五路仅削顶轮支线）；单轮执行主干（采集链与偏差
两级决策、分诊虚线回环，汇于关输出填表）。

新增生成器 gen_ac_rounds_svg.py / gen_ac_median_svg.py（纯标准库、
OVERFLOW 预检归零、generated-fresh 自动在册），README 补两行台账。

验证：两产物连跑两次 sha1 不变；check_generated_fresh rc=0 无
DIFF / NEW、漂移基线不增；mermaid-syntax 2 围栏新发 0；headless
Chrome 截图回读三轮，修掉两类只有渲染才暴露的真错（正文 x 在卡
循环外算导致第 2、3 列叠进第 1 列；三角波闭式值域 −2..4 画越界
尖峰）。六文件 BOM / CR / U+FFFD 均零。

注：当前 check_doc_links --all 报 27 处，全属并发会话在改的产品
需求三份文档，与本笔无关、未触碰。
 2026-10-30 12:21:02 +08:00
wandering1 4e4d597ed6 docs(测试说明): ADC 注入流程「取中枢」改为平实的中位数口径 
「记录表（每条 10 行取中枢）」的「中枢」全文无定义、两处均易读岔，
按平实语言口径改写：

- §8.5 通用动作：「必须看一片才能定中枢」改为「必须看一片取中间水平
  （中位数）才能定数」
- 幅值轮记录表引言展开为可执行填法：记录表每一行 = 连续 10 行心跳
  ua_mv 排序后第 5、6 个的平均；不取单行、不取峰值（单行带拍频跳动，
  毛刺行会拖偏算术平均）；并点明表里「序号」是一次重测
- 机制注已在原文（meas 为瞬时基波有效值透传、200 ms 是节拍非平均窗，
  数据可信 §4.5），本次只换措辞不动判据

验证：check_doc_links --all --sections-strict 通过；scripts/ci_local.py
全绿；文件无 BOM / 无 CR / 无 U+FFFD；全仓「中枢」复扫残留 0。
 2026-10-30 11:45:33 +08:00
wandering1 314ebd2cfe docs(屏板链路): 删除日志口联动的历史冲突描述行 
- 屏板链路设计说明 §2 删「日志口联动」整行：现时态写成「共用 DR 会
  互相插字节」的历史归因会误导新读者（现状两条流早已分家）
- 产品需求 §9.14 第三批行同步去掉同族机理括注，保留「第 16 条排在
  10 之前：日志先腾出 USART1，屏板链路才能独占」的约束本身
- 端口归属现状另两档已有专述：产品需求 §4.2 表、控制台单写者日志
  设计说明 §11；历史细节走 git log
 2026-10-30 11:08:08 +08:00
wandering1 aa2b15d306 docs(测试说明): ADC 注入流程 5.1 标题改直白 
「断电核阻」压缩过度不好读，改为「断电，用万用表电阻档核对」。
全仓 grep 旧词零残留；纯标题行改动，不动章节编号与正文。
 2026-10-30 11:04:15 +08:00
wandering1 f8e62a9ba2 feat(门禁): 新增 mermaid-syntax 钩子，围栏内确定性语法提交前必拦 
- scripts/check_mermaid.py（纯标准库）：R0 围栏未闭合 / R1 图类型头缺
  错 / R2 -. 后直接跟管道（确定性语法错误形态）/ R3 subgraph 与
  sequence 块的 end 计数配对；--all / --selftest（5 形态）/ --prune；
  排除面与 doc-links 同口径；零语料空基线
- 接线 .pre-commit-config.yaml（doc-links 后），docs/门禁说明/
  mermaid-syntax.md 专篇（八段结构含限制与盲区），README 索引与
  AGENTS.md 计数 51→52、提交期实跑 48→49
- 门禁说明 README 顺带修正两处历史矛盾：gitlint 实际就在本配置
  （commit-msg 阶段），旧文「52−3−gitlint」与「gitlint 不在配置里」
  均过时——锚定口径 52 = 47 pre-commit + 3 manual + 1 commit-msg，
  加钩后 48 + 1 = 49；三处 grep 争执例句改抽象表述（例句里的数字
  自己会过时）
- docs/子系统设计/屏板链路设计说明.md:38 修复触发本钩子的坏图：
  -. 后直接跟管道不是合法边 operator，改为 -.->|label| 形态

实测：YAML 解析 52 / commit 阶段枚举 48 行全 Passed（含新钩子）/
check_mermaid --all 29 文件 60 块围栏 0 命中 rc=0 /
check_doc_links --all rc=0（215 文档）/ 六文件无 BOM/CR/U+FFFD。
 2026-10-30 11:03:58 +08:00
wandering1 2be49dc9dd docs(skills): 明确 @build/@test/@task 为文档别名并新增 precheck/postmerge 命令
CI / 静态门禁 (pre-commit) (push) Failing after 3m45s
Details
CI / 主机侧单测 (MSVC) (push) Failing after 43s
Details 
AGENTS.md「构建与验证」新增总口径：@build / @test / @task 都是本仓库的
文档别名、不是 shell 命令（2026-10-30 实测：bash 敲 @task / @build 即
command not found，dsh task 被解析成 profile 名报错）；`=` 后的命令行
才是可执行形态，DSH 会话显式调用为 /keil-build、/serial-boot-test、
/task-worktree。

- AGENTS.md / docs/README.md / 并行任务工作树方案.md：@task 三处定义位
  由「短命令」统一改为「文档别名」，并写入两种实测失败形态
- keil-build / serial-boot-test SKILL.md：定义位点破别名性质；@test 在
  skill 内原先没有定义句，补口径 blockquote
- task-worktree SKILL.md 与 reference/：whenToUse、标题、症状表、插件桥
  去 @task 前缀改指 list / 本 skill；frontmatter 能力清单同步
- task_worktree.py 新增 precheck（树内只读自查：BOM 漂移 / CR / U+FFFD、
  docs 逐档门禁、--msgfile 消息 BOM/CRLF/行长/禁词检查，自动补
  ci-artifacts/）与 postmerge（主树体积凭证自动诊断：新鲜跳过、红先短链
  再只读复检裁定是否升全链；check_doc_links --all；列文件不代提交）
- done 快路径打印与门禁拦截提示均指向 postmerge

实测：precheck 对坏消息文件抓到 CRLF、行长 95>80、禁词×3（rc=1）；
postmerge 端到端「凭证同码新鲜→跳链→doc --all 绿（2967 章节引用 /
214 文档）→列 dirty 文件」rc=0；check_skill_size.py 与 py_compile 通过；
frontmatter 改动后 DSH 已用新值真加载过一轮。无 .c/.h 改动，不涉及体积。
 2026-10-30 10:25:05 +08:00
wandering1 a157b443cb chore(台账): keyresp 合并后回填 RAM 台账与体积/覆盖率凭证 
主干 0cabed0b 合入 task/keyresp-ui-key-latency 后按 C5 链补绿：
- @build 0 错 0 警（Code=246720 RW=2052 ZI=149708，与分支树同码）
- check_mem_numbers.py --write + ram_baseline.py --write/--update
- check_test_coverage.py --update-baseline（47/47，line 90.2%）
- add 后重打体积凭证（check_size_gate.py --stamp，同码免涨）
- check_doc_links.py --all 通过（214 文档 / 2966 引用）

RAM 增量归因见台账：本任务自身仅 ui_port.o +12 B 级，
其余为主干批 3 屏板链路累计（前笔 7708f12c 正文已如实说明）。
 2026-10-30 09:56:12 +08:00
wandering1 0cabed0b5c merge: task/keyresp-ui-key-latency 合入 v2-on-ui 
任务 keyresp（1 个提交）经 task-worktree 回收：
- fix(ui/screenlink): 按键应答扣到按键后画面，反馈典型 250-450 ms 降至 70-135 ms
- 延迟应答核心改动 + 注键环 + 两行带重绘 + 模拟器 sleep 扣时；账本见
  docs/子系统设计/屏板链路设计说明.md §7.1
- 台架真机验证紧随本合并（烧录后按键实测 dfok/dfold）
 2026-10-30 09:51:29 +08:00
wandering1 7708f12c10 fix(ui/screenlink): 按键应答扣到按键后画面，反馈典型 250-450 ms 降至 70-135 ms 
按键召唤答的是按键前的旧帧：uiTask 还没消化键答案就发走了，新画面
只能等下一次周期召唤（280 ms/轮）才带得出——真机反馈 250-450 ms 的
主构成（根因账本 docs/子系统设计/屏板链路设计说明.md §7.1）。

改动（用户批准范围 A+B+C；屏板固件未动，决策三不变）：
- sb_link：按键召唤改为只入队不起发；uiTask 同拍重绘并组帧成功后交
  凭据（sb_link_key_rendered），TIM3 1 kHz 的 sb_link_ms_tick 以 ≤1 ms
  放行新帧。140 ms 截止（SB_KEY_RESP_MAX_MS，+59.6 ms 线上 <205 ms
  屏板放弃线）保底发旧帧，"一召一答"契约不破；线忙时同旧丢单、
  不留扣件。起发两中断源（USART1 IDLE/TIM3）共用 sb_tx_kick，
  "判忙→占位"在 PRIMASK 临界区原子完成。
- ui_task：排空注键挪到组帧之前，注键→即派即绘→组帧同拍闭环；
  组帧返回 BSP_OK 才交重绘凭据（BUSY 拍帧还没反映按键）。
- ui_port：注键单槽改 8 深环（连按不再互相覆盖，满丢最旧+计数）；
  新增 ui_port_service_keys：同拍 lv_indev_read + lv_refr_now，
  省掉 indev ≤20 ms + 刷新 ≤20 ms 两段等待。
- ui_menu_view：菜单移动选中只失效新旧两行带（黄金参考零像素变化），
  滚动/异常回退整框失效。
- simulator：窗口循环 sleep 扣除本轮已耗时（原先无条件睡满
  lv_timer_handler 返回值，叠加 Windows Sleep 15.6 ms 粒度放大观感）。
- 串口 TX 上报新增 dfok/dfold（凭据放行新帧数/超时保底旧帧数）：
  dfold 连涨 = uiTask 被饿 ≥140 ms 的直接现场证据。

验证：test/host/sb_link 164/164（新增 18 条：不立刻起发/凭据放行/
140 ms 截止保底/忙时不留扣件/陈旧凭据不放行等边界）；菜单 8 状态 +
内容页 66 张黄金像素 PASS；Keil @build 0 错误 0 警告（两次）；
BOM 99 文件无漂移、代码规范、doc-links 本次文件零问题、cppcheck PASS。
文档：屏板规划文档已被主干收编进设计说明，延迟账本落
docs/子系统设计/屏板链路设计说明.md §7.1，并同步 §4 口径、§8 接口、
§9.1 单测台账 146→164、§10 坑账本补条。

RAM 台账（分支不跑 --write，并行分支提交约定）：本笔盖戳行
RW_IRAM1 94,336 B (72.0%) / RW_CCM 57,376 B (87.9%)，较上一台账行
+4,400 B——为距上次台账构建以来分支累计差（含批 3 状态灯等未盖戳
提交），非全部本笔引入；本次自身增量按对象计为 ui_port.o +12 B
（8 深键环+丢计数+indev 指针）与 sb_link/o 数十字节级。
gate: only mem-budget/mem-numbers pending lead ledger backfill
（合并落主干后 Lead 统一 --write 回填受管区）。
 2026-10-30 09:50:31 +08:00
wandering1 36f6948544 merge: task/rrfix-rename-ref-dir-move 合入 v2-on-ui 
任务 rrfix（1 个提交）经 task-worktree 回收：
- fix(scripts): rename_ref 搬整目录不再改脏目录内部内容，并补齐出链层级
 2026-10-30 09:34:53 +08:00
wandering1 1221676272 fix(scripts): rename_ref 搬整目录不再改脏目录内部内容，并补齐出链层级 
2026-10-30 测试说明分层那次（28 个路径、209 文件）实测踩到两条，都是
「把不该改的东西改脏」，当时的补救全靠事后从 git 里捞原始字节：

B1 整目录搬迁会改写目录内部文件的内容。「相对引用文件所在目录」这条
    解析规则不检验目标是否存在，于是台架日志里不是路径的斜杠片段被当成
    「旧目录下的子路径」并插上目录名：`1/1 PASSED` → `test_data/1/1 PASSED`、
    `13639/32768`、日期占位 `[----/--/-- --:--:--]` 全中招，连有效的
    `see ../a.md` 也被换成指向不存在的 `see td/a.md`。23 个证据文件是
    用 `git show HEAD:<旧路径>` 逐字节还原才救回来的。
B2 目录内部文件指向外部的 `../` 出链不补层级。emit_dir 取的是
    `new_abs.parent`，整目录搬迁时少算一层，`../images/x.svg` 搬深一层后
    仍指旧层级；图片按文档目录相对（§3.2），check_doc_links 看不见 → 静默断链。

改法（尽量小面）：
- resolve_token：按引用文件目录解析时要求目标真存在；根相对写法保持原宽松口径。
- rewrite_text：moved 文件的 emit_dir 改成「本文件搬完实际所在的目录」；
  单文件搬迁走原分支，一字未动。
- 整目录搬迁时目录内部互为相对的引用一律不改（两侧一起搬，改了必错）；
  「旧路径是不是目录」必须在搬迁前记进 old_is_dir_global——--apply 是先
  git mv 再改写，那时旧路径已经不存在了。
- glob 形态改成看得见：搬目录时前缀整体跟着搬（本来就该改）；搬单文件时
  一条 glob 可能同时盖住搬走与没搬走的两批文件，不猜，只点名列出。
  分层那次有 4 处这种引用是静默漏改、事后手改的。

回归：新增 `--selftest`（在一次性临时 git 仓里跑本脚本的副本，`.gitignore`
先排除 /scripts/ 免得脚本自己进扫描面）。案例 A 守整目录搬迁（证据文件
逐字节不变、出链补层、别人文件的入链照改、glob 前缀跟着搬），案例 B 守
单文件搬迁的层级换算与 glob 提示，18 项断言全绿。反向对照也做了：同一
夹具在改前版本上 B1/B2 都复现，所以断言不是凭空写的。

文档同步：docs/文档规范.md §3.6 第 4/5 条从「现存危害」改写成「已修 +
验收判据」，新增第 6 条 glob 提示，并加「改本体必须先跑 --selftest」；
docs/测试说明/README.md 第 3/5 节口径同步；scripts/README.md 补 --selftest
与任务树 --no-verify 的用法行。顺带修掉分层那笔里我写错的日期：
2026-11-01 → 2026-10-30（文档规范 4 处、测试说明 README 2 处，真值就是今天）。

树内验证：AST OK；--selftest PASS；改动的 3 个 .md 单文件
check_doc_links --sections-strict RC=0（36 处章节引用、可判定 34、无法判定 0）；
字节体检干净。未跑 @build（无 .c/.h 改动）。
 2026-10-30 09:34:21 +08:00
wandering1 44596f1487 ci(体积凭证): 屏板链路合并后同码凭证更新（@build 0/0 后回填） 
主干合并 add61ca2→899e4a6b 后代码 blob 指纹变化（仅注释与文档改动，
Code=246,160 B / RW_IRAM1=94,312 B (72.0%) / RW_CCM=57,376 B (87.9%) 均无增量）。
 2026-10-30 09:30:07 +08:00
wandering1 899e4a6bdf merge: task/screenlink-plan-to-design 合入 v2-on-ui 
任务 screenlink（2 个提交）经 task-worktree 回收：
- Merge branch 'v2-on-ui' into task/screenlink-plan-to-design
- docs(屏板链路): 规划文档收编为设计说明事实源，全仓引用与端口口径同步
 2026-10-30 09:25:49 +08:00
wandering1 add61ca2af Merge branch 'v2-on-ui' into task/screenlink-plan-to-design 
# Conflicts:
#	docs/子系统设计/控制台单写者日志设计说明.md
 2026-10-30 09:25:35 +08:00
wandering1 8744c833e5 docs(屏板链路): 规划文档收编为设计说明事实源，全仓引用与端口口径同步 
- 重写 docs/子系统设计/屏板链路设计说明.md：链路角色、串口与端口配置、
  物理接线、协议实现口径、键值与状态灯映射、资源与耗时、对外接口、
  已验证/未闭环、坑账本——只写现状事实，演进过程查 git 历史
- 删除 docs/任务规划/屏板链路.md（内容已全部沉淀进上述设计说明，
  登记簿「完成即销项」；docs/任务规划/README.md 相应两行一并移除）
- 代码与主机侧测试的文档指针改指设计说明对应章节：
  sb_link.h/.c、sb_proto.h/.c、sb_led_map.h、console_log.c、ui_task.c、
  test/host 的 sb_link/sb_proto/sb_led_map 三套与两个台架脚本
- docs/README.md：设计文档索引行与设计说明描述更新，任务规划目录 7→6 文件
- docs/产品需求/产品需求设计文档.md：串口通道现状口径同步——第 11/12/13 条
  已交付（4208 B 应答/状态灯掩码/键上行/双出口并发）、LOGO 下发出局不实现、
  帧长实测固化、调试日志口 UART5/RS232#1（§4.2/§5.16/§6.6/§9.12/§9.13）
- docs/子系统设计/控制台单写者日志设计说明.md v1.8：全文端口口径由
  USART1 同步为 UART5/RS232#1（CON_UART* 单点宏），ORE 机理标注跨端口
  同因，时间线补端口迁移行；头部修订指针改为实际章节名

说明：本任务经用户显式授权在任务树内编辑 docs/任务规划/ 与产品需求基线
（铁律「单写者」豁免一次）；主树合并后统一跑全量 check_doc_links --all。
 2026-10-30 09:22:44 +08:00
wandering1 2b478588a7 docs(task-worktree skill): 补「只改注释也刷红体积同码凭证」实测坑 
done testdoc 撞上的一次新型红：size-gate 的判据是索引 blob 指纹，不是体积数字。
全库路径同步顺带改了 20 个 .c/.h 的注释，Program Size 逐项没变，凭证照样报
「不同码」。处置比 C 节补绿链短：合并后 done 自己那次 @build 已 0 错 0 警，
只需 ram_baseline.py --update 重写 scripts/size_attestation.json，
不 --write 动内存受管快照（数字没变就去改受管区＝给别的在飞分支造冲突面）。

连带登记第二个坑：done 在「分支已合入」的路径上于门禁之前就 return，
补完凭证重跑不会替你复绿，落主干后的全量证据要自己跑 ci_local.py
（实测 47 runner / 3896 断言全绿）与主树 check_doc_links.py --all
（实测 215 个文档 / 2993 处章节引用 rc=0）。

只加 reference/pitfalls.md 一条，SKILL.md 正文一字未动（受插件写侧
65536 字节上限，深规程一律进 reference/）。
 2026-10-30 09:14:49 +08:00
wandering1 8f5ac7f5d0 chore(台账): 合并后刷新体积同码凭证（代码内容变了、体积未变） 
done testdoc 的门禁跑在 @build 之前：这笔合并把 20 个 .c/.h 的注释与文档
路径一起改了，索引指纹由 1ed4267c77f6 变成 172c6c78b8fb，而凭证仍记着
01:15 的那次测量，size-gate 因此报「不同码」。合并后 done 自己跑的 @build
是 0 错 0 警，Program Size 与合并前逐项相同
（Code=246160 RO-data=29816 RW-data=2036 ZI-data=149700），
数字没动，只按脚本自己的提示跑 ram_baseline.py --update 重写凭证。

复验：check_size_gate.py --local rc=0（同码 ✓ 受管区 ≤92% ✓）；
主树全库 check_doc_links.py --all rc=0（215 个文档 / 2993 处章节引用）。
 2026-10-30 07:22:20 +08:00
wandering1 7feceb803d merge: task/testdoc-test-docs-layering 合入 v2-on-ui 
任务 testdoc（1 个提交）经 task-worktree 回收：
- docs(测试说明): 按用途分六个子目录并同步全库引用
 2026-10-30 07:17:20 +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 fea4cc7502 docs(架构): 项目架构总览全局更新——同步录波/SOE/屏板并订正串口归属 
v1.1（2026-10-14）之后主干前进 59 笔，本总览积累系统性偏差，通读全文后
全局更新（含配图生成器数据同步）：

- 串口三分定态：USART1=屏板链路 700 kbaud、UART4=RS-485（B2 未接线）、
  UART5=控制台日志 115200（console_log CON_UART=huart5 实证；
  旧文把 USART1 标成调试口是屏板批 0 迁移前的口径）
- 采集主线补齐：adc_cal 标定折算、meas 200ms 遥测快照（adcTask 唯一
  发布者，104 与 UI 共用同一份上游）、录波环三任务交接（adcTask 写入
  冻结 / defaultTask 游标落 /wave / uiTask 单通道回放 / FTP 取回）
- SOE 事件记录链路入图：protectTask 动作/复归边沿投递（纯 RAM 队列）
  → defaultTask 经 syslog_drain 尾部落 /log/soe.log（64B 定长）
- 配置从 [network] 单段改五段注册制（+ftp/adc_cal/run_par/comm），
  另有 /prot_set.bin（B7 原子写）
- UI 一节按注册表驱动重写：菜单树 61 行、16 个 #P 受保护叶、26 个
  #page 绑定、ui_data 三帧契约（写侧唯一填充 ui_data_feed）、录波
  两页、显存一份三出（屏板主出口/:7003 镜像/模拟器）
- §2.1 任务表按 freertos.c 现值逐行核对；protectTask 如实标注
  「未标定闭锁」现状（产品 required_mask 0x1F7）
- 配图：gen_arch_svg.py 顶部数据（层芯片/串口/删悬空图脚注）重跑，
  脚本与产物同一笔提交；check_generated_fresh.py 按「只减不增、
  还清即删整条」把本次还清的 项目架构总览.svg 基线下架（留出处注）

验证：check_doc_links --all --sections-strict 通过；scripts/ci_local.py
全绿；generated-fresh 单跑 rc=0（无 DIFF/NEW）；SVG 无头渲染回读目检
两轮（首轮揪出悬空图脚注）；md 无 BOM/CR/U+FFFD；#P 计数剔注释行复核。
 2026-10-30 06:53:07 +08:00
wandering1 613fc25651 docs(任务规划): 动态验证判据号 D1~D6 清退为语义轮名 
用户裁定 2026-10-30：字母+数字判据号看不懂，删除；需要标识的用语义。
六轮本名取自「验什么」列（顺序图原本也写作 幅值/波形/削顶）：
D1→幅值轮、D2→波形轮、D3→相位轮、D4→测频轮、D5→削顶轮、D6→谐波轮。

- docs/任务规划/数据可信.md §4.6.2（判据属主）：标题与表首列、任务卡
  DoD、§7 决策 8、§8 风险行、顺序图节点、§9 边界表；留一行换算注，
  本族旧号作废不得再取走
- docs/测试说明/ADC前端注入验证流程.md §8（执行手册）：六张执行卡、
  出口分档表、耗时排程、[ERR] 判读、失败分诊、收尾还原表；归档文件名
  示例同步 ac_d1/d5/d3 → ac_amp/clip/phase
- 同形异义族一字未动：二极管位号 D1~D6、FSMC/8080 数据线、网络自愈
  决策 D1~D10（已迁 DR-）、链路延迟缺陷编号、配置文件设计决策表
- 本族无机器识别面（两道编号门禁 2026-10-28/29 已退役），换算表落
  §4.6.2 注内，刻意不进 id_aliases.json；停发靠规范与评审

验证：族内 \bD[1-6]\b 复扫归零（仅剩换算注 2 行，有意保留）；两文件
无 BOM/CR/U+FFFD，字节卫生与 HEAD 一致；84 组替换逐处断言命中数；
纯文档改动，零代码行为变更。

gate: check_doc_links --all + ci_local 通过，pre-commit 提交期实跑
 2026-10-30 01:32:48 +08:00
wandering1 2533a72a0a chore(台账): done 后重生成凭证，对齐合并态 .map
CI / 静态门禁 (pre-commit) (push) Failing after 44s
Details
CI / 主机侧单测 (MSVC) (push) Failing after 43s
Details
2026-10-30 01:15:07 +08:00
wandering1 4d08c3e706 merge: task/screenlink-bench-serial 合入 v2-on-ui 
任务 screenlink（17 个提交）经 task-worktree 回收：
- merge: v2-on-ui into task/screenlink-bench-serial (wave + screenlink)
- docs(屏板): 批 3 改写（LOGO 出局）+ 4-1 双通道并发实测回填
- feat(屏板): 状态灯位映射 sb_led_map + 104 RUN 观测口（批 3）；附 4-1 并发压测脚本
- docs(屏板): 回填真屏板 10 min 连续零错实测（§5.5），未测项清单刷新状态
- feat(屏板): 帧 B 组帧 + 中断起发 TX DMA + 按键队列 + 离线判定（批 2）
- docs(屏板): 批 1 收尾，1-2/1-3 判据回填并订正三处错口径
- feat(屏板): USART1 700 kbaud + 收中断传输层 sb_link（1-2/1-3）
- docs(屏板): 订正 CRC 字节序口径（低字节在前）
- chore(体积): 重盖同码凭证（sb_proto 进索引）
- feat(屏板): 协议层 sb_proto（帧 A 解析 / 帧 B 组帧 / CRC-16）
- docs(屏板): 批 0 的 0-3 接法落纸
- chore(台架): 台架串口默认口改 COM3
- test(日志): 主机单测桩跟到 UART5
- docs(屏板): 批 0 的 0-1 / 0-2 标记完成
- feat(日志): 控制台迁到 RS232#1/UART5，USART1 让位给屏板链路
- docs(屏板): 删掉「日志口改 UART_MODE_TX」的说法
- docs(屏板): 批 0 日志口定为 RS232#1（UART5），落定 CN1 端子与适配器要求
 2026-10-30 01:09:12 +08:00
wandering1 b4588108ed merge: v2-on-ui into task/screenlink-bench-serial (wave + screenlink) 2026-10-30 01:08:37 +08:00
wandering1 77f031a8fd fix(keil-build): frontmatter 整值双引号，修复技能整份加载失败 
根因：今日在飞会话给 description/whenToUse 追加了新内容（「pw: 前缀」等），
但两行值为未加引号的 YAML plain scalar——其中的 ASCII「冒号+空格」让
DSH parseFrontmatter() 所用的严格 yaml 解析器报 Nested mappings 错误 →
keil-build 技能整份不加载（skill() 读不到、技能目录不收录）。
js-yaml 能吃下去，拿它自检会假绿。

修复：description/whenToUse 整值加双引号（pw: 字面量原样保留），
正文护栏段同步为「要么整值双引号，要么一个 ASCII 冒号都不写」并点名
解析器与假绿坑；另有两段纯重排（护栏段前移、衔接项目符号归位）。

验证（三重）：DSH 自带 yaml 包严验全仓 17 个 SKILL.md 全 PASS；
skill-size 门禁 17/17 无悬空指针；skill('keil-build') 全文可读，
技能目录已恢复收录。字节卫生：无 BOM、纯 LF、无 U+FFFD。

注：本笔仅含 SKILL.md。索引中另有一笔在飞会话暂存的 uvprojx，
属 UV4 XML 归一化抖动，按 AGENTS 口径不入库，留给该会话自行处置。
 2026-10-30 01:01:44 +08:00
wandering1 cb2fb4f095 docs(skills): keil-build SKILL.md 更新——frontmatter YAML 冒号陷阱与调用判据补全 
- ⚠ frontmatter 写法判据：description/whenToUse 含 ASCII 冒号时必须整值加双引号，
  否则 @deepseek-ai/dsh-skill-filesystem 的 parseFrontmatter()（yaml.parse）整份
  加载失败——本文件曾中招。
- 补退出码 2（BUILD_ENV_ERROR / UV4.exe not found）判读：DSH 会话看不见用户级
  DTU_KEIL_UV4 时的候选路径探测与单次调用 env 注入闭环；build 锁持有者名
  （含插件树 pw: 前缀）判读。
 2026-10-30 01:00:36 +08:00
wandering1 e02f46ed6a docs(任务规划): 删除两份遗留的 20261028 分工说明 
- 分工说明-20261028-RS485解锁与门禁口径对账.md
- 分工说明-20261028-采集链与上送链联调.md

两份均为 2026-10-28 的一次性分工简报，任务线已收口、文件遗留未清，
用户确认为没用文件后删除。删除前核对引用面：docs/ 全量 *.md 完整扫描、
根 README/AGENTS/.gitea 均零引用；仅 ci-artifacts/（已忽略的一次性脚本
与日志）内有历史命中，不构成悬空链接。
 2026-10-30 00:50:21 +08:00
wandering1 f405c8994f docs(屏板): 批 3 改写（LOGO 出局）+ 4-1 双通道并发实测回填 
- 规划批 3 表改两项（3-1 映射表 / 3-2 下发），3-3 LOGO 标 ❌ 出局
  （用户裁定 2026-10-29：LOGO 功能无用、不实现，sb_proto 组帧函数列待删）；
  §0 执行序、验收清单第 8 条、另测三项（LOGO 那条连同串进去的残句一并清）
  → 两项、风险表两行同步。风险表"const 数组"防返工手段按实际实现改口
  （位宏 + 单点纯函数 + 单测钉定义集——5 路输入判据形态各异，表统一不了谓词）。
- 设计说明 §3 决定 7 改写（LED 掩码独立纯逻辑模块折算）+ 新增决定 9（LOGO 出局）；
  新增 §5.7 双通道并发回归实测（7003 侧 2200 拉帧零错零超时 / 屏板侧隔离窗口
  每召必答零丢弃 / 画面一致性由同一份活显存机制保证 / len=7 观察项如实记）；
  §7 清单第 8 项销项、第 10 项状态灯改为"已实现待目视"（含 ID2/ID5 在未标定
  闭锁下恒灭的口径提示）、第 11 项 LOGO 划掉。
- 裸 §5.7 跨文档引用改全路径（--sections-strict 自引用判据）。
 2026-10-30 00:40:45 +08:00
wandering1 0b84c43d2e feat(屏板): 状态灯位映射 sb_led_map + 104 RUN 观测口（批 3）；附 4-1 并发压测脚本 
批 3（LOGO 按用户裁定出局，不实现、sb_proto 的 LOGO 组帧挂待删标注）：
- 新增 App/algo/sb_led_map.c/h：业务状态 → 屏板 LED 位掩码的唯一映射表
  （纯逻辑，主机单测可跑）。ID1 运行心跳 500ms 半周期闪（与主板 LED 同拍）、
  ID2 保护动作、ID3 104 链路 RUN、ID4 采样电平故障（不选 sticky——灯要能灭）、
  ID5 保护启动 picked；bit0 与 ID 6~19 恒 0。这张表参考源码里没有，属自定，
  出处 docs/产品需求/产品需求设计文档.md §5.16.3 ①。
- iec104_serv 新增 iec104_serv_link_run()（透传 link 状态机，不另存镜像量）。
- ui_task.c 帧组装块每拍现采四路状态源（均为任意上下文可读观测口）折算后
  传 sb_link_frame_update——替换批 2 的恒 0 占位；掩码变了帧就重组，
  复用 busy/dirty 机制，无新通路。
- 主机单测 test/host/sb_led_map 17/17（位语义/恒零位/闪烁相位/tick 回绕/
  NULL 契约）；注册豁免走 SIM_EXEMPT（模拟器无屏板串口）。

批 4 的 4-1 双通道并发回归（真屏板在线实测）：
- 新增 test/host/remolcd_pull_test.py：RemoDispBus 拉帧压测客户端
  （INIT→LCDMEM 10 Hz、逐帧 XOR+长度校验、往返延迟统计、--dump PBM）。
- 实测：网络侧两轮 2200 拉帧零错零超时（min 35/avg 63/max 131 ms）；
  屏板侧 60 s 隔离窗口 rx +233 全收、drop 零新增、bad=0、off=0、无
  OFFLINE——两侧互不拖。观察项 len=7（断帧尺寸≠6，累计 7 次）出现窗口
  无法归因压测、隔离窗口零新增、有效帧零损失，已挂设计说明 §5.7 待查。

附带：sb_link.h frame_update 注释回填实测耗时（509/688 µs 取代旧估算）。
Keil 0 错误 0 警告；ci_local 全绿（SKIP=nested-comment，主树脚本另查 0 新发）；
Code=239,064 B / RW_IRAM1 65.5 % / RW_CCM 87.9 %；覆盖率 90.1 % / 44 套件。
 2026-10-30 00:39:57 +08:00
wandering1 ecf9d3ad3d docs(task-worktree skill): 修 @T3@ 围栏腐坏，正文瘦身并把细节外置 reference/ 
围栏腐坏是真 bug：@T3@ 是被误提交进仓的代码围栏占位符，Markdown 渲染出
来就是一行 @T3@ 加裸命令。git log -S 定位：842d711e（2026-10-28）
SKILL.md 还有 18 个真三反引号围栏行、0 个占位符；21c68521（2026-10-29
插件桥接那笔）起变 0 围栏 / 34 个占位符。全仓只有本技能 6 个文件有此
病，draw-diagram / keil-build / ui-verify 等都用真围栏。本轮七个文件
占位符清零、围栏全部成对。

信息密度：SKILL.md 28,139 → 23,087 B（−18%，占插件写侧上限 65536 的
35%，给自进化留头量）。同一句外置理由在 C2/D/E/F/G/陷阱/验证 重复 7 次
→ 0；frontmatter 与 F 节写了两遍的插件桥接说明收进 F 节；「这不是免费
的」「挡给你看的保护」这类修辞删掉。删掉的细节全部落进对应 reference
篇——skill-size 钩子会校验指针不悬空：现 26 处链接 / 8 篇目标 / 悬空 0，
每篇都有入口。

锚点未重排：节号 A–G/C2、各节步骤号、铁律编号被 reference/ 反向引用
（铁律 3/5/7/9 与 A 第 1、5 步，C 第 5~7 步，E 第 1~6 步均结构性存在）。
只在 SKILL.md 出现的 PIPESTATUS 教训保留（reference/ 里没有，删了就丢）。

门禁：check_skill_size.py rc=0（17 个 SKILL.md 全在写侧上限内、无悬空
指针）；七文件均无 BOM / CR / U+FFFD、单个尾换行。
 2026-10-30 00:31:36 +08:00
wandering1 b49e226815 docs(配图): 菜单树总览改由生成器画，登记钩子扫不到的图 
- 新增 tools/arch_diagram/gen_menu_tree_svg.py → docs/images/菜单树总览
  .svg：43 节点 = 9 菜单 + 34 叶，30 已绑页 / 4 未绑 / 16 叶带密码门，
  最深 4 级；读数由脚本现算，不在文档里另抄一份
- 生成器内嵌 NODE_SRC（= ui_menu_tree.txt 的 43 行节点）：在仓库里跑会
  与真值逐行互验、不一致 exit 1；generated-fresh 在临时目录重跑读不到
  真值 → 用内嵌表，输出逐字节一致（实测临时目录产物同 sha256）
- 产品需求 §8.2 原先挂的是级联框显示几何图（画的是示例级联，从来不含
  整棵树的节点），换成这张树图，并删掉「该图仍是 42 节点时代所画」的
  补丁注
- 图形绘制流程新增 §2.1：登记 generated-fresh 扫不到的四张图 —— 两张
  tools/refgraph 产物（引用关系图 / _模块，不在 gen_*.py 命名面里）+
  两张手画稿（级联框总览、级联框几何计算）。钩子只扫
  tools/arch_diagram/gen_*.py，这些图改了不会有人报警；再多一张先说清
  为什么不能用生成器
- arch_diagram README 脚本一览加行
 2026-10-30 00:25:03 +08:00
wandering1 98d46e626d fix(内存台账): subsystem_of 补齐 12 个 App 对象前缀并加未归类兜底 
按台账 §2「应用 = App/ 其余」自家口径重算归集。此前 wave_、iec104*、
soe_、meas、freq、run_par、protect_task、task_prof、boot_stats、
vol_idle_sync 都不在前缀表里，12 个对象 9,445 B 静默落进「其它」（参考
行、无配额），配额 8 KB 的「应用」行看不见录波与 SOE 支路。补齐后
应用 16,888 → 26,333 B、其它 15,849 → 6,404 B；区域水位与 92% 红线不变
（台账受管区已 --write 回填）。

兜底：App 下的 .c 编出的对象只要落进「其它」，--gate 就逐条 WARN 点名
（软提醒不拦）—— 下一个新增 App 目录不会再静默隐身。台账 §2 口径表、
应用条目、变更记录与 内存内容分配策略 §6 那条「本卡不动，已报 lead」
同步改口。
 2026-10-30 00:19:15 +08:00
wandering1 058e7c061c docs(数据可信): §8 风险表改按行名引用，修掉两处指错行 
- IEC104上行设计说明.md 与 iec104_pts.c 的 s_q_map 注释原写「§8 风险
  表末行」，末行其实是「加压烧板」；含单测要求的是「削顶通道被当成可
  测」行。两处都改成行名，行名完整落在一行内
- ADC前端注入验证流程.md 同源错引用改成「削顶负向用例被当成固件 bug」行
- 数据可信.md §8 表头加一条引用规矩：写行名，别写「末行 / 第 N 行」，
  本表会插行
- doc-links 只校验章节编号存在性，看不见「末行」这类行内指向，也从不扫
  .c/.h —— 这两处此前没有门能拦

@build 0 errors 0 warnings（只改注释，Program Size 未变）
 2026-10-30 00:18:53 +08:00
wandering1 9c6d150261 docs(屏板): 回填真屏板 10 min 连续零错实测（§5.5），未测项清单刷新状态 
21:30~21:44 挂机窗口末轮计数：rx=4258 ok=4258 crc=0 err=0 bits=0x00
rearm=0（连错误中断都没进过）；末段 5 s 18 帧 = 277.8 ms/帧；
tx=4249 done=4248 drop 窗口内零新增 kerr=0 abor=0；keys=53 kq=0
（按压期间零丢弃）；fb=902 bad=0、us max=812 µs < 1 ms 改口判据；
窗口内无 OFFLINE/back online 行。验收清单第 1 条主机侧半边闭环。

§7 清单状态同步：第 2 项 ✅；第 1 项拆成"主机侧已测/目视半边待测"；
5.5 接线教训顺延为 5.6 并同步三处跨文档引用。
 2026-10-29 21:46:47 +08:00
wandering1 35d6897fdc Merge branch 'task/idfreeze-no-new-id' into v2-on-ui 
两笔文档治理：空壳变更记录节清完（17 篇）+ 编号一律停发（用户裁定
「啥号都不发」，§4.1 五族也只读存量）。
 2026-10-29 21:32:05 +08:00
wandering1 20617a33f7 docs(编号规范): 编号一律停发——§4.1 五族也不再发新号，只读存量 
用户裁定（2026-10-29）：「啥号都不发」= 任何族都不再新增编号，
含 §4.1 那五个原本"有脚本按字面量匹配"的存量族；既有号只读引用，
族里新增内容一律写语义行名。

规范本体：
- §1 由「先问三句」改成「默认答案：不发号」，三问表换成场景对照表；
- §4.1 由「允许用号的族」改成「存量族」，第四列改「既有号被谁读 /
  新写怎么办」，逐行写明新写怎么做（TRAP 写语义行名、FR 用 §5 行名、
  CODE-RULE / MENU-STATE 先问用户、P-n 只读存量页号）；
- 末框四条对照 + 唯一例外入口（确需机器按字面量匹配 → 先问用户）；
- 新增族 = 一律不许；批准后顺序：本文 §4.1 → 属主文档 → 才动 registry。

跨文件同步（12 份）：门禁说明 id-check-new / id-check / host-unit-tests
（把"校验 5/3 拦新号"这类现状叙述历史化）、两份 TRAP 记录的编号口径、
开机账本用例号说明、AGENTS 两处、id-family 技能与其 steps-alpha 模板、
归档 README 与两份归档脚本 docstring。

AGENTS 主题表那行原写「允许用号的 7 个族」，与规范的 5 行本就对不上，
旧计数一并消掉。

未做：pre-commit 的 default_stages 一行——用户对该项未置可否。

验证：py_compile 与 check_ids_new.py --self-test 均 rc=0；逐篇
check_doc_links.py --sections-strict rc=0（编号规范 70 处引用 /
68 可判定 / 无法判定 0）；13 份改动文件表列数与字节体检相对基线零新增。
 2026-10-29 21:31:42 +08:00
wandering1 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 dab0d8ba17 feat(屏板): 帧 B 组帧 + 中断起发 TX DMA + 按键队列 + 离线判定（批 2） 
批 2 五项全部落地（docs/任务规划/屏板链路.md §3）：
- 2-1 sb_link_frame_update()：uiTask 渲染后按需组帧，不留 3200 B 影子
  副本，直接拿活显存与帧内点阵段 memcmp；组完自校验，过了才置 ready。
  静态 4208 B 帧缓冲实测落 RW_IRAM1（0x20006d98），不在 CCM。
- 2-2 空闲中断校完 6 B 召唤帧直接点 TX DMA（sb_tx_kick），不排队不攒批；
  busy 期间再来的召唤丢帧并计数，绝不叠发（屏板收帧一次 IDLE 一包）。
- 2-3 按键走环形队列（中断入、任务出），uiTask 按 §4.3 表映射 UI_KEY_*
  后调 ui_port_queue_key；9/10（RESET/FACTORY）按决策四先丢弃并留痕。
- 2-4 HAL_UART_TxCpltCallback 在 rs485.c 加第三行转发（三个全局回调
  落点收一处，防日后重复定义）；busy 冻结帧缓冲，错误中断按 gState
  收拾被打断的 TX，防残留 busy 把链路永久锁死。
- 2-5 连续 >=10 s 无有效召唤帧才判离线（不按 500 ms——屏板约 5000 s
  自复位有 1 s 空窗），恢复即清标志；CRC 错帧静默丢弃并计数。

实测：台架 40 s（PC 顶替屏板，--key-fixed 2 持续改画面）rx=143 ok=143
keys=143 crc=0 / tx=143 done=143 drop=0 abor=0 fb=144 bad=0；脚本一停
10 s 准点出 OFFLINE。组帧耗时 509 µs 典型 / 709 µs 峰值——原 0.3 ms
判据系估算，已按实测在规划文档改口为 1 ms 并给出压降路径（未做）。

附带：rs485_on_rx 补 CODE-RULE-09 文档块（本轮改 rs485.c 触发整文件
重扫被拦）；CRC 循环计数改 32 位（消掉 ARMCC 每轮 UXTH）；bench 脚本
加 --reply/--key-fixed/--dump，并写明 CH340 收不了 700 kbaud 连续流、
--reply 收不全 4208 B 不是固件问题。

主机单测 146/146 PASSED（+65）；Keil 0 错误 0 警告；ci_local 全绿
（SKIP=nested-comment，worktree 限制，主树脚本另查 0 新发）。
Code=238,936 B / RW_IRAM1 65.5 % / RW_CCM 87.9 %。
 2026-10-29 20:59:36 +08:00
wandering1 1cf9f6f021 合并 task/idnorm-41-sweep：按机器面退役改写编号规范正文 
基线 594d2ee5，内容提交 f8d795c3（6 文件 +87/−77）。
要点：把规范正文里所有「现在时」的机器强制断言改成历史/现状口径；
§8.5 由退役路线流水表整体换成「手工普查与恢复机器面」；
§9 事实源指针改指 scripts/archive/id_gate/ 归档篇。
编号 §8 / §8.5 / §9.3 等刻意不重排（外部按号引用）。
 2026-10-29 20:54:16 +08:00
wandering1 f8d795c387 docs(编号规范): 按机器面退役改写规范正文 
依据（逐条回配置核实）：三处配置里 id_registry / check_ids /
id_known_backlog 命中数全为 0，没有任何活物再读编号登记；
check_test_traceability.py 存在但没被任何配置跑；变更记录例外
清单实测只剩 5 篇。

改写要点：TC 框把「registry 带游标所以允许发」改成裁定留痕并
明写别把不报错读成允许发号；删掉探针行与自相矛盾的 7 行；
§4.1.1 四处现在时（已冻结 / 越游标即拦 / 发号口已关闭 / 校验
错误级）改历史口径，中文前缀族改成「从来没有机器面」；§4.3
点明冻结前缀是档案不是闸门；§5.1 三步改成「族落在 §4.1 之
内 → 属主登记处写定义行 → 才允许引用」；§5.5 删掉「门禁已
豁免」口气并不再复述份数；§8 标题改「一道也没有」；§8.5 由
退役路线流水表整体替换为「手工普查与恢复机器面」（两条归档
命令 + 恢复成本三步 + 退役理由与 WAVE00 误拦），§8 / §8.5
编号刻意保留以免外部引用断链。

指针同步：AGENTS.md 与配置注释里的「§8.5 路线」改成新节名；
id-family-semantic-migration 的 SKILL.md 与两份 reference 把
§9 事实源指针改指归档、把「门禁咬不到」措辞改成「连归档扫描
工具都咬不到」。

校验：本篇逐篇 check_doc_links --sections-strict rc=0（60 处
引用 / 58 可判定 97 % / 无法判定 0）；check_skill_size rc=0；
表格列数 0 处不一致；无 BOM / CR / 乱码 / 行尾空格，单 LF 收尾；
YAML 解析钩子声明数仍 51（配置只改注释）。
 2026-10-29 20:53:26 +08:00