Files
Agent-Workbench/docs/TASK-CHECKPOINTS.md
2026-10-30 20:59:18 +08:00

44 lines
4.7 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.
# 任务恢复检查点
2026-10-30。1.12任务恢复检查点的契约与使用范围如下;源码、不可变发行和正式部署分别见[1.12验收](QA-1.12.md)。
## 用户可执行的流程
任务暂停或失败后,在任务记录中保存恢复检查点。检查点包含全部用户目标/追加要求/约束/验收条件、工作区和源码版本、原工具调用/参数/结果工件引用、原依赖计划/证明、待审查改动、未知结果以及最后已封存模型请求。内容保存为SHA256工件,并由SQLite记录绑定消费会话、Task和Run。
核对恢复条件时,工作台重新校验原恢复包、引用工件的真实字节、当前源码、Git HEAD/分支、工作区身份、任务要求和原工具/计划/提案状态。满足条件后,用户可以显式继续同一Task,创建resumeOf指向原Run的新运行。原文件、会话历史和工具状态不会被恢复包覆盖;已执行工具没有自动重放。
这是同一任务的受控续接和状态封存。它没有把项目复制成完整备份,也不支持把一个已完成或已经推进的任务回退到任意旧执行位置;原项目目录和原结果工件仍须存在。
## 拒绝和恢复边界
- 源码变化、扫描不完整、目标或追加要求变化、Git/工作区身份变化:保留原包,显示变化原因,不从旧位置继续。
- 后续已经产生新Run或新Task:旧检查点保持为历史,不再次续接原位置。
- 结果未知的工具调用:要求先核对实际副作用,不能转成已完成。
- 待审查文件提案、Git预览、未解决变更集或工作区创建/恢复:先完成现有审查或核对。
- 原恢复包、工具参数、结果工件或计划证明损坏/篡改:拒绝使用,不补造缺少的原记录。
- 缺少模型凭据:检查点仍可保存、读取和核对;实际续接能否调用服务由连接层独立判断。检查点不保存或重新填入任何模型Key。
恢复前端的确认带原包SHA256,服务端会再次执行核对;界面显示可恢复不代替续接时的检查。控制台更新只接受当前会话/Task/Run的响应,旧项目迟到响应不会更改当前检查点界面。
## 完整性、预算与生命周期
核验是项目活动的一部分,复用TaskPlanManager的活动门控;运行、检查、Git、变更集、工作区等活动期间不能保存或核对竞争状态。宿主关闭/升级会等待已有核验完成。热升级成功会重建记忆/检查点管理器;安装失败恢复原管理器与原Provider对象。
原结果使用稳定ID、实际参数SHA256及结果工件SHA256;检查点仅保存引用,避免重复复制整段长日志。每Task最多30个检查点、2000项工具引用,原工具结果累计最多64MB;来源扫描沿用有界工程清单,包体仍受8MB单工件上限约束。超出边界明确拒绝,原任务和证据不删除。
用户要求通过Provider已知凭据脱敏后存入恢复工件,原要求SHA256用于确认任务未变化。保存不发送模型请求。进程在记录提交前退出,仅可能留下未登记的内容地址工件,不能呈现为已保存检查点;提交后退出则由SQLite重新加载原记录,不自动执行模型或工具。
## API和验证
- GET /api/sessions/:sessionId/task-checkpoints:列出当前Task的原检查点。
- POST /api/sessions/:sessionId/task-checkpoints:要求匹配当前taskId/runId,保存稳定检查点。
- GET /api/sessions/:sessionId/task-checkpoints/:id:复核原证据和当前条件;只读核对不请求模型。
- POST /api/sessions/:sessionId/task-checkpoints/:id/resume:要求匹配sha256,重新核对后显式续接原Task。
12项专项通过,覆盖同Task续接/无重放、全部要求、来源变化、未知效果、待审查提案、工件/证明损坏、Git身份、归属/并发、SQLite重开、预算以及真实子进程在提交前/后退出。桌面/390px三组界面通过,证据.qa/task-checkpoint-ui-19c55755-cdf3-4f97-9802-421fd2460096;模型请求均为自有本地HTTP夹具。
最终完整源码/构建回归334/334通过,0失败/取消/跳过;204份输入前后散列一致,固定Node24.22.1/Python3.10.11/pytest8.4.2。原TAP、输入与核验器保存在.qa/task-checkpoint-regression-40d8ec07-c24d-4439-a169-cf03bfd63a56,TAP SHA256为e4a07d969c5f256cf1035730b9bc0763da98e93728972de16dac6649f4669ed9,摘要见[完整回归](task-checkpoint-regression.json)及[界面验证](task-checkpoint-ui-validation.json)。没有覆盖旧1.11发行证据,真实模型请求0,正式4318未重启或升级。
真实模型长任务成功率和新的源码/便携发行另行验收。检查点核验表示原状态完整、当前条件相容,不能代替业务完成判断。