2.3 KiB
2.3 KiB
271 采购地址入口有限下滑识别
- 类型：缺陷
- 父级大工单：#96（Client Epic #1）
- 所属 MVP / 版本：#253 采购运行时 AI 规格纠偏闭环
- 状态：待验收
- 日期：2026-08-18
- Gitea 工单：#271
背景与目标
规格面板停留在较低位置时，联系人和收货地址可能没有出现在无障碍控件树中，导致地址入口识别失败。本任务在点击地址前有限下滑并重新读取控件树，提升采购地址修改流程的兼容性，同时保持安全点击门禁。
最终方案
首次读取控件树时如果已经有唯一地址入口，不增加滑动。否则只在唯一的规格面板滚动区域内向下做最多 3 次小幅滑动，每次等待并重新读取控件树；检测到页面无进展、滚动区域消失或页面离开确认页时安全失败。识别到唯一入口后继续原有地址修改、保存、返回和不可逆阶段门禁。
改了哪些
client/src/pdd_u2_purchase_adapter.py：增加地址入口准备、有限下滑、页面检查、无进展检测和脱敏诊断。client/test/test_pdd_u2_purchase_adapter.py：增加地址入口被裁剪后下滑一次重新识别的脱敏回归测试。
验收结果
| 验收标准 | 结果 |
|---|---|
| 地址入口已唯一可见时不滑动 | 通过（既有测试覆盖） |
| 地址入口被裁剪时有限下滑后重新识别 | 通过（新增测试） |
| 滑动有上限且无进展时安全失败 | 通过（代码路径检查） |
| 地址修改、保存、返回确认页和不可逆门禁不变 | 通过（既有地址流程测试） |
测试
- 执行的命令：
C:/Python310/python.exe -m pytest test/test_pdd_u2_purchase_adapter.py -q - 结果：70 passed。
- 额外执行：
C:/Python310/python.exe -m pytest test -q，534 passed、2 failed；失败为现有版本号测试期望0.1.0，当前工作区版本为0.1.3，与本任务无关。 - 没验证到的部分：尚未连接真实 Android 设备验证不同 PDD 版本的地址入口滚动行为。
遗留问题
需要在真实设备上确认规格面板实际滚动容器是否稳定暴露 scrollable=true。
相关提交
bee3cb0fix: 规格面板地址入口有限下滑识别 (#271)