feat: 接入采购演练真机适配器 (#75)

2026-08-10 01:07:57 +08:00
parent 18f3209a62
commit 7e90af0dc9
6 changed files with 708 additions and 0 deletions
@@ -365,6 +365,17 @@ reconcile_purchase(task, run) -> PurchaseResult | ManualReview
 只读核对另用 `PddPurchaseReconcileAdapter`，只暴露 `read_order_match`
 和 `close`，不暴露选规格、设数量、下单或付款方法。

+正式 Client 由 `pdd_u2_purchase_adapter.py` 实现上述演练接口，并在
+`ui_main.py` 注入工厂。Adapter 通过 `PddDeviceService` 独占连接，每次判断
+都重新读取当前包名和控件树。当前 Admin 下发的 `color` 和 `size`
+使用精确文字匹配；其他动态维度直接停止，不做相似匹配。原生 PDD
+控件树不暴露商品编号，因此商品编号来自 Adapter 本次已校验并打开的
+PDD URL，包名和页面类型仍以最新控件树确认。
+
+部分 PDD 页面在点击商品页购买入口后直接进入包含规格和数量的
+订单确认页。Adapter 只点击这一次可逆入口；`enter_confirmation`
+和 `stop_before_submit` 只读确认“提交订单”等最终按钮存在，**不点击它**。
+
 现有 `wait_goods_page`、规格面板坐标、颜色尺码选择和下单按钮定位函数可以迁移到该适配层。实验脚本中的硬编码商品、设备、文件路径和 `print` 不得进入正式服务。

 PDD 页面可能出现登录失效、验证码、控件树不完整、A/B 页面、库存变化和价格变化。适配层必须返回结构化错误，不得把这些情况统一返回 `False`。