78 lines
4.2 KiB
Markdown
78 lines
4.2 KiB
Markdown
# 35 修复 PDD 商品页误判与失败响应
|
||
|
||
- 类型：缺陷
|
||
- 父级大工单：#1
|
||
- 所属 MVP / 版本：#2 / MVP
|
||
- 状态：待验收
|
||
- 日期：2026-08-07
|
||
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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 在复验前离线 |
|
||
| 不执行加购、下单或付款 | 通过 |
|
||
|
||
## 测试
|
||
|
||
```powershell
|
||
# 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 启动时恢复。第一次点击“获取任务”会用原幂等键确认旧失败回执，第二次点击才会重新采集该任务。这是单任务模式下的预期行为，不会重复领取或下单。
|
||
|
||
## 相关提交
|
||
|
||
- `c59b4b0` `fix: 修复 PDD 页面误判与失败回执 (#35)`
|