wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 30 Pull Requests Actions Packages Projects 2 Releases Wiki Activity
696 Commits 3 Branches 0 Tags
a275539c1775d8278af3013402d9aa7289698be2
Commit Graph

696 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
wandering1 969fc5c132 merge: task/n17-probe 合入 v2-on-ui 
任务 n17（1 个提交）经 task-worktree 回收：
- fix(网络): 主动拆会话登记即返——drop 路径不再占用 netTask（登记簿 N-17 收口）
 2026-10-25 10:32:25 +08:00
wandering1 9c2653c6ef merge: task/meas-snap 合入 v2-on-ui 
任务 meas（2 个提交）经 task-worktree 回收：
- Merge branch 'v2-on-ui' into task/meas-snap
- feat(遥测快照): 卡8 meas 双区快照模块 + adc_task 200ms 唯一发布点（道D M5）
 2026-10-25 10:29:38 +08:00
wandering1 62987b4596 Merge branch 'v2-on-ui' into task/meas-snap 
# Conflicts:
#	scripts/id_registry.json
 2026-10-25 10:29:18 +08:00
wandering1 a3c6e89378 fix(网络): 主动拆会话登记即返——drop 路径不再占用 netTask（登记簿 N-17 收口） 
道F 批 2 / task-17。定位 + 单点收口，不开 net 层跨上下文大口子。

【定位（链路，全部代码可复核）】
探针挂起 30s → time_sync.c:149 预算耗尽 → :187 net_drop_conn()。NET_MSG_
DROP_CONN 处理器（net_drop_conn_locked）内同步跑 net_sock_reset_sync
(QUARANTINE)（2ms 节奏、400ms 底/600ms 顶，自家注释原记「等待期 netTask
有界占用 ~400-600ms」）：netTask 的 1ms 主循环冻结在同一迭代 → NET 位
停摆；串行总线整窗停摆 → UI 推流/FTP/104 在途消息回执顺延；对时调用方
睡在 net_wait_result 等回执期间无分片心跳 → 五位同窗缺席 → 连续 8 个
100ms 抽样停喂 → 声明 [WD] task stall（V5 时代 req=0x37、快照只剩 bit0，
即日志 mask=0x00000001）。被动断连/EOF 走 net_listener_tick 异步沉降机
（D10 条令）故纯 FTP 负载 0 stall——只有主动 drop 留在同步原语里。

【修复】监听型 fd 的芯片拆除改为 net_listener_settle(QUARANTINE) +
net_listener_request(REQ_DROP) 登记即返，拆链/排渣/等 CLOSED/重建全部
交 net_listener_tick 30ms 节奏——与被动释放同一台机器（E16 台架实证该
自建序列 RST 10/10、FIN 5/5）。非监听 client fd 无监听可保，同步形态
原样保留（全仓零生产调用者）。返回值语义显式改为「拆除与重建已登记」
（net_socket.h 注释按 lead 要求写明，防未来调用方按旧语义写）。
APP_ASSERT（S12 试点）分派门与断言位置未动，登记时序下仍成立。

【评估否决留档（lead 要求论证入文档）】「缩短重建重试 5×2s」不采：
该退避在 time_sync_open_listener() bind/listen 失败路径、已被
time_sync_delay_fed() 分片喂保护、不在缺口链上；缩短反撞 TRAP-NET-09
沉降窗。全文见 docs/网络/网络自愈架构设计.md §4.6（已改写）。

【竞态与信源核对】① 主路径置 CLOSED 后迟到的 DISCONNECT/TIMEOUT 被
net_events 状态门拦截（只认活会话态），不会把刚登记的 QUARANTINE 降级；
② 零新增读清点——全局寄存器唯一读者仍 net_poll，隔离窗两处本 Socket
读清是 net_listener_tick 原位，§4.10 三条准入判据不触发；③ E13 物理
边界（对端不配合 FIN_WAIT_2 长尾）逐字不变，只移动等待发生的位置。

【测试】net_socket 主机套件 457/457：TC-NETSOCK-240f/321b/321b2/460e
重锚到登记式（settle+REQ_DROP、rst 机零启动、tick 预算 ≤20、无 [ERR]），
新增 321g/h/i + 460f 钉住 client fd 旧同步形态。全量 --all-files 40 绿。

【体积增量（vs scripts/ram_baseline.tsv 2026-10-25 行）】
ER_IROM1 237328→237344（+16 B）；RW_IRAM1 75792（+0）；ZI 0。
@build 0 错误 0 警告（Code=215948 RO=21396 RW=1232 ZI=131984）。

gate: only mem-budget/mem-numbers pending lead ledger backfill
test-coverage 本条**绿**（已覆盖行净增，未动用裁决③的覆盖率例外——
旧同步路径行经 client fd 新用例继续被覆盖，净差非负）。其余含
id-check/doc-links/全部主机单测绿。仅 mem-numbers/mem-budget 两红 =
台账 +16B 漂移待回填（lead 单写者禁区）。

【越界申报】① test/host/net_socket/{ns_s3_msg,ns_s4_state,ns_s5_io}.c
（批准③同类：只动本任务相关用例，未碰他人行）；② docs/网络/
网络自愈架构设计.md §4.6 改写（lead 本任务指令明示）。登记簿 N-17
销项与 README 波次行归 lead；docs/内存管理 数字未碰（禁区）。

台架：V5 复跑判据（e02_probe + FTP ≥30min 零 stall / 零复位）属网络
对端类——待 lead 排窗，步骤清单随 done 消息发出。
 2026-10-25 10:08:46 +08:00
wandering1 b746a1ff00 chore(ledger): ui-data 合入后回填台账/凭证/覆盖率并同步门禁计数 
task/ui-data-feed 合入（merge 98664a1）：ui_data 三通道快照 +
ui_data_feed 装配 + ui_w_soe 显示名 + 字库 +4 字（采/样/恢/效，
179→183）。合并后 @build 0/0：Code=217,204 / RO=21,504 /
RW=1,256 / ZI=132,680；RW_IRAM1 76,512 B（58.4%）、CCM 87.9%。
lane-e 分支侧 --no-verify 欠账清；覆盖率基线登记 ui_data.c
（37/37 套件、tested 41）；凭证重盖（L0c 恢复序列）。
AGENTS/门禁 README 计数 42→44 钩、18→20 单测钩子（n22+ui-data 两笔带进来）。
 2026-10-25 10:07:15 +08:00
wandering1 48bc50e794 feat(遥测快照): 卡8 meas 双区快照模块 + adc_task 200ms 唯一发布点（道D M5） 
卡 8（App/algo/meas.*，新增；布局权威 docs/任务规划/数据可信.md §4.5）：
- meas_snap_t = §4.5 布局（sizeof 72 B；字段偏移由 TC-MEAS-002 钉死——卡 9/
  UI 按整体拷贝消费，破布局=破协议；谐波 k-bin 扩展（docs/算法/继电保护功能
  复现规划.md L2-8）只许尾部追加，留口注释已写进 meas.h）
- 并发 = phasor 双区 + 单字节索引翻转（L2-7 同型，无锁）；seq 只增供判"换帧"；
  meas_get 失败路径清零填充（-2 未就绪时调用方可安全读）
- 值口径 = A-lite 裁决（lead 2026-10-25 快裁，推翻票面全链）：基波有效值瞬时
  透传，复用 phasor_calc 纯核 → 与 phasor 使用区同拍同值（TC-MEAS-005 逐位
  相等钉死）；不做 4 点平均/方和根（§4.5"200 ms 是上送节拍不是平均窗"）
- 品质注入：CLIPPED 位图唯一源 = adc_cal_flags()（「数据可信」§4.2 三态表，
  编排方注入、本层不链 adc_cal）；取窗不足路 = IV|NT 且整帧 valid=0 但照常
  发布（品质节拍性刷新）；TEMP = 最新一点透传 + NT（「数据可信」决策 5）；
  MEAS_QDS_* 低字节 = 104 QDS 线上值（本层不 include 协议层头——分层方向，
  卡 9 直接截低字节映射）；OV 留位不填（判据待运行参数化，卡 10 域）
- adc_task.c 编排：新帧拍 freq_run() 后按 **tick 经过**分频（非拍计数，idle/
  skip 拍会拉长名义节拍）调 meas_tick()——全仓调用点数 = 1（「数据可信」§8
  风险表"快照双写"行评审判据）；meas_init 挂 adc_task_init（不动 app_main.c）；
  心跳新增 meas: 行（seq/v/ua·un·ia_mv/f/fv）作 M5 台架观测面
- 死区 2 点确认状态机本卡不建（卡 9 迁移 104 语义时随建，lead 裁③）；104 层
  现有 deadband 常量未动；频率点绑定归卡 11
- 实测采样类判据（读数 vs 注入源）= 待台架实测，本卡零台架动作

测试与注册：新套件 test/host/meas（226/226，链真源 meas+phasor+sample_ring
免桩；覆盖 seq/双区无撕裂/布局/品质汇总/回绕/守卫）；id_registry 建族
TC-HOST-MEAS（游标 011）；meas-unit-test 钩子 + SIM_EXEMPT 一条 + uvprojx
仅增 meas.c 单条挂载（diff 已核零 UV4 抖动）；App/algo/README.md §1/§2/
§3.9/§4 同步（设计说明大节与 AGENTS 口径留 lead 收口，同批 1 先例）

gate：@build 0 错 0 警（Code=216352 RO=21476 RW=1232 ZI=132128）；RAM 增量
RW+ZI = +152 B（快照双区恰 +144 B = 卡面 DoD；余 s_meas_ms 等编排状态），
IRAM1 57.8%→约 57.9%；Flash（Code+RO+RW）+696 B；adcTask 静态最坏链 1408 B
/ margin 1152 B（45%）PASS（stack_report 实测，无抬栈）；BOM/CR/U+FFFD/
字面量 ASCII 逐文件自查通过（未触碰带 BOM
文件）。pre-commit run --all-files 实跑：其余钩子全绿（含 doc-links/id-check/
覆盖率总闸/双端注册/ui-golden/全部主机单测套），仅 mem-budget + mem-numbers
两条红 = 台账受管区 vs .map 漂移（Flash/RAM 台账回填属 lead 单写者区，批 1
同口径）：
gate: only mem-budget/mem-numbers pending lead ledger backfill
 2026-10-25 10:02:10 +08:00
wandering1 98664a11ed merge: task/ui-data-feed 合入 v2-on-ui 
任务 ui-data（2 个提交）经 task-worktree 回收：
- feat(ui-data): ui_data 三通道快照 + ui_data_feed 装配 + SOE 显示名映射
- feat(ui-font): 字库补 SOE 显示名用字 采/样/恢/效（179→183 字 / 274→278 字形）
 2026-10-25 09:59:35 +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 042e85820c chore(ledger): n22 合入后回填台账/凭证/覆盖率基线 
task/n22-flush 合入（merge 6f99dea）：vol_idle_sync 空闲 flush 兜底。
Code 215,744→215,932（+188 B）、RW 1,224→1,232（+8 B）、ZI 不变；
RW_IRAM1 75,792 B（57.8%）、CCM 57,376 B（87.9%）不变——lane-f 分支侧
--no-verify 欠账清。覆盖率基线登记 vol_idle_sync.c（36/36 套件）。
凭证重盖（L0c 恢复序列）。
 2026-10-25 09:29:55 +08:00
