保存、停止与恢复
任务结束后,在 Dashboard 选择“保存恢复点”或“保存并停止”,也可让 Agent 调用
workspace_checkpoint。请求返回 operationId 后需要等待终态。
只有恢复点持久引用提交后,服务才会停止实例。
纯状态查询和下载不会延长实例空闲时间。预览环境可使用较短的空闲停止间隔, 实际值取决于用户设置和管理员策略。
在新会话中继续
Section titled “在新会话中继续”保留 workspaceId,在新的 Agent 会话中调用 workspace_resume,等待 READY。
工作区 ID 不变,新实例 generation 递增;旧实例的迟到结果不能覆盖新实例状态。
恢复失败不会静默创建空目录。RECOVERY_REQUIRED 或 UNKNOWN 状态需要先检查原任务 与最后成功恢复点,再决定恢复或删除。
当前部署默认 workspace-archive:恢复普通工作文件,使用固定镜像重建环境。
它不保留 .git 目录、文件可执行位、进程、内存、终端会话或完整系统缓存。
单文件20 MiB、全部普通工作文件200 MiB及2000文件限额适用于导入、保存、恢复和导出。
脚本可通过解释器运行;需要 Git 元数据时重新检出仓库并合入工作文件。
filesystem-native 是平台文件系统快照能力,当前预览环境未完成真实平台验收。
以工作区返回的 capability 为准。
已验证保存停止后由新 opencode 会话恢复文件,并继续执行成功。开发验收等待 30 秒, 不等于真实两小时停止恢复已经通过。长期停止、平台原生快照和完整保留清理仍属于后续验收。