35 修复 PDD 商品页误判与失败响应

类型：缺陷
父级大工单：#1
所属 MVP / 版本：#2 / MVP
状态：已完成，用户验收通过
日期：2026-08-07
Gitea 工单：#35

背景与目标

#32 真机联调时，手机已经显示 PDD 商品页，控件树也包含 PDD 节点和“免拼购买”，但 ColorOS 的 app_current() 仍返回无线调试设置页。Client 因此误判页面未加载，30 秒后提交 PDD_PAGE_TIMEOUT。

Admin 实际接收了失败上报，但旧失败响应没有 result_id，Client 又把 200 响应误报成“Admin 拒绝：响应字段不完整”。加载超时还没有保存最后一份 XML，无法从报告中复盘页面。

最终方案

等待商品页时每轮都读取无障碍树，不再只有焦点包名为 PDD 时才读取。
商品页就绪要求焦点包为 PDD，或者控件树中至少有 3 个真实 PDD 包节点；同时仍要求购买入口标记存在且页面不在加载中。
只有确认属于 PDD 的页面才检查登录和验证码，避免其他应用的相似文字误触发。
每轮保留最后一份 XML；超时时写入 data/artifacts/，诊断信息保存本地路径、SHA-256 和检查屏数。
Admin SubmitFailure 成功响应增加非空 result_id，和 SubmissionReceipt 统一。
Client 兼容已经进入旧幂等表的 accepted + task_status + accepted_at 回执，用原幂等键重试时不会永久卡住。
真正的 2xx 格式异常改为可重试，提示“数据可能已接收”，不再显示“Admin 拒绝”。
启动恢复时把 #35 之前因“Admin 提交响应字段不完整”被标成 failed 的 Outbox 恢复为 pending。

改了哪些

client/src/pdd_collect_service.py：修复页面就绪判断并保留超时 XML。
client/src/http_admin_gateway.py：兼容旧失败回执，调整异常响应语义。
client/src/task_repository.py：恢复历史上误标为永久失败的 Outbox。
admin/service/submit.go：失败响应增加 result_id。
client/test/、admin/service/submit_test.go：增加焦点错报、非 PDD 防误判、诊断文件、旧回执和恢复测试。
docs/client/04-admin-api-contract.md、docs/admin/04-client-api.md：明确失败响应结构。

验收结果

验收标准	结果
焦点报告设置页、真实 PDD 控件树时判定就绪	通过，含真实 XML 回归
非 PDD 控件树含“免拼购买”时不误判	通过
登录、验证码、加载中页面继续拦截	通过原有回归
加载超时保存 XML 路径和 SHA-256	通过
Admin failure 响应包含非空 `result_id`	通过
Client 兼容旧 Admin 幂等回执	通过
2xx 格式异常保留为可重试	通过
历史误标失败 Outbox 在启动时恢复	通过
真机重新进入规格面板	未验证：ADB 在复验前离线
不执行加购、下单或付款	通过

测试

# client 目录
C:/Python310/python.exe -m unittest discover -s test -p 'test_*.py' -q

# admin 目录
go test ./...

# Client 离屏冒烟
$env:QT_QPA_PLATFORM='offscreen'
C:/Python310/python.exe -c "from src.ui_main import MainWindow; from PyQt5.QtWidgets import QApplication; app=QApplication([]); w=MainWindow(); print('OK'); w.close(); app.quit()"

Client 150 项测试通过。
Admin 全量 Go 测试通过。
Client 离屏启动和关闭通过，输出 OK。
使用 737116531267_home.xml 复现“焦点为无线设置、控件树为 PDD”，页面就绪判断通过。
没验证到的部分：准备真机复验时 192.168.0.173:5555 已从 ADB 设备列表消失，因此没有再次进入规格面板，也没有完成真实 Admin 页面联调；验证过程中没有加购、下单或付款。Windows 高对比度和 200% 缩放未手工验证。

当前任务恢复说明

原任务 COL-2fd0ccb9c55e450b 本地仍是 retry_wait，旧失败 Outbox 会在新版 Client 启动时恢复。第一次点击“获取任务”会用原幂等键确认旧失败回执，第二次点击才会重新采集该任务。这是单任务模式下的预期行为，不会重复领取或下单。

4.2 KiB Raw Blame History Unescape Escape