扫码页无响应自恢复变更记录

问题现象与定位

• 现场页面停留在“请放餐盘”，放置餐盘后没有业务响应。
• Android 未记录 ANR，应用主线程处于消息循环空闲状态，因此不是 UI 主线程卡死。
• 扫码 SDK 的串口读取线程长期阻塞在 FileInputStream.read()，且之后没有扫码成功、离盘或失败回调；业务页面只能等待回调，外观上表现为“卡死”。
• 现场 F700 的设备标识为 rk3568_r，实际扫码串口为 /dev/ttyS3；当前源码原先固定使用 /dev/ttyS2，无法同时适配两类主板。

实施内容

1. 新增 ScannerSerialPortResolver，集中维护设备型号与扫码串口的映射：RK3568/F700 使用 /dev/ttyS3，其他设备使用工程默认 /dev/ttyS2。
2. 新增 ScannerInactivityMonitor，扫码打开后记录最近一次成功、离盘或失败事件时间。
3. 每 30 秒检查一次扫码状态；连续 2 分钟没有任何 SDK 事件时，回收旧扫码句柄并重新打开串口，同时写入本地日志。
4. 页面停止或销毁时取消定时检查、停止状态监测并关闭扫码句柄，避免离开页面后继续重连。
5. 扫码结果分发统一检查业务监听器，并兼容 SDK 返回空结果，避免监听器已释放或结果为空时触发空指针异常。

代码范围

• app/src/main/java/com/zhct/traybinding/hardware/ScanCodeUtils.java
• app/src/main/java/com/zhct/traybinding/hardware/ScannerInactivityMonitor.java
• app/src/main/java/com/zhct/traybinding/hardware/ScannerSerialPortResolver.java
• app/src/main/java/com/zhct/traybinding/utils/Constants.java
• app/src/test/java/com/zhct/traybinding/hardware/ScannerInactivityMonitorTest.java
• app/src/test/java/com/zhct/traybinding/hardware/ScannerSerialPortResolverTest.java

验证结果

• 按测试先行方式先确认新增测试因实现缺失而失败，再完成实现并复测通过。
• ScannerInactivityMonitorTest：4 项通过，覆盖超时、事件续期、重连防抖和停止监测。
• ScannerSerialPortResolverTest：3 项通过，覆盖 RK3568、其他设备和设备名缺失。
• 全量 :app:testDebugUnitTest：24 项通过，0 失败，0 错误。
• 使用仓库已有 debug_3568 签名配置执行 :app:assembleDebug：构建成功。
• apksigner verify：F700 Debug APK 的 v2 签名有效，证书 SHA-256 为 2d370c21f5dfd553d2a796314b70925fb38adeef90864c920bbbbb12887d3522。
• :app:assembleRelease：未签名 Release APK 构建成功。
• git diff --check：通过。

验证边界

现场 F700 当前安装的是 2.1.3 版本 APK，本源码构建版本为 1.6.0。本次未执行降级覆盖安装，避免未经确认替换现场应用及影响现有数据；因此已完成源码、单元测试、构建和签名验证，真机扫码与自动恢复需在确认部署方案后复验。