sandbox-sdk

用途：在 Cloudflare Workers 上构建安全、隔离的代码执行环境，用于 AI 代码执行、代码解释器、CI/CD 系统与交互式开发环境。\n\n安装与前置：执行 npm install @cloudflare/sandbox；本地开发需 Docker，可用 docker info 验证。知识可能过时，建议优先查阅官方文档、API 参考与 examples 仓库。\n\n配置：wrangler.jsonc 需声明 containers、durable_objects 与 migrations；Worker 入口必须重新导出 Sandbox 类：export { Sandbox } from '@cloudflare/sandbox'; 否则无法部署。使用 getSandbox(env.Sandbox, 'user-123') 获取实例。\n\n主要能力：exec() 执行命令并返回 stdout、stderr、exitCode、success；runCode() 执行 LLM 生成代码，支持 python、javascript、typescript，可用 createCodeContext 保持上下文状态；文件操作包括 writeFile、readFile、mkdir、listFiles；exposePort 暴露 HTTP 服务端口并返回预览 URL；destroy() 释放资源。\n\n适用场景：Shell 脚本与构建测试流水线用 exec()，数据分析与 LLM 代码用 runCode()。Dockerfile 基础镜像为 docker.io/cloudflare/sandbox:0.7.0，含 Python 3.11、Node.js 20，可自行扩展依赖，需 EXPOSE 8080。\n\n限制与注意：首次操作时容器惰性启动，空闲 10 分钟后休眠（可用 sleepAfter 调整）；预览 URL 生产环境需自定义域名与通配符 DNS，.workers.dev 不支持子域名；不要使用内部客户端，避免硬编码多用户沙箱 ID，临时沙箱需调用 destroy() 清理。OpenAI Agents SDK 集成位于 @cloudflare/sandbox/openai。