SuperAPI AI 工具集

vercel-sandbox

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:调查 Vercel Sandbox 的生命周期、超时、快照与持久化行为,回答关于 @vercel/sandbox 的 SDK/API 语义、产品用法与疑似持久化缺陷的问题。

主要能力:按请求类型选择参考文件(api-surface.md 处理 SDK/API 与生命周期、快照、稳定版与 beta 持久化;common-use-cases.md 处理产品级用法与架构选择;troubleshooting-workarounds.md 处理异常行为与文档缺失)。先检查已安装 @vercel/sandbox 版本与本地类型,再判断属于稳定 1.x 临时沙箱还是持久化 beta 模型,并对时效性结论标注日期。

核心判断:区分 Vercel 函数/运行时超时、嵌入系统的应用/请求超时、沙箱超时三种时钟;稳定 1.x 中 Sandbox.get({ sandboxId }) 仅在沙箱存活时有效,沙箱停止后文件系统即消失,不属于可恢复持久化;sandbox.snapshot() 不是工作区持久化,它创建新快照产物并停止源沙箱;快照用于创建新起点,持久化 beta 用于跨会话保留命名工作区状态。

使用方式:先查已安装 SDK 类型与官方稳定文档,仅在涉及命名持久化时看 beta 变更日志;确认问题属于活跃沙箱复用、已停止沙箱恢复、快照热启动还是持久命名工作区。仅当任务与具体应用相关时,才检查消费方代码,例如 Junior 仓库中的超时预算、沙箱身份持久化与复用、超时路径是否真正恢复、元数据是否只在成功路径写入等文件。

修复建议:沙箱仍存活但下一轮新建时,提前持久化沙箱身份并从活跃沙箱恢复;沙箱确已停止时,增大或延长超时,或将中间产物外置;文档漂移时以已安装 SDK 为准;需要跨停止/超时边界的真正持久性时,使用外部存储或确认 API 可用后迁移到持久化 beta。

限制:不得仅凭变更日志推断持久化 beta 行为,须确认已安装 SDK 与本地调用点;资料未提供具体版本号、价格与平台细节。