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 子表没有伪造记录。
• 本轮未执行购买或支付，也未持久化原始控件树或截图。

2026-08-15 T23 v2 真机复核

已验证：

• 一加 PKG110 / Android 16 的设备 2 上报 rule.schema.v2、action.swipe.v1 和 collector.pdd.product-detail.v1，心跳在线空闲。
• 正式规则 2 和任务 20 固化 schema v2 规则、商品 719834019024、URL 和设备快照；任务经历 pending → running → completed_partial。
• 浏览器点击返回值不可靠时，以离开浏览器后的最终 PDD 包名和 NewPageActivity 为页面事实，不把已成功跳转误报为动作失败。
• 规格入口使用右下方“价格 + 购买/拼单语义 + 最近可点击容器”强证据，只用于打开规格面板。
• 图片型颜色卡片优先点击 TextView 颜色文字，排除 ImageView、“打开大图”和“查看大图”；真机不再进入 SkuPhotoBrowseActivity。
• 任务 20 采到 4 个颜色，四个颜色价格均为 2690 分，并生成 4 个可用、完整的单维 SKU；标题和“已拼299件”已提交。
• 管理端任务详情 API 返回 1 个规格维度、4 个颜色价格、4 个 SKU 和缺失清单，且没有原始控件树或截图字段。
• 当前商品只暴露出颜色维度，结果按规则以 completed_partial 提交，缺失为 size、shopName、reviewCount，没有猜测数据。
• 已验证规格标题、图片入口、窗口类名和浏览器返回值异常都会明确停止或采用受约束恢复，不点击相似候选。

仍待验证：

• 需要一个当前有效、明确同时包含颜色和尺码的 PDD 商品 URL，复核全部尺码读取和颜色 × 尺码 SKU 展开。既有样例商品 737116531267 已失效并返回 PDD 首页，不能作为真实通过证据。
• T23 在上述二维商品复核完成前保持进行中。

支持范围

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

通过标准

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