goauto/docs/10-real-device-acceptance.md

一加真机验收记录

验收结论：2026-08-15 用户已确认 T06～T17 通过验收；其中 T08 为已延期、未实施且不属于当前 MVP 的只读实时屏幕工单。

验收范围

T17 只验证 PDD 商品采集最小闭环：Agent 注册与心跳、任务串行领取、浏览器进入 PDD、规则快照执行、结构化结果或明确失败、管理端详情与重置。禁止购买和支付，不保存控件树或截图。

2026-08-15 一加 PKG110（Android 16）

已通过：

• ADB 设备在线，PDD App 已安装。
• Debug Agent 安装成功并保持前台服务。
• Agent 使用局域网地址访问服务端，设备自动注册成功，之后每 15 秒持续心跳。
• 手机到服务端 8000 端口连通。
• Android 单元测试与 Debug APK 构建通过。
• 人工启用“GoAuto 采集服务”后，系统显示服务已启用且已绑定；应用升级或被强制停止后，一加系统可能撤销该授权，必须重新人工启用。
• 指定设备任务成功经历 pending、running、completed_partial，完成任务领取、PDD 链接打开、规则快照执行和结构化结果提交。
• 未指定设备任务由在线空闲的一加设备原子领取，领取后设备快照固定为设备 2，并成功提交 completed_partial。
• 浏览器页面中的“安全验证”文案不再被误判为 PDD 验证码；登录、验证码和风控识别只在 PDD 包内生效。
• 真实商品页可访问节点能够识别商品标题、销量、店铺入口；进入店铺页能够识别店铺名；规格弹层能够识别颜色和尺码。
• 当前安全基线规则只验证到达 PDD 商品详情页，因此缺少标题、店铺、销量、评价、颜色和尺码时按约定提交 completed_partial，没有猜测数据。
• 同一任务重置后，旧错误和结果摘要已清空并可重新领取；URL、goods_id、规则和设备快照保持不变。
• 设备心跳中断后，运行中任务按约定以 DEVICE_OFFLINE 失败且没有自动重试或换机；重新启用设备后必须人工新建或重置任务。
• 全程未点击提交订单或支付控件，未保存控件树或截图。
• 最终版在任务执行期间使用有时限的屏幕唤醒锁，防止设备休眠中断心跳；任务终止后立即释放。

待验证：

• 用正式字段规则逐项采集标题、店铺、销量、评价、颜色、尺码和各颜色价格，并在管理端详情复核规格与 SKU 展开结果。
• 当前只有一台受支持的一加设备，多设备防双领已通过服务端并发测试，尚无第二台一加真机可做补充复核。

2026-08-15 最终闭环证据

• 任务 16（指定设备）：pending → running → completed_partial；最终前台包名为 com.xunmeng.pinduoduo，Activity 为 com.xunmeng.pinduoduo.activity.NewPageActivity。
• 任务 17（未指定设备）：由设备 2 原子领取并提交 completed_partial。
• 两条任务均保存 URL、goods_id、规则和设备关联，只保存结构化缺失字段清单；规格、颜色价格和 SKU 子表没有伪造记录。
• 本轮未执行购买或支付，也未持久化原始控件树或截图。

支持范围

当前 MVP 只维护一加/ColorOS 真机兼容，不包含华为 ROM。实机过程中发现的精确 Activity 页面证据和最近可点击父容器规则属于通用安全能力，继续保留。

通过标准

• 每台设备同一时刻最多运行一个任务，指定任务不能被其它设备领取。
• 页面控件唯一匹配；未命中或多命中必须失败，不猜测点击。
• 登录、验证码、人机验证、风控和无效链接返回稳定错误码且不自动重试。
• 字段不完整仍保存结果并标记 completed_partial。
• 任务详情可查看规格与 SKU；重置后旧结果和错误全部清空。
• 全程不触发购买/支付，不保存原始控件树或截图。