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
@@ -1028,7 +1028,7 @@ WebSocket 消息示例：
 - `ipv4_mode="dhcp"` 清除静态地址；`manual` 必须提供 IPv4 地址和网关，子网前缀空值使用 `/24`，DNS 空值使用网关。
 - `activation="next_boot"` 只更新持久 NetworkManager 配置并返回 `200`；`immediate` 先保存、返回 `202`，再异步激活连接，避免浏览器在响应发出前被切断。
 - SSID 按 UTF-8 字节限制为 `1..32`，个人热点密码限制为 `8..63` UTF-8 字节；IPv4、前缀 `1..32` 和 DNS 必须严格校验。除 `GET /api/network/wifi` 的 `saved.password` 外，任何响应、错误和日志不得回显密码。
- `/api/status.network` 暴露同一脱敏活动状态与提示状态；读取状态、静态资源和预览不取消开机提示，只有成功首页访问或成功改屏才取消。
+- `/api/status.network` 暴露同一脱敏活动状态与提示状态；读取状态、静态资源和预览不取消开机提示，成功首页访问、成功改屏或手机成功建立加密控制会话均取消本次开机的 WiFi 提示；手机断开、网络变化和服务重启不恢复，整机重启重新计时。

 ### 3.13.1 FRP 与网络诊断 API（`WEB-FRP-MAINTENANCE`、`CONFIG-FRP`、`WEB-NETWORK-DIAGNOSTICS`）

@@ -192,6 +192,7 @@ class DisplayService:
 ### 3.1.1.1 开机 WiFi 提示（`DISPLAY-WIFI-INDICATOR`、`CONFIG-WIFI`）

 - WiFi 提示是独立输出覆盖层，不写入当前用户帧、`last_mode`、用户亮度、方向或用户状态修订号；提示结束后恢复最新用户动图帧或静态帧。
+- 每次整机开机后，手机 App 完成加密握手及有效 `session.open` 即取消本次 boot 的全部 WiFi 提示，无需改屏；延迟到期前连接也取消后续提示。断开手机、网络变化及服务重启均不得恢复，整机重启后重新计时。扫描、底层蓝牙连接、失败握手或无效会话参数不取消；取消与后台提示提交必须协调，禁止迟到的网络查询恢复提示。
 - 仲裁顺序固定为 `临界低电图标 > WiFi 提示 > 开机笑脸 > 用户动图 > 用户静态画面`。WiFi 提示开始时结束当前开机笑脸，但不把提示帧当作用户改屏。
 - 连接成功时在黑底上连续左移 `SSID: <实际SSID>  IP: http://<IPv4>:8080/`；断开时顶部为静态 WiFi 断开图标，底部连续左移 `SSID: <保存SSID>  密码: <保存密码>`。未配置时显示明确无配置文案，不虚构密码。
 - 连接成功和断开两种滚动文字都必须把字体栅格化结果转成全亮或全灭的单色像素，不保留小字号抗锯齿灰阶；字体覆盖到的每个像素必须完整保留，避免局域网 IP、SSID、密码提示在网页当前帧和实屏上出现断笔或缺块。
@@ -5,6 +5,7 @@
 - DEVICE-MOBILE-WIFI-TRANSPORT：BLE 为会话前提；加密 BLE 交付 WiFi 地址与一次性短期凭据，以实际连接和身份验证判定可用，不比较 SSID 或限制同子网。WebSocket 复用公共业务、单所有者与串行执行。
 - DEVICE-MOBILE-WIFI-LIFECYCLE：BLE 独立保活；蓝牙断开撤销全部通道，WiFi 失败回退 BLE。只读可重取，结果不明写入不得重放。旧通道与回调隔离。
 - WEB-MOBILE-PRESENCE：顶栏“连接设备：名称 · WiFi/蓝牙”，无会话“连接设备：未连接”；切换不重复通知连接。
+- DEVICE-MOBILE-SESSION：手机成功完成加密握手和有效 `session.open` 后，设备取消本次开机的 WiFi 提示（含断网提示及联网 IP）。无需业务写入，断开或服务重启不恢复，整机重启重新计时；协议和 App 不变。
 - TEST-MOBILE-WIFI-TRANSPORT：覆盖双端向量、安全、在途故障、实际网络恢复、权限与传输对照；模拟与真实证据分别记录。

 本文件定义核桃派侧行为，手机产品需求与协议分别见 `../移动端相关内容/开发要求/移动端需求.md`、`../移动端相关内容/开发要求/设备通信协议.md`。当前是已确认的实施契约，不代表已部署。