docs: 归档任务 #284

2026-08-21 10:14:05 +08:00
parent f83f15c6e6
commit 1675c8a7c9
1 changed files with 45 additions and 0 deletions
@@ -0,0 +1,45 @@
+# 284 Admin：AI 规格匹配候选上限放大至 100 条
+
+- 类型：需求
+- 父级大工单：#14
+- 所属 MVP / 版本：#199 / Admin AI规格批量匹配
+- 状态：已完成，待用户验收
+- 日期：2026-08-21
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/284
+
+## 背景与目标
+
+顺运宝批量 AI 规格匹配原先在模型调用前最多接受 24 个合格候选。候选多于 24 个时，系统会安全拒绝且不调用模型。用户确认将该硬上限放大到 100，让规格较多的 PDD 商品能够继续使用 AI 匹配。
+
+## 最终方案
+
+- 将 Admin 单次模型调用的候选上限从 24 调整到 100。
+- 只有已采集、可购买、未被规则判为冲突且规格键长度合法的候选才计入上限。
+- 恰好 100 条时沿用原有候选白名单、置信度、上下文和保存前硬校验调用模型；超过 100 条时不调用模型、不写映射，仅记录审计拒绝结果。
+- 拒绝提示改为明确说明“可购买候选超过 100 条，请先人工核对”。
+
+## 改了哪些
+
+- `admin/service/ai_specmatch.go`：调整候选上限常量和超限提示。
+- `admin/service/ai_specmatch_test.go`：增加 100 / 101 个合格候选的服务层边界测试。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 100 个合格候选会调用模型 | 通过 |
+| 101 个合格候选不调用模型且不写映射 | 通过 |
+| 原有白名单、人工优先和硬校验行为不变 | 通过现有服务层回归测试 |
+| 固定 Go 1.23.0 编译、静态检查与全量测试通过 | 通过 |
+
+## 测试
+
+- 执行的命令：
+  - `GOTOOLCHAIN=go1.23.0 go test ./service -run 'TestMatchSybSpecWithAI_候选白名单低置信度和人工优先' -count=1`
+  - `GOTOOLCHAIN=go1.23.0 go vet ./...; go build ./...; go test ./... -count=1`
+- 结果：全部通过。
+- **没验证到的部分**：未部署到生产环境，未使用真实 GPT-5.5 对 100 个候选进行端到端调用。
+
+## 相关提交
+
+- `f83f15c` feat: 放大 AI 规格候选上限 (#284)