docs: archive accepted task 26

2026-08-17 16:55:28 +08:00
parent a5c60ff2d9
commit cf66bec59e
4 changed files with 62 additions and 3 deletions
@@ -31,7 +31,7 @@
 | T21 | [#23](https://git.ilapage.cn/OPC/goauto/issues/23) | Android PDD 商品详情采集器 | T20 |
 | T22 | [#24](https://git.ilapage.cn/OPC/goauto/issues/24) | 内置规则模板与管理端校验 | T20、T21 |
 | T23 | [#25](https://git.ilapage.cn/OPC/goauto/issues/25) | v2 一加真机验收 | T20～T22 |
-| T24 | [#26](https://git.ilapage.cn/OPC/goauto/issues/26) | 修复 PDD 规格面板蛇形遍历与尺码续页 | T20～T23 |
+| T24 | [#26](https://git.ilapage.cn/OPC/goauto/issues/26) | 修复 PDD 规格面板蛇形遍历与尺码续页（2026-08-17 已验收） | T20～T23 |
 | T25 | [#27](https://git.ilapage.cn/OPC/goauto/issues/27) | PDD 假售罄页面一次性下拉恢复 | T20～T24 |
 | T26 | [#28](https://git.ilapage.cn/OPC/goauto/issues/28) | PDD 商品详情进入失败后一次性重开浏览器恢复 | T20～T25 |
 | T27 | [#29](https://git.ilapage.cn/OPC/goauto/issues/29) | 修复相似商品区域导致假售罄恢复不触发 | T25、T26 |
@@ -68,7 +68,9 @@ T17 只验证 PDD 商品采集最小闭环：Agent 注册与心跳、任务串
 - 最终重置复采状态为 `completed`、缺失清单为空：14 个颜色、14 个颜色价格、8 个尺码和 112 个完整可用 SKU；同一颜色价格按业务规则复制到各尺码。
 - 尺码包含 `S` 至 `4XL` 和页面实际提供的定制选项；Agent 全程只读尺码，没有点击尺码、订单或支付控件。
 - 标题候选改为与销量节点存在空间关联的文本，不再把页面任意最长文本当作商品标题；旧结果已由重置事务清除。
- 全程只持久化结构化结果，未保存或上传原始控件树和截图。T24 实施与真机验证完成，等待用户验收。
+- 全程只持久化结构化结果，未保存或上传原始控件树和截图。
+- 2026-08-17 三星 SM-G9700 的任务 35 复采验证了选中颜色节点消失并重排的兼容修复：3 个颜色、3 个价格和 1 个尺码均已保存，`colorRow:1/2` 误报消失。评价数量仍未暴露为受支持的无障碍文本，因此按约定保留 `completed_partial` 和 `missing=[reviewCount]`，用户确认暂不处理。
+- T24 于 2026-08-17 经用户明确验收通过。

 ## 支持范围

@@ -56,6 +56,6 @@

 ## 当前阶段

-当前采集 MVP 的 T01～T22 已完成实现并由用户验收；T08 只读实时屏幕已延期。T23～T28 的一加真机增强、规格遍历、假售罄恢复、浏览器重开恢复和端口配置已经实现，其中部分工单仍等待用户验收。
+当前采集 MVP 的 T01～T22 和 T24 已完成实现并由用户验收；T08 只读实时屏幕已延期。T23、T25～T28 的一加真机增强、假售罄恢复、浏览器重开恢复和端口配置已经实现，其中部分工单仍等待用户验收。T24 的规格遍历已在一加和三星真机复核；三星未识别评价数量的问题由用户确认暂不处理。

 #31 PDD 商品档案原型已由用户确认，数据库、API 和 Admin 商品档案页面已进入待验收；#45 继续独立承担 PDD 商品列表批量创建采集任务，未混入商品档案实现。#32 采购闭环原型及后续采购工单仍按各自门禁推进。采购永不支付，真实地址修改和创建订单属于必须再次人工确认的高风险范围。
@@ -0,0 +1,57 @@
+# 26 修复 PDD 规格面板蛇形遍历与尺码续页
+
+- 类型：缺陷
+- 所属 Epic：#1
+- 所属 MVP / 版本：#2 采集最小闭环
+- 状态：已完成
+- 日期：2026-08-15～2026-08-17
+- Gitea 工单：https://git.ilapage.cn/OPC/goauto/issues/26
+- Wiki 页面：Task-26-PDD-spec-traversal
+- Wiki revision：以页面当前 revision 为准
+
+## 背景与目标
+
+商品 `236231603269` 初次采集只得到颜色，没有得到页面实际存在的尺码。后续三星任务 35 又暴露出选中颜色后节点消失、剩余选项重排时错误报告 `colorRow:1/2`。目标是稳定完成颜色蛇形遍历、逐颜色价格采集和尺码续页，不点击尺码、订单或支付控件。
+
+## 最终方案
+
+- 从当前规格节点祖先锁定横向颜色容器和纵向规格面板。
+- 规格面板有界归顶，使用文字与 bounds 视口签名判断边缘。
+- 颜色按视觉行交替方向遍历；每次点击后重新读取无障碍树并等待价格稳定。
+- 尺码只读，首次识别后保存容器结构，标题滚出后继续分页读取。
+- 选中颜色从可点击节点中消失并引起重新排版时，只结束当前行扫描，不再把行消失误报为数据缺失；颜色为空、价格缺失和点击失败仍明确报告。
+
+## 修改文件
+
+- `android/app/src/main/java/cn/ilapage/goauto/agent/automation/PddProductDetailCollector.kt`：规格容器、蛇形遍历、尺码续页和颜色行重排处理。
+- `android/app/src/main/java/cn/ilapage/goauto/agent/automation/AndroidUiDriver.kt`：规格容器滚动与手势完成等待。
+- `android/app/src/test/java/cn/ilapage/goauto/agent/PddProductDetailCollectorTest.kt`：长规格、续页和选中项消失重排回归测试。
+- `docs/` 与 `android/README.md`：算法和真机验证证据。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 商品 236231603269 采集实际尺码 | 通过：14 个颜色、14 个价格、8 个尺码、112 个 SKU |
+| 颜色文字安全点击并逐项读取价格 | 通过 |
+| 尺码只读，不触发订单或支付 | 通过 |
+| 三星颜色选中后重排不再误报 `colorRow:*` | 通过：任务 35 复采只剩 `reviewCount` |
+| 只保存结构化结果 | 通过 |
+| 用户验收 | 2026-08-17 明确通过 |
+
+## 测试
+
+- 执行命令：`android/gradlew.bat test assembleDebug`
+- 结果：通过，Debug APK 构建成功。
+- 一加任务 23：`completed`，14 个颜色、8 个尺码、112 个完整 SKU。
+- 三星任务 35：3 个颜色、3 个价格、1 个尺码；颜色行误报消失，`reviewCount` 按用户决定暂不处理。
+- **未验证部分**：三星页面评价数量兼容不属于 #26，保留 `completed_partial`。
+
+## 遗留问题
+
+- 三星任务 35 无障碍数据未提供当前解析器支持的评价数量，用户已确认暂不处理。
+
+## 相关提交
+
+- `72d6145` fix: complete PDD spec panel traversal (#26)
+- `1bf676e` fix(#26): ignore reflowed completed color rows