From 3558da66d57c88d49efdf3ea9e790101ece3ac37 Mon Sep 17 00:00:00 2001 From: chengma Date: Tue, 18 Aug 2026 16:52:13 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#271?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/271-采购地址入口有限下滑识别.md | 45 +++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/task/271-采购地址入口有限下滑识别.md diff --git a/docs/task/271-采购地址入口有限下滑识别.md b/docs/task/271-采购地址入口有限下滑识别.md new file mode 100644 index 0000000..4167673 --- /dev/null +++ b/docs/task/271-采购地址入口有限下滑识别.md @@ -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)`