返回目录 / 集成
Sandbox稳定版迁到@next：先审计协议不兼容再切换
围绕package/image配对、API迁移、验证与生产立即切换组织迁移。
Skills
先读官方migrate与1.0 preview文档、安装的@next类型，盘点stable APIs。Worker package与container image须同一@next线；把`await sandbox.exec(argv)`视为启动并返回handle，等待output另行处理；argv不隐式shell，handle无stdin，wait timeout/AbortSignal不会杀进程。替换sessions/transport/terminal/interpreter接口后跑类型检查与长进程、terminal测试。部署前要求用户批准，因为stable/@next双向协议不兼容且生产只允许immediate rollout，可能终止存量进程；迁移期间不要发布混线版本。
权限边界
前置条件
- 将现有stable `@cloudflare/sandbox`应用移植到SDK 1.0预览`@next`。
权限边界
- 会改package、容器镜像和进程/terminal/interpreter调用；生产切换会中断运行中工作。
限制
Worker包和镜像必须同为@next；立即rollout且需用户明确同意，稳定bridge留在stable。
固定上游来源
- 仓库
- cloudflare/skills
- 文件路径
- skills/sandbox-migrate-to-next/SKILL.md
- 固定提交
53395984c3ea1925d00fce03b266112302f050e6- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体，不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: Apache-2.0
适用工具
@cloudflare/sandbox stable and @next · Sandbox migrate docs · Wrangler container rollout