cmautobuy/docs/task/118-PDD通用商品链接首页跳转诊断脚本.md

#118 增加 PDD 通用商品链接首页跳转诊断脚本

• 工单号：#118
• 类型：诊断工具
• 父级：#1 Client 拼多多任务采集与采购客户端
• 版本：Client 采购自动化辅助诊断
• 状态：已完成，用户验收通过
• 日期：2026-08-10
• Gitea：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/118
• 实现提交：ff01f95

背景与目标

需要在 Android 真机上验证系统浏览器打开 https://mobile.yangkeduo.com/goods.html 后最终进入哪个页面，同时不能干扰已经 进入不可逆阶段的采购任务。

最终方案

新增独立命令行诊断工具。工具先只读检查 Client 数据库；存在尚未完成核单的 不可逆采购任务时，在连接或操作手机前退出。安全时仅使用 Android VIEW Intent 打开固定网址，等待后读取当前包名和无障碍控件树，复用项目页面分类器输出： PDD 首页、PDD 其他页面、浏览器或无法判断。

工具不会点击购买、规格、下单或支付按钮，不修改数据库，也不接入正式采购流程。 原计划使用 client/scripts，实施时沿用仓库已有诊断工具目录，改放在 client/tools。

改了哪些文件

• client/tools/test_pdd_home_deeplink.py：真机链接页面诊断工具。
• client/test/test_pdd_home_deeplink.py：安全拦截和页面分类离线测试。

验收结果

• 不可逆采购未完成核单时，在任何 ADB 页面操作前退出。
• 安全时使用指定设备和固定 VIEW Intent 打开测试网址。
• 输出当前包名和中文页面结论。
• 工具不包含购买、规格、下单或支付点击。
• 离线专项和 Client 全量测试通过。
• 当前待核单任务未被修改。
• 核单完成后，等待用户运行脚本验证真机最终页面。

测试

从 client 目录执行：

C:/Python310/python.exe -m unittest discover -s test -p "test_pdd_home_deeplink.py"
C:/Python310/python.exe -m unittest discover -s test -p "test_*.py"
C:/Python310/python.exe tools/test_pdd_home_deeplink.py --device 192.168.0.173:5555

结果：专项 4 项通过；Client 全量 341 项通过。真机命令检测到 PUR-9109e06ee106ef63 尚未核单并安全退出，任务记录未改变。

未验证到的部分：由于当前存在不可逆待核单任务，没有在手机上实际打开测试网址； 必须先完成该任务的订单核对。