fix(shopee): 颜色先统一繁简体格式做唯一精确匹配再调用AI(已上线,待验收) #257

Open
opened 2026-09-10 14:51:51 +08:00 by ila · 1 comment
Owner

需求与确认

2026-09-10 用户确认:颜色与尺码统一标准化比较,最小优化,建单实施,完成后编译更新线上,已授权合并发布及 GoAuto 重启。

基线与根因

main 2cb78ad;ai_suggest.go suggestMappings 仅 size 执行 deterministicSizeMatch,color 直接进入 AI。已有 aimatching.Normalize 可统一简体、空格、全半角、大小写。现场繁简体对应颜色候选可选但未匹配;不能据此断定 AI 未确认的具体原因。

方案与范围

仅 Server shopeeproduct 颜色建议/一键匹配路径与测试;复用 aimatching.DeterministicMatch 的颜色唯一规范化匹配。保留原规格名称,映射目标保存 PDD 原始候选名称。已确认且仍有效的映射优先保留;唯一精确命中返回 matched,现有自动匹配保存为 exact_match+confirmed;未命中或标准化后歧义仍走既有 AI/阈值/候选校验。不进行同义词猜测,不改 AI 输入原文,不重构原尺码路径。
不改 Android/Web/接口字段/权限/数据库结构,不降低AI阈值、不批量重算历史映射、不触发真实匹配或采购。依赖已满足,可与Android #256独立进行,不合入Android分支。

设计与验收

后端局部规则补全,无UI变化,复用现有界面与保存契约,无需原型。
测试繁简体/空格/全半角/大小写颜色唯一匹配、返回原始PDD标签;无AI配置时完整精确匹配可成功;已确认映射保留;未命中与歧义仍进入既有AI路径;不可选候选不参与;建议接口不写入,自动匹配保存正确来源状态,不改变原规格名称。回归shopeeproduct、aimatching、全Server测试与构建。

发布与风险

用户授权本单合并main、构建Linux Server、部署线上并重启GoAuto。保留原Web、配置、持久化目录及任务启停,不迁移、不清理生产数据、不下单或付款。切换前检查运行任务,旧release保留回退。线上只做健康和版本验证,实际一键匹配由用户操作验收。

文档影响

更新 Business-Rules-and-Glossary 中颜色/尺码先规范化唯一匹配的规则,Wiki在线回读revision后一次sync及sync --check;不导出任务归档。

工作流

Gitea MCP不可用,使用项目安全配置API回退,无凭据输出。开始实施,完成回写后保持待验收。

## 需求与确认 2026-09-10 用户确认:颜色与尺码统一标准化比较,最小优化,建单实施,完成后编译更新线上,已授权合并发布及 GoAuto 重启。 ## 基线与根因 main 2cb78ad;ai_suggest.go suggestMappings 仅 size 执行 deterministicSizeMatch,color 直接进入 AI。已有 aimatching.Normalize 可统一简体、空格、全半角、大小写。现场繁简体对应颜色候选可选但未匹配;不能据此断定 AI 未确认的具体原因。 ## 方案与范围 仅 Server shopeeproduct 颜色建议/一键匹配路径与测试;复用 aimatching.DeterministicMatch 的颜色唯一规范化匹配。保留原规格名称,映射目标保存 PDD 原始候选名称。已确认且仍有效的映射优先保留;唯一精确命中返回 matched,现有自动匹配保存为 exact_match+confirmed;未命中或标准化后歧义仍走既有 AI/阈值/候选校验。不进行同义词猜测,不改 AI 输入原文,不重构原尺码路径。 不改 Android/Web/接口字段/权限/数据库结构,不降低AI阈值、不批量重算历史映射、不触发真实匹配或采购。依赖已满足,可与Android #256独立进行,不合入Android分支。 ## 设计与验收 后端局部规则补全,无UI变化,复用现有界面与保存契约,无需原型。 测试繁简体/空格/全半角/大小写颜色唯一匹配、返回原始PDD标签;无AI配置时完整精确匹配可成功;已确认映射保留;未命中与歧义仍进入既有AI路径;不可选候选不参与;建议接口不写入,自动匹配保存正确来源状态,不改变原规格名称。回归shopeeproduct、aimatching、全Server测试与构建。 ## 发布与风险 用户授权本单合并main、构建Linux Server、部署线上并重启GoAuto。保留原Web、配置、持久化目录及任务启停,不迁移、不清理生产数据、不下单或付款。切换前检查运行任务,旧release保留回退。线上只做健康和版本验证,实际一键匹配由用户操作验收。 ## 文档影响 更新 Business-Rules-and-Glossary 中颜色/尺码先规范化唯一匹配的规则,Wiki在线回读revision后一次sync及sync --check;不导出任务归档。 ## 工作流 Gitea MCP不可用,使用项目安全配置API回退,无凭据输出。开始实施,完成回写后保持待验收。
Author
Owner

