cmautobuy/docs/task/155-兼容非滚动面板颜色节点.md

#155 Client：兼容非滚动规格面板的颜色节点定位

• 工单号：#155
• 类型：缺陷
• 父级：Epic #1、MVP #2
• 版本：Client 可运行任务闭环
• 状态：已完成，用户验收通过
• 日期：2026-08-11
• Gitea：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/155

背景与目标

Client 已能打开并解析新版非滚动规格面板，但采集商品 897186799891 时仍提示“规格面板没有可识别的颜色分类”。目标是让颜色 点击节点定位与规格解析使用同一套面板边界，并正确识别该页面的全部颜色。

最终方案

1. _find_option_node() 继续支持旧版可滚动容器，同时接受位于强证据确认的 非滚动规格面板中的可点击节点。
2. 保留文字精确匹配、有效坐标、最小宽度和屏幕安全边界检查，不对普通页面 增加无条件回退。
3. 实施中发现非滚动面板的按钮宽度按文字长度变化，旧版“最宽按钮 60%”规则 会误删短名称颜色。因此只在强证据确认的非滚动面板中跳过相对宽度过滤； 旧版可滚动面板继续保留该过滤规则。
4. 增加正向和负向回归，分别验证非滚动面板的3行5色结构，以及普通页面的 同名可点击文字不会被当成规格选项。

最终方案与建单方案目标一致；新增的按钮宽度处理来自实施中的第二层根因，已 在 Gitea 工单记录。

改了哪些文件

• client/src/pdd_collect_service.py：兼容非滚动面板的颜色节点及自适应按钮宽度。
• client/test/test_pdd_collect_service.py：增加颜色行识别和普通页面拒绝测试。

验收结果

• 脱敏非滚动面板识别为3行、共5个颜色节点。
• 颜色文字、可用状态和点击坐标均被保留。
• 现有可滚动规格面板测试继续通过。
• 普通页面中的同名可点击文字不会被当作规格选项。
• 未增加 sleep 或扩大超时时间。
• 采集服务精确测试、完整 Client 测试和语法检查通过。
• 用户使用真机重新采集商品 897186799891 验收。

测试

在 client/ 目录执行：

C:/Python310/python.exe -m unittest discover -s test -p "test_pdd_collect_service.py"
C:/Python310/python.exe -m unittest discover -s test -p "test_*.py"
C:/Python310/python.exe -m py_compile src/pdd_collect_service.py test/test_pdd_collect_service.py

结果：采集服务42项通过，Client完整396项通过，语法检查通过。本次真实失败 XML 只读复验得到3行、共5个颜色。

未验证到的部分：未使用真机重新采集商品 897186799891；未执行采购、下单 或付款。