docs(t216): freeze device command delivery contract

This commit is contained in:
QiuSW
2026-07-28 12:53:45 +08:00
parent 827afc7257
commit 75fdc63db2
8 changed files with 200 additions and 6 deletions
+3 -2
View File
@@ -45,7 +45,8 @@ Android 导航名称是逻辑目的地,具体 Compose/Fragment 形式待接入
| `POST /api/v1/tasks/{id}/cancel-ack` | 安全停止后确认 `CANCELED` 并结束 execution |
| `POST /api/v1/tasks/{id}/events` | 幂等补报本地执行事件 |
| `POST /api/v1/tasks/{id}/candidates` | 保存最多 5 个候选、模型判断和本地推荐 |
| `POST /api/v1/tasks/{id}/commands/next` | T-216 起领取 Admin 已创建的设备命令 |
| `POST /api/v1/tasks/{id}/commands/next` | 拉取或重放 Admin 已创建的同一条下单命令 |
| `POST /api/v1/tasks/{id}/commands/{command_id}/ack` | App 加密落盘后幂等确认命令 |
| `POST /api/v1/tasks/{id}/complete` | 提交人工结果,强制 `order_submitted=false` |
| `POST /api/v1/tasks/{id}/fail` | 提交结构化失败和受控证据 |
@@ -59,7 +60,7 @@ T-207 的 events/candidates/complete/fail 接受原设备对授权内已产生
## 导航规则
- App 有活跃任务时启动后优先恢复该任务,不允许直接领取下一条。
- `CLAIMED` 进入预览;`RUNNING` 进入执行;`WAITING_CONFIRMATION` 进入候选确认;
- `CLAIMED` 进入预览;`RUNNING` 进入执行;`WAITING_CONFIRMATION` 进入等待 Admin;
终态进入结果。
- 从执行页切换拼多多后,使用前台服务通知返回执行页。
- 候选确认页返回不能恢复自动化。