采购任务创建时,服务端先将 SYB 的目标颜色、尺码与 PDD 商品档案规格做确定性标准化匹配;未唯一命中时才使用可配置的 AI Provider 作为兜底。AI 配置在管理端「系统设置 → AI 规格匹配」中维护。Android Agent 不转换、不匹配、不接触 Provider 或密钥,只执行服务端下发的精确 PDD 规格文字。
用户已确认的规则:
spec_probe_completed
prototypes/<本工单号>/v1/index.html
Business-Rules-and-Glossary
Android-Agent-API-Contract
Architecture-and-Code-Map
Local-Development-and-Verification
原型 v1 已完成,等待用户审核:
prototypes/62/v1/index.html
df48ca0
docs(#62): add AI matching settings prototype
原型获明确确认前,不开始生产代码;数据库迁移和外部 Provider 测试连接在实施前还须单独人工确认。
2026-08-21:用户已明确验收通过 prototypes/62/v1/index.html。原型状态由“待审核”更新为“已确认”。下一步为服务端/Web 实施;因需新增加密配置存储与数据库迁移,按仓库安全规则等待单独人工确认后才开始。
需求变更已记录:用户于 2026-08-21 明确允许内部部署的 AI Provider API Key 明文保存,并只供管理员后续查看与替换;采购员和 Android 仍不可读取。Base URL 也明确支持公网/内网 HTTP 和 HTTPS。
新版设计证据:prototypes/62/v2/index.html,提交 9adb29b。v2 覆盖管理员显示/隐藏 Key、保存与测试反馈、HTTP 提示、未配置/测试失败状态和采购员只读隔离。原 v1 不再作为本次实现依据。
prototypes/62/v2/index.html
9adb29b
本地 HTML 与内联 JavaScript 静态校验通过;当前环境没有可用浏览器连接,尚未进行浏览器交互验收。请审核 v2;确认后才会把现有 #62 代码改为明文存储与管理员回显。
6181d97 feat(#62): add AI specification matching settings
enabled
go test ./...
pnpm lint
pnpm build:prod
python dev_scripts/harness.py check --strict
sync --check
下一步仅剩本机数据库迁移的人工确认。迁移只会将 ai_matching_setting.api_key_encrypted 重命名为 api_key 并保留已有字段值;不会触碰商品、采购任务、尝试、订单或支付数据。
ai_matching_setting.api_key_encrypted
api_key
用户已明确确认后执行 go run . migrate -c config/settings.yml。
go run . migrate -c config/settings.yml
结果:
1786701400000
sys_migration
用户要求:
该变更涉及接口校验与已确认页面的状态反馈位置。将创建 prototypes/62/v3/index.html,覆盖管理员测试成功/失败/进行中与采购员只读边界;用户重新审核通过 v3 后才修改生产代码和长期 Wiki。
prototypes/62/v3/index.html
97a7131 docs(#62): add AI settings v3 review prototype
等待用户审核 v3。未修改生产代码、接口校验或数据库。
0e3be46 feat(#62): extend AI matching timeout
timeoutSeconds
aria-live
26b3a4a
harness.py sync --check
harness.py check --strict
本单继续保持待用户验收,未关闭。
用户已明确确认 #62 可用并要求继续下一步,现按验收通过归档。
c57a1e1944f1c4dfb8fcade13eebfcff97242771
0e3be46
docs/task/
No dependencies set.
The note is not visible to the blocked user.
基本信息
需求摘要
采购任务创建时,服务端先将 SYB 的目标颜色、尺码与 PDD 商品档案规格做确定性标准化匹配;未唯一命中时才使用可配置的 AI Provider 作为兜底。AI 配置在管理端「系统设置 → AI 规格匹配」中维护。Android Agent 不转换、不匹配、不接触 Provider 或密钥,只执行服务端下发的精确 PDD 规格文字。
用户已确认的规则:
交付范围
服务端
spec_probe_completed后使用实时可选规格重复“确定性 → AI”,固化决策后才允许第二趟派发。管理端
不做
设计证据与门禁
prototypes/<本工单号>/v1/index.html。前置依赖与并行
验收标准
验证与风险
文档影响
Business-Rules-and-GlossaryAndroid-Agent-API-ContractArchitecture-and-Code-MapLocal-Development-and-Verification需求变更记录(2026-08-21)
原型 v1 已完成,等待用户审核:
prototypes/62/v1/index.htmldf48ca0docs(#62): add AI matching settings prototype原型获明确确认前,不开始生产代码;数据库迁移和外部 Provider 测试连接在实施前还须单独人工确认。
2026-08-21:用户已明确验收通过
prototypes/62/v1/index.html。原型状态由“待审核”更新为“已确认”。下一步为服务端/Web 实施;因需新增加密配置存储与数据库迁移,按仓库安全规则等待单独人工确认后才开始。需求变更已记录:用户于 2026-08-21 明确允许内部部署的 AI Provider API Key 明文保存,并只供管理员后续查看与替换;采购员和 Android 仍不可读取。Base URL 也明确支持公网/内网 HTTP 和 HTTPS。
新版设计证据:
prototypes/62/v2/index.html,提交9adb29b。v2 覆盖管理员显示/隐藏 Key、保存与测试反馈、HTTP 提示、未配置/测试失败状态和采购员只读隔离。原 v1 不再作为本次实现依据。本地 HTML 与内联 JavaScript 静态校验通过;当前环境没有可用浏览器连接,尚未进行浏览器交互验收。请审核 v2;确认后才会把现有 #62 代码改为明文存储与管理员回显。
v2 审核与实现状态(2026-08-21)
prototypes/62/v2/index.html。该版本覆盖内部部署下管理员明文查看/替换 API Key、采购员只读启用状态,以及公网/内网 HTTP/HTTPS Base URL。6181d97 feat(#62): add AI specification matching settings。enabled,Android 与任务快照不接收密钥。go test ./...、迁移单元测试、pnpm lint、pnpm build:prod、python dev_scripts/harness.py check --strict与sync --check。未配置真实 Provider,未发起外部连接、真机改地址、创建订单或支付。下一步仅剩本机数据库迁移的人工确认。迁移只会将
ai_matching_setting.api_key_encrypted重命名为api_key并保留已有字段值;不会触碰商品、采购任务、尝试、订单或支付数据。本机数据库迁移已执行(2026-08-21)
用户已明确确认后执行
go run . migrate -c config/settings.yml。结果:
ai_matching_setting.api_key_encrypted已重命名为api_key;1786701400000已写入sys_migration;需求变更:超时与测试反馈位置(2026-08-21)
用户要求:
该变更涉及接口校验与已确认页面的状态反馈位置。将创建
prototypes/62/v3/index.html,覆盖管理员测试成功/失败/进行中与采购员只读边界;用户重新审核通过 v3 后才修改生产代码和长期 Wiki。v3 审核原型已就绪(2026-08-21)
prototypes/62/v3/index.html97a7131 docs(#62): add AI settings v3 review prototype等待用户审核 v3。未修改生产代码、接口校验或数据库。
v3 已确认并完成实现(2026-08-21)
prototypes/62/v3/index.html。0e3be46 feat(#62): extend AI matching timeout。timeoutSeconds服务端与管理端范围已从 3~60 秒调整为 3~600 秒;测试覆盖 600 可保存、601 被拒绝。aria-live通知辅助技术。26b3a4a;本地镜像已同步。go test ./...、pnpm lint(30 条既有警告、无错误)、pnpm build:prod、harness.py sync --check、harness.py check --strict。本单继续保持待用户验收,未关闭。
用户验收与归档(2026-08-21)
用户已明确确认 #62 可用并要求继续下一步,现按验收通过归档。
c57a1e1944f1c4dfb8fcade13eebfcff972427710e3be46。docs/task/,因为用户未要求任务归档镜像。用户验收与归档(2026-08-21)
用户已明确确认 #62 可用并要求继续下一步,现按验收通过归档。
c57a1e1944f1c4dfb8fcade13eebfcff972427710e3be46。docs/task/,因为用户未要求任务归档镜像。