已完成并线上发布,待验收(2026-09-10)

  • 实现 ea38ced58cba0878cbaa9aa917930995ab8381b0;Wiki镜像305062dba07580c39069dbf17750e73655e1bbbc。两提交已推送并快进合并main;main工作区干净。代码范围仅shopeeproduct颜色建议分支及合成测试,无Android/Web/迁移变化。
  • 颜色先保留有效confirmed映射,再调用已有DeterministicMatch颜色路径。唯一规范化命中返回matched,现有AutoMatchMappings保存exact_match+confirmed。原始名称不变、映射目标保留PDD候选原文。尺码路径未改,歧义/未命中继续原AI处理,无阈值或权限放宽。
  • 先红后绿:新增无AI配置繁简体颜色测试在原实现报AI未启用,修复后通过。测试覆盖大紅/大红、墨綠/墨绿、空格/全半角/大小写,建议不写库、一键匹配持久化正确状态与来源、原PDD规格不变、歧义/不可选/未命中仍回到AI。现有有效映射保留、低置信度、候选校验测试一并通过。
  • go test -p 1 ./app/goauto/shopeeproduct ./app/goauto/aimatching、go test -p 1 ./...、Linux amd64 CGO=0 trimpath stripped构建通过;gofmt、diff --check通过。合成测试只用内存数据库与既有测试Provider,不触发真实AI/订单。
  • Wiki Business-Rules-and-Glossary在线revision 31d2dbd24acd8ac119dfd0d538c12d0525a2764f,一轮sync和sync --check通过。同步附带的无关Troubleshooting镜像保留未暂存,不混入提交。部署拓扑与运维命令不变,无额外运维Wiki更新。
  • 已按用户本轮授权上线 /home/goauto/releases/20260910-ea38ced-257,运行Server代码与main一致(差异仅文档)。二进制66785442 bytes,SHA256 08c93104f84316534cd6ebedf0a73e3aba9f4891a9f27035aab1b6c990c62b3a,上传与运行进程摘要一致。
  • GoAuto重启成功PID28186/active,内外部健康200,外部首页200,Nginx首页与沿用Web文件一致。切换前业务运行计数为0;未迁移、未修改AI设置,定时任务启停和迁移版本前后相同。保留Web、配置及持久化目录,未重启Nginx或本地服务。
  • 旧release /home/goauto/releases/20260910-2cb78ad-255 保留可回退。未删除数据、未批量重算映射、未代用户点击一键匹配或创建采购任务/订单/付款。线上真实商品映射效果仍待用户手动点击验收。
  • Gitea MCP不可用,沿用安全配置API回退;未输出凭据。工单保持开放待验收。
## 已完成并线上发布,待验收(2026-09-10) - 实现 ea38ced58cba0878cbaa9aa917930995ab8381b0;Wiki镜像305062dba07580c39069dbf17750e73655e1bbbc。两提交已推送并快进合并main;main工作区干净。代码范围仅shopeeproduct颜色建议分支及合成测试,无Android/Web/迁移变化。 - 颜色先保留有效confirmed映射,再调用已有DeterministicMatch颜色路径。唯一规范化命中返回matched,现有AutoMatchMappings保存exact_match+confirmed。原始名称不变、映射目标保留PDD候选原文。尺码路径未改,歧义/未命中继续原AI处理,无阈值或权限放宽。 - 先红后绿:新增无AI配置繁简体颜色测试在原实现报AI未启用,修复后通过。测试覆盖大紅/大红、墨綠/墨绿、空格/全半角/大小写,建议不写库、一键匹配持久化正确状态与来源、原PDD规格不变、歧义/不可选/未命中仍回到AI。现有有效映射保留、低置信度、候选校验测试一并通过。 - `go test -p 1 ./app/goauto/shopeeproduct ./app/goauto/aimatching`、`go test -p 1 ./...`、Linux amd64 CGO=0 trimpath stripped构建通过;gofmt、diff --check通过。合成测试只用内存数据库与既有测试Provider,不触发真实AI/订单。 - Wiki Business-Rules-and-Glossary在线revision `31d2dbd24acd8ac119dfd0d538c12d0525a2764f`,一轮sync和sync --check通过。同步附带的无关Troubleshooting镜像保留未暂存,不混入提交。部署拓扑与运维命令不变,无额外运维Wiki更新。 - 已按用户本轮授权上线 `/home/goauto/releases/20260910-ea38ced-257`,运行Server代码与main一致(差异仅文档)。二进制66785442 bytes,SHA256 `08c93104f84316534cd6ebedf0a73e3aba9f4891a9f27035aab1b6c990c62b3a`,上传与运行进程摘要一致。 - GoAuto重启成功PID28186/active,内外部健康200,外部首页200,Nginx首页与沿用Web文件一致。切换前业务运行计数为0;未迁移、未修改AI设置,定时任务启停和迁移版本前后相同。保留Web、配置及持久化目录,未重启Nginx或本地服务。 - 旧release `/home/goauto/releases/20260910-2cb78ad-255` 保留可回退。未删除数据、未批量重算映射、未代用户点击一键匹配或创建采购任务/订单/付款。线上真实商品映射效果仍待用户手动点击验收。 - Gitea MCP不可用,沿用安全配置API回退;未输出凭据。工单保持开放待验收。
ila changed title from fix(shopee): 颜色先统一繁简体格式做唯一精确匹配再调用AI to fix(shopee): 颜色先统一繁简体格式做唯一精确匹配再调用AI(已上线,待验收) 2026-09-10 14:57:08 +08:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#257