docs: 归档任务 #277

2026-08-18 17:56:45 +08:00
parent 1902935d58
commit 08a5d8c3d0
1 changed files with 47 additions and 0 deletions
@@ -0,0 +1,47 @@
+# 277 修正规格摘要误判颜色标题
+
+- 类型：缺陷
+- 父级大工单：#96
+- 所属 MVP / 版本：#253 采购运行时 AI 规格纠偏闭环
+- 状态：待验收
+- 日期：2026-08-18
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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)`