Dismiss WiFi boot prompt when mobile session opens

2026-10-09 12:26:55 +08:00
parent a277da0f96
commit c0e26b97fe
16 changed files with 250 additions and 18 deletions
@@ -1,5 +1,17 @@
 # 核桃派点阵屏控制服务测试流程

+## 手机会话取消 WiFi 开机提示（TEST-WIFI-MOBILE-DISMISS）
+
+对应 `DISPLAY-WIFI-INDICATOR`、`CONFIG-WIFI` 和 `DEVICE-MOBILE-SESSION`。直接影响设备会话入口、WiFi 覆盖取消与后台刷新；协议、App 和原生驱动不变。以本机 mock 覆盖延迟到期前连接、联网 IP/断网提示活动时连接、失败握手与无效参数、断开及网络变化、迟到查询并发、同 boot 重建和新 boot 重新计时；验证恢复用户帧，亮度、方向、模式和修订不变。
+
+部署后只读 `/api/status` 和帧接口，**不得访问首页**，因为首页本身会取消提示而掩盖手机入口缺陷。先核对提示未取消，再用登记手机的 `run_ble_test.py --scenario connection` 完成会话及断开重连，不发送改屏命令；应为 `dismissed_for_boot=true`、`wifi_indicator_active=false`。真实 `systemctl restart` 后保持取消；整机软件重启后，在手机尚未连接时应重新计时，等待提示延迟到期，再连接手机复验。网络断开/恢复分支优先 mock，当前任务不为此切换真实网络。
+
+取消路径和提示提交点使用同一独立锁；NetworkManager 查询在锁外，返回后在提交前复查取消状态，避免慢查询阻塞连接或重新显示提示。现有 boot 标记保存在 `/run/matrix-screen-controller`，不得改成跨整机重启的持久设置。板端核对真实驱动与 fault 统计，无驱动改动时按影响跳过无负载基准、实屏图案、摄像头、ADC 和无关 Android 页面；必要但未完成的手机或生命周期验证记“未验证”。
+
+本机 WiFi API 测试应先等待 mock 的开机网络激活完成，再记录激活次数基线，避免后台线程调度影响“下次开机”和“立即生效”的次数断言。文案目录校验失败时用 `scripts/build_ui_copy_catalog.py` 重建并核对实际差异，不绕过校验。中文路径下把 Python 子进程输出重定向为 UTF-8 日志时，仅对本次进程显式设置编码，避免父进程使用 UTF-8 而子进程仍输出本机代码页导致日志混合编码。
+
+比较部署和重启前后持久文件时分别记录两个阶段：普通部署应保持原有内容；既有 `kernel-recovery.json` 在整机重启后可由 `finalize_after_boot()` 更新成功 boot ID 与记录时间。只允许核验为成功且对应当前 boot 的这项预期变化，其余文件继续逐项比较，不把用户配置或资源变化一并忽略，也不恢复过期健康记录。
+
 TEST-MOBILE-WIFI-TRANSPORT 对应 DEVICE-MOBILE-WIFI-TRANSPORT/LIFECYCLE 与 WEB-MOBILE-PRESENCE，步骤见 `移动端相关内容/安卓app/如何安卓测试/WiFi传输测试.md`。合格标准：BLE 为会话前提、实际直连身份验证、独立密钥、无重复写入、WiFi 回退恢复、BLE 断开撤销、真实重启后新会话，以及网页/App 实际链路显示一致；模拟与实机分别记录。

 本文件只维护可重复步骤、分层边界和合格标准，不记录某一次已经通过的结果。任何物理操作都按 `AGENTS.md` 的人工停顿规则执行。