跳转到内容

保存、停止与恢复

任务结束后,在 Dashboard 选择“保存恢复点”或“保存并停止”,也可让 Agent 调用 workspace_checkpoint。请求返回 operationId 后需要等待终态。 只有恢复点持久引用提交后,服务才会停止实例。

纯状态查询和下载不会延长实例空闲时间。预览环境可使用较短的空闲停止间隔, 实际值取决于用户设置和管理员策略。

保留 workspaceId,在新的 Agent 会话中调用 workspace_resume,等待 READY。 工作区 ID 不变,新实例 generation 递增;旧实例的迟到结果不能覆盖新实例状态。

恢复失败不会静默创建空目录。RECOVERY_REQUIRED 或 UNKNOWN 状态需要先检查原任务 与最后成功恢复点,再决定恢复或删除。

当前部署默认 workspace-archive:恢复普通工作文件,使用固定镜像重建环境。 它不保留 .git 目录、文件可执行位、进程、内存、终端会话或完整系统缓存。 单文件20 MiB、全部普通工作文件200 MiB及2000文件限额适用于导入、保存、恢复和导出。 脚本可通过解释器运行;需要 Git 元数据时重新检出仓库并合入工作文件。

filesystem-native 是平台文件系统快照能力,当前预览环境未完成真实平台验收。 以工作区返回的 capability 为准。

已验证保存停止后由新 opencode 会话恢复文件,并继续执行成功。开发验收等待 30 秒, 不等于真实两小时停止恢复已经通过。长期停止、平台原生快照和完整保留清理仍属于后续验收。