用途:将项目部署到 Vercel,通常由 vibe-coding-ship 在目标平台为 Vercel 时调用。
主要能力:检测 Git 远程、关联项目、选择团队、支持交互式与令牌两种认证方式、区分预览与生产部署、管理环境变量、查看部署与日志,并给出常见错误排查建议。
使用方式:交互模式下先运行 vercel --version 检查 CLI,缺失时执行 npm install -g vercel;用 vercel whoami 检查登录,未登录执行 vercel login;通过 cat .vercel/project.json 判断是否已关联,未关联则运行 vercel link;用 git remote -v 检查远程。部署预览用 vercel deploy,生产用 vercel deploy --prod,生产部署前需用户确认。令牌模式(CI/自动化)使用 vercel deploy --token=$VERCEL_TOKEN,生产加 --prod,指定团队加 --scope=$VERCEL_TEAM_ID。环境变量可用 vercel env ls、vercel env add DATABASE_URL production、vercel env pull .env.local 管理,且不要提交 .env.local。
适用场景:前端或 Node 项目部署到 Vercel;CI 自动化部署;需要预览与生产分离的发布流程。
限制:Vercel 不支持持久 Python 服务器(无长运行进程、无后台 worker),完整 Flask/Django/FastAPI 应用需迁移为 serverless 函数或改用 Railway/Render/Fly.io、DigitalOcean App Platform。Python 仅支持 serverless,需在项目根目录提供 requirements.txt。函数超时可通过 vercel.json 的 maxDuration 调整。生产部署必须确认。
其他:部署成功或失败会输出对应状态并写入 progress.txt。