怎么执行这份 Runbook
先检查前置条件，再按命令块执行。任何命令都要根据客户环境替换域名、路径、服务名和数据库名，不要复制示例里的占位值直接跑。
部署完成后必须做验证；验证不过就按回滚路径退回，并在交接记录里写清原因。
Runbook
Vercel + GitHub 部署 Runbook
用于部署 Next.js 主站、在线工具、内容页和静态公开页面。
执行命令
命令是模板，不含真实密钥。执行前必须替换项目名、路径、域名、服务名和数据库名。
本地验证
npm run lint npm run test:unit npm run build
提交并推送
git status --short --branch git log -1 --oneline git push origin main
生产部署
vercel --prod --token "$VERCEL_TOKEN"
前置条件
GitHub 仓库已创建，当前分支干净或只包含本次要发布的提交。
Vercel 项目已创建并能通过 token 访问。
构建命令、安装命令和环境变量已经确认。
如果域名解析被关闭或备案审核中，只做部署，不做生产域名验证。
部署验证
确认 Vercel 构建成功，构建日志没有依赖、环境变量或路由错误。
域名可用时，检查首页、工具页、流程页、sitemap.xml 和 feed.xml。
域名不可用时，记录“DNS/备案原因跳过生产域名验证”。
确认新增公开路由已经进入 `app/sitemap.js` 或对应动态 sitemap 数据源。
回滚路径
优先在 Vercel 控制台回滚到上一个成功 Deployment。
如果代码需要回退，创建新的 revert 提交，不使用破坏性 reset。
回滚后再次检查关键路由、sitemap 和工具交互。
记录回滚原因、回滚目标 deployment 和后续修复计划。
交接说明
记录提交号、Vercel deployment URL、构建命令、环境变量名和验证结果。
不要把 `VERCEL_TOKEN` 或其他密钥写入仓库、页面或公开文档。
如果域名解析关闭，明确写入 HANDOFF，等恢复后再做 live check。
