cmautobuy/docs/task/111-识别失效PDD商品链接返回首页.md

111 识别失效 PDD 商品链接返回首页并安全终止当前任务

• 工单号：#111
• 类型：缺陷
• 父级大工单：#1
• 所属 MVP / 版本：MVP 后续 / PDD 页面识别与采购安全
• 状态：已完成，待用户验收
• 日期：2026-08-10
• Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/111

背景与目标

失效商品链接可能先唤起 PDD，再返回 PDD 首页。原流程只能等待商品购买入口， 最终得到普通超时，也可能把打开链接前的旧商品页当成本次目标。此次增加可靠的 页面分类和有限重开，使当前任务安全失败，同时不打断连续自动获取。

最终方案

• 采集和采购共用 pdd_page_classifier.py，统一分类外部应用、加载、商品页、 首页、网络、登录、验证码、风控、支付/确认和未知页面。
• 首页使用 PDD 控件树、已选中的“首页”和完整底部导航组合识别；连续读取稳定且 超过跳转宽限时间后，第一次重开相同 URL，第二次才返回 PDD_GOODS_UNAVAILABLE。
• 打开前后商品页脱敏签名相同时拒绝旧页面，不进入规格选择或下单步骤。
• 商品失效保存为不可重试的 FAILED，通过现有失败 Outbox 上报；界面收到 business_failed 后继续下一轮自动获取。
• 复用真机读取结果制作最小脱敏首页 XML 固件，不保存推荐商品、账号和未读数量。
• 未修改 Admin API、数据库结构、pdd_data 或任务状态枚举。

改了哪些

• client/src/pdd_page_classifier.py：新增共享页面分类器和商品深链状态跟踪器。
• client/src/pdd_collect_service.py：采集流程接入页面分类、一次重开和旧页保护。
• client/src/pdd_u2_purchase_adapter.py：采购流程复用相同规则，并在规格点击前失败关闭。
• client/src/collect_task_service.py、purchase_task_service.py：保存不可重试业务失败。
• client/src/pdd_ui_event.py：商品失效仅结束当前任务，连续模式继续获取。
• client/test/fixtures/pdd_home_page.xml：新增真机裁剪脱敏首页固件。
• client/test/：增加分类、采集、采购、任务服务和调度回归测试。
• docs/client/06-quality-security.md：补充商品深链页面识别安全基线。

验收结果

验收标准	结果
有效商品页正常继续，短暂首页不立即误判	通过（状态机与现有真实商品 XML 测试）
稳定首页只重开一次，第二次返回指定错误码和中文提示	通过
商品失效后不选择规格、不创建订单	通过
商品失效不停止连续自动获取	通过
网络、加载、外部应用、登录、验证码和风控独立分类	通过
旧商品页不作为本次目标商品	通过
采集与采购共用分类基础	通过
真机首页脱敏 XML 固件覆盖	通过
全量测试和离屏启动通过	通过
真实下单默认关闭且未下单、未付款	通过

测试

• 执行的命令：
  • C:/Python310/python.exe -m unittest discover -s test -p "test_*.py"
  • 设置 QT_QPA_PLATFORM=offscreen 后实例化 src.ui_main.MainWindow
  • C:/Python310/python.exe -m py_compile 检查本工单修改的 Python 文件
  • git diff --check
• 结果：Client 全量 329 个测试通过；离屏启动输出 OK；语法和差异检查通过。
• 没验证到的部分：没有一条由用户确认当前仍然失效的真实商品链接，因此未执行 “同一失效链接两次返回首页”的真机端到端。真机仅安全读取首页控件树并制作脱敏 固件，未点击规格、未创建订单、未下单、未付款。

相关提交

• 8c9dbfe fix: 识别失效商品链接返回首页 (#111)