SuperAPI AI 工具集

ship-prod

部署与运维

查看项目

更新于 10-16 03:47

技能介绍

用途:将 qaskills.sh 部署到正确的 Vercel 生产项目,并证明部署真正落到线上。git push 到 main 不保证自动部署,此技能是明确的部署路径。

固定信息:项目 qaskills.sh,项目 ID prj_rDKli4AyhHoXZXV8NHrs92Ncbf4f,组织 team_DGM6VSs6vhASlhktmHkSqPwn,账号 luckydutta96。存在一个同名但不含域名的诱饵项目 qaskills,不要部署到那里,也不要接受交互式的默认链接选项。构建命令位于根目录 vercel.json,Node 通过 packages/web/package.json 的 engines 固定为 24.x。注意 vercel --prod 上传的是工作树而非 git HEAD;.vercel/project.json 被 gitignore,新工作树未链接时需显式指定环境变量。

使用方式:先做预检,执行 vercel whoami 确认账号为 luckydutta96,用 git status --short 判断是否为干净工作树,用 git log 查看 HEAD,并运行 pnpm --filter @qaskills/shared build 与 pnpm --filter @qaskills/web build 确保构建通过。干净树可直接 npx vercel --prod --yes;脏树(默认情况)用 git worktree 检出 HEAD 到临时目录,带 VERCEL_ORG_ID 与 VERCEL_PROJECT_ID 环境变量执行 npx vercel --prod --yes,完成后移除工作树。记录 CLI 输出的部署 URL。

验证:每次部署都必须执行 npx vercel ls 确认最新部署为 Ready、Production,用 curl 检查 https://qaskills.sh 返回 200,并对具体改动页面做检查(如新文章返回 200,或 grep 预期标记)。三条全部通过才能说已部署;若域名仍为旧内容而新部署已就绪,用 npx vercel promote 移动别名。

回滚:用 npx vercel ls 找到上一个就绪的生产部署,再 vercel promote 指回。代码级回滚则在 main 上 git revert 后重跑本技能。

限制与常见故障:未授权或作用域错误说明登录了其他账号;本地构建通过但 Vercel 失败通常是导入期依赖环境的代码,需延迟初始化;部署就绪但站点未变可能是别名未移动或发布了过时 HEAD。不要把脏工作树直接部署到生产,不要用默认选项回应交互提示,未经用户同意不要修改 Vercel 项目设置(Node 版本、环境变量、域名)。