docs: 归档任务 #271

2026-08-18 16:52:13 +08:00
parent bee3cb0e4b
commit 3558da66d5
1 changed files with 45 additions and 0 deletions
@@ -0,0 +1,45 @@
+# 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)`