feat(tasks): persist encrypted result handoff and recover received tasks
Add signed device-scoped task state/result endpoints and AES-GCM result outbox. Atomically claim original-message replies, reject cross-user/stale/expired tasks, preserve unknown platform receipts without blind replay, and retain ambiguous ciphertext for at most seven days. Maintain legacy synchronous compatibility and clarify stale deployment-plan diagnostics. Validation: ECS suite 227 passed/2 skipped, later outbox guards 12 passed, deployment diagnostics 54 passed. Real ECS/PostgreSQL/platform failure acceptance remains pending.
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
# 任务恢复与结果交接:第一阶段
|
||||
|
||||
已实现:客户端对已收到的任务保存当前用户 DPAPI 加密记录,内容包括精确任务身份、请求摘要、原生 run_id 和未交接结果。重连后先校验当前应用/环境/本人/设备/绑定代次,再用签名 /work/v2/tasks/state 核对服务器任务是否仍有效。已知 run_id 只 GET,不重新执行;未知受理回执不自动重发。任务必须尚在原绝对期限内。
|
||||
|
||||
客户端将结果签名上传 /work/v2/tasks/result;ECS 按原任务归属和结果摘要幂等接收,使用现有服务器 keyring 对结果作 AES-GCM 加密,AAD 包含环境、应用、本人、设备、绑定代次、任务及摘要。客户端只有收到相同摘要的持久化回执后才清理本地结果。
|
||||
|
||||
后台 outbox 先原子领取 ready 状态,再回复原 source_message_id。完成后清除密文;发送中断/回执不明标为 unknown,不自动重发。发送前 Token 预检失败可继续重试,但进入 sending 后不作盲目重试。unknown 密文最多保留7天用于受控排障,之后清除。worker 死亡检测带60秒宽限,存活 worker 的发送不被其他 worker 抢占。解绑/撤销会使旧任务失效,未发结果丢弃。
|
||||
|
||||
兼容性:只有带原消息ID的机器人任务声明 durable-http-v1,旧客户端仍用现有 WebSocket 回包;管理员同步指令维持原返回语义。需要新 ECS 与新客户端配套。schema 为新增表,不重建数据库,不轮换 keyring。
|
||||
|
||||
范围与限制:本阶段恢复的是客户端已经持久化接收的任务及已知原生 run;ECS 在下发前死亡、客户端尚未保存的任务不自动重放;原生受理请求已发送但没有拿到run_id的任务保持unknown,需人工核对。任务不能跨过期、解绑或绑定代次变化恢复。飞书是否已收消息而回执丢失仍需平台幂等能力验证,本阶段不声称端到端 exactly-once。下一阶段再做完整下发队列、会话调度与用户可见任务查询。
|
||||
|
||||
## 现场更新(开发测试通过后再执行)
|
||||
|
||||
当前已运行父计划是 /home/cnooc/hainuo-broker-update-20261104-async。待安装包就绪后,先拉最新代码,再用 prepare-update 从这个父计划生成新的独立目录,例如 /home/cnooc/hainuo-broker-update-20261105-recovery。然后对新目录逐条 build、activate、state。不要复用旧的 prepared 迁移父计划,不重新生成密钥,不重做原迁移 prepare。切换后再安装配套1.078客户端。
|
||||
|
||||
## 必须现场验证
|
||||
|
||||
1. 只读测试任务执行中断网再恢复,原生任务不得再执行一遍,最终回复原消息。
|
||||
2. 任务已拿到run_id后退出/重启桥接,原生进程仍运行时能继续查询;原生也重启时如实报告interrupted而非重跑。
|
||||
3. 执行中重启ECS,原绑定和授权不变,客户端恢复上传结果,原消息只回复一次。
|
||||
4. 执行中解绑再绑定,旧任务不得推送;第二账号不能读取或提交第一账号任务。
|
||||
5. 故障注入结果上传回执丢失/平台发送回执丢失,分别验证重复交接幂等和unknown不重发。
|
||||
|
||||
开发机使用临时SQLite/FakeRedis、loopback WebSocket/HTTP、合成身份与结果,不代表真实PostgreSQL/Docker/私有化飞书现场验收。测试不读取真实Token,也不调用真实模型业务。
|
||||
Reference in New Issue
Block a user