fix: harden PDD v2 real-device collection (#25)

This commit is contained in:
QiuSW
2026-08-15 16:09:02 +08:00
parent affa6b3f8c
commit 271b6dde11
11 changed files with 455 additions and 29 deletions
+1 -1
View File
@@ -32,4 +32,4 @@
## 当前阶段
当前 MVP 的 T01~T07、T09~T21 均已完成实现、验证并由用户验收。T08(只读实时屏幕)已延期且未实施,不属于当前 MVP。T17 已在一加/ColorOS 真机完成指定设备领取、空闲领取、PDD 商品详情页到达和部分结果提交验证,不包含华为兼容。T22 正在提供管理端内置 v2 规则模板和安全编辑表单,随后由 T23 完成一加真机验收。当前实施范围仍是采集闭环;Agent 架构允许未来增加独立采购规则的创建订单能力,但付款能力禁止进入项目。
当前 MVP 的 T01~T07、T09~T22 均已完成实现、验证并由用户验收。T08(只读实时屏幕)已延期且未实施,不属于当前 MVP。T17 已在一加/ColorOS 真机完成指定设备领取、空闲领取、PDD 商品详情页到达和部分结果提交验证,不包含华为兼容。T23 正在进行 v2 一加真机验收,已验证浏览器跳转、颜色文字安全点击、逐颜色稳定价格和结构化 SKU 提交;仍需使用一个当前有效且明确包含颜色与尺码的商品完成全部尺码复核。当前实施范围仍是采集闭环;Agent 架构允许未来增加独立采购规则的创建订单能力,但付款能力禁止进入项目。
+19
View File
@@ -38,6 +38,25 @@ T17 只验证 PDD 商品采集最小闭环:Agent 注册与心跳、任务串
- 两条任务均保存 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 页面证据和最近可点击父容器规则属于通用安全能力,继续保留。
@@ -118,4 +118,4 @@ Agent 不限制为“只能采集”,而是注册带版本的类型化能力
## 当前状态
T19~T21 已验收:v2 契约、能力协商和 Android 商品详情采集器已经接入。T22 已提供服务端内置模板、参数约束接口、管理端安全编辑表单、只读 JSON 预览,并在任务详情展示颜色价格和规则快照,当前等待用户验收。T23 负责一加真机验证;在 T23 完成前,文档中的规则文件仍标记为 proposed。
T19~T22 已验收:v2 契约、能力协商、Android 商品详情采集器、服务端内置模板和管理端安全编辑表单已经接入。T23 一加真机已跑通浏览器跳转、规格面板强识别、颜色文字安全点击、4 个颜色稳定价格和结构化 SKU 提交;当前样例只暴露一个颜色维度,仍需一个当前有效的颜色 + 尺码商品完成全部尺码复核。在该复核完成前,文档中的规则文件仍标记为 proposed,T23 保持进行中。