cmautobuy/docs/task/277-修正规格摘要误判颜色标题.md

277 修正规格摘要误判颜色标题

• 类型：缺陷
• 父级大工单：#96
• 所属 MVP / 版本：#253 采购运行时 AI 规格纠偏闭环
• 状态：待验收
• 日期：2026-08-18
• Gitea 工单：#277

背景与目标

采购任务 cg83 下发颜色“紫色誘惑”后，Client 已正确匹配真机上的简体“紫色诱惑”，但把上方“请选择：颜色”摘要误当成颜色标题。错误区域没有覆盖完整可见的目标卡片，最终报 PURCHASE_OPTIONS_MISMATCH。

目标是准确识别独立规格标题，兼容带候选数量的标题，同时保持现有规格匹配和安全点击门禁。

最终方案

规格标题先删除空白和末尾括号数量，再与已有标题集合进行完整匹配。这样“颜色 (4)”和“颜色（4）”会按“颜色”处理，而“请选择：颜色”“选择款式后查看优惠”和“选择颜色后，提交订单”等摘要或提示不会成为标题。

没有修改繁简转换、颜色滚动、尺码选择、地址修改和下单流程。

改了哪些文件

• client/src/util/select_color_size.py：增加独立规格标题规范化，移除标题关键词包含匹配。
• client/test/test_select_color_size.py：覆盖本次摘要在上、真实标题在下的布局，以及两种括号数量格式。

验收结果

验收标准	结果
“请选择：颜色”不作为颜色标题	通过
“颜色 (4)”和“颜色（4）”可识别	通过
繁体目标可定位简体且完整可见的唯一颜色卡片	通过
既有颜色、套餐、尺码和采购适配器测试通过	通过
当前真机控件树只读计算得到正确区域和安全候选	通过

测试

• 执行的命令：C:/Python310/python.exe -m py_compile src/util/select_color_size.py
• 执行的命令：C:/Python310/python.exe -m pytest test/test_select_color_size.py test/test_pdd_u2_purchase_adapter.py -q
• 结果：89 passed。
• 真机只读结果：标题边界 (36, 1416, 198, 1469)；颜色区域 (0, 1469, 1080, 1580)；目标安全边界 (36, 1495, 249, 1580)。
• 没验证到的部分：尚未重新执行原失败任务的完整真机采购；未点击目标、下单或付款。

相关提交

• 1902935 fix: 修正规格摘要误判颜色标题 (#277)