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
+24 -2
View File
@@ -67,6 +67,7 @@ internal/platform/ # 配置、日志、文件存储和 VLM 适配器
```text
ui/ # 登录、任务列表、执行状态、设置
taskclient/ # 后端 API、认证、幂等和重试
tasksource/ # 统一任务源;本地探针与后端 API 实现
workflow/ # ProcurementWorkflow 状态机
automation/ # Accessibility 节点、截图、点击、输入、滑动
ai/ # 结构化 AI 请求/响应,不含供应商业务类型
@@ -108,7 +109,10 @@ evidence/ # 截图、步骤日志、脱敏和上传
### 3.1 技术探针
```text
App 内固定任务
本机私有蝦皮订单目录
-> Debug 导入工具按订单号配对文本和参考图
-> 规范化为 ProbeTask
-> Android FixtureTaskSource
-> 校验设备就绪
-> 解析为固定/模型搜索词
-> 打开拼多多并搜索
@@ -119,6 +123,24 @@ App 内固定任务
该阶段不依赖后台,用于尽早判断 Android 自动化是否可行。
`TaskSource` 是工作流读取任务的唯一边界:
- 第一层使用 `FixtureTaskSource`,消费 Debug 导入工具生成的本地私有样本。
- 第二层替换为 `HttpTaskSource`,通过 Go-Gin 的 `claim-next` 和资产接口读取任务。
- 两种实现必须产生相同的领域字段;workflow、AI 和 automation 不得判断任务来自
文件还是 HTTP。
Debug 导入工具运行在开发机上,Android App 不能假定能直接访问 Windows 绝对路径。
工具读取用户显式配置的目录,将数据写入被 Git 忽略的 `.local/` 生成目录,再由
Debug 构建或测试装载。导入必须:
- 用文件主名关联订单号,不能用文本模糊匹配图片。
- 首版严格解析 UTF-8 四行标签 `店铺名:`、`商品标题:`、`SKU:`、`数量:`。
- 校验店铺名、标题、SKU、正整数数量和唯一且可解码的 JPEG 参考图。
- 对缺失、重复、编码无法识别和字段格式未知返回结构化错误。
- 不把完整订单号、店铺名、原图路径写入普通日志。
- 仅在用户明确配置 VLM 后发送必要的标题、SKU 和参考图;不发送订单号或店铺名。
### 3.2 MVP 业务闭环
```text
@@ -294,7 +316,7 @@ IDLE
## 九、开发顺序
1. 接入 Android 基线并记录真实构建方式。
2. 固定任务 + 固定搜索词跑通拼多多页面探针。
2. 导入一条脱敏蝦皮样本,以固定搜索词跑通拼多多页面探针。
3. 接入需求提取和候选判断,验证结构化输出。
4. 建立后端数据模型、API 和简单管理 Web。
5. 接入 App 领取、租约、进度和结果。