Session 与资源状态分开看
Session 有 open、pausing、paused、resuming、closing、closed 等状态。Sandbox 的运行 / 暂停状态和 Runtime 可达性另行记录。Provider managed standby 未必能从 API 精确观测,所以 open Session 不证明计算一直活跃,paused 也需要结合暂停 scope 和 Provider 返回判断。 图示为主要受管理路径;Provider 自动 standby 不必经过平台的每个显式暂停状态。过渡结果不明时状态可能保留待调查,不能为了图表完整而强行推到目标态。四种保留机制
内存暂停保留虚拟机或进程状态;磁盘恢复保留文件并重启 Runtime;快照重建保持 Session 身份但更换云资源;Provider managed standby 由供应商调度,平台在下一次任务时恢复可用执行。 应用应依赖受管理工作区和已验证的 Harness 对话恢复,避免依赖任意进程、socket 和临时目录。Fly Machines 有冷启动回退;Modal 可以更换资源 ID;Blaxel 的实际 standby 不可由其 API 明确确认。具体策略见当前 Provider 表。谁能进入空闲
只在 Runs 之间暂停。等待授权或审批仍是活动 Run,不能当作空闲回收。下一次 submit 由 worker 协调唤醒、Runtime 恢复与新 invocation,不要求应用先手工 resume。 正常唤醒不重放不确定的活动 invocation。快照、创建或恢复操作结果未知时仍需要对账;“自动恢复”不能掩盖重复外部写入风险。暂停 scope 决定你能推断什么
自动空闲检查选择
sandbox scope。它要求 Session 为 open、已有 Sandbox、具有暂停或自动 standby 能力,而且不存在非终态 Run。因而,刚创建但尚未分配资源的 Session 与等待审批的 Session 都不是“到计时器就暂停”的对象。并发提交和生命周期操作还需要协调;计时器到点不是完成承诺。
用四种策略理解下一轮
例如,第一轮保存项目文件并结束,空闲后第二轮仍向原 Session 提交。若使用快照重建,应用从 Session 获取当前资源绑定,不继续操作缓存的旧云资源 ID;若磁盘恢复导致预览进程消失,则文件保留不等于原预览仍能访问。需要的服务必须通过适用的恢复流程重新就绪。
三种时间不能合并
idle_timeout_seconds 决定空闲检查资格;实际采用值最多为资源 timeout_seconds 减十秒。资源运行期限负责限制活动资源寿命;Provider 的账户保留和计费规则是第三层。它们不是同一个倒计时。
当前控制平面的到期扫描排除 state: paused 且 pause_scope: sandbox 的 Session,唤醒时为对应控制平面管理资源记录新的运行期限。逻辑 Session 暂停不获得这个豁免。这个实现规则不覆盖 Provider 自身的保留限制,也不代表暂停资源永不收费或永久可恢复。
显式 close 与期限触发的关闭也不同:显式 close 遇到活动 Run 返回 session_busy;控制平面到期处理会撤销旧 worker lease,使活动 Run 进入取消流程,并在资源删除确认后完成终态。关闭正在等待授权的任务时,不能将一次被拒绝的 close 当作资源已清理。操作与错误见Session 参考。
能分别回答“Session 是否接受后续工作”“计算是否真的暂停”“Runtime 是否可达”“资源是否已确认删除”,才足以选择下一步动作。状态域的组合比一个统一的“在线 / 离线”标记更准确。
从持久活动记录理解空闲计时
空闲查询使用 Session 的updated_at 与最近 Run 的 updated_at 中较晚的时间,并同时要求没有非终态 Run、已有计算资源、具备支持的生命周期能力。关闭浏览器或暂时没有模型 token,都不能单独满足这些条件。
以 idle_timeout_seconds: 60、timeout_seconds: 600 的 Session 为例:Run 在 12:00:00 完成后,假设没有其他更新,相关持久活动时间超过 60 秒才具备暂停资格。worker 的五秒扫描间隔不是保证 12:01:00 暂停完成的承诺。它先处理到期再处理空闲,避免清理扫描重叠,还可能遇到未完成转换或 Provider 延迟。
如果 Run 到 12:01:00 仍为 waiting_authorization,它依然活动,不满足空闲暂停条件;等待期间资源期限仍可能到期。逻辑 scope: session 暂停也不会停止控制平面资源期限。界面应分别展示授权等待、空闲资格和到期,不将“浏览器不活跃”的计时器当作计算资源生命周期依据。
沿快照唤醒追踪资源身份
下表使用示意名称,不是可提交的 API 值或真实回执。
R2 已创建后,恢复响应仍可能丢失。查询为空或有歧义不能作为再次发起恢复的理由:操作保持未确认。保留 Session/operation 记录并调查,不更换身份重试。源资源与 checkpoint 也属于不同资源;关闭 Session 除了当前计算资源,还要处理保留的 checkpoint/镜像资源。
原生文件系统恢复可能保留资源身份、重建 Runtime 进程;内存暂停的实际保留取决于 Provider/Harness 契约;自动待机则可能在 Session 仍 open 时改变资源调度。这些路径都不能让结果未知的活动 Tool 副作用变得可以安全重复。
示例依据:空闲资格与生命周期清理、worker 扫描与恢复、checkpoint/restore 账本。选型与操作继续阅读 Sandbox 能力和容量、配额与成本。