docs(#46): revise spec matching rules for AI matching
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
QiuSW
@@ -11,7 +11,8 @@
|
||||
- 当前采集 MVP 只实现 PDD 商品、规则、任务、Android 执行和任务详情。采购是独立的后续高风险 MVP，未通过对应原型和工单门禁前不能混入采集代码。
|
||||
- 不保存原始控件树和设备截图；只保存结构化任务日志、错误码、任务规则快照和采集结果。
|
||||
- 一台设备同一时刻只执行一个任务；手机离线时当前采集任务失败，默认不重试、不自动换机。
|
||||
- 找不到控件、验证码、风控、人机验证或登录失效时明确失败，不使用 OCR/VLM，不猜测规格，不点击相近候选。
|
||||
- 找不到控件、验证码、风控、人机验证或登录失效时明确失败，不使用 OCR/VLM。
|
||||
- 规格匹配：Agent 本地不得自行猜测规格或点击相近候选，只执行服务端下发的精确规格；人工映射缺失、商品无规格数据或目标规格定位不到时，由服务端 AI 匹配接口决策（见 #46），AI 无结果时明确失败。
|
||||
- SKU 数据不完整仍须提交并允许在任务详情查看，状态记为 `completed_partial`。
|
||||
- 规则创建即生效；删除后不能创建新任务，但已有任务继续使用自身规则快照。
|
||||
- 同一 PDD 商品不能同时存在多个 `pending` 或 `running` 采集任务。
|
||||
|
||||
@@ -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
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 业务规则与术语
|
||||
@@ -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`，用于事后批量追溯 |
|
||||
|
||||
Reference in New Issue
Block a user