docs: define Shopee probe fixture input

This commit is contained in:
QiuSW
2026-07-25 17:15:05 +08:00
parent 50a6d8ee5b
commit 285606639b
11 changed files with 164 additions and 10 deletions
+40 -4
View File
@@ -7,6 +7,7 @@
| 项 | 当前事实 |
| --- | --- |
| 任务来源 | 其他管理后台或本项目管理 Web 采集商品标题、描述、图片、数量和预算。 |
| 第一层样本来源 | 本机目录中的蝦皮订单文本和参考图;二者以蝦皮订单号作为同名文件名。 |
| 执行方式 | 采购人员使用 Android App 操作拼多多;当前没有可运行实现。 |
| 核心痛点 | 人工把图片和描述转成搜索词、逐条比较商品并记录结果,耗时且不一致。 |
| 验证范围 | 一台设备、一个管理身份、一个采购执行人员、拼多多单平台。 |
@@ -58,7 +59,38 @@
`order_submitted` 必须为 `false`。
9. 取消和失败不得自动转成新任务;是否重试由人员显式决定。
## 六、MVP 验收标准
## 六、第一层本地样本约定
第一层技术探针不依赖 Go-Gin。开发工具从用户明确指定的本机目录读取蝦皮订单样本,
规范化为与未来 API 一致的采购任务,再提供给 Android/VLM 工作流。
已经确认:
- 一份文本文件和一份参考图使用相同的蝦皮订单号作为主文件名,例如
`240725001234.txt` 与 `240725001234.jpg`。
- 文本包含自己的蝦皮店铺名、待采集商品标题、SKU 和数量。
- 2026-07-25 提供的首份样例是可按 UTF-8 解码的无 BOM 文本,固定四行标签为
`店铺名:`、`商品标题:`、`SKU:`、`数量:`。
- 首份同名参考图是可正常解码的 JPEG;具体像素尺寸只是样本事实,不作为固定限制。
- 蝦皮订单号作为外部来源标识,只用于关联样本和追踪,不作为内部数据库主键。
- 参考图和订单文本属于私有验证数据,不得提交 Git。
导入后至少形成以下不可变原始字段:
| 字段 | 来源 | 规则 |
| --- | --- | --- |
| `source_order_no` | 文件主名 | 必填;同一批样本内唯一。 |
| `source_store_name` | 文本 | 必填;日志和截图默认脱敏。 |
| `title` | 文本 | 必填。 |
| `sku` | 文本 | 必填;不得由模型改写。 |
| `quantity` | 文本 | 必须为正整数;不得由模型改写。 |
| `reference_image` | 同名图片 | 必填;缺失或匹配到多张时拒绝导入。 |
正式私有样本目录、是否允许 JPEG 以外的图片,以及一张订单包含多个 SKU 时的文本
和图片命名规则仍待 `T-004` 固定。解析器不得根据模糊内容猜测字段,也不得静默选择
重名图片;遇到不是上述四行格式的文件应明确失败,除非先通过新样例扩展契约。
## 七、MVP 验收标准
### 单任务验收
@@ -89,7 +121,7 @@
这些比例是进入下一阶段的验证门槛,不是正式生产 SLA。
## 七、范围决策
## 八、范围决策
| 问题 | 当前决策 |
| --- | --- |
@@ -99,10 +131,14 @@
| 搜索结果 | 最多检查前 5 个可见候选,避免无界遍历。 |
| 下单边界 | MVP 停在候选或订单确认页,不提交订单、不支付。 |
| 账号边界 | 验证版为单管理身份 + 设备身份;完整人员 RBAC 后置。 |
| 第一层任务输入 | 从本机私有蝦皮订单文件生成测试任务,不先建设 Go-Gin。 |
## 八、待确认与风险
## 九、待确认与风险
- Roubao 上游源码、许可证、可构建分支和 Android 版本支持仍需在 `T-001` 核实。
- Roubao 上游仓库、许可证和远端构建版本已核实;源码导入、分支选择和本机构建仍由
`T-001` 完成。
- 首份蝦皮样本格式已核实;正式私有目录、更多图片类型和一单多 SKU 规则仍需在
`T-004` 固定。
- 拼多多版本、页面结构、账号登录状态和测试设备尚未形成可复现基线。
- VLM 厂商、模型、成本上限、数据留存地区和图片隐私规则待确认。
- 拼多多平台条款、自动化允许范围和账号风控需要业务方确认;项目不实现绕过措施。