247 Commits

Author	SHA1	Message	Date
super_agent_bot	be16669564	docs(ui/nav): 台架复核落地——收列键语义、回根按 depth、限度取证结论（#69） ... 台架实机会话 2026-11-02（bench 档 fw 22:25:12 / 产品档 22:29:56，均经 /serial-boot-test 闭环：身份戳匹配 + 回读 no-difference）： - 复核② 收列键语义：菜单态按 s 与按 l 同走 menu_back、均收 一级且父列选中留在原地（depth 1→0、sel 不变）——旧断言 「菜单态按 s 不收列」是把待机态 s 无效（task-24 实证）误 读成菜单行为。to_root() 据此在 STATUS depth>0 时按 s 逐级 收（弹框被屏裁时像素 n_cols 漏计、固件 depth 不漏），老固 件像素路径保留 l 兜底仪式。§7.2 纪律与 board-ui-nav skill 恢复配方同步改写。 - 复核① 被裁弹框两叶：菜单步进依旧吃不到（枚举落同胞页， 落点由 STATUS 如实报出、不再谎称到达）；GOTO 直开两叶到 达且完整渲染（自检记录 ink 4073 / 运行记录 ink 3559）→ KNOWN_UNREACHABLE 对 --to 保留，绕行路径 --goto。§7.4 改写。 - 产品档（未加宏）实测：STATUS 照常应答（不设闸）、GOTO 回 status=4——生产/bench 行为差异真机钉死；§7.6 增实机验证记 录段。回归：--selftest-quick 66/66+闸 7/7；--selftest 闭环 失败集与 master 基线逐项一致（6 存量像素 + 2 执行类拒绝）。	2026-11-02 22:39:48 +08:00
super_agent_bot	aaf75f7992	feat(scripts): board_ui_nav 接入 STATUS/GOTO 并落实排帧流规则①（#69） ... - 每键后先读 KEY 回执，再等帧流静默 ≥900ms、双帧一致才判稳取帧： docstring 规则①此前代码只 sleep 300ms 单帧，本次补实（#38 调试 复盘的主错源之一）；判稳超上限记 unstable，禁止再基于此盲补键 - STATUS 客户端（字节契约以 ui_net_sink.h 为唯一真源，解析做防御）： --where 固件身份 + 像素双口径报"现在在哪"；--to 到位判定固件身份 为主、像素为佐，不一致只记账不盲补（不一致=判据或固件有问题， 先 dump 现场）；UNKNOWN 恢复先问 STATUS 定分支——菜单态关列用 l 不用 s（菜单不响应 s 的历史判据存疑，待台架复核后收口）； STATUS depth=0 直接判回根，剪贴弹窗不再挡 to_root - --goto 直达页（仅台架/模拟器固件，产品恒拒），主机侧同步拒绝 执行类页 id；旧固件（无 STATUS 应答）自动退回纯像素路径， 向后兼容 - WALK_DIR 与 --walk 默认目录并一（原 ci-artifacts/uiwalk 使 BOARD_TRUTH 复核看不到新 walk 帧，10-31 记过） 无板端到端：窗口态 lvgl_sim（UI_REMO_ALLOW_GOTO）11 步全绿，含 待机→e 唤醒重开最近页的实锤复现。--selftest-quick 66/66、门 7/7。	2026-11-02 22:22:10 +08:00
super_agent_bot	493fa6ba0e	feat(ui/remo): 7003 总线新增 STATUS 身份查询与 GOTO 直达页（#69） ... STATUS（命令 4）一帧回答"现在在哪个画面"：kind（MENU/PAGE/STANDBY） + 菜单路径/选中 + 页 id，布局契约与字节序见 ui_net_sink.h。由 uiTask 轮询驱动，同上下文读静态导航状态：零画面副作用、免锁、不发日志。 新增只读接口 ui_menu_get_nav_state / ui_content_page_current_desc。 GOTO（命令 5）按页 id 查生成表直开内容页，以 VIEW 权限进入（与 "已过查看密码"同档，不代输任何密码）。编译期门控 DTU_BENCH || UI_REMO_ALLOW_GOTO：产品构建恒拒（status=4），模拟器 构建默认开启便于无板验证；执行类页（clear/reset）固件侧同样拒绝 （status=2，与主机 EXEC_PAGE_IDS 同一事实源）；待机中拒绝（status=5）， 由主机按键唤醒后再来。成功应答带回目标叶节点下标便于对账。 ui_sink 主机单测补导航侧链接假件 + 最小 lvgl 桩（仅本测试目录）。 产品构建 Keil 0 Error 0 Warning；ui_sink 单测 17/17。	2026-11-02 22:19:58 +08:00
super_agent_bot	046097918d	fix(ui/wave): 回放页切通道/切段后不重绘——key_cb 接管键后补失效 ... 回放页 v1.0 建的键处理返回 true（接管全部键），但从未调 ui_content_page_invalidate()：框架只在 key_cb 返回 false 时才替页面 失效，于是「键送达、状态已切、屏上纹丝不动」。该病被枚举缺陷完全 遮住（整页恒空、没有可切的画面），随本波枚举修复首次上板才暴露： 真机按 ←/→/↑/↓ 帧字节完全不变（同帧哈希），布局与状态机无问题。 - 上/下切通道、左/右切段成功路径、空态再探路径，各补一次 ui_content_page_invalidate()（与 ui_page_clock / ui_page_password 等已接管键的页面同纪律）； - 切段失败仍保持「按了没动」的诚实语义（不重绘、不把忙态清成空）； - 修改记录 v1.1。 /keil-build 0 错误 0 警告（Code 247,288 B，+4 B），RAM 不变； 台账 / 同码凭证同批刷新。 Refs #38	2026-11-02 18:21:34 +08:00
super_agent_bot	d6253aa974	fix(ui/wave): 钉死并修复回放页恒空根因——读侧用反 seg_path 返回契约 ... FR 埋点构建上板判读（本 boot 串口实录，临时诊断构建 = 上一提交）： [UI_TASK] ui wave scan #1 done cnt=7 np=0 tt=0 ac=407 [ERR][UI_TASK] ui wave head #1 path fail idx=6 - 目录枚举一直是好的（cnt=7 = 盘上七段全数入表，锁也拿到，tt=0）： 10-31「唯独 ui_task_wave_scan 拿不到目录条目」的定性被推翻。 - 真正坏的在 load_head / seg_win 的拼路径判错：契约 （App/algo/wave_store.h:458）是「成功 = 写入字符数（本形态恒 16）， 失败才是负码」，读侧自建成功能起写成 != 0 判失败——每次成功都被 判死，f_open 永远走不到，盘上有段也恒显「无录波段」。写侧 default_task.c 同函数用 <= 0，一直是对的，所以「FTP 六段全见、 写侧枚举正常、唯独回放恒空」的怪象全线得解。 - 模拟器走桩、不编译本文件读侧，黄金参考图与主机单测因此从未覆盖 这条链，此病从建成存活至今（板端首张真机波形图见 PR #67）。 - 两处口径改 <= 0（与写侧一致）；表列着的段 f_open 失败补带 FR 码 的永久留痕——该失败态页面无视觉面，10-31 误定性的教训就是静默。 - 临时诊断（#N 序号 / try 闸日志 / 无条件 done 行）收敛删除，留 最小永久集：scan opendir/readdir FR、零条目 INFO、head/win 开档 失败 FR。try 闸恢复静默（看门狗设计说明 §4.3 口径）。 - /keil-build 0 错误 0 警告：Code 247,284 B（较临时诊断构建 −368 B，较修复前 +236 B），RAM 不变；台账 / 同码凭证 / 数字回填 同批刷新。 Refs #38	2026-11-02 18:07:52 +08:00
super_agent_bot	3e01e9d98e	diag(ui/wave): 枚举扫描诊断留痕第二组（临时构建，随根因修复收敛） ... 第一组埋点烧后开回放页串口零留痕（既无 FR 失败也无零条目 行），剩余唯一静默分支 = try 闸取锁失败直接返回/扫描成功但有条目 不打印/段头与窗口读取失败不打印。本组补齐： - scan：每次尝试编号 #N；try 闸失败行带 vol_lock_get_stats 计数（消费方 观测，不取锁，符合看门狗设计说明 §4.3 口径）；完成行改为无条件打印 cnt/np/tt/ac（排除「成功但页面仍空」歧义） - load_head / seg_win：try 闸、路径构造、开档 FR 码与读失败出口全部留痕 临时诊断构建，判性后随根因修复收敛到最小永久集。 /keil-build 0 错误 0 警告（Code +604 B，RAM 不变）。 Refs #38	2026-11-02 17:39:58 +08:00
super_agent_bot	ee002d7ead	fix(ui/wave): 回放页枚举扫描失败不再钉「无段」缓存并补 FR 码留痕 ... 真机回放页恒显「无录波段」而 FTP 六段全在盘上（登记簿同名条目， 见 #38 §5）。本提交按执行手册 §3 步骤 1 落两件事： - ui_task_wave_scan：f_opendir/f_readdir 失败本轮返 -1（「本轮无完整 事实」语义），不再无条件钉 s_wave_scanned——原实现把卷忙/FR_DENIED 一类失败钉成「0 段」假空态，直到下一次 manual_req 才重试；失败不 钉表后下一次进页/按键自然重试，与 soe_store 读者同纪律。 - FR_NO_PATH（从未录过波）仍归「0 段」并钉表，设计原口径不动。 - 失败分支补带 FR 码的留痕（opendir/readdir 各一条 DBG_ERROR）， 「FR_OK 但零条目」加一条 DBG_INFO（留痕行正文以 「ui wave scan」前缀区分，tag 用本文件既有的 [UI_TASK]） ——根因判读表见执行手册 §3， 板级远程开一次回放页即可定性，不必猜。 - DBG_TAG 定义 + dbg_log.h 包含上收到包含区（原在 s_wave_ops 之后的 文件中部；同标签同宏，不构成行为改动，本文件既有留痕照常）。 - 体积/RAM 同码凭证随 /keil-build（0 错误 0 警告）同批刷新： Code +8 B，RAM 不变；台账受管区水位按门禁要求随本次 .map 同步 （台账此前落后 master 既有 flash 漂移 +320 B，--write 一并拉齐）。 Refs #38	2026-11-02 17:07:21 +08:00
wandering1	7efa58d9a1	network: 台架 IP 迁到 192.168.31.100，并把重复写死的值收进单一真源 ... 分两段（用户裁定 2026-11-02）：先做地址迁移，再把同类字面量收敛成 单一真源，以后再改地址只动一处。 一、IP 迁移 192.168.1.100 → 192.168.31.100（gw 同步 → .31.1） - 工厂默认：Drivers/BSP/NETCFG/net_cfg.c 的 NET_CFG_DEF_IP/_GW - 注释/文档示例、主机与板级测试、台架 py 脚本、两份 sim_config.ini - 字节序教学点同步换算 hex：0x6401A8C0 → 0x641FA8C0（内存 C0 A8 1F 64），旧版示例引文与历史 Trap 记录按冻结纪律不动 - UI 黄金基准：网口设置 4 态 + shot_info 共 5 张 .bin 由 check_content_pages.py --update 重刷（渲染值 IP 变了，属预期变更） - 保留判定：客户点表引用（IEC104/继电保护规划）、芯片手册摘录、 日期冻结的变更记录行、已退役台架档案 MDK-ARM/retracted_bench_* 二、单一真源收口（A+B+C+D，用户批准全做） - 新建 test/host/bench_defaults.py：台架 py 默认值唯一定义点 （DEVICE_IP/DEVICE_GW/PC_IP/NET_BCAST），22 个脚本改为引用； MDK-ARM 两探针与 scripts/board_ui_nav.py 经 sys.path shim 引入 - test/board/net_test_task.h 新增 TEST_PC_PEER_IP，板测三处 PHASE*_REMOTE_IP 改引该宏（保留 -D 覆盖）；Phase1 断言改 memcmp 数组比较，数组各只出现一次 - simulator/tests/check_content_pages.py 从 net_cfg.c 正则解析 NET_CFG_DEF_* 推导期望值（解析失败即报错、不静默兜底）， 脚本内台架 IP 字面量清零 - 装饰性注释去具体值（net_cfg.h/net_socket.h/net_socket.c/ net_socket_sim.c）；字节序教学 hex 对刻意保留为唯一写值点 - 刻意不动：主机单测夹具 IP（逐文件钉住的任意值是正确测试 实践）、文档正文 IP（那是文档内容本身） 顺带：scripts/gen_task_table.py 规范串清掉「，B5」——编号清退提交 72b4b094 改了受管区没重跑生成器，task-table 门禁因此一直红 验证：产品 @build 0/0；CH395F 套件开关构建 0/0 后还原产品态； 6 套主机单测 rc=0；content_pages（含宏推导路径）/菜单 8 态/ 推流位比对全 PASS；bom-drift 99 无漂移；doc-links/coding-standard/ cppcheck 绿；py_compile 23 文件 + --help 冒烟（含 shim 绝对路径）	2026-11-02 14:46:42 +08:00
wandering1	f81bb38b64	docs(测试说明): 录波远程半轮收尾回写并新增到场执行手册 ... - 故障录波设计说明 §10 新增「板级远程半轮记录」：真 FAT 落盘、触发 时序三样本、冷却恢复、轮转同号覆盖、PC 侧坏段拒收、104 并发 （参考主站 16/18 绿，两条 COV = 标定闭锁腿物理预期）六项 PASS； drop 400–640 点/窗入账为纯观察项（丢样本不丢采集实测面）。 - 新缺陷「回放页段表枚举恒空（板级）」登记登记簿 §2：五面判别钉死 唯 ui_task_wave_scan() 在 uiTask 拿不到目录条目；伴生纪律缺陷 f_opendir 失败仍钉 s_wave_scanned=1（修复方向同记录）。 - 新增 docs/测试说明/专项验证/故障录波板级到场轮执行手册.md：剩余 人到场判据拆成四幕，逐步写清谁出手/做什么/会看到什么，含到场 检查清单、现场记录表、两个用户决定点、收工还原清单与分诊； 索引挂行 docs/README.md 与 测试说明/README.md（专项 5→6 篇）。 - scripts/board_ui_nav.py 文件头补三条 7003 驱动纪律（ACK 与推流 同 TCP 须 drain 静默、home 首 e 是重开最近页捷径、级联光标记忆）。 - 自我更正入档：起草台架计划时带入的「≤15 s 判据」全仓无属主， 已溯源改指 WAVE_SEAL_TIMEOUT_MS 2 s 封存窗（真锚）；「§1.2 两个 待台架核数值」为错引，改指 §4.2 兜底行与 wave_ring.h 冷却时长。 bench 锁已 release、设备未改烧；证据包在 ci-artifacts/wavebench/。 gate: doc-links --all --sections-strict rc=0（218 篇 3103 处 无法判定 0）；mermaid 预检新发 0；py_compile 过；七文件 BOM/CR/U+FFFD 全零。	2026-11-01 14:10:53 +08:00
wandering1	c373e2e97d	chore(台账): waveclose 合并后回填体积同码凭证 ... 主干合并 docs(任务规划) 录波卡片登记簿销项（51ce5900）后 git-index 指纹变为 80504df8；全量重建 /keil-build -r 0 错 0 警，测量与本码：Code=246,720 B / RW_IRAM1=94,336 B (72.0%) RW_CCM=57,376 B (87.9%)，均 ≤92%。本笔仅重写凭证，无代码改动。	2026-10-30 18:28:46 +08:00
wandering1	2525c2d948	docs(104): 端口口径统一成「工厂默认」，登记「改后立即重 bind」待办 ... 用户裁定两条：① 剩余裸写端口的地方加「工厂默认」限定词，不改固件行为； ② 生效语义按需求口径「保存即生效」定，现实现（端口下次重 bind 才生效）是 要改的一侧 → 建任务登记，本笔不动代码行为。 限定词（24 处 / 17 文件）：AGENTS 数据主线、App/protocol/README、根 README 文档索引、Src/freertos.c 三处任务注释、docs/README、项目启动顺序管理、存储 架构说明、软件架构与运行时规格（2）、RAM 使用分析、产品需求设计文档（5）、 项目架构总览（3）、test/host/README、iec104_master 流程注释、IEC104 上行设 计说明、继电保护功能复现规划。配图两张同批重跑：gen_arch_svg.py 与 gen_memory_svg.py（脚本与产物同一笔）。 两处陈旧计数（都做过双源核证）： - 测试开发标准流程 像素层「60 内容页」→ 内容页黄金参考 66 张（64 页）； 双源 = simulator/tests/ref/shot_*.bin 实数 66 与 check_content_pages.py 的 PAGES 66 条（含两个 _p2）。 - .pre-commit-config.yaml 的 uinav-selftest 注释「18 张黄金参考」→ 写成 「接线当时 18 张、现 66 张」：git log -S 定到 6a904c1b（2026-10-25），那 天 ref 目录确实 18 张，写时为真，但它描述的是钩子现有行为，属当前态。 口径修正与登记： - 页面扩充详细方案「通讯设置 = 无配置模型（端口与 CA 都是 #define）」→ 标 「当时」，并写明现已在 /config.ini 的 [comm] 段可配、UI 通讯设置页可改。 - 产品需求 §通讯配置：删掉「改后需重启生效」这句把两件事混为一谈的话，改成 需求要求「保存即生效」+ 现实现（公共地址重启、端口下次重 bind）+ 指向登记簿。 - docs/任务规划/登记簿.md §1 新增「104 端口改后立刻重 bind」：含隐性耦合 —— .serialtest/config.json 的必检锚点写死 listening on 2404，端口一改串口 回归必假失败；改行为时要么锚点只查 listening on，要么由脚本注入端口。 复扫（旧形态归零判据）剩 20 处未带限定词，逐条定性为刻意不改：默认值定义处、 出厂模板与断言、usage 与 argparse default、UI 黄金参考显示值、台架主站地址 （同数不同义）、串口锚点、叙事句、引用关系图坐标。逐条理由见一次性台账。 门禁：check_doc_links --sections-strict 对 16 篇改动 .md 逐个 rc=0； check_mermaid --all 31 文件 62 围栏新发 0；check_nested_comment --all 449 文件新发 0；check_bom_drift --all 99 个名单内文件无漂移； check_generated_fresh PASS（25 生成器 / 21 一致 / 4 只减不增基线）；字节体检 无新增 BOM / CR / U+FFFD / 行尾空格（三连空行与 HEAD 逐项相同 = 存量）。 /keil-build 0 错 0 警，Program Size Code=246720 RO=29836 RW=2052 ZI=149708 与凭证同码：本笔只碰注释与配图文字，无固件行为变更。	2026-10-30 15:40:27 +08:00
wandering1	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	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	aed842e1f2	Merge branch 'v2-on-ui' into task/archsplit-sw-hw ... # Conflicts: # docs/架构设计/软件架构与运行时规格.md	2026-10-30 13:32:52 +08:00
wandering1	00fe66a029	docs(架构设计): 系统架构与硬件规格拆为软件与硬件两档，软硬件分治 ... 用户裁定（2026-10-30）：合档拆成两部分，软件与硬件不混排。 - 软件侧（新 §1~§6）= 分层 / 任务模型 / 就绪位表 / 启动时序 / 线程通信 / 工具链与工程约束 → docs/架构设计/软件架构与运行时规格.md - 硬件侧（新 §1~§5）= 主控内存 / V0.1 引脚表 / 存储器件 / 版本兼容 / 能力边界 H1~H5 与量纲口径 → docs/架构设计/硬件规格与能力边界.md - 旧 2.1 的 RTOS / 工具链 / CubeMX 三行迁入软件档 §6.1；旧 2.5 五条工程 约束归软件档 §6.2，SDIO 一条归硬件档 §5 H5（同事实不再两处并存）。 - 存储器件小节的 BBT / 单写者 / FatFs 三条细则不与权威档重复，改为指向 存储架构说明与软件档 §2。 - 引用重挂：AGENTS 引脚行→硬件档 §2；docs/README 3 处；需求档 7 处 （「架构硬件档」别名一分为二「软件架构档 / 硬件规格档」）；复刻明细 2 处；section_aliases.json 两键改四键。 - 两档尾部各留裸号换算注（旧档号不带 §，避免与本文编号体系混淆、且 doc-links 自引用 strict 必拦）；旧档名全仓零引用。 门禁：树内 check_doc_links --all --sections-strict 剩 35 处全部为 simulator/SDL2 联接「名称含空格」假红（主树同命令 rc=0 干净），本笔 文件新发 0；mermaid 预检新发 0；七文件 BOM/CR/U+FFFD 全零。	2026-10-30 13:08:44 +08:00
wandering1	4a4ad6bc5f	chore(全仓): @build/@test 旧文档别名清退为技能调用名 ... 现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名， 不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体 run_boot_test.py 的真实调用。 - AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改 「编译（/keil-build）」「串口回归（/serial-boot-test）」 - keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree 方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围） - 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入 等 41 行历史证据保留旧名 - gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑 - 顺手补并行方案同行漏网计数 51→52 钩子 验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52 钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。	2026-10-30 13:03:12 +08:00
wandering1	dc964090ea	docs(产品需求): 需求基线拆薄为三档（大厂标准），doc-links 增别名解析 ... 产品需求设计文档.md v1.9 → v2.0（2691 → 1816 行）： - 新增 §2 背景·目标用户·典型场景·成功指标，§3.2 产品级非目标表， §4 P0/P1/P2 需求总览（19 行）；§9 收窄为缺口清单与推进顺序。 - 拆出 docs/产品需求/参考产品复刻明细.md（803 行）：复刻基线 + 定值/遥测/开入开出/事件/元件/录波/记录/规约逐项差额与完成判据。 - 拆出 docs/架构设计/系统架构与硬件规格.md（215 行）：运行时架构 （就绪位表/机制表/启动时序）+ V0.1 硬件规格；与项目架构总览 定分工——位表/机制表/时序图/引脚表以新档为准。 引用同步：AGENTS.md 引脚表指针改指系统架构与硬件规格 §2.2； docs/README.md 目录树与索引四处重写；故障录波三处「录波采样率」 行指针改指复刻明细 §7；PRD §11 补两新档指针。 门禁工具：check_doc_links.py 裸名解析增别名后缀匹配（「见需求档 §5.16」形态），§ 链遇紧邻已登记别名换目标；section_aliases.json 登记 需求档 / 架构硬件档 / 复刻明细(档) / 产品需求设计文档 / 系统架构与硬件规格。 终验：doc --all rc=0（3038 处 / 可判定 80%）；mermaid --all 64 围栏 0 命中；改动文件字节卫生全过；新旧逐行差集审计无丢行。	2026-10-30 12:36:31 +08:00
wandering1	f8e62a9ba2	feat(门禁): 新增 mermaid-syntax 钩子，围栏内确定性语法提交前必拦 ... - scripts/check_mermaid.py（纯标准库）：R0 围栏未闭合 / R1 图类型头缺 错 / R2 -. 后直接跟管道（确定性语法错误形态）/ R3 subgraph 与 sequence 块的 end 计数配对；--all / --selftest（5 形态）/ --prune； 排除面与 doc-links 同口径；零语料空基线 - 接线 .pre-commit-config.yaml（doc-links 后），docs/门禁说明/ mermaid-syntax.md 专篇（八段结构含限制与盲区），README 索引与 AGENTS.md 计数 51→52、提交期实跑 48→49 - 门禁说明 README 顺带修正两处历史矛盾：gitlint 实际就在本配置 （commit-msg 阶段），旧文「52−3−gitlint」与「gitlint 不在配置里」 均过时——锚定口径 52 = 47 pre-commit + 3 manual + 1 commit-msg， 加钩后 48 + 1 = 49；三处 grep 争执例句改抽象表述（例句里的数字 自己会过时） - docs/子系统设计/屏板链路设计说明.md:38 修复触发本钩子的坏图： -. 后直接跟管道不是合法边 operator，改为 -.->|label| 形态 实测：YAML 解析 52 / commit 阶段枚举 48 行全 Passed（含新钩子）/ check_mermaid --all 29 文件 60 块围栏 0 命中 rc=0 / check_doc_links --all rc=0（215 文档）/ 六文件无 BOM/CR/U+FFFD。	2026-10-30 11:03:58 +08:00
wandering1	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	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	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	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	2533a72a0a	chore(台账): done 后重生成凭证，对齐合并态 .map	2026-10-30 01:15:07 +08:00
wandering1	b4588108ed	merge: v2-on-ui into task/screenlink-bench-serial (wave + screenlink)	2026-10-30 01:08:37 +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	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	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	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	51d89cf9d3	gate: 按用户裁定整体退役编号门禁 id-check-new（钩子 52 → 51） ... 配置：摘掉该钩子，原位置留一条退役注记（不复述数钩子数的字面量）。 YAML 解析口径实测：声明 51 / 带 manual 3 / 提交期实跑 48。 脚本：git mv 进 scripts/archive/id_gate/check_ids_new.py，与已退役的 check_ids.py 同档；docstring 改退役口径，REPO_ROOT 因归档位置深两级 改取 parents[3]，失败提示与自述路径同步改写。从归档位置实测： --self-test 5 正例拦下 / 29 反例放行 rc=0；--worktree 与暂存区模式 rc=0。 文档（七份）：AGENTS.md 六处——总数、加钩流水（顺带补上 2026-10-29 漏记的 skill-size 一笔）、枚举项删除、本行相加数、提交期实跑、门禁索引 与主题表两行；门禁说明 README 八处——声明数、实跑数、计数流水、grep 陷阱的举例数、§2 标题、姿态表「只查新增」行、两行索引状态；编号规范 七处——引导块改「本文即唯一事实源」、族总表一处、§8 标题与正文、 §8.5 补第④步、④ 之后无机械牙那段、速查；门禁说明 id-check-new.md 整篇重写为退役留档（查什么 / 落地前的噪声回放 / 退役五条理由 / 手工 跑法 / 此后靠什么 / 认下丢了什么）；门禁说明 id-check.md 与归档目录 README、check_ids.py 里「现行门禁 = id-check-new」的指针同步改写。 技能（三份）：id-family-semantic-migration 一行、stale-doc-count-sweep 的 pitfalls 与 steps 各一行改手工跑法（steps 第 5 条那笔历史计数例不动）。 此后编号形态没有机器面：判据只剩 docs/编号规范.md §1 三句自问、§4.1 族总表与人工评审；2026-10-14 那类"销项删行后号被重新取走"不再有提交期 警报——这条代价已写进留档，别当成"检查没了随便写"。 纯文档与门禁配置，未跑 @build。全程未 push。	2026-10-29 20:22:47 +08:00
wandering1	7c8669e52a	feat(屏板): USART1 700 kbaud + 收中断传输层 sb_link（1-2/1-3） ... 批 1 的 1-2 / 1-3：把屏板（DTU-LCD）发来的 6 B 帧 A 在 USART1 上稳定收下来。 1-2 波特率：.ioc 不保存任何 UART 的波特率（只有 USART1.IPParameters=VirtualMode），GUI 里改也不落盘，所以只能在 Src/usart.c 的 USER CODE BEGIN USART1_Init 2 区覆盖 huart1.Init.BaudRate 后重调一次 HAL_UART_Init（第二次调用时 gState 已非 RESET，HAL 只重算 BRR、不再跑 MspInit，GPIO/DMA/NVIC 不会被重配）。开机日志实测 BRR=0x0078，与理论值 84 MHz/(16x700 kHz)=7.5 逐位相符，误差 0%。 1-3 收中断：新建 Drivers/BSP/ScreenLink/sb_link.c/h——16 B 缓冲 + IDLE 中断断帧、帧 A 校验、错误中断里按 RM0090 清 ORE/NE/FE/PE、周期统计上报。 HAL_UARTEx_RxEventCallback / HAL_UART_ErrorCallback 是全局单例（唯一实现 在 rs485.c），故只在那里各加一行转发，按句柄过滤放在 sb_link 内。 台架实测（PC + USB 转 TTL 顶替屏板，COM6@700000）撞出两个真问题： - 错误回调里无条件重挂 -> 出现 err=160 / rearm=160 同步增长，看着像每帧 都重挂失败。真因是 HAL 把 NE/FE/PE 归为非阻塞型（接收照跑、RxState 仍是 BUSY_RX），此时 ReceiveToIdle_IT 只会返回 HAL_BUSY。改为仅当 RxState == HAL_UART_STATE_READY（ORE 那类阻塞型）时才重挂。 - 日志字面量里带中文 -> ARMCC #870-D invalid multibyte character sequence。字面量一律纯 ASCII，中文只写注释。 验证：主机单测 81/81 PASSED（test/host/sb_link/，其中按 RM0090 的清除语义 把"必须 SR->DR 顺序才清得掉 ORE"钉成断言）；Keil 0 错误 0 警告；台架 rx == 发送帧数、ok == rx、crc=0、len=0、size=6、keys 随按键帧递增；先用 错波特率灌 64 B 垃圾（len=31、bits=0x06）后自动恢复且 rearm=0。 新增 test/host/screenlink_bench.py 作为可复跑的屏板激励（--key / --glitch-baud）。	2026-10-29 20:13:18 +08:00
wandering1	5c64cf0859	merge: task/criteria-462-fix 合入 v2-on-ui（§4.6.2 判据写定 + 编号白名单登 WAVE） ... 两笔内容提交：05664051（判据四处改写 + 手册侧九处去对照语气）、 9fe8f854（KNOWN_BARE 登记 WAVE 段文件名前缀，自检 5/29 全过）。 与 557f1d04 的计数同步零文件交集，纯文档 + 一行白名单，未跑 @build。 全程未 push。	2026-10-29 20:06:03 +08:00
wandering1	9fe8f8545d	gate: 编号门禁白名单登记录波段文件名前缀 WAVE ... scripts/check_ids_new.py 的 KNOWN_BARE 加 WAVE（附两行注释说明来源： App/algo/wave_store.c 拼名、FTP 根下 /wave/、100 个号轮转）。 此前文档里写段文件名只能改成 WAVE<NN>.BIN 绕开裸形态，登记后按字面写。 classify_bare("WAVE00") 由 fail 变放行，--self-test rc=0（5 正例拦下 / 29 反例放行，FOO99 仍 fail）。 docs/门禁说明/id-check-new.md §7 表加一类"固件生成的产物文件名"， 并提醒先分清产物名与编号族——加白名单是唯一放宽手段，没有整库豁免入口。	2026-10-29 20:05:43 +08:00
wandering1	557f1d042a	docs(计数): 录波落地后的全仓计数同步（套数/钩子/黄金/菜单/字库） ... 机器面先定真值，再逐处对齐文档；带日期戳的取数行只加「当时」不改数。 六个数（每条两个以上独立机器源互证） - 主机单测套数 41 → 44（find test/host -name run_unit_test.py / 覆盖率总闸 --list / 基线 modules 条目三源一致；目录数 46 = 44 + common + __pycache__，两个数分开写） - 有专属钩子 22 根（YAML 解析 -unit-test 后缀）⇒ 无专属钩子 19 → 22 套，并把 wave_ring / wave_store / wave_trig 逐名列进门禁台账 §6 第 4 条，18 / 19 / 22 三个数 改标「裁定当时 / 2026-10-28 / 2026-10-29 现值」 - 内容页黄金参考 60 → 66 张（simulator/tests/ref/shot_*.bin 实数 / PAGES 条目 66， 其中 2 个分页 → 页面 64）；钩子显示名与门禁索引表成对改 - 菜单 42 → 43 行（9 菜单 + 34 叶）、已绑 28 → 30、未绑 4（ui_menu_tab.h 宏 + g_menu_tab[] 末行 / ui_page_registry.h 的 UI_PAGE_MAP_COUNT + #page= 计数剔示例行） - 中文字库 218 → 224 唯一字、313 → 319 字形（清单唯一码点 / .bitmap_index 条目数 含 notdef；224 + 95 = 319 成立） - 钩子口径 52 声明 / 49 提交期实跑：只核不改，核对 AGENTS 与 YAML 解析一致 Lead 追加四处（wave-algo 按「AGENTS 只核不改」的指令交回我裁的部分） - AGENTS.md 提交门禁节：41 套 → 44 套（两处）、19 套 → 22 套（两处，并把「与录波 三套」写进括注）、ui-golden 条目 60 张 → 66 张；52 / 49 的口径叙述与历史括号原样 - scripts/board_ui_nav.py 的自述 docstring：60 张 → 66 张 - test/host/sys_log_mcu/sys_log_mcu_test.c 注释：全量门禁 41 套 → 44 套（纯注释） - 产品需求 FR-UI-2：需求原文「42 节点」保留不动，在实现行注「2026-10-29 实到 43 节点，42 是 V0.1 立项数」——需求基线不由实现方回改 刻意不动的（冻结面） - 带日期戳的实测行（自动化测试流程、字库差集门禁、覆盖率口径里的 67 s / 25 s / 45 s / ~105 s 四个耗时）、保留变更记录的文档历史行、页面补齐规划里自写「完成即 冻结」的立项快照表、2026-10-28 那份分工说明、级联框总览.svg（42 节点时代所画， 无生成器，重画另开一笔）、三处伪命中（字体数据行、芯片手册、m2/m3 数据目录） 自查（真实退出码）：check_doc_links.py --all RC=0（215 个文档、章节引用可判定 80 %， 合并后第一次全库零红）；check_generated_fresh.py RC=0（22 张图 17 一致 / 5 条既有 BASELINE 豁免，生成物零改动）；编号门禁 add 后复扫 RC=0；17 + 4 个改动文件字节体检 全绿（无 BOM / LF / 无 U+FFFD / 无尾随空白 / 单个尾换行）。	2026-10-29 20:04:24 +08:00
wandering1	15bcfc7c92	merge: task/wave-record 合入 v2-on-ui（故障录波数据面与单通道回放页） ... 冲突两处与处置 - docs/子系统设计/故障录波设计说明.md §5.2：上游把这张表交给格式化器重排，多出一列 空列，并把「FA_WRITE 竖线 FA_OPEN_APPEND」里的竖线当成分隔符打断，标志位写法已损坏。 取我方四条陷阱版（含实现期复核新增的第四条：搬段途中环被解冻甚至已换段 → 关档后 复检环侧身份判废），并把标志位里的竖线转义（与 运行与自检记录设计说明.md 同一写法）。 上游在表后新增的「取窗竞态的原因」配图不是本任务内容，原样保留未删。 - scripts/size_attestation.json：不手工拼接，改为合并后在主树重新构建再重盖凭证。 顺手修一处上一轮我引入的排版断行 - docs/任务规划/数据可信.md §4.6.5「跨转换器相位」那一行少一个分隔符，三列表渲染成 两列；同时把引用从 §7 精确回 §7.1（链路分段）。合并面 68 个文档、46 张表逐张核对 列数一致，命中 0。 合并态权威构建（主树，本次凭证的来源） - 0 错误 0 警告；Code=243,552 / RO=28,784 / RW=1,972 / ZI=145,388；RW_IRAM1 89,936 B （68.6%）/ RW_CCM 57,376 B（87.9%）——与任务树逐项相同：上游自 merge-base 起对代码 只改了 sample_ring 的注释与函数头，故台账数字无需重排，仅重盖同码凭证。 - 上游 14 个提交带来的门禁与技能改造（skill-size 钩子、五个技能正文外置）与本波正交， 真重叠只有 docs/门禁说明/README.md 与 docs/测试说明/主机单测覆盖率口径.md 两处， 按 hunk 距离自动并上，已逐项核对。 状态与后续 - 台架三条判据（注 1 V/50 Hz 对表、FTP 拉回比对、与 meas 及 104 同表读数）按用户裁定 保持未完成，卡片不销项；本笔交付的是软件闭环。 - 全仓计数清扫（主机单测 41 → 44 套、无专属钩子 19 → 22 套、黄金 60 → 66 张、提交 钩子数口径、两处钩子显示名）另开一笔，不与本笔混编。 - docs/任务规划/** 本应在主工作树改，本波由用户在任务树显式豁免、随本笔合回。	2026-10-29 19:32:26 +08:00
wandering1	d64bbdc57f	feat(wave): 故障录波数据面、接线与单通道回放页（软件闭环交付） ... 数据面（App/algo，纯逻辑，双端编译） - wave_ring：8 路 × 320 点列优先环（1 kHz，预触发 160 + 后触发 160），adcTask 唯一写者；触发/冻结/封存/冷却四态，冻结持续到落盘回执才解冻，滞留 2 s 自弃 兜底——下一次真故障无波可录比丢一段更贵 - wave_store：段头编解码 + 拉模式打包游标 + 自带无表位运算 CRC-16/MODBUS（带 锚点自检）+ 段名与整段长度等式；格式不依赖平台类型宽度 - 段头只存原始码值与封存瞬间生效系数，工程量只当单位标签、不进任何算式 - 三套主机单测（环 113 / 编解码 170 / 触发状态机 110），全部无桩、生产源原样 纳入；新文件补 stddef 是 ARMCC 与主机差异，主机侧照不出这条分叉 - test/host/wave_read.py 是按 §6.2 的独立第二实现（dump/fft/shape/plot），92 条 自洽断言；三份合成段互读双校验全过、哈希钉死，格式面双向闭合 - 三套新单测不加专属钩子，由覆盖率总闸全量真跑（沿用既有裁定） 接线（任务层） - adc_cal：新增生效系数的 32 位定点原值入口（与既有浮点入口共用生效视图）， 段头按最低有效位精确记账，不经浮点回算 - adcTask：每拍压 8 路语义原始码值并推进状态机，封存那一拍同拍交棒封存瞬间事实； 台架定周期自抓走双层编译门，产品镜像里零存在；串口新增一条 wave: 周期行 - defaultTask：卷空闲后一次心跳整段搬完（try 锁 + 256 字节分片 + 一次完整开档到 关档），成败都回执；失败先删半成品再计错，段号只在成功时推进；持锁超 50 ms 补一条告警并记历史峰值（喂狗余量可核） - Lead 复核补第四道并发陷阱：采集任务优先级高于落盘道，搬段中途它可能正好把滞留 超时的本段自弃、甚至封出下一段——数据区校验和是对「实际读到的字节」算的， 半新半旧的段照样自洽，故关档后复检环侧身份判废：删文件、不补账、段号不推进 - Lead 复核抓到触发挂号不是原子操作（旧实现分三个字节写，消费者可在窗口里读到 上一段的触发源与元件号）：已把载荷压进一个字节，越界当场拒且不记任何计数； 段文件字节布局零改动，三份合成段哈希逐字节不变 - protectTask：保护启动上升沿同点请求录波，一拍一次、元件号取最低位；判据本体 零改动 人机（160×160 单色屏） - 菜单树节点 26「手动录波」绑页面 + 记录查询组末新增「录波回放」叶，重跑生成器 得 43 节点 / 34 叶 / 30 已绑，页面映射 28 → 30 - 回放页一屏一路、触发点前后各一周波共 40 点、每点 3 像素阶梯线（只用水平与 垂直两种线段——单色屏斜线会被阈值裁掉）；零点虚线、触发光标、窗口峰值、 单位徽标与形状受限徽标；空态与坏段各一句显式文案，绝不用半截波形冒充数据 - ui_data 新增录波注入通道（六件操作表、三态返回）；执行侧胶水带段头缓存、 手动请求后连缓存一起作废、逐点走全仓唯一的码值换算入口 - 模拟器接真实环与编解码合成两段（含坏段与空态旗标），6 张新黄金参考，既有 60 张逐字节零漂移未用更新模式；字库 218 → 224 字 / 319 字形 - 两份图形配置里图表组件仍为关；零堆分配；页面池水位不变 - 回放读路径的 uiTask 阻塞上界按实码写清：一次渲染 = 段表刷新 + 未缓存段头最坏 22 次小读；已验段只剩一次开窗读 + 40 点解码；无实测数不编，实测归台架、 仪器用已在跑的单轮工作耗时探针，不新加埋点 台账与文档 - 内存台账：录波环与落盘/回放静态逐条入册，三档对照 81,536 → 88,296 → 89,936 字节（62.2% → 68.6%），累计 +8,400；预估 5.9 KB 与实测 +6,760 的差额点名； 散列文件头注释同步；任务栈表核对后无需抬栈；体积趋势行与同码凭证由权威构建 重打（0 错误 0 警告，四项体积与上一轮相同——本轮改动只有注释与声明位置） - 设计说明：§5 补第四条并发陷阱；§6.3 定字段口径（两份独立实现的共同依据）； §7 回填实测；§9 周期行写实；§10 台架判据改两段式且不比绝对相位；§12 补读路径 风险行；抬头状态改成「代码面已交付、未做完的只有板级那一轮」 - 卡片：软件闭环一栏列证据；台架三条按用户裁定保持未完成，不做虚假销项 - 口径同步：数据可信、UI 补齐、页面补齐规划、产品需求、采集短板评测、任务规划 索引与两份 README；陈旧现状句清扫 16 处（带日期戳的历史取数行一律不动） - 门禁说明：nested-comment 记仓库根探测必须兼容 linked worktree 的 gitdir 文件 形态（修前该钩子在任务树里恒报环境错、静默不可用）；coding-standard 记 「函数头注释超过 24 行就把函数功能挤出回看窗口」这条机制与本次现场 - 覆盖率基线登记两个新覆盖模块（套件 41 → 44 套）；环单测重打后该文件有效行 227 → 226、覆盖行 226 → 225，比率仍 99.6%，是分母变小不是覆盖率回退 为什么是单一提交：文档链接、双端注册、生成器幂等（菜单与字库）、内存数字与 体积事实源、编号门禁这五道整仓门禁要求代码、页面、菜单树、字库、文档与台账 同处一个提交才自洽，按数据面/接线/人机/台账拆成四笔必然红其中至少四道 编号门禁新增行 14 处命中已按语义改写：魔数常量按字符命名、段名样例改由格式串 生成、频谱表头改 f / 2x / 5x 并加一行图例；改写后自洽断言 92 条仍全过	2026-10-29 19:23:15 +08:00
wandering1	16048140fd	chore(体积): 重盖同码凭证（sb_proto 进索引） ... 上一条提交漏带 scripts/size_attestation.json。指纹按 git 索引内容生成， sb_proto.c/h 进索引后指纹从 bfe075e7 变为 df1c01ab，凭证不跟着走就会 判"不同码"。 Code=236,460 B 不变（新模块尚无调用者），RW_IRAM1 81,536 B / RW_CCM 57,376 B 均未动。	2026-10-29 19:17:56 +08:00
wandering1	b25d70e962	feat(屏板): 协议层 sb_proto（帧 A 解析 / 帧 B 组帧 / CRC-16） ... 批 1 的 1-1：新建 Drivers/BSP/ScreenLink/sb_proto.c/h，纯逻辑、无 HAL 依赖， 可主机侧单测。屏板侧的协议事实源是 DTU-LCD 的 CRC16.c / MODBUS.c / rs485.h。 - CRC-16/MODBUS 用一张 16 位合并表（512 B，与屏板两张 8 位表同量）。可逐项 验证的关系：s_crc_table[i] == (auchCRCLo[i] << 8) | auchCRCHi[i]——屏板把 低字节表叫 Hi、高字节表叫 Lo，这正是下面那个字节序陷阱的根源。 - 帧 A 解析：先校 CRC 再看字段。地址/功能码/命令类型不符报 BSP_ERR_PARAM， CRC 不符报 BSP_ERR_CRC（调用方据此决定"计数"还是"静默丢"）。RT_CMD 带 非 0 key 不报错、按 0 收——为这一项丢一帧等于丢一次刷新，代价不对等。 - 帧 B 组帧：普通图（掩码小端）+ LOGO（宽高大端 + 魔数 0x89 0x45），整帧 4208 B 重写（998 B 填充固定 0x00 且参与 CRC），组完即自校验。 LOGO 容量按字节数判（((w+7)/8)*h <= 3200）而不是像素数：161x159 只有 25599 像素，却要 3339 B 才装得下。 - 主机单测 59/59 PASSED（test/host/sb_proto/），覆盖率 74/74 行、6/6 函数。 其中两条向量是屏板自己算出来的线上字节（01 03 01 00 F0 48 与 01 03 00 09 31 DE），并按屏板 Check_CRC 的口径反查"它会认这一帧"。 - 双端注册：uvprojx 加 File + IncludePath；模拟器侧走 check_registration.py 的 MCU-only 豁免（纯逻辑，模拟器无消费路径）。 - Keil 构建 0 错误 0 警告；Code 不变——尚无调用者，链接器按未用节丢弃。 文档侧的 CRC 字节序订正见下一个提交。	2026-10-29 19:17:28 +08:00
wandering1	f5161e1567	feat(日志): 控制台迁到 RS232#1/UART5，USART1 让位给屏板链路 ... 批 0 的第 2 项。USART1 是唯一 MCU 引脚直出的 TTL 通道，700 kbaud 的屏板 链路要用它，控制台必须先让开。 console_log.c 加一处端口收口块，换口只改这一段： CON_UART / CON_UART_IRQN / CON_UART_CLK_DISABLE/ENABLE / CON_UART_INIT 代码实际改动 4 处：con_tx_bounded 的 huart1.Instance（NULL 判据、counted 回退、赋值）与 con_uart_reinit 全函数体。其余是把描述当前行为的注释里的 USART1 换成「控制台串口」；历史变更记录（2026-10-02 / 10-24）里的 USART1 保持原样，那是当时的实况。 注意事项：UART5 在 APB1、USART1 在 APB2，时钟宏不能照抄； __HAL_RCC_UART5_CLK_ENABLE 定义在 stm32f4xx_hal_rcc_ex.h。 不改 UART 模式（2026-10-26 裁定：保持 UART_MODE_TX_RX，不动 RX 配置）。 MX_UART5_Init 在 Src/main.c:135，比 MX_USART1_UART_Init 晚几个初始化调用， 该窗口内的日志由 CON_UART.Instance == NULL 短路接住（记 dropped，不崩）。 构建：Code=236,460 RO=28,124 RW=1,876 ZI=137,084（Code 较迁移前 +4 B）。 台架验证（COM3 @115200，RS232#1 经 CN1.10/CN1.12）： - 烧录回读 no difference found；8 个 required 锚点全中，无 forbidden； 启动到 net init: OK 用时 661 ms - 连续 10 分钟长稳：1218 行，零 [ERR]、零 dropped、零 tx_fault， 末行仍在正常 PROF 输出 - USART1 已无任何控制台写入（全文件 grep 只剩历史注释）	2026-10-29 18:45:59 +08:00
wandering1	0c8fb5e1b6	chore(体积): 合并后重盖同码凭证（指纹 d9848eb1，体积零变化） ... X-20261029 合入 v2-on-ui 后体积门禁报「不同码」，原因是凭证按 git 索引 blob 计算指纹，纯注释改动也会改变文件哈希，尽管链接产物一字未变。 @build 已在合并提交 c51ac2e8 上跑过 0 错误 0 警告，.map 为 17:50:23 的 产物、晚于最新受管源码，前置条件满足，故按门禁自身给出的修复路径重盖： ram_baseline.py --update check_mem_numbers.py --write 与 ram_baseline.py --write 均报「已是最新」， tsv 今日行数字相同未变，本次只改凭证四个字段（fingerprint / built_at / git_head / map_mtime），sizes 与 pct 保持原值： Code=236,456 RO-data=28,124 RW-data=1,876 ZI-data=137,084 RW_IRAM1 81,536 B (62.2%) / RW_CCM 57,376 B (87.9%) check_size_gate --local 现已通过：同码 + 受管区 <= 92%。	2026-10-29 17:52:33 +08:00
wandering1	c63bd029a9	feat(门禁): 新增 skill-size 钩子——SKILL.md 不得超插件写侧上限 65536 ... dsh-mnemon 的 MAX_SKILL_BYTES = 65536 只在写侧校验，加载侧从不检查， 所以正文越界的技能照常加载、却永远生成不出草案：同日两次卡死 （83194 字节与 72601 字节）都是这个形态，复位台账无效，只能瘦身。 故把上限机械化，越界与悬空指针在提交期就拦下。 - scripts/check_skill_size.py：纯标准库（裸 python 也能跑，故不解析 .venv）；FAIL >65536、FAIL reference/ 指针悬空、FAIL UTF-8 BOM、 WARN ≥49152（75%——实测一次「采纳」把主文从 49821 顶到 62806）； 总是全树扫，只拿 reference/x.md 触发的提交正是漏网场景； --root 可复指到用户级 ~/.dsh/skills；--selftest 五形态（干净 0 / 临界 0+WARN / 超限 1 / 悬空+BOM 1 / 根不存在 2）全过 - .pre-commit-config.yaml 加 skill-size，files: ^\.dsh/skills/ - 新增 docs/门禁说明/skill-size.md，含盲区：拦不住插件自身的采纳写盘、 用户级技能目录不在触发面、不解析 frontmatter、不查 U+FFFD - 计数同步 51 -> 52（实跑 48 -> 49，索引 28 -> 29 篇）：AGENTS.md 与 门禁索引，另 7 处文档旧计数改写、CI 指南带日期实测行只加注 本笔先落地，技能正文的渐进展开拆分在下一笔。	2026-10-29 15:02:23 +08:00
wandering1	db5109e41d	chore(size): 重打体积同码凭证——补上一笔注释收尾提交的同码缺口 ... @build 0 错误 0 警告之后跑 ram_baseline.py --update：新增 2026-10-29 趋势行，并由它 自动 --stamp 重打 scripts/size_attestation.json。 数字与 2026-10-28 那行逐项相同（Code 236,456 / RO 28,124 / RW 1,876 / ZI 137,084； RW_IRAM1 62.2%、RW_CCM 87.9%，红线 92%）——所以缺的不是体积变化，是"这份源码对应 一次真实链接"的同码性：上一笔收尾提交改了保护任务源文件（纯注释）却没有重测，凭证 自那次起一直红着，主干 push 会被它拦下。 现在 check_size_gate --show 与 --local 均判同码通过；本地 CI（含体积步）全绿。	2026-10-29 07:50:33 +08:00
wandering1	21c68521ff	feat(task-worktree): 桥接 DSH worktree 插件——补共享联接、锁归属 pw:<name>、修释放不掉 ... 诉求最初是升级 dsh-task-worktree：实测已装 0.4.6 = npm dist-tags.latest，无需升级； 真正的缺口是本仓 skill 看不见插件建的树（.dsh-worktrees/），故按用户追加指令把两套 系统接起来。回收方向刻意不打通：本 skill 永不删插件的树。 脚本 task_worktree.py：新增 plugin 子命令 list/adopt/unadopt，事实源是 git worktree list（不是插件 manifest，免得被绕过）；adopt 只补缺失的 .venv 与 simulator/SDL2 联接，已有联接跳过、实体目录绝不碰；锁归属用 pw:<name> 前缀；new 顺带提示另有 N 棵 插件树、不占活跃上限 3。 一并修一处真 bug：lock release --bench-pass 在任务无台账时先 EnvError 退出、锁释放 不掉，导致每个任务的 done 收口连坐失败；现在改为警告后仍然释放。 keil-build：default_lock_task() 增加 .dsh-worktrees/ 反推分支，插件树内的构建归属 pw:<name> 而不是兜底的 build-cli（主树行为未变，本次 @build 实测仍走 build-cli）。 .gitignore 预先忽略 .dsh-worktrees/，让插件的 ensureIgnored() 找到同一字面量、不再 改写这份受控文件。check_doc_links / check_layer_deps / gen_refgraph 三处扫描面同步 排除：仓里再放一份仓会让 doc-links 假红、并让生成的配图字节漂移到 generated-fresh。 文档：并行任务工作树方案新增 §3.4 两套系统边界对照；SKILL.md 加 §F 共存一节，同时把 §B 从 53 行压到 29 行（净 +39，用户此前在飞的改写已 rebase 保留、未被覆盖）。 验证：@build 0 错误 0 警告；scripts/ci_local.py 48 根提交期钩子与 gitlint 全绿； check_doc_links --all --sections-strict 通过（2596 章节引用、无法判定 0）；id-check-new 通过；改动文件字节体检无 BOM、CRLF 与 U+FFFD。桥接行为在临时 scratch 仓端到端跑过 （adopt 建两个 reparse、unadopt 只摘联接、pw 锁取放、缺台账也能释放、越界 name 退 2）。	2026-10-29 07:50:05 +08:00
wandering1	41670a1cc6	docs(gates): 主机单测套数复点同步——41 套 / 无专属钩子 19 套 ... 第 41 套 boot_stats 由 728d6067（2026-10-27 11:29）入库，全仓写的 「40 套 / 18 套无专属钩子」从那天起过期；本轮按实测复点同步。 真值双源互证：test/host/*/run_unit_test.py 实数 41（43 个目录，除 common 与 __pycache__）＝ scripts/check_test_coverage.py 自报 suites=41/41。专属钩子 22 根（YAML 解析 id 以 -unit-test 结尾， 22 条全对得上有 runner 的目录）⇒ 无专属钩子 19 套 = 41 − 22。 改当前态共 18 处：AGENTS.md 提交门禁节三处、.pre-commit-config.yaml test-coverage 注释、docs/门禁说明/host-unit-tests.md §6 第 4 条六处 （无钩子名单首位补 boot_stats、目录数 42→43、裁定句改「裁定当时 18 套，2026-10-28 现值 19 套」）、docs/门禁说明/README.md、 docs/代码规范/pre-commit使用说明.md 两处、docs/编号规范.md、 scripts/README.md、docs/任务规划/分工说明-20261028 一条、 docs/测试说明/主机单测覆盖率口径.md 追加 2026-10-28 = 41 套 ~105 s 新实测点、test/host/sys_log_mcu/sys_log_mcu_test.c 注释行。 刻意不动：带日期戳的历史耗时与套数行（只追加新的实测点，不覆写）、 host-unit-tests.md 里「22 根 / 40 套 / 18 套无专属钩子」这句复核原文 （只在后面追加更正）、scripts/archive/id_gate/ 留档两处、 同数不同义的五处（40KB 级 / −20~40% / 不到 40 行 / 18 断言点 / 板端 RTC 套件）。钩子数 51、专属 22 根、提交期实跑 48 根本轮实测 未变，相关句一字未动。 门禁：doc-links --all --sections-strict / id-check-new --worktree / no-mojibake / bom-drift / validate-config 全 rc=0， test/host/sys_log_mcu 单测 rc=0；改后复扫「40 套」仅剩 3 处 （1 处刻意保留 + 2 处留档）、「42 个目录」0 处、「18 套」仅剩 2 处 （都带「当时」口径）。	2026-10-29 00:58:23 +08:00
wandering1	295eb9911f	ci(gates): 覆盖率总闸与全量 cppcheck 移到远端 CI 强制（提交期实跑 48 根） ... 用户裁定 2026-10-28：慢钩子不再压在每个 git commit 上，由远端 CI 强制；本地等价入口 = scripts/ci_local.py 的 manual 段。 实测三根耗时：cppcheck 20.5 s、test-cppcheck 38.1 s、 test-coverage 105.2 s，合计 ~165 s ≈ 一次带代码提交耗时的 三分之二（test-coverage 的 files: 覆盖 App/，改一行就跑光 40 套）。 - .pre-commit-config.yaml：cppcheck / test-cppcheck / test-coverage 加 stages: [manual] + 理由注释；替换掉 test-coverage 上方「没写 stages → 所有阶段都跑、输出出现两次」 的旧坑注释（固定 manual 后不再有这一坑）。 - .gitea/workflows/ci.yml：static-gates job 在静态门禁步之后 新增「手动阶段门禁（覆盖率总闸 + 全量 cppcheck）」步， if: always()，逐根 --hook-stage manual（pre_commit run 不支持 多 id），日志 ci-artifacts/manual-stage.log + 归档 + STEP_SUMMARY， rc≠0 即失败；run 块纯 ASCII。 - scripts/ci_local.py：新增 MANUAL_STAGE_HOOKS 与 run_manual_stage() （静态段之后默认跑），删 run_coverage() 死代码，--coverage 降级为兼容别名。 - AGENTS.md + 12 篇 docs/scripts/README：三数同源口径改为 声明 51 / 提交期 --all-files 实跑 47 / +gitlint = 48， 其余 3 根在 manual 阶段；历史测量数字只加「当时」不回改。 验证：pre-commit run --all-files = 47 Passed / 0 Failed rc=0； manual 三根 Passed（test-coverage line 89.8% func 93.2% 41/41 套）； ci_local.py --static-only 全绿；check_doc_links --all --sections-strict rc=0、mojibake / bom-drift / id-check-new rc=0； ci.yml yaml.safe_load 通过。未改任何 .c/.h，故未跑 @build。	2026-10-28 23:04:59 +08:00
wandering1	e9cae5fdcd	chore(size): 重打体积凭证（合树后同码 @build 0/0，数字未变） ... 前面几笔（含并发会话那两笔）改动了在册文件，凭证指纹还停在 21:41 的 索引上，体积门禁因此报「代码与测量不同码」。现在按合树后的状态重打： @build 0 错 0 警，Program Size Code=236456 RO=28124 RW=1876 ZI=137084，与 scripts/ram_baseline.tsv 的 2026-10-28 行完全一致， 所以台账不追加新行（ram_baseline.py --update 自行判定同码不重复登记）。 check_size_gate.py --stamp / --local 均 rc=0。	2026-10-28 22:24:33 +08:00