docs: define Shopee probe fixture input
This commit is contained in:
+24
-2
@@ -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 领取、租约、进度和结果。
|
||||
|
||||
Reference in New Issue
Block a user