2 Commits

Author	SHA1	Message	Date
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