[ PROMPT_NODE_25592 ]
vercel-deploy
[ SKILL_DOCUMENTATION ]
# Vercel 部署
将任何项目即时部署到 Vercel。**除非用户明确要求生产环境,否则始终部署为预览版 (preview)**。
## 前置条件
- 当沙箱阻止部署网络调用时,使用 `sandbox_permissions=require_escalated` 重新运行。
- 部署可能需要几分钟。使用适当的超时值。
## 快速开始
**只需运行此命令(设置 10 分钟超时):**
bash
vercel deploy [path] -y
**重要:** 为 deploy 命令使用 10 分钟 (600000ms) 的超时时间,因为构建可能需要一些时间。
如果失败并提示“未找到现有凭据”,请使用下方的备选方法。
## 备选方法(无认证)
如果 CLI 因认证错误失败,请使用部署脚本:
bash
# 部署当前目录
bash scripts/deploy.sh
# 部署特定项目
bash scripts/deploy.sh /path/to/project
# 部署现有压缩包
bash scripts/deploy.sh /path/to/project.tgz
该脚本处理框架检测、打包和部署。它会等待构建完成并返回包含 `previewUrl` 和 `claimUrl` 的 JSON。
**告诉用户:** "您的部署已准备就绪,地址为 [previewUrl]。请在 [claimUrl] 处认领它以管理您的部署。"
## 生产环境部署
仅在用户明确要求时使用:
bash
vercel deploy [path] --prod -y
## 输出
向用户展示部署 URL。对于备选部署,同时展示认领 URL。
**不要**使用 curl 或 fetch 访问已部署的 URL 来验证其是否有效。只需返回链接。
## 故障排除
### 升级网络访问权限
如果部署因网络问题(超时、DNS 错误、连接重置)失败,请使用升级后的权限重新运行部署(使用 `sandbox_permissions=require_escalated`)。当沙箱网络阻止出站请求时,部署需要升级的网络访问权限。
给用户的示例指导:
部署需要升级的网络访问权限才能部署到 Vercel。我可以以升级后的权限重新运行该命令——需要我继续吗?