cmautobuy/docs/task/166-兼容款式与套餐规格.md

#166 Client：兼容款式与套餐规格分组

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

背景与目标

商品 757123298435 的规格面板使用“款式”和“套餐”两个分组。原解析器不认识 “套餐”标题，把套餐按钮继续归入前面的款式区域，最终将套餐组合错误写入 color。本任务让 Client 正确拆分并保存这两个规格。

最终方案

• 规格解析器增加“花色”和“套餐”标题别名。“款式/花色/颜色”映射为主规格 color；前面已有主规格时，“套餐”映射为第二规格 size。
• 只有“套餐”一个分组时，将其作为主规格 color，保证现有逐主规格采价流程仍 能工作；额外第三维度生成独立 key，并由采集流程明确拒绝，不静默合并。
• 最终 dimensions 保留页面原始名称“款式”“套餐”，SKU 仍使用稳定的 color / size 字段。
• 默认选中的套餐沿用第二规格安全取消流程，取消后回到顶部采集所有款式。
• 采购确认面板和规格选择区域同步识别“款式/套餐”。只有套餐时选择区域可以用 套餐标题兜底；款式和套餐同时存在时始终优先款式。
• 保持原价格规则不变：只逐个主规格采价，不采集款式与套餐的组合价格。

改了哪些文件

• client/src/pdd_collect_service.py：增加套餐分组、上下文 key 映射及原始分组名称 保留。
• client/src/pdd_u2_purchase_adapter.py：采购面板证据词兼容款式和套餐。
• client/src/util/select_color_size.py：套餐作为单规格时可作为主规格区域兜底。
• client/test/test_pdd_collect_service.py：增加款式套餐、单独套餐、默认套餐取消、 三维规格拒绝和完整采集测试。
• client/test/test_pdd_u2_purchase_adapter.py：增加采购面板识别回归测试。

验收结果

• 款式选项只进入 color，套餐文字不再混入颜色。
• 套餐选项进入 size，并保留原始分组名称。
• 默认选中的套餐可以安全取消，再采集全部款式。
• 只有套餐一个维度的商品仍能作为主规格采集。
• 不支持的额外维度不会被静默合并。
• 采购面板能识别“款式/套餐”，现有颜色尺码测试没有回归。
• 没有修改数据库、Admin 接口及价格粒度。
• 精确测试、Client 全量测试和语法检查通过。
• 用户使用真机商品 757123298435 确认最终款式和套餐数据。

测试

在 client/ 目录执行：

$env:QT_QPA_PLATFORM="offscreen"
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_pdd_u2_purchase_adapter.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 src/pdd_u2_purchase_adapter.py src/util/select_color_size.py test/test_pdd_collect_service.py test/test_pdd_u2_purchase_adapter.py
Remove-Item Env:QT_QPA_PLATFORM

结果：采集服务 58 项、采购适配器 26 项、Client 完整 420 项测试通过，语法检查 通过。

没验证到的部分：未使用真机重新采集商品 757123298435；未执行真实采购、 下单或付款；套餐价格仍按已确认规则不单独采集。

相关提交

• 9c7e715 兼容款式与套餐规格分组。