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

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: OnePlus-Real-Device-Acceptance wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/OnePlus-Real-Device-Acceptance.- wiki_revision: b1b1b343917e66288f4282bc6b3b90ea4ff3cca0 synchronized_at: 2026-09-04T11:30:32Z

一加真机验收记录

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

验收范围

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

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

已通过：

• ADB 设备在线，PDD App 已安装。
• Debug Agent 安装成功并保持前台服务。
• Agent 使用局域网地址访问服务端，设备自动注册成功，之后每 15 秒持续心跳。
• 手机到 config.yaml 的 ports.server 端口连通（默认 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 为页面事实，不把已成功跳转误报为动作失败。
• 规格入口使用右下方“价格 + 购买/拼单语义 + 最近可点击容器”强证据，只用于打开规格面板。
• 2026-08-21 三星 SM-G9700、PDD 7.95.0、商品 172119352488 的任务 42 暴露规格入口误触评价页：评价卡片包含规格词和数字，被旧兜底误判；评价页又与详情页共用 NewPageActivity。#59 收紧为明确选择语义或底部真实购买文字，排除评价上下文，并增加一次安全返回重试与分级错误。安装新 APK 并通过正式接口重置任务后，真机日志记录 spec-entry source=bottom_purchase、标签“快要抢光 免拼购买”、点击结果 SUCCESS，未进入商品评价页；规格面板采到 2 个颜色和 8 个尺码，任务以 completed_partial 提交，仅缺少颜色 9031#长裤 的价格。该缺失属于既有价格采集问题，不阻塞本次误触修复验收。
• #60 针对上述颜色价格缺失增加点击生效证据、300ms 刷新保护、连续稳定读取和分级诊断。三星覆盖安装新 APK 后再次重置任务 42，结果为 completed、缺失清单为空：颜色 8913#长裤 与 9031#长裤 均取得 3112 分价格，8 个尺码完整；两个颜色的日志均显示 target_state 证据和连续 2 次稳定价格读取。
• 2026-08-21 三星 SM-G9700 的采购任务 5（CG-5）使用不含 openSpecPanel.textAliases 的新规则快照完成第一趟 spec_probe：回传 2 个颜色、8 个尺码和两个颜色的 3112 分价格，attempt 结果为 spec_probe_completed。任务转入 spec_probe_pending 等待服务端规格决策；未修改地址，未创建订单，未提交支付。
• 图片型颜色卡片优先点击 TextView 颜色文字，排除 ImageView、“打开大图”和“查看大图”；真机不再进入 SkuPhotoBrowseActivity。
• 任务 20 采到 4 个颜色，四个颜色价格均为 2690 分，并生成 4 个可用、完整的单维 SKU；标题和“已拼299件”已提交。
• 管理端任务详情 API 返回 1 个规格维度、4 个颜色价格、4 个 SKU 和缺失清单，且没有原始控件树或截图字段。
• 当前商品只暴露出颜色维度，结果按规则以 completed_partial 提交，缺失为 size、shopName、reviewCount，没有猜测数据。
• 已验证规格标题、图片入口、窗口类名和浏览器返回值异常都会明确停止或采用受约束恢复，不点击相似候选。

二维规格复核：

• 商品 972800403573、任务 22 在同一台一加设备完成 pending → running → completed_partial，最终 Activity 为 PDD NewPageActivity。
• 采到颜色“灰色、黑色”和尺码“M码80-120斤、+同色螺纹袜”，两个颜色价格均为 492 分；按当前业务规则展开为 4 个可用且完整的二维 SKU，同一颜色价格正确复制到各尺码。
• 首次真机结果暴露出 #一次选多款# 是规格面板功能入口而非尺码。Agent 增加排除规则和单元测试后重置同一任务，旧结果被清空，复采结果由 6 个错误 SKU 收敛为 4 个正确 SKU。
• 标题和“已拼1件”已提交；页面未暴露店铺名和评价数量，因此按约定保存 completed_partial 和 missing=[shopName, reviewCount]，没有猜测字段。
• T23 所需的浏览器跳转、颜色文字点击、逐颜色价格、全部可见尺码和颜色 × 尺码展开均已有真机证据，实施验证完成，等待用户验收。

2026-08-15 T24 长规格列表复核

• 商品 236231603269 的任务 23 初次结果只有颜色并标记 missing:size；真机面板实际存在尺码，确认属于 Agent 遍历提前结束，而非商品无尺码。
• 修正后颜色容器与纵向规格面板通过当前规格节点的祖先关系分别锁定；规格面板先稳定归顶，颜色按视觉行交替方向蛇形遍历。
• 已确认 Android 坐标手势原来在 450ms 完成前被读取，导致旧视口连续两次被误判为列表边缘。现在优先调用目标容器的无障碍滚动动作；坐标手势回退等待完成回调。
• 最终重置复采状态为 completed、缺失清单为空：14 个颜色、14 个颜色价格、8 个尺码和 112 个完整可用 SKU；同一颜色价格按业务规则复制到各尺码。
• 尺码包含 S 至 4XL 和页面实际提供的定制选项；Agent 全程只读尺码，没有点击尺码、订单或支付控件。
• 标题候选改为与销量节点存在空间关联的文本，不再把页面任意最长文本当作商品标题；旧结果已由重置事务清除。
• 全程只持久化结构化结果，未保存或上传原始控件树和截图。
• 2026-08-17 三星 SM-G9700 的任务 35 复采验证了选中颜色节点消失并重排的兼容修复：3 个颜色、3 个价格和 1 个尺码均已保存，colorRow:1/2 误报消失。评价数量仍未暴露为受支持的无障碍文本，因此按约定保留 completed_partial 和 missing=[reviewCount]，用户确认暂不处理。
• T24 于 2026-08-17 经用户明确验收通过。

支持范围

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

通过标准

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