SuperAPI AI 工具集

vercel-cli

通用与其它

查看项目

更新于 10-16 05:55

技能介绍

该技能用于通过 Vercel CLI 部署与管理 Vercel 项目,适合部署应用、管理环境变量、配置域名或推送密钥时使用。

使用前提:bun add -g vercel,然后 vercel login 登录。

主要能力与用法:

  • 项目关联:在 Turborepo 中可用 vercel link --repo 一次关联所有应用,或进入 apps/web 执行 vercel link --project support-web;首次创建可用 vercel --yes。
  • 部署:vercel 生成预览部署,vercel --prod 生产部署;也支持 vercel --cwd apps/web、--no-wait、--force、--logs。
  • 环境变量:vercel env ls 列出,vercel env add 添加,vercel env pull 拉取到本地,vercel env run 直接带环境变量运行命令,vercel env rm 删除。注意没有更新命令,需先删除再添加。资料特别强调:绝不要用 heredoc 或普通 echo 管道传值,因为会加入尾随换行并静默破坏密钥;应使用 echo -n 'secret' | vercel env add MY_VAR production。
  • 项目与域名:vercel project ls/inspect/rm 管理项目,vercel domains ls/add 管理域名,vercel alias 将部署指向自定义域名。
  • 日志与 CI/CD:vercel logs <deployment-url> 查看日志,支持 --follow;CI 中可用 VERCEL_TOKEN 或 --token,如 vercel --token $VERCEL_TOKEN --prod。
  • Monorepo:每个应用可有自己的 vercel.json,根目录可配置 ignoreCommand,如 npx turbo-ignore。
  • 作用域:可用 vercel --scope skillrecordings 或 vercel switch skillrecordings 指定组织。
  • 排查:rm -rf .vercel 后 vercel link 清除本地缓存,vercel --force --logs 重新部署。

限制:域名 webhook 地址不支持通配符,需使用精确的 Vercel 应用域名;环境变量不存在直接更新命令。其他细节资料暂未提供。