# 66 修复旧 Wi-Fi 设备恢复失败时无法搜索 USB 设备

- 类型：缺陷
- 父级大工单：#1
- 所属 MVP / 版本：#2 Client 可运行任务闭环（MVP）
- 状态：已完成，用户验收通过
- 日期：2026-08-09
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/66

## 背景与目标

Client 保存了不可连接的旧 Wi-Fi ADB 地址时，点击“搜索”会在恢复旧设备失败后
直接结束，导致 `adb devices -l` 已经识别的 USB 设备也无法显示。本任务让局部
恢复失败不再中断普通设备搜索。

## 最终方案

- 后台 Worker 仍先尝试恢复已保存设备。
- 恢复失败时保存警告文字，并继续调用普通设备搜索。
- 搜索成功结果同时携带实际设备列表和可选恢复警告。
- 主线程先刷新实际设备表格，再提示旧设备恢复失败、配置已保留。
- 只有普通设备搜索也失败时才显示“搜索失败”并保留旧表格。
- 不自动删除或改写已保存设备，不改变保存、删除和 USB 转 Wi-Fi 流程。

## 改了哪些

- `client/src/android_device_service.py`：增加包含设备列表和恢复警告的简单结果对象。
- `client/src/settings_ui_event.py`：恢复失败后继续搜索，并区分警告与整体失败。
- `client/test/test_settings_ui_event.py`：补充恢复失败后的 USB、空结果和整体失败测试。
- `docs/client/05-ui-specification.md`：记录设备搜索的容错与反馈规则。

## 验收结果

| 验收标准 | 结果 |
|---|---|
| 已保存 Wi-Fi 在线时正常恢复并自动勾选 | 通过 |
| 旧 Wi-Fi 离线但 USB 在线时仍显示 USB | 通过 |
| 旧 Wi-Fi 离线且无其他设备时显示空表和恢复警告 | 通过 |
| 普通设备枚举失败时保留旧表格并显示搜索失败 | 通过 |
| ADB 操作继续在工作线程执行 | 通过 |
| 已保存配置不被自动修改或删除 | 通过 |

## 测试

- 执行的命令：
  - `C:/Python310/python.exe -m unittest discover -s test -p test_settings_ui_event.py -v`
  - `C:/Python310/python.exe -m unittest discover -s test -v`
  - `C:/Python310/python.exe -m py_compile src/android_device_service.py src/settings_ui_event.py`
  - 设置 `QT_QPA_PLATFORM=offscreen` 后创建并关闭 `MainWindow`
  - 使用当前保存的旧 Wi-Fi 地址运行 `AndroidDeviceSearchWorker`，观察恢复警告和设备结果
- 结果：设置页 37 项测试通过；Client 全量 183 项测试通过；语法检查通过；
  离屏冒烟输出 `OK`；旧 Wi-Fi 恢复超时后仍返回 USB 设备 `30167b23`。
- **没验证到的部分**：尚未由用户在可见 Client 界面点击“搜索”完成最终交互验收；
  没有测试可正常连接的真实 Wi-Fi 手机，仅由自动化测试覆盖该分支。

## 相关提交

- `ff8cdd7` 修复 Wi-Fi 恢复失败后继续搜索设备