46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
# 271 采购地址入口有限下滑识别
|
||
|
||
- 类型：缺陷
|
||
- 父级大工单：#96（Client Epic #1）
|
||
- 所属 MVP / 版本：#253 采购运行时 AI 规格纠偏闭环
|
||
- 状态：待验收
|
||
- 日期：2026-08-18
|
||
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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`。
|
||
|
||
## 相关提交
|
||
|
||
- `bee3cb0` `fix: 规格面板地址入口有限下滑识别 (#271)`
|