diff --git a/docs/task/177-兼容非滚动面板静态尺码采集.md b/docs/task/177-兼容非滚动面板静态尺码采集.md new file mode 100644 index 0000000..4e4bab2 --- /dev/null +++ b/docs/task/177-兼容非滚动面板静态尺码采集.md @@ -0,0 +1,48 @@ +# 177 兼容非滚动规格面板的静态尺码采集 + +- 类型:缺陷 +- 父级大工单:#1 +- 所属 MVP / 版本:#2 +- 状态:已完成,待用户验收 +- 日期:2026-08-12 +- Gitea 工单: + +## 背景与目标 + +提交提示型非滚动规格面板已经能识别尺码文字,但第二规格续页逻辑仍强制要求滚动容器,导致已经识别出全部尺码后报“无法定位第二规格滚动区域”。目标是在不放宽未知页面校验的前提下,正确接受强证据确认的静态尺码列表。 + +## 最终方案 + +- 建立第二规格续页上下文前,先检查是否存在第二规格滚动区域。 +- 没有滚动区域时,只有现有强证据能确认完整非滚动规格面板,才按当前控件树顺序返回第二规格。 +- 静态分支继续过滤非规格文字,并保留标题明确数量的完整性校验。 +- 普通未知结构仍返回原错误;横向和纵向第二规格继续使用原续页上下文。 + +## 改了哪些 + +- `client/src/pdd_collect_service.py`:增加强证据非滚动第二规格的静态采集分支。 +- `client/test/test_pdd_collect_service.py`:补充静态尺码、不滑动、明确数量不足和强证据边界测试。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 提交提示型非滚动面板返回全部可见尺码 | 通过 | +| 静态尺码采集不执行滑动 | 通过 | +| 未经强证据确认的结构不进入静态分支 | 通过 | +| 标题明确数量但采集不足时仍安全失败 | 通过 | +| 横向、纵向第二规格续页测试保持通过 | 通过 | +| Client 全量测试通过 | 通过 | + +## 测试 + +- 执行的命令:在 `client` 目录执行 `C:/Python310/python.exe -m unittest discover -s test -p 'test_pdd_collect_service.py'` +- 结果:67 个采集测试全部通过。 +- 执行的命令:在 `client` 目录执行 `$env:QT_QPA_PLATFORM='offscreen'; C:/Python310/python.exe -m unittest discover -s test -p 'test_*.py'` +- 结果:442 个 Client 测试全部通过。 +- 额外验证:使用本机失败时临时保存的控件树进行只读验证,得到 M、L、XL、2XL、3XL,滑动 0 次;原始 XML 未提交。 +- **没验证到的部分**:未连接真机重新执行商品 823647390597;实际采集提交 Admin 的闭环等待用户验收。 + +## 相关提交 + +- `2088bc3` fix: 兼容非滚动面板静态尺码采集 (#177)