Files
ecs-relay-service/deployable/TASK_RECOVERY_PHASE1.md
ex_tianzy e4c3a8ad4e 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.
2026-11-05 10:24:55 +08:00

26 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 任务恢复与结果交接:第一阶段
已实现:客户端对已收到的任务保存当前用户 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,也不调用真实模型业务。