用途:把已写好的站点从“代码能跑”带到“线上真能用、搜得到、数据通、能交接”。它不是部署教程,而是一份踩过坑的上线 checklist,每个坑先讲为什么再讲怎么办。
主要能力:先做选型分叉,按“谁长期维护内容”判断路线——纯静态(单/几个 index.html,无 build 无框架)、headless + 前端(Next 前台 + WordPress/CMS 内容后台,API/GraphQL 取数,ISR 更新)、全栈(内容和渲染都在 CMS 内,如 WP + 可视化编辑器)。再走六步主线:选型定案、部署上架、数据流打通、上线前自查、域名切换、上线后验证与交接。纯静态走 1→2→4→6,跳过数据流和域名切换;headless/全栈六步全走。
用法:/ray-launch ~/projects/apps/mysite 给项目路径自动判路线;/ray-launch 一个单页落地页 描述站点类型;/ray-launch 帮我把 Next 站上线到 Vercel 直接说目标。开跑前先定位三件事:谁长期维护内容、是否有频繁变的内容、上线目标域名与当前托管位置。
静默失败坑位:Vercel 按 commit 作者邮箱匹配 GitHub 身份,邮箱不对部署不触发也不报错;ISR mock 兜底会静默回落,页面看着正常但显示的是 mock;CDN/静态缓存造成“修复无效”假象,验证要带随机 query 参数;表单 demo 模式提交成功但不发信;切换后旧域名残留在页面源码里。
上线前自查:环境变量在托管平台配全、DNS TTL 提前调低、MX/SPF/DKIM 切换时不许动、做基线备份并约切换时间窗。上线后验证:关键页真机 200、View Source 搜旧域名=0、表单真实收件箱收到一封、sitemap 提交 GSC、旧域名 301、SSL 无混合内容告警、移动端抽查。观察期 T+1~T+14 盯 GSC 收录与 404,清理动作后置以保住回滚路径。
交接:站上线不等于活干完,交接物和权限设计见 references/handoff.md。纪律:切换永远配回滚,选型以维护者为轴,拿不准就问“三个月后谁改这里”。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;该 checklist 是一个站的实战沉淀,不是通用真理,遇到与源料冲突的新情况应以“为什么”为准推导。