cmautobuy/docs/task/221-地址流程关键操作后增加稳定等待.md

221 Client：地址流程关键操作后增加1秒稳定等待

• 类型：缺陷
• 父级大工单：#1
• 所属 MVP / 版本：#2
• 状态：已完成，待用户验收
• 日期：2026-08-14
• Gitea 工单：#221

背景与目标

正式采购修改收货地址时，关键操作完成后可能立即读取到上一状态的控件树，造成页面切换、保存或返回确认超时。本任务在关键状态改变操作后增加固定稳定时间，再继续执行原有页面状态确认。

最终方案

• 使用单一常量把地址操作稳定等待固定为 1 秒。
• 点击地址入口、点击“修改”、写入新地址、单次点击“保存”、关闭已知 ColorOS 密码本浮层和点击地址页返回后，分别执行一次稳定等待。
• 固定等待后仍使用原有控件树轮询、唯一目标、默认地址、表单连续稳定、单次保存和超时诊断。
• “修改”和 ColorOS 浮层处理发生在已有超时循环内部，固定等待会同步补回超时预算，避免减少原页面确认时间。
• 不改变地址后缀、Admin 接口、SQLite、任务状态、不可逆下单门禁和禁止付款规则。

改了哪些

• client/src/pdd_u2_purchase_adapter.py：增加统一地址操作稳定等待，并接入六类关键状态改变操作。
• client/test/test_pdd_u2_purchase_adapter.py：记录 Fake Clock 的等待时间，验证普通地址闭环执行 5 次、ColorOS 浮层闭环执行 6 次 1 秒等待。

验收结果

验收标准	结果
地址入口后等待 1 秒再确认地址面板	通过
点击“修改”后等待 1 秒且保留安全重试	通过
写入地址后等待 1 秒再验证表单	通过
保存只点击一次，并等待 1 秒再确认结果	通过
关闭已知 ColorOS 浮层后等待 1 秒	通过
地址页返回后等待 1 秒再确认规格页	通过
原安全门禁、错误分类和超时语义保持	通过
地址专项及 Client 回归	专项通过；全量存在 2 项无关既有失败

测试

• 执行的命令：
  • C:/Python310/python.exe -m py_compile src/pdd_u2_purchase_adapter.py
  • C:/Python310/python.exe -m pytest test/test_pdd_u2_purchase_adapter.py -q --disable-warnings
  • C:/Python310/python.exe -m pytest test -q --disable-warnings
  • git diff --check -- client/src/pdd_u2_purchase_adapter.py client/test/test_pdd_u2_purchase_adapter.py
• 结果：语法检查和差异检查通过；地址专项 48 项全部通过；Client 全量 470 项中 468 项通过。
• 没验证到的部分：没有连接真机执行地址修改、保存、返回或真实采购。全量测试另有 2 项既有失败，原因是工作区版本为 0.1.2，旧更新测试仍固定期待 0.1.0，与 #221 无关。

相关提交

• 84ec0ed fix: 稳定采购地址页面切换 (#221)