cmautobuy/docs/task/168-兼容纵向套餐标题滑出.md

#168 Client：兼容纵向套餐标题滑出后的续页采集

• 工单号：#168
• 类型：缺陷
• 父级：Epic #1、MVP #2
• 版本：Client 可运行任务闭环
• 状态：待验收
• 日期：2026-08-11
• Gitea：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/168

背景与目标

纵向套餐数量较多时，向下滑动会让“套餐”标题离开无障碍控件树。旧流程每一屏 都依赖可见标题重新识别第二规格，因此错误报告“滚动过程中丢失第二规格”。本任务 让 Client 在标题消失后仍能安全采集后续套餐。

最终方案

• 首次识别第二规格时，记录其名称、滚动容器的 class、resource-id、坐标范围， 以及选项的节点结构。
• 后续页面还能识别标题时使用原解析结果；标题不可见时，在重新定位的同一滚动 容器内，只提取结构与首屏选项一致的节点。
• 第二规格视口签名直接使用已确认的维度，不再要求当前屏幕重复显示标题。
• 控件树一次缺少续页节点时重新读取一次，持续无法定位才明确报数据不完整。
• 在第二规格汇总和续页提取时排除价格、数量、提交订单、立即购买等操作控件。
• 保留原横向套餐、衣服颜色尺码、逐颜色采价和默认尺码取消逻辑。

改了哪些文件

• client/src/pdd_collect_service.py：增加第二规格续页上下文、容器重新定位、节点 结构匹配、操作按钮过滤和短暂缺失重读。
• client/test/test_pdd_collect_service.py：增加纵向十个套餐、标题滑出、跨页去重、 操作按钮排除和不点击选项的测试。

验收结果

• 纵向长套餐在标题滑出屏幕后仍能继续收集后续选项。
• 所有套餐按页面顺序去重，连续稳定到边后结束。
• “增加数量”和“提交订单”等操作控件不会混入套餐。
• 横向套餐、普通衣服尺码、颜色价格及默认尺码取消测试保持通过。
• 第二规格续页采集过程中不点击套餐或尺码。
• 未修改数据库、Admin 接口、数据结构和采购安全规则。
• 精确测试、Client 全量测试和语法检查通过。
• 用户使用出现该问题的真机商品完成采集验收。

测试

在 client/ 目录执行：

C:/Python310/python.exe -m unittest discover -s test -p "test_pdd_collect_service.py"
$env:QT_QPA_PLATFORM="offscreen"
C:/Python310/python.exe -m unittest discover -s test -p "test_*.py"
C:/Python310/python.exe -m py_compile src/pdd_collect_service.py test/test_pdd_collect_service.py
Remove-Item Env:QT_QPA_PLATFORM

结果：采集服务 61 项、Client 完整 423 项测试通过，语法检查通过。

没验证到的部分：未使用真机重新采集发生问题的商品；未执行真实采购、下单或 付款；不同 PDD 版本可能使用不同的套餐节点层级，需由本次真机验收确认。

相关提交

• 94793ab 兼容套餐标题滑出后的续页采集。