# #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`：安全拦截和页面分类离线测试。

## 验收结果

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

## 测试

从 `client` 目录执行：

```powershell
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` 尚未核单并安全退出，任务记录未改变。

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