wandering1 6f99dea3a9 merge: task/n22-flush 合入 v2-on-ui 
任务 n22（1 个提交）经 task-worktree 回收：
- feat(存储): 写回缓存空闲 flush 兜底——卷空闲周期 CTRL_SYNC（登记簿 N-22 收口）
 2026-10-25 09:25:14 +08:00
wandering1 484d068250 feat(存储): 写回缓存空闲 flush 兜底——卷空闲周期 CTRL_SYNC（登记簿 N-22 收口） 
道F 批 2 / task-16。FTL 单页写回缓存（nand_ftl.c s_cache_dirty）与 dhara
journal 只在换页/整页写/f_close 时刷出，漏网脏页的掉电驻留窗无上限。本
提交以最小面收口：不碰 GD5F/dhara 驱动，全部走既有 FatFs CTRL_SYNC 路径。

实现 App/fs/vol_idle_sync.[ch]（新增，仅 MCU 端，uvprojx App 组注册）：
- 四级门：STORAGE_READY 就绪门 → 5 s 节流（无符号差回绕安全判据）→
  vol_lock_wait(0) try（锁被持有=文件序列在做，跳过，不改 STOR 持有期
  语义）→ disk_ioctl(0, CTRL_SYNC)；
- clean 态脏标志+journal 双短路、零 NAND 触点；脏态最坏 = 一次 f_close
  的同步段同型成本，不引入新磨损来源；
- 失败按边沿 latch 一条 DBG_ERROR、成功重新武装；失败路径也成对放锁；
- TEST_SUITE_STORAGE 构建整体 no-op（卷由 testTask 独占）。
接线：defaultTask 主循环 syslog_drain 之后（default_task.c v1.3）。

文档：docs/架构设计/STM32F4-Base存储架构说明.md §5.5 补空闲兜底与边界；
本板无掉电检测硬件、不做掉电前强制 flush、勿当掉电保护——口径同步落
注释与文档（sys_log_mcu.c 两处旧「暂不做」注释随实现改口）。

测试：新主机单测 test/host/vol_idle_sync/（TC-VOLSYNC-001..012，19 断言
全过）；scripts/id_registry.json 建 TC-HOST-VOLSYNC 族（仿 ADCCAL 先例）；
.pre-commit-config.yaml 加 vol-idle-sync-unit-test hook（只加自己条目）。

越界申报（①②③ 均 lead 批准，④ 为门禁连带必要）：
① App/task/default_task.c 单点接线（include + 1 调用 + 头修改记录）；
② docs/架构设计/STM32F4-Base存储架构说明.md §5.5；
③ .pre-commit-config.yaml 单 hook + scripts/id_registry.json 单族；
④ scripts/check_registration.py SIM_EXEMPT 加一行（vol_idle_sync.c 模拟器
   侧豁免，registration-check GAP 所需；与批准③同类别但未列名，特此申报）。

体积增量（vs scripts/ram_baseline.tsv 2026-10-25 行）：
Flash(Code+RO) 237140→237328（+188 B）、RW 1224→1232（+8 B）、ZI 0；
增量 = 3 个文件级 static + 一处 DBG_ERROR 调用点；栈/堆无变化。

gate: only mem-budget/mem-numbers pending lead ledger backfill
全量 pre-commit --all-files：40 项 Passed，仅 mem-numbers（D-7 体积档）与
mem-budget 两条红 = 台账数字待回填（增量如上，属 lead 单写者禁区）；
其余含 doc-links/id-check/registration/test-coverage/全部主机单测皆绿。
@build 0 错误 0 警告（Code=215932 RO=21396 RW=1232 ZI=131984）。

台架：空闲 sync 实机节奏（clean 零触点、脏态时长、无心跳扰动）属实际
测量采样类——本批跳过，留「待台架实测」。
 2026-10-25 09:23:20 +08:00
wandering1 13ef0715bb docs(销项): 批 1 登记簿收口 + A-5 口径联动到三处门禁文档 
销项（登记簿删行 + 结论沉淀指针）：
- 数据可信.md：卡 1~7 行删除，表下补销项记录（merge 231dc81/d39e5c9/
  59da40b）；§2.1 口径冲突注改 ✅ 已定死；§6 顺序图与失效预警改写为
  "批1 已销项 + 批2 在途"现状；卡 0/0b/12 与 M4①⑤台架面保留待跑
- 测试与架构专项.md：未闭环一览删 S12 / A-5 两行；§1 标题 1 项→0 项，
  P1-10 剩余两条改已销项记录（5 档构建 + f3 PASS，数字正文在
  test/board/ch395f_test.h）；§2.1 S12、§2.3 A-5 标题 ⬜→✅ 带落点
- README.md：一览删 P1 收步行；网络/结构/UI 行加 🟦批2 在途标记；
  测试基础设施 5→3；数据可信行改"在途 7 卡"；验证常态两处删
  P1-10/S12/A-5
口径联动（A-5 已落地，文档追平）：
- CI 远程CI完整指南.md §0.0 整节重写（盲区→同码凭证强制 + 三项仍
  守不住 + 变更记录行）；CI README 索引行同步
- 门禁说明/mem-numbers.md §1/§6、mem-budget.md §6 第 4 条：远端缺口
  已由 check_size_gate.py 关闭，唯一正文 = 其 docstring
 2026-10-25 08:36:44 +08:00
wandering1 db9f256fd0 docs(收口): 批 1 台架记录与门禁/产物分家口径落档（道C 文案兑现） 
- test/board/ch395f_test.h：f3 轮台架记录追加——VERDICT PASS，
  task stall 468→14（net 类 431→0，掩码复活实锤），余 13 条为
  netTask 自挂起前喂一次 vs 精确匹配判据的语义打架 + 1 条 uiTask
  瞬态 + 1 条设计内 P2 留痕；lead 裁决不放宽超集判定
- 主机单测覆盖率口径.md：中间产物路径 L80 与坑 12 重写为
  %TEMP%/dtu_host/<工作树哈希>/ 分家 + runs 独占（adabb6a 落地，
  旧固定共享名作废；判据正文指向 harness 顶部）
- 并行任务工作树方案.md §5 表：单测产物一行——不需要锁但必须
  按树分家（对照 build/bench 真独占）
- 门禁说明/cubemx-survival.md §6：新增第 7 条「基线漏项=静默不检」
  （net-msgq-adopt 实证，--write 后抽查新增条目）
- 门禁说明/id-check.md §5：拦下过真事追加——P1-10 注释裸编号被
  校验 6 拦（紧邻写法在 C 注释同样生效）
 2026-10-25 06:12:02 +08:00
wandering1 bd7f15fc3e chore(size): P1-10 合入后重盖体积凭证（v2 索引指纹） 
task/P1-10-test-fw 合入（merge 73f9e10，含 A5 指纹跨树稳定修复 /
WD 掩码死分支复活 / %TEMP 分家 / 四 Fault 显式判据 / P1-10 四档实测）。
产品态体积与 383b450 逐项相同：Code=215,744 / RO=21,396 /
RW=1,224 / ZI=131,984（零增量——掩码修复在产品构建走原分支）。
台架 f3 轮 VERDICT PASS（boot log 20261025_055725，bench PASS 已入台账）。
 2026-10-25 06:08:25 +08:00
wandering1 73f9e10492 merge: task/P1-10-test-fw 合入 v2-on-ui 
任务 P1-10（8 个提交）经 task-worktree 回收：
- chore(size): sync 追平后重盖体积同码凭证（v2 索引指纹，1396 文件）
- docs(P1-10): sync 追平后补记四档复测数字（产品基线已前进，旧注保留）
- merge: v2-on-ui 追平至 task/P1-10-test-fw（含 A-3 卡5~7 与 B-3 记录 reader）
- test(P1-10): 套件回归 forbidden 换成显式四 Fault 标签 + 台架记录 21/21
- fix(WD): HW 测试模式掩码死分支复活——include 缺失自 7feeea6
- fix(test): 主机单测/覆盖率产物按工作树分家 + 每次跑独占目录（task-10）
- test(P1-10): CH395F 套件三档构建实测 + 修阶段开关行尾跨行注释的切换陷阱
- fix(A5): 体积凭证指纹改取 git 索引 blob——跨 checkout 稳定，并拦未 staged 改动
 2026-10-25 06:03:55 +08:00
wandering1 8c28f3bfdd docs(收口同步): 批 1 落地后 AGENTS/104/算法层口径更新 + SOE 7/8 消费面补齐 
- AGENTS.md：钩子 40→42、主机单测钩子 16→18（adc-cal/prot-dim）、
  覆盖率总闸 28→35 套、layer-deps 基线 6→3（记录 reader 注入兑现）
- IEC104上行设计说明.md：遥测读数改工程量口径 + 死区额定 0.5% 重定
  已落地（卡 6）；§8 第 4 条改写、变更记录追加行
- 采集与算法层设计说明.md：状态行/红线③/幅值门三处由「标定未实现」
  更新为「折算已落地、精度复核待卡 12 注入」
- App/log/soe_rec.h 类型注释表补 7/8 两行（lane-a 口误 6/7 已勘误，
  真值按枚举链 SAMPLE_RESUME=6 连续计数）
- test/host/soe/decode_soe.py：TYPE_NAMES + docstring 补 7/8——
  否则台架 FTP 下载校验会把标定闭锁记录判 bad type 误红（隐藏消费边）；
  soe 套件 32/32 复跑绿
 2026-10-25 05:55:00 +08:00
wandering1 54dd019950 chore(size): sync 追平后重盖体积同码凭证（v2 索引指纹，1396 文件） 
sync 合并（a281231）之后按 lead 的六步做重盖。合并带进来的主干凭证是 v1 格式
（383b450 用主干那版脚本盖的，schema=1），而本分支的 check_size_gate.py 已是
schema=2（7c4628b：身份取 git 索引 blob，跨 checkout / 跨工作树稳定）→ 不重盖则
L0c 与 CI 的体积门禁都会按设计报"schema 不符"。

盖戳前置（脚本自己会验，这里是实跑结果）：
- 产品态 @build 0 错误 0 警告：Code=215744 RO=21396 RW=1224 ZI=131984，与 lead 信号
  里的主干数字逐项相同；.map 晚于指纹范围内全部源码 mtime；
- 受管区：RW_IRAM1 75,784 B / 57.82%、RW_CCM 57,376 B / 87.89%，都在线内（阈值 92%）；
- 指纹范围内无未 staged 改动/未跟踪文件（第四道前置）→ 允许盖章。

凭证：索引指纹 abfd54b71de9…，1396 个文件（比追平前多 8 个：新增 adc_cal /
prot_dim 等受管源码），测量时刻 2026-10-25T05:51:46+08:00，git_head=a281231 侧。
复核：--local rc=0、--ci rc=0（CI 侧按凭证数字复核红线，无需 Keil）。

