# 任务恢复检查点 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未重启或升级。 真实模型长任务成功率和新的源码/便携发行另行验收。检查点核验表示原状态完整、当前条件相容,不能代替业务完成判断。