feat: 滚动采集评价数量和店铺名 (#40)

2026-08-08 10:30:04 +08:00
parent 2f83be5e40
commit 9dadac2bff
4 changed files with 257 additions and 11 deletions
@@ -48,7 +48,7 @@ Client 顶级导航仅包含：
 - 商品编号、商品链接和商品标题；
 - 店铺名称（无障碍树未提供时允许留空并保存诊断证据）；
 - 已拼数量及原始显示文字；
- 评价数量及原始显示文字（当前首页未提供时允许留空，不能为此反复滚动并阻塞规格采集）；
+- 评价数量及原始显示文字（首屏没有时，在进入规格面板前有限次缓慢向下浏览补采；到达页面底部或次数上限后仍没有时允许留空）；
 - 所有规格维度及其可见值；
 - 每个颜色对应的价格、币种，以及当前控件树显示的规格可用状态；
 - 采集时间、设备及必要诊断产物引用。
@@ -354,15 +354,17 @@ reconcile_purchase(task, run) -> PurchaseResult | ManualReview

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

-采集商品时按“首页就绪 → 读取当前首页摘要 → 点击规格入口 → 确认规格面板
-出现 → 颜色列表归左 → 按行蛇形逐色点击并采价 → 向下滚动并只读尺码 →
-组装结果”的顺序执行。颜色点击可能改变列表位置，因此每次点击后必须重新读取
+采集商品时按“首页就绪 → 读取当前首页摘要 → 有限滚动补采评价和店铺 →
+点击规格入口 → 确认规格面板出现 → 颜色列表归左 → 按行蛇形逐色点击并采价 →
+向下滚动并只读尺码 → 组装结果”的顺序执行。颜色点击可能改变列表位置，因此每次点击后必须重新读取
 控件树，不能复用旧坐标；左右边缘以连续两次没有新颜色且视口稳定为准。

 当前业务价格粒度固定为颜色。第一行从左到右、下一行从右到左交替遍历，操作
 顺序采用蛇形以减少滑动，输出维度仍恢复为页面每行从左到右的自然顺序。尺码
-只读取文字和当前可用状态，不点击、不参与采价。打开规格面板前不得为了寻找
-评价或店铺连续滚动商品详情；这两个可选字段缺失时保存证据，但不阻塞核心采集。
+只读取文字和当前可用状态，不点击、不参与采价。商品首屏的标题和已拼数量必须
+保留；首屏缺少评价或店铺时，打开规格面板前小幅、慢速向下浏览并分别累积这两个
+字段，不要求它们同时出现在一屏。获取完整、页面不再变化或达到次数上限后停止，
+字段仍缺失时保存证据，但不阻塞核心规格采集。

 ## 10. 关键架构决策