为什么用 --stamp 而不是 --update：--update 会顺手往 scripts/ram_baseline.tsv 追加一行
当日趋势数据，而台账行归 lead 在 done 时统一回填（今天 383b450 刚回填过一笔，
再追加就是同日重复行）。这里只需要凭证，所以单独盖戳，tsv 一个字节没动。

RAM 增量：0 B（凭证是 JSON，不进固件；本次产品构建数字与主干逐项相同）。
gate：见本笔提交输出；未用 --no-verify。
 2026-10-25 05:53:05 +08:00
wandering1 d07a9a4d67 docs(P1-10): sync 追平后补记四档复测数字（产品基线已前进，旧注保留） 
sync 到 59da40b / 891ca81 之后重测四档 CH395F 配置（全部 0 错误 0 警告、链接通过）：
  默认 11/14   Code=219,112  RW_IRAM1 78,072 B 59.6%   距 92% 线 42,514 B
  NET 全开     Code=220,636  RW_IRAM1 85,688 B 65.4%   距线 34,898 B
  HW 全开      Code=230,900  RW_IRAM1 91,088 B 69.5%   距线 29,498 B（最坏态）
  HW 无 PC     Code=216,888  RW_IRAM1 78,808 B 60.1%   距线 41,778 B
产品基线同期前进到 Code=215,744 / RO=21,396 / RW=1,224 / ZI=131,984，RW_IRAM1
75,784 B / 57.82%（与 lead 信号里给的主干数字逐项相同）。04 点那组旧记录按"历史
不追改"原则留着，只标注基线已前进；两组差值都在 +136~+152 B，来自新增 adc_cal 的
数据段，所以**结论不变**：最坏态仍余约 29 KB，不需要把 scatter 扩到 192 KB。
PHASE5 三块静态缓冲依旧在链上（hw_full 的 ch395f_test_task.o 数据段仍 12,285 B）。

四档复测都走**朴素行注释切换**（改宏 = 行首加/去 //），顺带二次确认 16917bf 修
的开关行注释陷阱没有复发。跑完 test_config.h 与 ch395f_test.h 均按字节还原，
产品固件重建后回到基线数字。

RAM 增量：0 B（纯注释）。gate：test-cppcheck / id-check / no-mojibake /
trailing-whitespace / end-of-file-fixer / doc-links / mem-budget 全 0；
未用 --no-verify。
 2026-10-25 05:50:45 +08:00
wandering1 a28123115d merge: v2-on-ui 追平至 task/P1-10-test-fw（含 A-3 卡5~7 与 B-3 记录 reader） 
按 lead 信号 sync 追平：主干 59da40b（cal-lockout-dim）+ 891ca81（UI-rec-reader）+
383b450（台账与凭证回填）合入本任务分支，为下一轮台架做准备（台架镜像必须建立在
追平后的代码上，否则烧进去的 hex 与主干不同码，体积门禁的凭证也对不上）。

唯一冲突：scripts/size_attestation.json —— **取主干侧**（383b450 刚按合并后的固件重盖
过，数字更新；本分支侧是 7c4628b 的 v2 格式戳，覆盖的是追平前的树）。取完即
`git add` 解决，没有手工拼接。**已知副作用**：主干那份是 v1 格式（schema=1），而本
分支的 check_size_gate.py 已升到 schema=2 → 在下一步 `ram_baseline.py --update` 重盖
之前，ci_local 的 L0c 会按设计报"凭证 schema 不符"。这不是回归，是合并两侧脚本版本
差一步，下面第 4 步就把它治好（也正是要请 lead 合这笔的原因：合完主干两边同版）。

合并后产品构建（实跑，非推演）：@build 0 错误 0 警告，
Code=215744 RO=21396 RW=1224 ZI=131984 —— 与 lead 在信号里给的主干数字**逐项相同**；
RW_IRAM1=75,784 B / 57.82%（追平前 75,632 B / 57.70%，+152 B 与"两笔合计 +152B"吻合）、
RW_CCM=57,376 B / 87.89% 未动、ER_IROM1 22.62%。说明本树固件内容已与主干同码。

本分支带来的（前四笔已在分支上，这里只登记合并面）：
- 7c4628b 体积凭证指纹改索引 blob；16917bf CH395F 三档实测 + 阶段开关注释陷阱；
- adabb6a 主机单测/覆盖率产物按工作树分家 + runs 独占（task-10）；
- a9ba8ec 看门狗 HW 层掩码死分支复活（App/util，lead 背书写域）+ 存活基线 --write；
- 5f1057a 套件 forbidden 换显式四 Fault 标签（GD5F 旧豁免的漏口一并堵上）。
与主干侧的文件交集只有 size_attestation.json 一处，已按上解决；.pre-commit-config.yaml
本轮是主干侧改的（道A 加了钩子相关条目），本分支没碰它，无并集冲突。

gate：本笔合并提交走完整 pre-commit（含 16 根单测钩子与 test-coverage 全量覆盖率
基线比对）；未用 --no-verify。
 2026-10-25 05:41:49 +08:00
wandering1 5f1057ac74 test(P1-10): 套件回归 forbidden 换成显式四 Fault 标签 + 台架记录 21/21 
台架第一轮（boot log 20261025_050539）判 VERDICT FAIL，命中 469 条 [ERR]，两类：
  1) [ERR][CH395] ch395f P2 boundary fault @get_state sn —— **设计内**：Phase 15 的
     sn 越界负向用例故意命中驱动守卫（Drivers/BSP/CH395F/ch395f.c 的
     ch395f_p2_fault_note()：首次 DBG_ERROR、之后只计数），用例本身 PASS；
  2) [ERR][WD] task stall ×468 —— **设计外**，已在 a9ba8ec 单独修（掩码死分支），
     不用豁免去掩盖它。
本笔只管判据：套件回归这条路要豁免的是"设计内守卫 [ERR]"，不是崩溃。

为什么不能只是把 [ERR] 从 forbidden 里删掉（核过 verify_log 源码与固件崩溃行）：
四种 Fault 的崩溃行是 [ERR] HARDFAULT / MEMFAULT / BUSFAULT / USAGEFAULT
（Src/stm32f4xx_it.c 的 hard_fault_report 先打 "[ERR] " 再打标签），而 verify_log 的
forbidden 是**大小写不敏感的子串匹配**（fl in ln.lower()）→ 默认集合
HardFault;assert;[ERR] 里的 HardFault 只兜得住硬Fault，**MEM/BUS/USAGE 三种平时
完全靠 [ERR] 兜**。据此：
- 新增 FORBIDDEN_SUITE =
  HardFault;MEMFAULT;BUSFAULT;USAGEFAULT;assert;bring-up FAIL
- CH395F 用它（原来吃默认值，含 [ERR]）；
- GD5F 也用它——旧值 "HardFault;assert" 正是上面那个漏法（当初只为豁免
  TC-GD5F-704 的设计内 [ERR] 就把整条 [ERR] 摘了，等于顺手放走了三种 Fault），
  现在既保留豁免意图，又把崩溃判定补齐；
- STORAGE / RTC 不动（它们没有设计内 [ERR]，继续吃含 [ERR] 的默认判据）。
边界写死在注释里：产品 @test 的判据（.serialtest/config.json 的 forbidden 含 [ERR]）
**一个字节没动**，豁免只活在"套件回归"这条路上，渗不回产品路径。

test/board/ch395f_test.h：
- Phase 15 汇总实测 21/21（旧注释写"台架 20/20 PASS"是历史记录，已按本轮改正）；
- 记一条台架档案：镜像 ch395f_hw_nopc_v2.hex 单次开机跑完 1/12/15，汇总行
  9/9、1/1、21/21，failed=0，全程无 Fault；并记下同轮暴露的掩码死分支结论与它的
  证据位置，后来人切阶段时不必再踩一遍。

验证：
- py_compile 通过；test/run_all_suites.py --check-build --suites CH395F 走**官方编排**
  实跑 PASS（BUILD_OK 0 错 0 警，Code=217468 RO=21452 RW=1268 ZI=134076），脚本自己
  还原 test_config.h 并重建产品固件；这个 Code 与上一笔实测表里"默认阶段 11/14"一行
  逐项相同 → 两个独立工具互证同一组数字。
- gate：id-check / no-mojibake / trailing-whitespace / end-of-file-fixer /
  doc-links / cppcheck(test/) / test-suite-switch（产品态 Skipped）全 0；
  未用 --no-verify。
