14 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
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	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	dc214e1426	docs(UI): 内容页黄金参考当前态改报「60 张」，三数按双源实测同步 ... 三数实测真值（每项两个独立来源互证）： - 张数 60：simulator/tests/ref/ 入库 shot_*.bin 实数 60 ＝ check_content_pages.py 的 PAGES 条目数 60（id 逐一对齐）。 - 已绑 28 叶 / 未绑 5 叶：ui_page_registry.h 的 UI_PAGE_MAP_COUNT 28 ＝ ui_menu_tree.txt 剔掉文件头注释示例行后的 #page= 实数（不剔是 29）。 - 字体 218 唯一字 / 313 字形：ui_cn_chars.txt 唯一码点 218（ASCII 区 0 个，ASCII 0x20~0x7E 由生成器子集参数另计、不算进字数）； ui_font_cn_12.c 的 .bitmap_index 条目 314 条含 notdef，剔掉 notdef → 313 = 218 + ASCII 95。 口径更正（数字一律不动）：当前态计数单位由「页」改报「张」——张数 = 页面个数 + 分页页多拍的第 2 屏（runreport_p2 / sparam_p2 两张），两个数 不许互相冒充。同日先前那行「53 → 59 页」是页面个数口径、与判据本体 不同源，原文冻结不回改，只在各文件变更记录末行追加当日更正。 历史一律冻结：变更记录里的 27 / 40 / 47 / 53→60 / 59 与字库 122/217、 179/274、185/280、183/278 都是当日快照，只追加、不回改。 夹带说明：.pre-commit-config.yaml 一并入本笔——pre-commit 要求配置本身 已 staged 才允许提交；该文件的改动是 ui-golden 显示名（60 页→60 张）与 一条钩子计数口径注释（同日 51 → 52 → 51 净零，属另一类，已在此点名）。	2026-10-28 15:33:42 +08:00
wandering1	94b0d79026	feat(ui)+chore(docs): UI 补齐清单清空；数据可信销项与「卡」号清退 ... 本笔含两组收尾工作（同一工作区内交错在 6 个共享文档/门禁配置里， 拆开会产生"文档声称的页数与树里黄金数不一致"的中间提交，故合为一笔）： 一、UI 补齐（清单清空） - 新建 6 个内容页模块：ui_page_accident / oper / alarm / start / yk 复用 ui_w_records 共享组件（分页、空态"无记录"、按实例读盘缓存）， 记录层与五个写入点已由道F task-10 / 道G task-12 落地，本批只补页面； ui_page_runreport 为 13 行 2 页只读统计，四个数逐个挂范围标签 （自电池周期 / 本次开机），boot_ready=0 显 "--" 不显 0。 - 数据面：ui_data_info_t 尾部追加 9 字段，ui_data_feed 用 boot_stats_get() + iec104_serv_get_stats() 纯搬运；模拟器填确定值假数据 （差异登记 docs/测试说明/模拟器差距清单.md §2.3 两行）。 - 接线：菜单树 6 叶绑 #page=，绑定叶 22→28、UI_PAGE_MAP_COUNT=28； 字库 185→218 字 / 280→313 字形；双端注册 uvprojx +30、CMakeLists +6。 - 回归：内容页黄金 53→60（含 runreport_p2 真拍第 2 页），文本断言 425 正向 / 36 反向；存量 53 张逐字节零漂移；记录 5 页各用独立空目录 （模拟器把操作留痕写进 cwd 的 sim_oper.log，共用 tmp 会让空态拍不到）。 二、数据可信销项 + 「数据可信」任务卡号整族清退 - 删除已闭环的"已知电压注入验证"行与闭环结论块（证据在 docs/硬件平台/ADC通道映射说明.md §8.1 与 docs/测试说明/ADC前端注入验证流程.md §5~§7），§5 标识列改语义短语。 - 卡 0/0b/1~12 共 14 个号全仓 288 站点 / 56 文件清退成语义短语， 代码注释、测试、门禁配置与文档一并改；换算表入 docs/编号规范.md §9.3。 这一族是中文前缀，不进 check_ids 语料，刻意不入 id_aliases.json。 验证（实测） - @build 0 错 0 警：Code=236456 RO=28124 RW=1876 ZI=137084； RAM +464 B（RW +304 / ZI +160），RW_IRAM1 62.2% / RW_CCM 87.9%， 体积同码凭证与 RAM 台账已回填。 - check_menu_rows 8 状态 rc=0（池 5368/5448 常量未动）； check_content_pages 60 页 rc=0；check_font_charset / registration / coding-standard / bom-drift / mojibake / doc-links --all / layer-deps / nested-comment 全 rc=0；check_ids --strict 无错误；主机单测 ui_data 295 / boot_stats 21 / sys_log_mcu 141 / soe 32 / soe_store 27。 未做（不是遗漏） - 六页真机判据（真记录翻页、掉电保持、清除后归零、boot_count 自增、 拔 RTC 电池落 RESTARTED、IWDG 复位落 rst_cause、主站连一次 conn_up+1） 已登记 docs/任务规划/登记簿.md §7；模拟器结构上照不到。 - docs/产品需求/产品需求设计文档.md 属另一条在飞改动，本笔不含； 其中我已同步 6 处现状数字（28 叶 / 60 页 / 218 字），随该笔入库。	2026-10-28 07:23:16 +08:00
wandering1	a275539c17	docs(全仓): 内容页黄金 47 → 53 的当前态同步——含钩子显示名，登记簿口径另笔 ... task-9 让内容页黄金从 47 涨到 53（通讯设置页六态），本笔只做**当前态陈述**的同步；真值全部本轮实测： `simulator/tests/ref/*.bin` = **53**；`git diff 31ca4a1f..HEAD` 对该目录 = ** 6 个新增、零修改** ⇒ 存量 47 张 逐字节未变（这条是关键：新增页不该让旧页重生成，否则回归基线就失去意义）。 **四类命中各走各路，这是本笔的全部难点**（分类比替换重要得多）： · 当前态 → 改，25 处页数，落在 16 只文件（AGENTS、钩子显示名、导航器 docstring、`lvgl-simulator` s kill、 门禁索引与 `ui-golden` 详解、UI 自动化流程、内容页架构、页面补齐规划与扩充方案、数据供给、自动化测 试流程、覆盖率口径、测试开发标准流程、模拟器两份 README）； · 变更记录历史行 → **一条不动**，另在其下一行插入当日「47 → 53」新行 6 条（含判据与零漂移证据）； · **同数不同义 → 不动**：覆盖率口径里的「47 个 .c」「47 = 13+5+29」、ram_report 的表行号 47、`#47-D` 诊断号、LSI 47kHz、47,360 栈字数、像素哈希 3476/3474 —— 一并替换就会毁掉六个不相干的事实； · 带日期戳 / 自declare 冻结的快照 → 不臆改（数据供给篇那句上一笔已加「当时」，页面补齐规划里那张 「2026-10-25 复核…剩 21 叶」的表自带「完成即冻结不回改」声明）。 复扫残留当前态 47 = **0**。⚠ 顺手纠一条**会教错方法**的陈旧：naive 计数 `grep -c '#page='` 上一笔写的是 22，现在真值是 **23**（文件头示例行也算一次）——旧文档里那个 22 **恰好等于新的正确 bound 数**，不改的话, 下一个人用错算法还能碰巧对上，比错更糟。 ⚠ `AGENTS.md` 里本次有两件事同行相邻（本笔的内容页 53 页 + 批次三那句 `TC-*` 停发），**分两句说明**： 前者是计数同步，后者是昨天那条「批次三不坐」裁定的入口文案，二者不是同一件事。 钩子显示名改在 `.pre-commit-config.yaml`（47 → 53）。**这条必须与代码同批入库**：配置脏而未 stage 时 pre-commit 会直接报错挡住全仓任何提交（今天已实测两次），所以本笔先落它，把后面几笔的路清开。 自查：`check_doc_links --all` rc=0（203 篇）、`check_ids --strict` rc=0 且不可判定绝对 数 **979 未变**（新增 文本里的提交号与 `#page=comm` 没推高它）、`gen_task_table --check` 0、`check_bom_drift` 0、18 只文件 noBOM / LF / U+FFFD=0；行数变动 +49/−47 全部可归属（插 6、删 2、并 1），其余为 1:1 等行替换。登记簿销项与叶数 （`UI补齐.md` + `docs/任务规划/README.md`）**不在本笔** —— 那是口径变更不是计数同步。	2026-10-27 13:54:05 +08:00
wandering1	31ca4a1faa	docs(计数): 内容页黄金参考 40 → 47 页全仓同步，登记簿剩余项与顺序一并更新 ... 上一笔 UI 落地时我把「文档计数与真值同源」这件事留在了别人身上（setpage 的移交项写得很明白：内容页 40→47 的全仓计数改写由 Lead 派）。这一笔把它做完，**只改当前态陈述，历史不动**： · **改成 47 的判据**：simulator/tests/ref/ 实测 47 张 .bin（7 张新增、存量 40 张逐字节零漂移），共 1 6 处当前态 陈述跨 11 只文件同步——含 AGENTS 的 ui-golden 条目、**钩子显示名**（.pre-commit-config.yaml） 、门禁索引与 ui-golden 详解的标题与正文、UI 自动化流程的页数与 PASS 文案与快检张数、内容页架构回归段、覆盖率口径的 「不做 UI 单测」理由、启动自动化流程回归段、导航器脚本 docstring。 · **不改的两处，理由写明**：5 只文件里的历史变更记录行「27 → 40 页」是当天事实，原样保留，只在各文件 变更记录顶部加一行 2026-10-27 的 40 → 47；UI_界面制作流程 的「< 40KB」是绘制缓冲红线，与本数无关， 属扫描误报，不动。 · **一处加限定语而不是改数**：UI_自动化测试流程 的「文本断言 310 条、覆盖 40 页中的…」带 2026-10-26 实跑 日期戳，那是那天的测量口径 ⇒ 改成「覆盖**当时** 40 页」，310 条不臆改，等下一次实跑回填真值。 顺带同步 docs/任务规划/README.md（登记簿销项，用户授权）：开篇「第一项是实现 param_request 写路径、然后做 整定 4 页」早已完成 ⇒ 改为剩余三项「通讯设置 → 记录 5 页 → 运行报告」；§2 顺序表「按 §1 的 1→5 推进」改为 「剩余 3 项按 1→3 推进（原第 1、2 两项已落地）」，与上一笔 UI补齐.md 的销项结果对齐。 三数同源自查：AGENTS 钩子数 51（YAML 解析口径）、内容页 47 页、门禁索引 27 篇均与配置一致； check_doc_links.py --all exit 0、check_ids --strict exit 0 且不可判定绝对数 **1,156 未变**（本笔没吃余量、 没新增编号引用）；13 只文件全部 noBOM / LF / U+FFFD=0 / 结尾换行齐。本笔零固件源，不改构建产物。	2026-10-27 07:16:32 +08:00
wandering1	d286b69a2d	chore(工具,文档): 台架 rc 语义与导航硬闸用例、门禁环境诊断、护栏还债算法、mem-budget 跨树口径 ... 四条道的收尾件同笔（全是 python 工具与文档，零固件源；各段归属按道署明）。 · **台架（bench-runner）**：verify_log.py 新增 classify_measurement() 与 measureme nt.* 字段，零行/零锚点 判 exit 2 并打 [MEASUREMENT-BROKEN]，**但同帧有 Forbidden 命中或自检故障仍判 1**（专门造了「零锚点 + [ERR] MEMFAULT」的陷阱日志实测——崩溃不许被降级成「没数据」）；--selftest 16 → 22 条。board_ui_nav.py 把两条执行页安全闸做成 7 条常驻用例接进提交钩子跑的快检档，作者把自己用例**证伪三轮**（测试强制上限、 清单清空时是崩不是判定、出厂默认被翻允许也照样绿）后三条危险改动逐条能红。台架卫生清单落 §7：每圈复位 前 open + 断言 ready + 看 rx 增长（今晚 daemon 死了 status 自愈把它遮住）、**Forbidden 令牌不得落在 英文单词内部**（裸 Fault 命中 default 两次假红）、改判定语义前先 grep 消费者。 · **环境（ui-param-writer）**：证伪卡片前提两处——identify 那个版本根本没有 tags 模块（RECORD 与磁盘逐项 一致，pre-commit 自己也从 identify.identify 取 ALL_TAGS，全仓零引用），真问题是 44 条 system 钩子里 42 条 entry 用裸 python → PATH 首位那个零第三方包解释器，今天没炸纯靠两件事同时成立。交付是**新增 entry 硬规则 + 修复死顺序与回滚并标注等静默窗口**，没有动共享环境（此刻重装会让别人的钩子在半途换解释器）。 · **门禁（gate-docs-fixer 已入库的 51 号钩子）**：本篇带上 host-unit-tests 的裁定句落点说明。 · **内存（comm-config-writer）**：mem-budget skill 补跨树测量身份口径（脚本按 __file__ 定位产物、什么才算 一次新测量、多链同涨同一数值的共享帧/幻影环归因法）+ 看门狗说明的指针行。 实测：verify_log --selftest 22/22、board_ui_nav --selftest-quick rc=0（硬闸 7/7）、 doc-links --all exit 0、 check_ids --strict exit 0 且绝对数 1,156 **未被本笔吃掉**；全部文件 LF / 无 BOM / U+FFFD=0 ；本笔零固件源, 随上一批权威构建验证过（0 错 0 警），故不再单独 @build。	2026-10-27 05:16:58 +08:00
wandering1	ac9ca33f0f	fix(台架脚本): 导航器加两条硬闸——执行类页面默认不进、未知屏 ENTER 最多一次 ... bench-runner 在给 UI 窗口做准备时报出一条**三段叠加就会真执行破坏性动作**的路径， 而我就是其中一段的作者：496b4dc5 把 e 放进 UNKNOWN 屏的回退键序（当时的动机是真的 ——本机待机态按 s/l 无效，冷启动落在待机态时闭环导航直接开不了工）。叠加面在这里： · 导航器每进一个叶子就发一次 ENTER，且会替「查看密码」自动确认； · 装置维护的 强制复归 / 清除记录 已进菜单树； · 这两页是**两段式确认**——第一次 ENTER 只把该行标成「确认?」，第二次 ENTER 就真的 执行（复归全部保护动作位并写 SOE / 清 SOE·运行·操作记录）。 单个 ENTER 安全，但**同一屏上第二次 ENTER 不安全**；而退避键序是循环消费的，第一次 按 e、第四次又按 e。更要命的是：新字库缺字、白框、状态行变化恰恰最容易让页面被判成 UNKNOWN——那正是我们最想在 UI 窗口里抓的东西。**越是显示异常，越容易被脚本按执行**。 两条硬闸（不改任何固件、只动这一只台架脚本）： ① to_root() 内 ENTER **最多按 BACKOFF_MAX_E 次**（默认 1）；还需要第二次就当场报错 停机、并把 dump 的帧留在盘上，而不是把第二个 ENTER 投出去。报错文案直接点名执行类 风险与放行方式（改用无 ENTER 的键序 --backoff-keys sl）。 ② 执行类页面 EXEC_PAGE_IDS = clear / reset **默认拒绝下钻**；确有真机需要才显式加 --allow-exec-pages，且运行时打印警告。要看这两页的显示正确性，正路是模拟器黄金参考—— 同一份 UI 源码、零真机副作用。 通用口径一并写进文件头：**导航类自动化脚本默认零 ENTER**，ENTER 只允许出现在明确 指定的、非执行类的用例步骤里。「靠按 ENTER 从未知状态脱身」这个前提本身就与执行类 页面冲突，不该由脚本替你承担后果。 行为验证（假设备，绝不连真机、绝不注键）：clear / reset 均被拒且理由含「真执行」； clock 不受该闸影响（走到设备层才失败）；持续 UNKNOWN 的循环实际按键序列是 e-s-l 后 在第 2 次 ENTER 前停机，实测 ENTER 计数 = 1 = BACKOFF_MAX_E，报错理由点名执行类风险。 5/5 通过；py_compile 通过；--help 可跑。临时脚本没留在仓库里，__pycache__ 已清。 另两处纯计数更正（与文档道 task-39 同批真值：黄金参考 40 页）：本文件 selftest_refs 的 docstring 27 → 40；.pre-commit-config.yaml 里 ui-golden 的显示名 27 → 40（这是 「声明 / 文档 / 实跑」三数同源的最后一处不同码）。	2026-10-27 00:13:41 +08:00
wandering1	496b4dc5e2	fix(台架脚本): board_ui_nav 的 UNKNOWN 回退键序改为 e-s-l，冷启动落在待机态不再空转 ... 旧逻辑 UNKNOWN 分支里的 l 条件**永不可达**：classify 只在 MENU 态填 cols，UNKNOWN 恒 cols=None ⇒ 回退实际等于静默连按 s。而本机待机态按 s/l 无效、要按 e 才进菜单 ⇒ 冷启动恰好落在待机态时，闭环导航直接开不了工（症状是界面点不动，脚本却报正常）。 现在 BACKOFF_KEYS 默认 esl、--backoff-keys 可覆盖（要旧行为填 sl），回退时**循环消费 键序、绝不连按同一键**，并新增 _dump_unknown 把认不出的帧存证下来，免得下次只能靠 复述。同笔带上 task-24 在 19:41:56 重跑产生的 trace 归档（1 行，不是本次手改）。	2026-10-26 23:42:27 +08:00
wandering1	621421f3ca	fix(判据脚本): --walk 存证不进工作树；真机动作需显式持锁确认 ... 票 = task-26（自报缺陷，Lead 批准开树自修）。两处都是我上一笔（导航器入库）留下的： 一条会让工作树变脏，另一条更严重——动到了不属于我的台架。 一、--walk 的存证落点 - 症状：outdir = os.path.join(HERE, "walk")，HERE = <仓库根>/scripts → 真机跑完在 scripts/walk/ 落 12 个帧：git status 立刻脏、done 的并集残留审计会把它当任务遗留物， 下一个窗口还盖掉上一个窗口的证据。我自己刚立过「轨迹只在 --trace 给了路径才落盘」的 规矩，这条路径上被自己破了。 - 改法：默认落 <仓库根>/ci-artifacts/uinav/walk/（已 gitignore，本仓台架产物一贯在此）， --outdir 可改；并加**反向拒绝**——解析后的目录若落在版本控制内且不在 ci-artifacts 之下， 直接 [FAIL] 退出 3、连目录都不建。「跑完记得删」只防得住记得的人（同 bom-guard 立项 理由，也同今天 .map / 缺 lvgl_sim.exe 那一族：事实源不存在就大声失败）。 二、未持锁就注入了按键（实测踩到，已做成参数闸） - 我给「默认落点会打印成什么」做验收时跑了 --walk，脚本在没有任何拦截的情况下连上 7003 并开始注键；而那时台架属于验收窗的准备方，板子停在主干 mega 镜像上。**板端 UI 状态可能 已被推到别处**：只注入了方向/进入/退出类按键，未烧录、未碰串口、未触发任何写操作 （网口设置的保存行走不到——导航器从不在保存行按 ENTER，过密码默认也只走只读查看密码）。 - 根因不是手滑，是「必须持 bench 锁」只写在文档与 print 里：跑的人自认为在跑一次离线 检查，脚本就真去连了。于是把确认做成参数 --i-hold-bench-lock：不给就拒绝（退出码 3， 不碰网络）；脚本不代取锁，也不替人判断「应该没人在用」。 - 给窗口方的处置建议：验收窗前先复位一次，或直接以 --walk 起步（导航器第一步就是回根， 且回根后还补收一次 l 防被裁弹框漏计）——别把我注入后的残留状态当成验收现象。 验收（本机、无板，全部实跑） - --walk --outdir <仓库内目录> → rc=3 + [FAIL] + 目录未被创建； - --walk / --board 未给确认位 → rc=3 且**不触网**（瞬时返回，不再有任何连板可能）； - --selftest-quick rc=0（黄金参考 18 帧 0 错）；check_doc_links 通过； - 一笔提交，未用 --no-verify；工作树仅这 2 个文件改动，无多余产物。 文档同步：docs/UI设计/UI_自动化测试流程.md §7.3 补「存证不进工作树」「真机动作需显式 确认位」两条并把用法示例改对（同一事实只在一处，正文仍在那一节）。	2026-10-25 18:30:41 +08:00
wandering1	6a904c1bee	feat(判据脚本): 板端 UI 有状态导航器入库 scripts/board_ui_nav.py ... 票 = task-25（Lead 定位置与钩子档位）。ci-artifacts/uinav/board_nav.py 收编入仓：判据依赖一 个不受版本控制的东西，本身就是隐患（今天刚写过这条道理：只有记得做的人才做得到）。 为什么要有这个脚本（大窗实测，不是预防性工程） - RemoDispBus 的 KEY 应答是**空帧、不携带状态**：发了 5 个键不等于到了第 5 层。 - 靠预置键序盲走到深页，9 个「应当到达」的态里只有 3 个真是那个态：03 停在菜单级联、 04/05/06 停在**密码输入页**（墨量 512/515/512，与黄金参考的两张密码态逐字对得上——此前 它被记成「512 bits 神秘空白态」）、07 停在网口设置、08 停在装置信息。 - 所以导航必须闭环：每按一键重新认屏，再决定下一个键；「到达」只由页面身份裁定。 认屏三条判据（全部精确字形匹配，复用同一份 ui_font_cn_12 与黄金回归脚本，不复制第二套规则） - 内容页：标题带命中 + 该页黄金行文本至少一条 + 读页码行「第 N 页，共 M 页」；只认标题会把 两屏认成一屏（「参数」既是菜单项也是页名），页码让「第 2 页 / 共 5 页」成为可比对的事实。 - 菜单：在白底横条（反白选中行）覆盖的行范围内、**整幅宽度**找反白标签，长标签优先、命中框 被包住者丢。三条实测教训都在注释里：① 选中行是黑字白底，只按正常极性永远读不出选中项； ② 一条连续白 run 里可能**贴着两列**（子列左边框就是根列右边框），按 run 限宽找标签会把 子列整个吞掉；③「参数定值」那行必然同时落进子串「参数」「定值」，不去重就凭空多出两列。 - 密码页：「用户密码」四个字中三个即判 PWD（整串匹配实测差约 1 px 打不中；数字格随输入变， 不参与判定）。 - 另两条纪律：收级联列按 l 不按 s（菜单态按 s 不收列，用 ssssssss 回根正是错位来源）；菜单树 的 #P 注记可能写在 #page= **之前**，解析顺序错了就剥不掉、那一叶的 id 永远认不出来。 结构与安全边界 - SimDevice（无头模拟器当设备，不需要台架）/ BoardDevice（只连 7003 取图注键）双后端同一套 导航逻辑；脚本不含串口、烧录、复位，跑真机必须自己持 bench 锁。 - 「过密码」默认只走**查看密码**（出厂 000 直接确认）；修改密码要显式 modify=True，不因 「能进去」就自动升格成可写。 - 末列弹框被屏幕裁掉时读不到选带 → 「枚举 + 验终点」兜底（末列盲按 N 次再进，成败仍只由 页面身份裁定），并可用 --dump-fail 把认错那一屏存下来；轨迹只在 --trace 给了路径时落盘， 默认不往工作树里写文件。 - 缺模拟器可执行文件时报 FAIL + 可执行提示，不「跳过当通过」（与同一天 mem-numbers 缺 .map 同一课）；--selftest-quick 是那条限制下仍可用的快检档。 门禁 - 新钩子 uinav-selftest 跑 --selftest-quick（files 只覆盖脚本自身与 simulator/tests/ref 帧， 档位选择理由写在配置注释里）。本笔**未用 --no-verify**：本树先 @build 一次让 .map 事实源 就位，全量钩子通过。 - 实测（模拟器后端）：黄金参考 18 帧分类 0 错、真机留档帧 9 帧 0 错、闭环 12 个绑定页到达 10 页（差的 2 页正是上面第 1 条限度，报错大声、现场帧已取证）。	2026-10-25 18:00:56 +08:00