用途:将任意项目快速部署到 Vercel。默认始终以预览(preview)方式部署,只有用户明确要求时才进行生产部署。
主要能力:支持通过 Vercel CLI 直接部署,也提供无认证的备用部署脚本,可自动检测框架、打包并部署,等待构建完成后返回包含 previewUrl 和 claimUrl 的 JSON。
使用方式:快速开始可运行 vercel deploy [path] -y,并为部署命令设置 10 分钟(600000ms)超时,因为构建可能耗时较久。若出现“No existing credentials found”认证错误,改用备用脚本 ./scripts/deploy.sh [path]。生产部署仅在用户明确要求时使用 vercel deploy [path] --prod -y。部署完成后向用户展示部署 URL;备用部署还需展示 claim URL,并提示“Your deployment is ready at [previewUrl]. Claim it at [claimUrl] to manage your deployment.”。不要用 curl 或抓取部署 URL 来验证其是否可用,直接返回链接即可。
限制与故障处理:当沙箱阻止部署网络调用时,需以 sandbox_permissions=require_escalated 重新运行。若因网络问题(超时、DNS 错误、连接重置)失败,也需以提升权限重跑部署。部署可能需要数分钟,应使用合适的超时值。