docs: 归档任务 #118

2026-08-10 19:07:38 +08:00
parent ff01f950eb
commit 4c722558ad
1 changed files with 58 additions and 0 deletions
@@ -0,0 +1,58 @@
+# #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` 尚未核单并安全退出，任务记录未改变。
+
+未验证到的部分：由于当前存在不可逆待核单任务，没有在手机上实际打开测试网址；
+必须先完成该任务的订单核对。