From 4c722558ad3a11ebbb8125a6ce1aa0cb2200c41f Mon Sep 17 00:00:00 2001 From: chengma Date: Mon, 10 Aug 2026 19:07:38 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#118?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../118-PDD通用商品链接首页跳转诊断脚本.md | 58 +++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 docs/task/118-PDD通用商品链接首页跳转诊断脚本.md diff --git a/docs/task/118-PDD通用商品链接首页跳转诊断脚本.md b/docs/task/118-PDD通用商品链接首页跳转诊断脚本.md new file mode 100644 index 0000000..269f690 --- /dev/null +++ b/docs/task/118-PDD通用商品链接首页跳转诊断脚本.md @@ -0,0 +1,58 @@ +# #118 增加 PDD 通用商品链接首页跳转诊断脚本 + +- 工单号：#118 +- 类型：诊断工具 +- 父级：#1 Client 拼多多任务采集与采购客户端 +- 版本：Client 采购自动化辅助诊断 +- 状态：待用户验收 +- 日期：2026-08-10 +- Gitea： +- 实现提交：`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` 尚未核单并安全退出，任务记录未改变。 + +未验证到的部分：由于当前存在不可逆待核单任务，没有在手机上实际打开测试网址； +必须先完成该任务的订单核对。