Open Agents沙箱概念图解什么是云端代码执行环境【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agentsOpen Agents 沙箱Sandbox是云端代码执行环境的核心抽象它为一台临时云虚拟机提供了文件系统、Shell、Git 和开发服务器能力让 AI 编码智能体在不占用你笔记本电脑的情况下把提示词变成真实的代码改动。本文将用图解方式拆解它的架构设计、生命周期与快照恢复机制帮助新手快速理解沙箱这个概念。️ 什么是沙箱AI 编码智能体的云端电脑先抛开术语当你让 AI帮我修这个 bug 并跑一下测试时AI 需要一个地方去执行代码——读文件、改文件、装依赖、跑命令。这个地方就是沙箱。在 Open Agents 中沙箱被抽象为 packages/sandbox/ 包中的一个统一接口Sandbox interface它定义了智能体可以操作的一台电脑能力说明对应方法 文件系统读、写、列目录、判断文件类型readFile/writeFile/readdir⌨️ Shell 命令执行命令并拿回 stdout/stderr/退出码exec/execDetached Git 操作克隆仓库、切分支、提交推送配合currentBranch等字段 端口预览暴露 3000/5173/4321/8000 端口的开发服务器domain(port) 快照对文件系统打快照供暂停后恢复snapshot()当前实现基于 Vercel Sandboxvercel/sandbox.ts工作目录默认是/vercel/sandbox。 关键架构决策Agent 不在沙箱里这是整个项目最值得理解的一点智能体Agent不运行在虚拟机内部而是运行在沙箱之外通过工具远程操作沙箱Web 界面 → Agent 工作流持久化运行 → 沙箱 VM纯执行环境这一分离带来了几个好处见 README 与 架构文档✅智能体执行不受单次请求生命周期限制——长任务可以跨多个持久化工作流步骤继续✅沙箱可以独立休眠/恢复互不牵制✅模型、供应商和沙箱实现可以各自独立演进✅ VM 保持纯执行环境不会变成控制平面Agent 侧的工具集bash、read、write、grep、glob、task 等位于 packages/agent/tools/正是它伸进沙箱的手。⏱️ 沙箱生命周期图解从创建到休眠沙箱不是开完就放着的它有一套完整的状态机完整图解见 SANDBOX-LIFECYCLE.md┌──────────────┐ 创建完成 ┌──────────────┐ │ provisioning │ ────────────▶ │ active │◀─── 用户发消息 └──────────────┘ └──────┬─────────┘ 刷新活跃时间 │ 30分钟无活动 ▼ ┌──────────────┐ 快照停止 ┌────────────┐ │ hibernating │ ───────────▶ │ hibernated │ │ snapshot() │ │ 已暂停 │ └──────────────┘ └─────┬──────┘ │ 点击 Resume └──▶ active两个关键时间参数配置在 lib/sandbox/config.ts参数数值作用非活动休眠窗口30 分钟超过即触发快照停止硬性过期时间标准 5 小时 / Hobby 40 分钟Vercel 虚拟机的硬上限休眠 ≠ 删除。休眠时系统先对文件系统做快照再停止虚拟机。当你下次回来点 Resume工作区会从快照恢复——你几乎感觉不到中间有过关机。几个刷新活跃时间的时机值得注意聊天开始/结束、创建/延长/恢复沙箱甚至你聚焦输入框打字时节流为每 5 分钟一次都会重置休眠倒计时——这样正在构思消息不会意外触发休眠。 快照恢复为什么你的工作不会丢快照snapshot是沙箱的核心持久化机制定义在 Sandbox 接口 中休眠时snapshot()生成一个原生快照 ID保存到数据库恢复时通过 PUT /api/sandbox/snapshot 用快照 ID 作为基础镜像启动新沙箱可选基础快照通过环境变量VERCEL_SANDBOX_BASE_SNAPSHOT_ID新沙箱可以从预配置好的基础镜像启动省去安装依赖的时间此外项目还规划了基于Git Diff 的工作区持久化方案sandbox-state-persistence-plan.md在沙箱停止前用beforeStop钩子捕获git diff与未跟踪文件确保即使重建沙箱也能无缝还原你的改动。 隔离与安全沙箱如何防止越权沙箱不是裸奔的虚拟机有几层防护网络策略Network Policy沙箱启动时默认禁止访问外部网络只有明确声明的域名如 GitHub 相关 API才被放行见 vercel/sandbox.ts 中的策略构建凭据中介Credential BrokeringGitHub Token 只在克隆仓库、推送代码的瞬间通过请求头注入操作完成后立即清除Token 从不落盘到沙箱文件系统中生命周期钩子beforeStop停止前提交未保存的改动、onTimeout区分超时停止与手动停止等钩子SandboxHooks让状态变更有章法 如何快速上手阅读沙箱源码如果你想进一步探索建议按这个顺序读packages/sandbox/interface.ts —— 沙箱的完整能力契约30 分钟读懂沙箱能做什么packages/sandbox/factory.ts —— 工厂函数connectSandbox看沙箱如何被创建与连接apps/web/SANDBOX-LIFECYCLE.md —— 生命周期完整文档含状态机图与安全网设计apps/web/lib/sandbox/lifecycle.ts —— 休眠评估的核心逻辑想本地运行整个项目只需安装依赖后执行开发命令完整部署步骤Vercel 环境、GitHub App 配置在 README.md 中有详细说明。总结Open Agents 沙箱的本质是把AI 写代码中的执行环节隔离在一台按需启停、自动休眠、快照可恢复的云端虚拟机里。你只管在网页上提需求沙箱在云端默默执行、暂停、恢复——这正是云端代码执行环境区别于本地插件式 AI 的核心价值。【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
