docs: finalize task acceptance and assumption audit records
Quality gate / backend (push) Canceled after 0s
Quality gate / frontend (push) Canceled after 0s

This commit is contained in:
Xin Wang
2026-10-23 19:57:21 +08:00
parent 89c3bad58e
commit b9c9d141b9
4 changed files with 26 additions and 6 deletions
+3 -1
View File
@@ -21,7 +21,7 @@ description: 使用 Pipecat 原生 Jobs 委派远程 OpenCode 任务。
## 运行与恢复
- NativeTaskRuntime 只组装 `WorkerRunner`、常驻 CoordinatorWorker 和 RemoteAgentWorker。派发、超时、取消和 FIFO 串行执行由 Pipecat 原生 Job 系统负责。
- 等待时限覆盖每次本地 Job(含排队),重启或重新观察后重新计时,不代表累计任务寿命上限;超时触发远端停止核查。原生 Job 全局 FIFO 串行;若另有未结束的远端句柄,新的编码任务不会提交,需先核查或停止旧任务。无法约束平台之外的 OpenCode 客户端。
- 等待时限覆盖每次本地 Job(含排队),重启或重新观察后重新计时,不代表累计任务寿命上限;超时触发远端停止核查。原生 Job 全局 FIFO 串行;若另有未结束的远端句柄,新的编码任务不会提交,需先核查或停止旧任务。被阻挡的新任务会标为失败并说明尚未向远端提交;解决旧任务后需重新提交,不会自动恢复。无法约束平台之外的 OpenCode 客户端。
- 提交回执表示平台接受任务。OpenCode 的 204 只表示远端接收;必须取得关联到本次 messageID 的完成消息才能显示成功。
- OpenCodeAdapter 负责创建远端 session、订阅 SSE、异步提交、结果查询和 abort。每个任务使用独立远端 session,内部步骤仍由 OpenCode 完成。
- 原生 Job 取消不代表远端已停止。适配器调用 abort 并查询远端状态;未确认时保留「停止待确认」。
@@ -48,3 +48,5 @@ description: 使用 Pipecat 原生 Jobs 委派远程 OpenCode 任务。
## 验证边界
测试覆盖真实 Pipecat Jobs 的派发/进度/断线独立/取消,以及显式模拟的 OpenCode HTTP/SSE 协议。不把模拟执行结果当作真实代码修改结果。本次在与项目一致的临时 pgvector/PostgreSQL 17 容器中完成了全量 Alembic 迁移、真实任务 API + 原生 Job + 数据库存储验收,覆盖重复请求不重复提交、事件序号与服务重启后的查询;远端仍由 MockTransport 显式模拟。现有开发库未修改,部署时仍需执行迁移,真实 OpenCode 联调待配置服务后进行。
协议配置可参考 [OpenCode Server 官方文档](https://opencode.ai/docs/server/)。