From faecd90d2bb1090be92592b9c28f939579cffcab Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Tue, 18 Aug 2026 15:47:38 +0800 Subject: [PATCH] docs(#46): revise spec matching rules for AI matching Co-Authored-By: Claude Opus 5 --- AGENTS.md | 3 ++- docs/03-business-rules-and-glossary.md | 14 +++++++++++--- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 7f6c6fd..5987d76 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -11,7 +11,8 @@ - 当前采集 MVP 只实现 PDD 商品、规则、任务、Android 执行和任务详情。采购是独立的后续高风险 MVP，未通过对应原型和工单门禁前不能混入采集代码。 - 不保存原始控件树和设备截图；只保存结构化任务日志、错误码、任务规则快照和采集结果。 - 一台设备同一时刻只执行一个任务；手机离线时当前采集任务失败，默认不重试、不自动换机。 -- 找不到控件、验证码、风控、人机验证或登录失效时明确失败，不使用 OCR/VLM，不猜测规格，不点击相近候选。 +- 找不到控件、验证码、风控、人机验证或登录失效时明确失败，不使用 OCR/VLM。 +- 规格匹配：Agent 本地不得自行猜测规格或点击相近候选，只执行服务端下发的精确规格；人工映射缺失、商品无规格数据或目标规格定位不到时，由服务端 AI 匹配接口决策（见 #46），AI 无结果时明确失败。 - SKU 数据不完整仍须提交并允许在任务详情查看，状态记为 `completed_partial`。 - 规则创建即生效；删除后不能创建新任务，但已有任务继续使用自身规则快照。 - 同一 PDD 商品不能同时存在多个 `pending` 或 `running` 采集任务。 diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index 6979272..bd4b8a3 100644 --- a/docs/03-business-rules-and-glossary.md +++ b/docs/03-business-rules-and-glossary.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Business-Rules-and-Glossary wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary.- -wiki_revision: d5b5407a09e3bcdc0bc34be2eb244e781c557420 -synchronized_at: 2026-08-17T09:15:56Z +wiki_revision: 6dea349fe5231f5d336919e3861b455b9bead8a4 +synchronized_at: 2026-08-18T07:46:08Z # 业务规则与术语 @@ -69,7 +69,8 @@ synchronized_at: 2026-08-17T09:15:56Z - 浏览器“打开拼多多APP”和系统确认框“打开”属于允许动作。 - 登录失效、验证码、风控、人机验证和找不到唯一控件时失败并给出具体错误。 -- 不使用 OCR/VLM 兜底，不猜测缺失数据，不保存原始控件树或截图。 +- 不使用 OCR/VLM 兜底，不保存原始控件树或截图。采集阶段不猜测缺失数据。 +- 采购阶段的规格匹配由服务端决策（见 [#46](https://git.ilapage.cn/OPC/goauto/issues/46)）：Agent 本地不得自行猜测规格或点击相近候选，只执行服务端下发的精确规格；AI 无匹配结果时明确失败。 - 当前 MVP 不创建订单、不支付、不提供实时屏幕或管理端远程控制。 - Agent 的长期能力可以扩展到采购规则中的“创建订单”，但采集规则不能调用该动作；采购必须作为独立高风险 MVP 实施。付款、免密支付及任何等价动作始终禁止。 @@ -93,3 +94,10 @@ synchronized_at: 2026-08-17T09:15:56Z | 部分完成 | 结果已提交，但一个或多个规格/SKU 缺失 | | 重置任务 | 保留任务输入快照，清除原结果后重新进入待执行状态 | | Portal/Agent | Android 端注册、保活、执行规则和提交结果的程序 | +| 虾皮 | Shopee 的中文展示名。管理端界面一律用「虾皮」，数据库表名、字段名、API 路径等程序标识符保持 `shopee_products` / `shopee_item_id` 不变 | +| 货运宝 / SYB | 顺云宝 ERP，虾皮订单与货运单的外部来源系统 | +| AI 规格匹配 | 人工映射缺失、PDD 商品无规格数据或目标规格定位不到时，由服务端 AI 接口把虾皮目标颜色尺码匹配到 PDD 实际规格；候选集限定为实时可选规格，无结果即失败 | +| 快路径 / 慢路径 | 采购执行的两种路径：Agent 能直接定位到下发的目标规格为快路径；定位不到则触发全量遍历采集并重新匹配，为慢路径 | +| 两趟执行 | 慢路径的实现方式：第一趟采集规格后结束并释放设备，服务端离线匹配，第二趟重新派发下单，复用 `task_attempt` 机制 | +| 采购探测 | 采购时对 PDD 商品页的实时规格采集，同时作为一次商品信息更新写回档案，按 `completed` / `completed_partial` 语义处理 | +| spec_source | 采购任务的规格来源标记：`manual_mapping` / `exact_match` / `ai_match`，用于事后批量追溯 |