- RAM/Flash 增量：0 B（Python 与注释，不进固件；test/board/*.h 的注释不改代码）。

下一轮台架等 lead：f2 镜像我会在 sync 到 A-3/B-3 之后重编（现在这份
ci-artifacts/p110_fw/ch395f_hw_nopc_f2.hex 戳 05:23:03，若中途主干动过固件就要重编），
判据用上面的 FORBIDDEN_SUITE；请顺手带回两个数：[ERR][WD] 总条数、mask 含 bit4(ui)
缺位的条数。
 2026-10-25 05:36:25 +08:00
wandering1 383b4500d0 chore(ledger): UI-rec 与 cal-lockout 两笔合入后回填台账与凭证 
task/UI-rec-reader（merge 891ca81）：reader 注入 Code +104/RO +8/
RW +4/ZI +4；task/cal-lockout-dim（merge 59da40b）：卡5 闭锁 +
卡6 三常数 + 卡7 prot_dim 套件，Code +200/RO +80（vs 含 UI-rec 的
前一构建）。合并后 @build 0/0：Code=215,744 / RO=21,396 /
RW=1,224 / ZI=131,984；RW_IRAM1 75,784 B (57.8%)、CCM 57,376 B
(87.9%)——两笔合计 RAM +152 B，远低于 92% 红线。
覆盖率 35/35 套件基线同步；凭证按 .map 重盖（L0c 恢复序列）。
道A M4 代码面与道B 批 1 三卡至此全部落地。
 2026-10-25 05:32:46 +08:00
wandering1 a9ba8ec745 fix(WD): HW 测试模式掩码死分支复活——include 缺失自 7feeea6 
结论先说：wd_required_mask() 里那条"硬件层测试构建剔除 netTask"的分支，自它被写进
仓库那天起**从未生效过**——不是逻辑错，是本编译单元根本看不见判据宏。台架一轮
（2026-10-25，boot log 20261025_050539）把它照出来了：
  - 468 条 [ERR][WD] task stall 里，**431 条是 mask=0x1F5 / req=0x1F7**；
  - 0x1F5 恰好等于那条死分支本该要求的集合（default|ftp|ui|timesync|adc|iec104|
    protect，NET 位不在内）——该动的任务全动了，只是"要求方"看不见自己的例外，
    于是按产品掩码 0x1F7 追 netTask 的心跳位；而 netTask 在 ENABLE_HW_LAYER_TESTS
    下按设计入口自挂起（CH395F 归 testTask 独占），永远追不到。
根因：ENABLE_HW_LAYER_TESTS 定义在 test/board/ch395f_test.h（经 test_config.h 拉入），
而本文件没有 include 任何一条通往它的路径 → #if defined(...) 在本 TU 恒为假 → 死代码。
同一个需求早有既有做法：App/task/net_task.c:39 就为这个宏 include 了 test_config.h，
注释还写着"产品构建全未定义，无作用"——本文件只是漏了这一步。

修法：补 #include "test_config.h"，并把根因与 req/mask 证据写在包含点上方（同一事实
不另开文档；销项时 docs 引这里）。写域扩到 App/util 由 lead 背书（看板 task-9）。

零产品影响（实测，不是推演）：
- 产品态（TEST_SUITE_* 全注释、宏未定义 → 走原分支）@build 0 错误 0 警告，
  Code/RO/RW/ZI = 214104 / 20388 / 1204 / 131852，与主干 2026-10-25 台账逐项相同。
- 测试态 hw_nopc 尺寸也与修复前逐项相同：改的只是"选哪个常量"，没有新代码路径。
- 修复后净效果（下一轮台架复核）：431 条 net 类 stall 消失，剩下的是 uiTask 间歇
  缺位的 37 条（0x1E7 / 0x1E5）——那是另一件事，不在本提交里掩盖。

顺手记两条**没在本提交改**的发现（判据语义，归 lead 裁）：
1) 抽样判定是**精确匹配**（注释自述："掩码必须恰等于会置位的任务集合"）。而 netTask
   自挂起前会喂一次位 → 那一瞬间 mask=0x1F7 又不等于剔除后的 0x1F5 → 照样报 stall。
   即"从掩码里剔一位"与"精确匹配"天然打架；要不要放宽成"观测 ⊇ 要求即可"值得单定。
2) 本轮 miss 一路涨到 1971 而**没有停喂、没有复位**：说明"连续未达标即停喂"的阈值
   路径在 HW 层测试构建里未被触发（或 IWDG 尚未启动）。这条对产品侧更重要，值得单查。

随附 .cubemx_survival_baseline.json：本文件在存活审计里是 kind="generated" 的整文件
哈希项 watchdog-module（"非 CubeMX 管辖，但须确认未被误删"），有意改动按脚本自述用
--write 重建基线。**先证明漂移 100% 来自本笔**：把我的 include 临时撤掉再跑
--check → rc=0（基线与 HEAD 逐项相符），因此不存在"别人早就改了没登记"的情况。
--write 顺带补出一条**基线里原本缺失**的条目 net-msgq-adopt（Src/freertos.c 的
RTOS_QUEUES 区，须含 net_msg_queue_adopt）：它此前不在基线里 → --check 一直在静默
跳过这一项。本笔把它一并登记，属于意外收获，不是本笔的目的。

gate：cppcheck / coding-standard / bsp-err / id-check / no-mojibake /
trailing-whitespace / end-of-file-fixer / mem-numbers / mem-budget /
cubemx-survival（已 --write 重建基线）全 0；
未用 --no-verify。
 2026-10-25 05:32:24 +08:00
wandering1 59da40bb4a merge: task/cal-lockout-dim 合入 v2-on-ui 
任务 cal-lockout（1 个提交）经 task-worktree 回收：
- feat(保护标定): 卡5 未标定闭锁 + 卡6 下游三常数重定 + 卡7 量纲回归单测
 2026-10-25 05:28:05 +08:00
wandering1 891ca81995 merge: task/UI-rec-reader 合入 v2-on-ui 
任务 UI-rec（1 个提交）经 task-worktree 回收：
- refactor(UI): 记录页改注入式 reader，layer-deps 基线 6->3(道B task-6)
 2026-10-25 05:22:31 +08:00
wandering1 ffd462ef3c feat(保护标定): 卡5 未标定闭锁 + 卡6 下游三常数重定 + 卡7 量纲回归单测 
卡 5（protect_task.c 第⑤闭锁源，「数据可信」§4.3 决策 1=闭锁）：
- UA/UN/IA 的 adc_cal VALID 未全置位 → prot_elm_init + 本拍不 eval；每拍现查
  flags、无自有状态（卡 12 标定写入后自动解锁）；判据链优先级 = 采样可信在前、
  标定可用在后（数据都是旧的谈不上标定）
- 边沿日志用 DBG_INFO 而非 [ERR]：未标定是出厂常态、非故障，且 @test 禁用
  [ERR]（「默认构建保护不动作 = 期望」的台架判据同步项已在 MR 报 lead）；
  SOE 分型 SOE_T_CAL_BLOCK/RESUME（soe_rec.h 枚举尾追加，值 6/7——reader 侧
  显示标签映射归道B reader，MR 已报）
- 台架旁路 = 编译期宏 DTU_BENCH（§4.3：不进 cfg 不进 104；本仓所有提交目标
  都不定义它 = 产品恒强制闭锁）

卡 6（下游三常数按工程量重定，依据同源 docs/任务规划/数据可信.md §2.3）：
- FREQ_AMP_MIN（freq.h）：语义从拟定码值域重定为二次值 V——50 V = 0.5×Un
  （标称 100 V），断保险/PT 空载/浮空必低于之；数值沿用 50.0f 属巧合并在
  注释明写；eng=0 过渡期本门恒失效 → OF/UF 按必不启动填充，与卡 5 同向安全
- k_yc[].deadband（iec104_pts.c）：9 点按「额定 0.5 %」规则重定：电压类
  0.5 %×100 V=0.5、电流类 0.5 %×1 A=0.005、频率维持 0.5 Hz 绝对值（非额定
  比，卡 10 运行参数化）；标称基准与 prot_set 头部同源，防两处真相
- g_prot_set_meta[]（prot_set.c）：数值/范围复核结论=不动（0~4×标称自洽），
  文件头补量纲口径块：A/V = 二次值、标称 100 V/1 A、OV120=1.2Un/UV20=.2Un/
  3U0 15=.15Un、OC1/2/3=10/5/2×Ir、OL=1.0×Ir；PS_ID_COUNT/blob VER 未动
- iec104 套件 TC-008 死区用例同步重定标（100.4 带内 / 101.25 越带），97/97

卡 7（test/host/prot_dim 新套件，真实链 adc_cal→ring→phasor→prot_elm）：
- 用例从 ADC 码值出发、显式写出 code↔二次值互逆换算（dim_code vs apply），
  折算点被旁路或量纲再错位断言立刻翻转（M4 判据⑥「不该动作时不动作」）
- 合成 ROM 覆写（#undef K_Q16 宏）模拟卡 12 标定后板级口径，走 adc_cal_set
  正规路径置 VALID；b=-30 码全链对消进 rms 断言
- 38/38：基线静默（含 OL 低定值陷阱）、反错配对照（raw 码值灌环复现历史事故
  必假动作 vs 经折算必静默）、OC1/2/3+OL+OV+UV+3U0 七类逐一：越限定值→
  受控启动拍→dly-2 不动作/+5 动作→返回系数带内保持→跌破释放、双件聚合位图
  独立性（撤 IA 只回 OC1）

测试与注册：prot-dim-unit-test 钩子 + TC-HOST-PROTDIM 族（游标 010，B 层口径
同 ADCHEALTH/ADCCAL 先例）；无新 MCU 源文件（uvprojx/SIM_EXEMPT 零改动）

gate：@build 0 错 0 警（Code=215640 RO=21388 RW=1220 ZI=131980 vs 基线
215440/19780/1220/131980 → Flash +1808 B、RAM 零增量）；protectTask 静态最坏
链 872 B/margin 1176 B（57%）PASS，adcTask 不变；staged 门禁除 mem-numbers/
mem-budget（台账漂移，回填归 lead）外全绿：
gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本轮未触碰带 BOM 文件）
 2026-10-25 05:22:17 +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 adabb6af12 fix(test): 主机单测/覆盖率产物按工作树分家 + 每次跑独占目录（task-10） 
现象（2026-10-25 三条道并行开发实测，看板 task-10）：全量 ci_local 的 L0 里
test-cppcheck / test-coverage 偶发 "files were modified by this hook"，单独重跑
即绿、工作树零改动。根因在 unit_test_harness：obj/exe 直接落在**全机共用**的
%TEMP%，名字由套件名派生（%TEMP%\net_socket_tests.exe、%TEMP%\net_socket_obj），
多棵工作树并行跑同名套件必然互踩。

真正要命的不是编不过，而是**结论张冠李戴**：A 树编译完，B 树把同名 exe 又盖一
遍，A 树随后 subprocess 执行的是 B 树编出来的二进制——两棵树的 summary_marker
一模一样，harness 分辨不出来，于是拿别人的运行结果给自己判 PASS。这种失败不会
变红，只会静默给出错误结论，比红难查一个量级。

修法（不是加锁）：
- 产物根按**工作树**分家：%TEMP%\dtu_host\<仓库根路径 sha1 前 10 位>\。树身份取
  harness 文件自身位置（test/host/common 往上三级），不依赖 cwd/环境变量；工作树
  之间只联接 .venv 与模拟器 SDK，test/host 每棵树各有一份，所以这个身份可靠。
- **每次运行再独占一个子目录** runs\<pid>-<纳秒>\，obj 与 exe 都放进去，跑完
  finally 删（含 Ctrl-C 路径）。这一步顺带把"同树并发同名套件"也消灭了：两个
  进程既拿不到同一个 exe，也拿不到同一个 .obj（实测共享根时并发会因 obj 撞名
  直接编不过，返回 rc=2）。没有牺牲缓存：每个测试单元就一个 .c，cl 每次整体重编，
  "共享 obj 省编译"本来就是错觉。**不加锁**：这里没有需要互斥的独占资源，只是
  名字撞了；加锁等于把 L0.5 变成 build/bench 那样的全局串行。
- 独占目录里留 <exe>.owner.json（suite / repo_root / pid / started）：需要证明"这
  份产物属于哪棵树哪次跑"时有的可查，不必靠时间戳猜。
- 编译返回 0 但产物不存在 → 明确报环境错误，绝不跑来路不明的二进制。
- 两个开关：DTU_HOST_BUILD 改产物根（CI/容器固定路径），DTU_HOST_BUILD_KEEP=1
  保留本次目录（要单步调试 exe 时用）。判据单一事实源 = host_build_root()。
- scripts/check_test_coverage.py 同源改造：work_root 由固定共享名 dtu_test_cov 改为
  复用 harness 的 host_build_root()/coverage，并同步 --work-dir 帮助文案与 docstring
  （docs 里"并行期每人只跑 --module 自己模块"那条规避就此作废，它是为绕开旧共享名
  而写的）。顺带删掉因此不再使用的 import tempfile。

附带修一处同族不诚实（做本任务时从自己的输出里发现）：ci_local 的收尾那行以前
无条件打印"L0 + L0b + L0c + L0.5 全部通过"，--l05-only 时等于把没跑过的段宣布
为通过——正是 A-5 那个"SKIP 冒充 PASS"的镜像版。改为只列本次真正跑过的段。

自证（都是实跑，不是推演）：
- 两棵树身份并发跑同一套件：把修好的 harness 复制成 A/B 两个树身份（repo_root 不
  同 → 两个不同产物根），套件 BUILD 从真仓库加载，各跑 4 轮并发 → 8/8 rc=0，
  两侧 roots 分别是 …\55deb98e3b 与 …\902100bc41，互不可见。
- 敌意场景：把两边 DTU_HOST_BUILD 强行指到同一目录（旧写法必撞 exe/obj）→ 8/8
  rc=0，共享根下只剩一个空的 runs/。同树并发同理被这一条覆盖。
- 单套：test/host/sha256 rc=0（13/13），产物确实落在 …\4b9166f602\runs\<pid>-…；
  覆盖率 --module sha256 rc=0（line=111/114 func=7/7），落在 …\coverage\sha256。
- 全量：ci_local --l05-only → 33 runner(s)，2276/2276 assertions passed，fail=0。
- 临时目录与 scratch 已清理（脚本在仓库外，不入库；ci-artifacts/ 之外无残留）。

文档：test/host/common/README.md 新增"产物目录归属"一节（落点结构、为什么按树、
为什么每次独占、两个开关、一行命令查当前树的产物根）；harness 顶部注释是判据正文。
docs 侧两处按分工归 lead 在 done 时统一改，合并请求里已给可直接粘贴的替换文本：
docs/测试说明/主机单测覆盖率口径.md 的产物目录条与"坑 12"、以及并行任务工作树
方案.md 的产物归属条。AGENTS.md 与 docs/** 本次一个字节没动。

RAM/Flash 增量：0 B（纯测试工具链，不进固件）。gate：见提交钩子输出，未用 --no-verify。
遗留：tools/font_gen/make_font.py 同样用固定共享名（%TEMP%\simsun_regular.ttf、
font_extra_<cp>.c）——同一类跨树竞态，但属道B 字体域，我没动，建议另开一张卡。
 2026-10-25 05:13:14 +08:00
wandering1 16917bf165 test(P1-10): CH395F 套件三档构建实测 + 修阶段开关行尾跨行注释的切换陷阱 
P1-10 剩余①「CH395F 套件实际构建确认链接通过」今天才真正有数：产品基线 + 三档
测试配置（ARMCC，全部 0 错误 0 警告；.sct 保持 128 KB 未动，符合 P1-10 写的
"不建议扩到 192KB"）：

  配置（TEST_SUITE_CH395F + 阶段）    Code      ZI      RW_IRAM1      距 92% 余量
  产品基线（阶段全关）                214,104   131,852   75,632 57.7%   44,954 B
  默认阶段 11/14（只切套件宏）        217,468   134,076   77,920 59.5%   42,666 B
  NET 层全开 6~11/13/14              218,992   141,688   85,552 65.3%   35,034 B
  HW  层全开 1~5/12/15（最坏态）      229,256   147,176   90,952 69.4%   29,634 B
  HW  层无需 PC 1/12/15（冒烟用）     215,244   134,896   78,672 60.0%   41,914 B

P1-10  specifically 关心的 PHASE5 三块静态缓冲（3 x PHASE5_CHUNK_SIZE = 3 x 4093）
确实进了链接，不是"理论上会在"：hw_full 的 ch395f_test_task.o 数据段 = 12,285 B
（12,279 + 该 TU 其余 6 B）。于是"理论余量足够但未实测"改成了实测：最坏态仍余
29,634 B（RW_IRAM1 上限 131,072 B，92% 线 120,586 B）。RW_CCM 四档恒为 57,376 B /
87.9%——测试代码不进 CCM，但该区已经贴着红线，将来往 CCM 加东西要单独核算。

顺手修掉一个把实测挡了三年的坑（就是它让第一轮 hw 配置炸掉的）：
ENABLE_PHASE11/14 两行的说明是**挂在行尾的跨行块注释**。而"关掉一个阶段"的标准动
作是在行首加 //，// 只注释到行尾 → 块注释从第二行起变成裸代码，实测 188 条
error #7: unrecognized token，报点落在注释续行上，看着像头文件坏了、其实只是注释
被腰斩。run_all_suites.py 的 _rewrite_config 只改 TEST_SUITE_* 行（那些行没有行尾
跨行注释）所以一直没暴露；ch395f_test.h 恰是"人手工切阶段"的入口，必须自身安全。
修法：把两段说明挪到 #define 行的上一段，行尾只留同行闭合的短注释；并在开关区后面
写清"开关行注释规范"+ 上面这张实测表（同一事实只在这一处，销项时文档引它）。

验证（_wt/P1-10-test-fw，每步都实跑 @build）：
- V1 产品态（改注释后）：0/0，Code/RO/RW/ZI = 214104/20388/1204/131852，与主干
  2026-10-25 台账行逐项相同 → 本改动零体积增量。
- V2 只切套件宏（默认阶段 11/14）：0/0，RW_IRAM1 77,920 B / 59.5%。
- V3 **朴素行注释切换**（正是炸掉第一轮的那个动作）改到 HW 1/12/15：0/0，且尺寸与
  用 #undef/#define 覆盖法得到的 hw_nopc 逐字节相同（215244/23656/1200/134896）
  → 陷阱确认已消除，两条改法等价。
- V4 还原后产品重建：0/0，数字回到基线；test_config.h 与 ch395f_test.h 均按字节还原
  （git status 只剩本文件这一处改动，测试宏没有留在树里，test-suite-switch 无需放行）。
- 产物身份戳实测：hw_nopc = "Oct 25 2026 04:32:16 suite=CH395F dstr=off"、产品态 =
  "Oct 25 2026 04:32:25 suite=NONE dstr=off" → dstr=off 三档一致，破坏性开关全程关。

RAM 增量：0 B。gate：改动只命中 no-mojibake / trailing-whitespace / end-of-file-fixer /
check-added-large-files / id-check / mem-budget，全部 0；未用 --no-verify。

P1-10 剩余②（@test 烧录抓日志）需要 bench 锁，已把镜像与锚点清单交给 lead 执行；
真机跑 Phase 2~5 / 8 / 11 / 13 / 14 需 PC 端 tcp_server / peer 配合（Phase 11 还要
制造死对端，E11），属"实际测量采样"类，按用户指示本轮跳过，不在本提交声称做过。
 2026-10-25 04:49:19 +08:00
wandering1 317e04219d chore(ledger): UI-widgets 合入后重盖凭证并登记覆盖率分母 
task/UI-widgets 合入（merge c1b425d，3 对组件文件 + 双端注册）。
组件暂无引用方 → 链接器剥离整 TU，Code/RW/ZI 与上一步相同
（215,440 / 1,220 / 131,980，RAM 零增量）；覆盖率分母 +7 文件
（untested 109→115，接线后转实测）。凭证按 @build 0/0 后 .map 重盖。
 2026-10-25 04:42:33 +08:00
wandering1 d89c07c40c chore(ledger): UI-widgets 合入后重盖凭证并登记覆盖率分母 
task/UI-widgets 合入（merge c1b425d，3 对组件文件 + 双端注册）。
组件暂无引用方 → 链接器剥离整 TU，Code/RW/ZI 与上一步相同
（215,440 / 1,220 / 131,980，RAM 零增量）；覆盖率分母 +7 文件
（untested 109→115，接线后转实测）。凭证按 @build 0/0 后 .map 重盖。
 2026-10-25 04:40:53 +08:00
wandering1 c1b425dc53 merge: task/UI-widgets 合入 v2-on-ui 
任务 UI（1 个提交）经 task-worktree 回收：
- feat(UI组件): 新增数值编辑器/定值表/动作确认页三组件(道B task-5)
 2026-10-25 04:36:52 +08:00
wandering1 f711130b4c feat(UI组件): 新增数值编辑器/定值表/动作确认页三组件(道B task-5) 
域5 新增 3 对文件(双端注册 uvprojx + CMakeLists)，只做渲染与输入抽象、
不接真实数据源(数据绑定 = 批 2 道E ui_data/prot_set 经回调注入)：
- ui_w_editor：定点整数(10^decimals)逐位编辑——上下步进(0..9 环绕无进位)、
  左右移数字光标(首末环绕)、ENTER 提交经 min/max 范围校验，越界拒绝并
  显示"越界"提示留在编辑态；光标反显盒与 ui_page_net_cfg 字节光标同画法
  (含"只画单字符防折行"实测坑注释)；共享格式化 ui_w_editor_fmt_scaled()
  单一规则源(值列显示与编辑光标恒同串)
- ui_w_setlist：定值四视图(参数/定值/控制字/软压板)共用列表渲染 +
  整定输入——行表(名称<=7字/id/类型/小数位/范围/二态串表) + 回调注入
  (get/set/commit/state/bad)；查看视图(commit=NULL)与整定视图只差绑定：
  整定视图末行固定"保存"行，值随交接态 ENTER/WAIT/OK/ERR(net_cfg 先例)，
  整表一次提交(一次封存一次校验和，页面补齐规划 §3.2)；二态行 ENTER
  循环切换；保存失败越界行经 bad 回调反显(页面扩充详细方案 §3.2.7)
- ui_page_action：可复用操作确认链——一次确认 -> 二次确认 -> ok_cb
  只投递不阻塞 -> done_text 回报(或成功即关页)，拒收显示 ERR 可重试；
  ESC/LEFT 关页取消(实测取消后菜单与基线逐字节一致)；单例描述符由
  开页装载(内容页框架全局单页前提)，不定义 ui_page_action_desc
  (registration-check 页面模块判据不误拦，批 2 跳板各自出口)

组件文案用字全部落在上一分支预置字集内(font-charset WARN 60->52 印证
确/取/消/越/二/次/返/回 已转源码在用)，无需再动字库。

BSP 公开 API 约定合规(首提被 cppcheck/coding-standard/bsp-err 三钩拦下,
按门禁口径修净后复验全绿)：
- 键分发返回值取 uint8_t 1/0 不用 bool(bsp-err/err-type：bool 只许
  is_/has_ 谓词)；ui_w_editor_value 直返 int32_t(出参形状无错误通道)
- ui_page_action_open 返回 bsp_err_t：BSP_ERR_PARAM 参数无效 /
  BSP_ERR_STATE 已有页打开 / BSP_ERR_NO_SPACE 框架开页失败(可判分支)
- get/state/bad 回调 typedef 各补"返回值："注释块(bsp-err/return-doc)
- cppcheck variableScope 变量收scope 7 处；CODE-RULE-18 Yoda 1 处
  (sel+1u==total -> sel==count)；提交内已不含 --wdemo/--wact harness

验证：
- 模拟器零警告；组件行为经临时 sim-only harness(--wdemo/--wact) 截图
  目检 7 态：基线视图/bad 反显/进编辑步进/越界拒绝/二态切换/保存整表
  提交 OK/确认链三段/取消回菜单；harness(main.c 4 处 + CMake 1 行 +
  ui_w_demo.c)已完整还原删除，提交内不含(最终树 main.c 无改动，
  CMakeLists diff 仅 3 行注册)
- 回归：菜单 8 状态 + 内容页 11 页黄金参考逐字节 PASS(ref 无变化，
  无基线更新提交)；池基线 5368/往返 5448 不变
- 门禁：coding-standard PASS / font-charset PASS / layer-deps PASS
  (新文件零 App include，基线 6 不变——减基线归 task-6)
- @build 0 Error 0 Warning；Code +324 B、RO/RW/ZI 0(组件尚无引用方，
  ARM 链接器未剥离仅因新 TU；批 2 页面接线后实例 RAM 每页约 +40~60 B)

gate: 全钩子正常执行通过，无 --no-verify
- pre-commit run --all-files 全绿(含 mem-budget/mem-numbers：本分支基于
  回填后台账 d9ab955，RAM 0 变化、RO 不变，仅 Code +324 B 不涉受管区)
- 手工自查：6 新文件 BOM=EF BB BF 齐全、全 LF、U+FFFD=0、字面量仅
  UTF-8 中文(UI 带 BOM 先例口径：保存/越界/二次确认/告警/跳闸等，
  全部已在字体子集)；ASCII 串仅 ENTER/WAIT/OK/ERR 状态字
 2026-10-25 04:34:43 +08:00
wandering1 a5f7385cad chore(ledger): cal-adc 合入后回填 Flash/RAM/覆盖率台账并重盖凭证 
task/cal-adc-cal 合入（merge d39e5c9）：adc_cal 折算模块 + 系数落盘
+ L5-2 rail_watch。Code 214,104→215,440（+1,336 B）、RO 20,388→21,308
（+920 B）、RW 1,204→1,220（+16 B）、ZI 131,852→131,980（+128 B）。
RAM 增量 +144 B（IRAM1 57.8%、CCM 87.9%，远低于红线）；adcTask 栈
worst 1344 B / margin 47%。清 lane-a 分支侧 --no-verify 欠账。
覆盖率基线登记 adc_cal.c（118/119 行 99.2%）；体积凭证按 @build
0/0 后的 .map 重盖（L0c 恢复序列）。
 2026-10-25 04:28:52 +08:00
wandering1 d39e5c9ab5 merge: task/cal-adc-cal 合入 v2-on-ui 
任务 cal-adc（1 个提交）经 task-worktree 回收：
- feat(采集标定): 卡2 adc_cal 折算模块 + 卡4 系数落盘 + L5-2 码值贴轨检出
 2026-10-25 04:22:34 +08:00
wandering1 3528644e9d feat(采集标定): 卡2 adc_cal 折算模块 + 卡4 系数落盘 + L5-2 码值贴轨检出 
卡 2（App/algo/adc_cal.*，新增；adc_task.c:335 折算点收口）：
- 模型：工程量 =(code+b)×k（「数据可信」§4.1）；k 以 int32 Q16(µV/码×65536)
  落盘、b 以 int32 码值落盘；ROM 默认 = 卡 1 定死的引脚侧 LSB，Q16 下整除无
  舍入（TPAFE 10,000,000=152.587890625 µV/码；STM32 52,800,000=805.6640625）
- adc_task 每拍 frame[s] 改 adc_cal_apply()（现单位 = ADC 引脚电压 V，eng=0，
  二次值语义等 VALID）；TEMP 透传码值（决策 5）；不缓存 k_f 副本——逐点由
  RAM 现值派生（无回调设计下杜绝陈旧系数；18k flops/s 可忽略）
- 三态 flags（§4.2）：VALID = 文件位图 ∧ k 在合法带；CLIPPED 按来源运行期
  派生（V0.2/N-18 后自动恒 0）；消费者判可用性只查 adc_cal_flags()
- 合法带哨兵：k∉ROM×[0.5,2.0] 或 |b|>8192 → 折算回退 ROM + 每通道每开机
  一条 [ERR] + VALID 压制（位图说谎也兜住）——同时挡坏文件与坏标定
- 两点标定公式 adc_cal_two_point() 算术核齐备（int64、±舍入界、斜率/零点
  守卫 -1/-2 分档）；台架两点标定（卡 12）按用户指示未跑，留台架注入口径：
  心跳新增 cal: 行（ua/un/ia_mv 定点 + vl/cl/rail 位图，未标定 vl 应恒 0x00、
  cl 应恒 0xE6，注入饱和电平 rail 位应起）

卡 4（[adc_cal] k_ua..k_in+valid / [adc_cal_ofs] b_ua..b_in，§4.4 布局）：
- 两段注册进 cfg 引擎（data_size 33/32，不挂回调——RAM 副本即生效值）；
  adc_cal_init() 落 app_main_init 内核前（注册必须先于 defaultTask 的
  cfg_file_load；跨任务读走 4 字节对齐字，µs 级混窗为「数据可信」§4.4 明载
  设计）；文件缺失/损坏 = 引擎回退工厂默认 = ROM 表本体（默认即理论系数）
- adc_cal_set()：整定写入口（属主上下文），越带拒绝 RAM 不动
- 单测走真实 cfg_file 引擎集成：文件值生效 / 越界 k 哨兵兜住且不报 VALID /
  超长损坏文件回退默认且 flags 无 VALID（卡 4 DoD 原句）/ 段缺失默认

L5-2（adc_health v1.2，越界门限按 FS 百分比、码值域与标定正交）：
- adc_health_rail_watch()：连续 20 拍（=一周波）贴同侧轨带（TPAFE±98%半量程、
  STM32 顶 98%/底 2%，门限由 adc_cal_rail_ths 供）且此前见过中带释放沿才
  锁存——空载恒 0 / 开机恒 0 合法工况不误报（短板评测 §6.2 判据①）；
  adc_task 编排：边沿 DBG_ERROR + SYSLOG 每开机一次 + 心跳 rail/edge 位图
- 健康用例 60/60（+13）：释放沿/清零/交替/双侧/init 复位/越界通道守卫

测试与注册：新套件 test/host/adc_cal（89/89，8 通道×≥3 码点期望值由 LSB
常数独立推导、Q16 无舍入、set 边界含端点、两点还原合成 k/b 往返）；
编号形态返工一轮：TC-ADCCAL-00A~00D 改 014~017、注释 FS-1 字样改写、
id_registry 族 pattern 转义修正、族游标登至 017；coding-standard 返工：
公开实现函数补齐函数头注释块（CODE-RULE-09）
uvprojx 仅增 adc_cal.c 一条挂载（diff 已核零抖动）；SIM_EXEMPT/id_registry
(TC-HOST-ADCCAL 族)/adc-cal-unit-test 钩子行按 new-source-file 与 B 层口径
补齐；覆盖率 34/34 套件 89.6%，adc_cal.c 99.2%（baseline --update 属共享
台账文件，留 lead done 后统一回填）

gate：@build 0 错 0 警（Code=215440 RO=19780 RW=1220 ZI=131980）；
RAM 增量 +144 B（RW+16/ZI+128：贴轨 9×6B + 两段 RAM 副本，IRAM1 57.7%→
约 57.8%）；Flash +1336B/+920B RO。adcTask 栈 worst=1344B margin 1216B
(47%) PASS（stack_report 实测）。staged 门禁除 mem-numbers/mem-budget 外
全绿（该两条 = 台账漂移，回填 --write 落 docs/内存管理/** 单写者区，按
Lead 既定例外归 lead done 后处理）：
gate: only mem-budget/mem-numbers pending lead ledger backfill
BOM/CR/U+FFFD/字面量 ASCII 已逐文件自查（本次未触碰任何带 BOM 文件）
 2026-10-25 04:21:12 +08:00
wandering1 7c4628b043 fix(A5): 体积凭证指纹改取 git 索引 blob——跨 checkout 稳定，并拦未 staged 改动 
现象（道C-3 开工第一步就撞上，属于上一提交 e25e51c 引入的缺陷）：
_wt/P1-10-test-fw 里 check_size_gate --local 报"不同码"，而两棵树 git status 全干净、
HEAD 同为 e1967cf。定位：主工作树的受管源码里 **1046/1388 个文件落成 CRLF**，新建
工作树同一提交落成 **LF**（实测 Drivers/BSP/dbg_cfg.h：1293 B/CRLF vs 1247 B/LF），
但两者的**索引 blob 完全相同**（都是 c39395f7…）。根因是本仓 core.autocrlf=true 与
.gitattributes 的 eol=lf 并存——所以"工作树原始字节"根本不是跨 checkout 的稳定身份。
后果比红一次更糟：主树盖的凭证在**每一条道的平行工作树**里都会误红，runner 上同样
（checkout 出来的行尾取决于那台机器的配置）→ 门禁自己造 false positive。

修法（AGENTS「行尾不依赖 core.autocrlf」的机器化版本）：
- 指纹 = git **索引** blob：`git ls-files -s` 的 path+blob 逐行聚合哈希（v2），
  跨 checkout / 跨机器一致；凭证 schema 从 1 抬到 2，旧凭证直接判"不符、重新盖戳"，
  不做静默兼容（v1 凭证在别的树里必然误红，留着只会污染判读）。
- 新增第四道前置：**范围内有未 staged 改动/未跟踪文件时拒绝盖戳**——未 staged 的部分
  不在索引里，凭证会声称覆盖一份并不存在的代码。已 git add 的不算脏：索引已含其内容，
  正是"将要提交并被测量"的那一份。--local/--ci 同样把这类脏单独报出来。
- 新增守卫的机理性说明写在 index_snapshot() 上方与 docstring 的"指纹范围"节（唯一正文）。
- scripts/size_attestation.json：按 v2 重新盖戳（本树产品态实测 Code=214104 /
  RW=1204 / ZI=131852 / RW_IRAM1 75,632 B / RW_CCM 57,376 B，与主干 2026-10-25
  台账行同源）。

验证：
- 跨树一致性：_wt/P1-10-test-fw 与主工作树分别独立算索引指纹，结果都是
  bf6ec94a761e…（1388 文件）→ CROSS-TREE STABLE。
- --stamp / --local / --ci 三态均 rc=0；凭证与 tsv 末行互证同源（Code=214,104 B）。
- 负向：在 test/board/ 放一个未跟踪探针文件 → --local 与 --stamp 双双 rc=1 并点名该
  文件；删除后 --local 回到 rc=0（本树已确认干净，探针不留痕）。
- py_compile 通过；门禁实跑：no-mojibake / trailing-whitespace / end-of-file-fixer /
  check-added-large-files / id-check 全部 0。

RAM 增量：0 B（凭证与门禁脚本，不进固件）。gate：全过，未用 --no-verify。
⚠ 需要 lead 做一步：合入后主树跑一次 python scripts/check_size_gate.py --stamp
  （或 ram_baseline.py --update）把 v1 凭证换成 v2，否则主树的 L0c 会报 schema 不符。
 2026-10-25 04:18:32 +08:00
wandering1 e1967cf2ea chore(size): A5 合入后重盖体积同码凭证 
合并 task/A5-size-gate 后主干指纹前进（凭证停留在分支基线），
按门禁指引 @build 0/0 后 ram_baseline.py --update 重盖：
Code=214,104 / RO=20,388 / RW=1,204 / ZI=131,852（A5 零体积增量，
数字与 d9ab955 台账行一致）。
 2026-10-25 03:59:00 +08:00
wandering1 ba9450c50b merge: task/A5-size-gate 合入 v2-on-ui 
任务 A5（1 个提交）经 task-worktree 回收：
- ci(A-5): 体积门禁补强制路径——同码凭证 + CI 无需 Keil 复核 92% 红线
 2026-10-25 03:54:24 +08:00
wandering1 e25e51c378 ci(A-5): 体积门禁补强制路径——同码凭证 + CI 无需 Keil 复核 92% 红线 
背景：A-5 残余（docs/任务规划/测试与架构专项.md）说得很直白——mem-numbers 在
CI 被跳过（runner 无 Keil/无 .map），上一轮只把"跳过"声明成一条 ::warning::，
"盲区本身未消除"：看到 CI 全绿仍会以为体积也守住了。

复核时本地侧同样漏：ram_baseline.py --gate 在无 .map 时自适应 SKIP 且返回 0；
mem-budget 甚至没进 CI 的 SKIP 名单——它在 runner 上以"Passed"的面貌出现，实际
什么都没检查。两处共同点是**"没跑 = 通过"**。

做法：给体积数字配一条可提交、CI 可复核的**同码凭证**，而不是要求 runner 装 Keil。
- 新增 scripts/check_size_gate.py（口径与边界的唯一正文在其模块 docstring）
  · --stamp：只在三条都成立时才盖章——① .map 存在且解析得出执行区与 Grand
    Totals；② .map 不早于指纹范围内任何源码的 mtime；③ 受管区占比不超过
    mem-budget 用的同一常数。凭证因此不是随手可写的。
  · --local：工作树指纹必须等于凭证指纹，否则 FAIL（="改了代码但体积从没测过"）
  · --ci：不需要 Keil 也能判的两条——同码性 + 按凭证记录的数字复核 92% 红线
  · --show：排障用。指纹 = git ls-files 范围内逐文件 sha256(路径+内容) 再聚合，
    覆盖 App/ Drivers/ Src/ Inc/ Lib/ Middlewares/ test/board/ 与 MDK-ARM 的 .sct/.s
- 新增 scripts/size_attestation.json：本树的凭证（由本树一次真实 @build 盖戳）
- scripts/ram_baseline.py：--update 顺手盖戳——"每次 @build 后跑 --update"是既有
  纪律，不新增人工步骤；在函数内 import 防成环；盖戳失败只告警、不改 --update
  返回值（新鲜度由门禁自己 fail-closed 兜）。_util/_read_tsv 提为公开名
  region_pct / read_tsv_rows 供其复用（体积口径禁第二处定义）；--gate 的无 .map
  文案改成明说"SKIP 不等于 PASS"并指向兜底路径。
- scripts/ci_local.py：新增 L0c 体积门禁步（fail-closed、无条件照跑、约 0.3 s）
  与 --size-only 开关；docstring 里把"无 .map 时跳过两根钩子"的语义补全。
- .gitea/workflows/ci.yml：L0 作业末尾加「体积门禁」步（if: always()，无需 Keil）；
  主干 push 拦红、其余事件 --warn-only（分支上代码尚未定型，拦红只造噪音，还会
  诱发多条道同时抢写 scripts/ 台账）；SKIP 名单补 mem-budget，让它诚实显示
  Skipped 而不是假 Passed；文件头的"门禁盲区声明"改写为"已关闭为强制路径 +
  仍守不住的三项"。run: 块全部纯 ASCII（PS 5.1 无 BOM 按 GBK 解码的实测坑）。
- scripts/README.md：登记新脚本与凭证文件，补用法行。

验证（工作树 _wt/A5-size-gate，分支 task/A5-size-gate）
- @build 0 错 0 警：Code=213780 RO=18860 RW=1204 ZI=131852——与 ram_baseline.tsv
  的 2026-10-24 行逐项相同（本改动不碰固件源码，指纹不变，零体积增量）。
- 门禁实跑全 0：check-yaml / trailing-whitespace / end-of-file-fixer /
  check-added-large-files / no-mojibake / id-check / doc-links / mem-budget。
- 负向 8 例全过：改凭证指纹 → --local 与 --ci 都 rc=1；凭证占比改成 95% →
  --ci rc=1，加 --warn-only 则 rc=0；凭证写成非法 JSON → rc=1；用 mtime 回拨的
  .map 去 --stamp → 拒绝且不动凭证；把区 max 改小到必然超线再 --stamp → 同样拒绝。
- 正向：--stamp 之后 --local / --ci 均 rc=0，并与 tsv 末行互证同源。
- --update 的盖戳联动单独验（把 TSV_PATH 与凭证指到仓库内已 gitignore 的
  ci-artifacts/ 探针文件，跑完清理，本树台账未被测试污染）。
- ci_local 全量：L0.5 33 runner / 2227 断言全绿、gitlint 10/10、L0c rc=0。L0 里
  test-cppcheck 与 test-coverage 各报过一次"files were modified"——单独重跑两条
  均 rc=0 且工作树无改动，判定为三条道并行跑主机单测时 %TEMP% 里按套件名派生
  的 obj/exe 互相踩踏（harness 产物名全机共用一个 TEMP 目录），非本改动引入。

RAM 增量：0 B（未动固件源码，凭证数字与本树一次真实链接一致）。
gate：全部通过，未使用 --no-verify。

遗留 / 需要 lead 裁定
1. 合入后主干 push 会要求"同码测量"：done 流程在 @build 0/0 之后要多跑一条
   python scripts/ram_baseline.py --update，并把 scripts/size_attestation.json
   （数字变了则连 scripts/ram_baseline.tsv）一并提交。这就是"强制"的含义，但
   确实新增半步——若你想先只在本地强制（L0c），我把 CI 那步改成 --warn-only。
2. 文档口径同步我没做（docs/任务规划/**、docs/门禁说明/**、docs/CI/README.md
   归主树）：A-5 销项时建议把"CI 不守体积"改为"CI 守同码性 + 红线，绝对数字仍
   由本地真实构建产生"，正文引用 check_size_gate.py 的模块 docstring。
3. 编译器选项（uvprojx）刻意不进指纹：UV4 每次构建改写它且不入库，进指纹会让
   门禁在"刚刚构建完"的那一刻自己变红；代价是改优化等级/宏不触发本门禁，需人工
   重测——已写进边界正文。
 2026-10-25 03:51:19 +08:00
wandering1 d9ab9552c3 chore(mem): 回填 UI-font 合入后的 Flash 台账快照 
task/UI-font-subset 合入（RO-data 18,860→20,388 B，+1,528 B，
中文字库 119→179 字 / 274 字形所致；Code=214104、RW=1,204、
ZI=131,852 不变，RAM 零增量）。
done 后统一回填，清 lane-b 分支侧 --no-verify 欠账。
 2026-10-25 03:31:44 +08:00
wandering1 b802651a56 merge: task/UI-font-subset 合入 v2-on-ui 
任务 UI-font（2 个提交）经 task-worktree 回收：
- docs(UI设计): 字体字符集计数回填 179字/274字形并登记cmap首命中事故
- feat(UI字体): 扩字60字为页面扩充预置, 修复生成器cmap插入顺序缺陷
 2026-10-25 03:27:11 +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 2e0f66a07e feat(UI字体): 扩字60字为页面扩充预置, 修复生成器cmap插入顺序缺陷 
字库扩充(批2页面预置, task-4/道B):
- ui_cn_chars.txt 119→179 字(CJK 176 + 符号 ▶/，/：)，含 ASCII 共 274 字形
- +60 字: Ⅰ Ⅱ Ⅲ 段 延 投 退 跳 闸 零 频 荷 负 低 过 电 一 二 次 位 公
  出 回 外 部 度 温 态 状 总 接 显 示 最 近 未 标 欠 闭 锁 长 间 障 配
  道 重 载 返 年 月 分 秒 合 已 请 求 确 取 消 越
  依据 = 页面补齐规划/页面扩充详细方案两篇规划中出现的页面显示串；
  待拍板的厂家设置支用字(厂/家/恢/调/试)不入
- Ⅰ/Ⅱ/Ⅲ 宋体有字形(simsun face0 cmap 实测 HAS)且正常入字体，罗马数字
  无需任何工具链兜底

make_font.py 修复(本次扩字暴露的真缺陷):
- LVGL get_glyph_dsc_id() 线性扫描 cmaps[]、首个包含码位的 range 即返回:
  Ⅰ(U+2160) 使稀疏 range 起点 0x4E09→0x2160，把 U+25B6 ▶ 单码位补回条目
  吞进宽 range → 模拟器箭头全变方框(菜单 658 px 差异)；旧 verify_coverage
  按"进了任一 range 即覆盖"判定，全绿照不出解析路径倒置
- 修复: _insert_cmap_entry() 把补回条目插到包含它的 range 之前;
  _cmap_lookup_gid() 可达性守卫，可达即跳合并(全角逗号走稀疏列表，不再
  追加永远不可达的死条目); verify_coverage() 改按首命中语义

验证(全绿):
- font-regen 四步(extract→并回 KEEP_EXTRA→make_font→diff)；仓库外沙箱
  dry-run + 确定性: 沙箱/仓库产物 sha256 一致(26e519db…)
- 逐码位结构对账: added=60 / removed=0 / 保留字形位图字节零差异 /
  度量一致(multiset 差 = 新字身)
- font-charset PASS(60 未知冗余 WARN = 预置字，批2接线后自然转在用)
- 模拟器菜单 8 状态 + 内容页 11 页黄金参考与旧字体逐字节一致(箭头恢复);
  ref/ 基线无变化，故无黄金参考更新提交
- @build 0 Error 0 Warning; A/B 同树构建: RO-data +1528 B, RW/ZI(RAM) 0

gate: only mem-budget/mem-numbers pending lead ledger backfill
- pre-commit --all-files 实测: 仅这两条失败(台账受管区/内存文档数字 vs
  .map 漂移; 根因是 RO-data +1528 B 的 Flash 增量, RAM 无变化);
  其余 38 钩子全绿(font-charset/ui-golden/cppcheck/编码规范/单测族均过)
- 修复手段 ram_baseline.py --write / check_mem_numbers.py --write 均写
  docs/内存管理/**(Lead 单写者域), 本分支按裁决不代跑, 请合并后回填
- 手工自查: 改动 8 文件 BOM/CR/U+FFFD 与各自原状一致(全 LF 无 BOM),
  字体产物纯 ASCII, make_font.py 中文仅在注释与打印, 无字面量改动
 2026-10-25 03:23:52 +08:00
wandering1 65c5e7d310 chore(mem): 回填 cal-scale 合入后的 Flash/RAM 台账快照 
cal-scale-doc 合入（Code 213780→214104，+324 B，Flash 增长来自
CFG_VAL_INT 编解码与错误分支；RW=1204 / ZI=131852 不变，RAM 零增量）。
ram_baseline.tsv 记录 2026-10-25：RW_IRAM1 75,632 B (57.7%) /
RW_CCM 57,376 B (87.9%)。done 后统一回填，替代分支侧 --no-verify 欠账。
 2026-10-25 03:19:18 +08:00
wandering1 231dc81239 merge: task/cal-scale-doc 合入 v2-on-ui 
任务 cal-scale（1 个提交）经 task-worktree 回收：
- feat(采集标定): 卡1 TPAFE 量程口径定死 + 卡3 cfg_file 补 CFG_VAL_INT
 2026-10-25 03:15:22 +08:00
wandering1 411594bf67 feat(采集标定): 卡1 TPAFE 量程口径定死 + 卡3 cfg_file 补 CFG_VAL_INT 
卡 1（文档口径；卡 0/12 实测类按用户指示跳过，只落口径与占位）：
- ADC通道映射说明.md 文首摘要行的 ±10 V 更正为 ±5 V 双极性：板上 RANGE
  接 GND，±5 V 满量程 = 10 V 跨度，LSB ≈ 152.59 µV/码（@引脚）
- §7 TPAFE 量程行重写并括注 ±10 V 是芯片可选档（RANGE=HIGH，跨度 20 V、
  LSB 305.18 µV）、本板未用；§1 缺陷实质 2 补「满量程 = 10 V 跨度」
- 新增 §7.1 端到端量纲链路分段口径：②引脚侧 LSB 系数定死（TPAFE 152.59 /
  STM32 805.66 µV/码，纯转换器事实、与前端网络无关，卡 2 的 ROM 默认按此
  冻结）；③1k+1k 网络「2:1 分压 vs 源阻抗匹配」两读法待卡 0 注入斜率判别；
  ④端子→AINn 变比为仓库缺口待卡 0b；305.18/1611.3 定性为读法 A 的条件值、
  判别前禁入代码；§9 变更记录编号不动（继保规划有指向本文件 §9 的跨文档
  引用），新增行追加于其后
- 全仓其余 ±10 V 仅剩芯片手册转写与 tpafe5160 RANGE 枚举可选档注释
  （芯片能力描述，非本板口径）；数据可信.md §2.1 冲突挂账归 lead 销项

卡 3（代码；cfg_file.c 带 BOM，编辑后核 EF BB BF 完好）：
- 新增值类型 CFG_VAL_INT（枚举尾部追加、既有值不变；len 1/2/4 小端补码）：
  s_decode_int() = strtol + ERANGE + 宽度上下界双校验（两端 long 均 32 位，
  超范围文本饱和成 LONG_MAX 仅比界抓不住，ERANGE 必查）；s_encode() 带负号
  %ld 输出；cfg_file_register() 拒 INT 非法 len
- 单测新增 TC-CONFIG-006/007/008：-1 / INT32_MIN / INT32_MAX / 越界拒绝
  （含饱和带 2147483648）/ 编码带负号 / [sys] 段 load-save-load 往返一致 /
  注册拒绝 INT len=3 —— cfg_file 套件 200/200 PASS
- 回归：net_cfg 45/45、ftp_cfg 16/16 PASS，既有 network/ftp 段行为不变
- 越界改动说明：TC-CONFIG-006~008 定义行登记进属主文档
  docs/测试说明/配置文件单元测试说明.md（id-check 增量拦截要求在属主登记处
  补定义，该文件不在本卡写范围但为门禁唯一修复路径，仅追加 3 行用例 + 1 行
  变更记录，lead 评审时留意）

gate：@build 0 错误 0 警告（Code=214104 RO=18860 RW=1204 ZI=131852）；
RAM 增量 0 B（RW/ZI 与 ram_baseline 2026-10-24 行完全一致，IRAM1 57.7%、
CCM 87.9% 不变），Flash +324 B；uvprojx 零挂载变化、未入库。
staged 门禁全绿，唯 mem-numbers / mem-budget 因 Flash 增量需台账回填
（--write 目标 docs/内存管理/** 属单写者文件，本道不得触碰）：
gate: only mem-budget/mem-numbers pending lead ledger backfill
（--all-files 全量自查确认失败面仅此两条；BOM/CR/U+FFFD/字面量 ASCII 已
手工自查）
 2026-10-25 03:13:32 +08:00
wandering1 658fbe7a72 merge: task/S12-assert 合入 v2-on-ui 
任务 S12（1 个提交）经 task-worktree 回收：
- feat(S12): 模块级轻量断言宏 APP_ASSERT + net_socket 状态机不变量试点 2 处
 2026-10-25 03:06:59 +08:00
wandering1 56893709fe feat(S12): 模块级轻量断言宏 APP_ASSERT + net_socket 状态机不变量试点 2 处 
规格：docs/任务规划/测试与架构专项.md §2.1（模块级轻量断言宏，必须零生产开销）。
本提交只做道C-1：新增断言宏 + 2 处试点，不开 net 层大口子、不新增 test/host 目录。

改动
- 新增 Drivers/BSP/app_assert.h：APP_ASSERT 两级裁剪。
  · 关闭态（默认，产品构建）：编译期消失、零符号零代码；条件仍进 sizeof 的
    不求值上下文，写错变量名/比较类型会当场报错，不会出现"裁掉=从没被编译器看过"。
  · 打开态：失败交 configASSERT 用的同一个钩子 vApplicationAssertFailed()
    （裸控制台打 [ERR] ASSERT FAILED file:line 后软复位）；宿主端（模拟器 /
    主机单测）落 stderr + abort()，非零退出码不会被一键回归静默吞掉。
  - 开关 APP_ASSERT_ENABLE 默认注释，策略与 ENABLE_DESTRUCTIVE_TESTS 同级。
  - 纯宏、无函数、无数据，不新增 .c → 不涉及双端注册（.h 靠 include 路径找到）。
- Drivers/BSP/NET/net_socket.c：2 处试点，都落在"函数头写了限定条件、函数体
  一项都没检查"的缺口上。
  · net_close_locked：控制块必须落在 s_net_socks 数组内且 in_use——此前给出
    越界或已释放指针会一路走到 memset(sizeof(net_sock_t))，直接踩脏 fd 表。
  · net_drop_conn_locked：进入时必须 in_use + TCP 流 + 会话处于 ESTABLISHED
    或 CONNECTING——函数体无条件置 CLOSED 并登记重建，将来绕过
    NET_MSG_DROP_CONN 分派门的新调用路径会拆掉一个健康监听器（症状与 N-30
    一族同源难查），断言把这条状态机不变量钉成机器可查。
  两处均 netTask 上下文、非中断、非高频；条件纯读无副作用；既有错误返回分支
  一条都没改（断言不替代错误码，见 app_assert.h 第四节纪律）。
- test/host/net_socket/run_unit_test.py：include_dirs 补 Drivers/BSP 一行，使该
  套单测编 net_socket.c 时用真 app_assert.h，不造桩——假件与真头漂移正是本
  runner「常量闸」要防的那类自洽假绿；stub 目录仍在最前，同名头命中不受影响。
- Drivers/BSP/README.md：根级文件表补 app_assert.h 一行。

两处有意偏离示意稿（理由已写进头注释）
1) 断言点不再额外发一条 DBG_ERROR：钩子本身已打印 file:line，而每条 DBG_*
   调用点约 90 B Flash + 216 B 栈（AGENTS「日志不是免费的」）；断言点又常在
   「内核状态已不可信」的现场，走裸控制台比走日志行缓冲稳。
2) 头落 Drivers/BSP（与 dbg_log.h、bsp_err.h 同级）而非示意稿的 App/util：它是
   纯宏叶子能力，落 App/util 会让 BSP 新增一条反向 include App 层头的边，而
   layer-deps 存量基线只减不增、加不进去；落 Drivers/BSP 已在 MCU 与模拟器双端
   include 路径内 → 双端零工程文件改动（uvprojx / CMakeLists 一字未动）。

验证（工作树 _wt/S12-assert，分支 task/S12-assert）
- @build 产品态：BUILD_OK，0 错误 0 警告。
- 体积与 RAM：Code=213780 RO=18860 RW=1204 ZI=131852，与 scripts/ram_baseline.tsv
  的 2026-10-24 基线行完全相同 → Flash/RAM 增量 0 B；.map 中 app_assert 相关
  符号 0 条（规格完成判据"无新增符号"）。gate 全绿，无需 mem-budget 例外。
- 打开态实测（临时取消注释编译，跑完已还原成注释态）：0 错 0 警，
  Code=213916（2 处断言共 +136 B ≈ 68 B/处，无每调用点栈代价），RW/ZI 不变。
- 宿主 MSVC 三态实测：关闭态断言不求值但条件仍做类型检查（错误标识符报
  C2065）；打开态真条件不触发、假条件 stderr 打 [ASSERT] FAILED 后 abort；
  net_socket 主机单测 452/452 通过（用真头，开关默认关）。
- 门禁实跑：cppcheck(warning/perf/portability/style)、no-mojibake、coding-standard、
  layer-deps、bsp-err、id-check、doc-links、registration-check、mem-budget 全 0。
- 台架 @test 未跑：bench 锁归 Lead；产品态本改动零行为差异，无需烧录回归。

遗留
- 打开态未在台架上真跑一轮（需 bench 锁 + 一个故意造假的注入点）：待台架实测。
- 文档销项（测试与架构专项.md §2.1、并行分道方案.md 对应行、AGENTS 任务表）
  归主工作树统一处理，本分支未碰 docs/任务规划/**。
 2026-10-25 03:04:07 +08:00
wandering1 15aa08552c docs(问题记录): 删除项目审查与优化建议报告，结论并入模块文档与编号规范 
用户裁定：该报告大部分内容已闭环，可删除；仍有价值的迁到合适文档。删前逐条核对，
确认绝大多数结论在仓内早已有权威副本（LV_DRAW_SW_COMPLEX / osFlagsNoClear / SPI 分频 8
/ 分层反向依赖存量基线等），只迁真正独有的四类内容：

1. 暂缓理由与重开条件（三条量化门槛）→ RAM 使用分析与优化方案 §4，并明确「本节是唯一
   权威」，其它文档只留指针；同时把 10 处指向报告 §5.3 的重开条件引用改指该节。
2. 2026-10-22「常驻 vs 动态」三项诊断（静态前五块 43,462 B = 58%；动态面只有 heap_4，
   故栈余量=CCM 余量；栈深主因是日志/配置写链）→ 同文档 §2.5。
3. `_fp_digits` 1,018 B 删不掉的机理与 F-6 根因修法（Q10 宏改单精度，−332 B，4.49e6 例
   逐位等价）→ §2.6.4。
4. 「UI 侧缓冲进 CCM」要按 DMA 可达性二分（LVGL 池可进，帧缓冲/推流缓冲不可）→ 暂缓清单。

编号侧（报告曾是 6 个族的属主登记处）：
- 原报告 §9 的 26 行「号 → 现在详述于」对照表迁到 docs/编号规范.md 新增 §4.5，6 族
  owner_docs 改指该节。规范正文含大量写法示例，直接当定义集会误伤，故 check_ids.py
  新增 `_def_owners`：snapshot_only 族剔除规范正文，只恢复可判定、不参与悬空/撞号/裸形
  /紧邻判定（实测若不分，裸形 S1 误报 238 条、S-3 与登记簿 S-3 误判重复定义）。
- 11 个已死号（N-03b/N-10~N-13/N-20/N-21/N-24/N-26/S-1/S-2）在 id_aliases.json 登记
  status=void 并写明去处——它们被约 110 处代码注释与文档引用，原先只靠「报告里顺带提过
  一句」才算有定义，报告一删就集体悬空。N-21/S-1/S-2 一号两义，注记已分别标明。
- 顺带修 id_aliases.json 的 note 被脚本累积重复 26 次；修 registry 里 3 处仍指向改名前的
  任务卡文件名（W1-采集保护收尾.md / W8-数据可信.md），以及 iec104_master.py 两处同类注释。

门禁：check_ids --strict 通过（可判定 8747/10410 = 84.02%，基线由 82.6% 抬到 84.0%）；
check_doc_links --all --sections-strict 通过（177 文档）；pre-commit 相关钩子全过。
 2026-10-25 02:08:58 +08:00