完整的发布前就绪检查清单生成器

# 发射前检查清单 ## 项目详情 - **项目名称：** [名称、类型、描述] - **技术栈：** [框架、托管、服务] - **功能：** ${需要验证的关键功能} - **发射类型：** [软启动 / 公开发布 / 客户交接] - **域名：** [DNS 是否已配置？] --- ## 功能 - [ ] **所有关键用户流程端到端运行正常** ， 验证方式：在预发布环境中走查每个核心流程 - [ ] **所有表单提交正确并显示适当的反馈** ， 验证方式：提交有效和无效数据，确认成功/错误消息 - [ ] **支付流程正常（如适用）， 使用真实沙箱测试** ， 验证方式：使用测试卡号完成测试交易，确认 webhook 和收据 - [ ] **认证正常（登录、登出、密码重置、会话过期）** ， 验证方式：测试每个认证路径，包括过期会话 - [ ] **邮件通知发送正确（检查垃圾邮件文件夹）** ， 验证方式：触发每封邮件，确认送达和格式 - [ ] **第三方集成响应正确** ， 验证方式：测试每个集成，确认预期响应 - [ ] **错误处理正常（出错时会发生什么？）** ， 验证方式：故意触发错误，确认优雅降级 --- ## 内容与文案 - [ ] **无 lorem ipsum 残留** ， 验证方式：搜索代码库和已部署站点中的“lorem”和“placeholder”文本 - [ ] **所有链接有效（无 404）** ， 验证方式：使用爬虫工具或手动点击所有内部和外部链接 - [ ] **法律页面存在（隐私政策、条款、Cookie 同意）** ， 验证方式：确认每个页面存在且可访问 - [ ] **联系信息正确** ， 验证方式：测试联系表单和列出的电子邮件/电话号码 - [ ] **版权年份为当前年份** ， 验证方式：检查所有页脚 - [ ] **社交媒体链接指向正确的个人资料** ， 验证方式：点击每个链接，确认目标正确 - [ ] **所有图片都有替代文本** ， 验证方式：使用无障碍审计工具或手动检查 - [ ] **Favicon 已设置（所有尺寸）** ， 验证方式：检查浏览器标签页和所有设备尺寸 --- ## 视觉占位符扫描 ### 代码库扫描 ， 搜索以下模式： - [ ] **URL 中包含占位符服务** ， 验证方式：搜索 `placeholder`、`via.placeholder.com`、`placehold.co`、`picsum.photos`、`unsplash.it/random`、`dummyimage.com`、`placekitten`、`placebear`、`fakeimg` - [ ] **文件名包含占位符标记** ， 验证方式：搜索 `placeholder`、`dummy`、`sample`、`example`、`temp`、`test-image`、`default-`、`no-image` - [ ] **Next.js / Vercel 默认文件** ， 验证方式：检查 `public/next.svg`、`public/vercel.svg`、`public/thirteen.svg`、`app/favicon.ico`（如果仍是 Next.js 默认） - [ ] **框架样板图片仍在 `public/` 文件夹中** ， 验证方式：列出 `public/` 并检查非品牌文件 - [ ] **硬编码尺寸但无真实图片** ， 验证方式：搜索 `width={400} height={300}` 搭配灰色 div 或缺失 src - [ ] **SVG 占位符模式** ， 验证方式：搜索用作临时图片填充的内联 SVG（通常是灰色矩形，中心有图标） ### 组件级检查： - [ ] **头像组件回退到通用用户图标** ， 验证方式：检查回退是设计好的还是库默认值 - [ ] **卡片组件带有 `image?: string` 属性** ， 验证方式：检查未传入图片时渲染什么 ， 是设计好的空状态还是布局损坏 - [ ] **Hero/横幅部分** ， 验证方式：确认背景图片是最终版还是开发样本 - [ ] **产品/作品集网格** ， 验证方式：确认所有项目使用真实图片，而非重复的测试图片 - [ ] **Logo 组件** ， 验证方式：确认是最终 logo 文件还是文本占位符 - [ ] **OG 图片（`og:image` 元标签）** ， 验证方式：确认是设计好的资源还是框架/托管默认值 ### 第三方和 CDN 检查： - [ ] **从仅开发用的 CDN 加载的图片** ， 验证方式：搜索 `picsum.photos` 等 - [ ] **可见的图库水印** ， 验证方式：搜索大于 500kb 的图片，可能是未购买的图库图片 - [ ] **替代文本中包含 `lorem` 或 `test` 的图片** ， 验证方式：搜索替代文本属性 ### 占位符清单输出： | # | 文件路径 | 行号 | 类型 | 当前值 | 严重程度 | 所需操作 | |---|---------|------|------|--------|----------|---------| | 1 | `src/app/page.tsx` | 42 | 图片 URL | `via.placeholder.com/800x400` | 严重 | 替换为 hero 图片 | | 2 | `public/favicon.ico` | - | 框架默认 | Next.js 默认 favicon | 严重 | 替换为品牌 favicon | | 3 | `src/components/Card.tsx` | 18 | 缺少回退 | 无图片 = 布局损坏 | 高 | 设计空状态 | 严重程度级别： - **严重：** 用户在关键页面可见（hero、首屏上方、OG 图片） - **高：** 用户在正常使用中可见（卡片、头像、内容图片） - **中：** 在边缘情况下可见（空状态、错误页面、回退） - **低：** 仅在代码中，不对用户可见（测试夹具、仅开发路由） --- ## SEO 与元数据 - [ ] **页面标题唯一且具有描述性** ， 验证方式：检查每个页面的标题标签 - [ ] **为每个页面编写元描述** ， 验证方式：检查每个页面的元描述 - [ ] **Open Graph 标签用于社交分享（使用分享调试器测试）** ， 验证方式：在 Facebook/Twitter 调试器中运行 URL - [ ] **Robots.txt 配置正确** ， 验证方式：检查 robots.txt 是否允许/禁止正确的路径 - [ ] **Sitemap.xml 存在并已提交** ， 验证方式：确认 sitemap.xml 存在并提交到 Google Search Console - [ ] **设置规范 URL** ， 验证方式：检查每个页面的规范标签 - [ ] **结构化数据 / Schema 标记（如适用）** ， 验证方式：使用 Google 富结果测试工具验证 --- ## 性能 - [ ] **Lighthouse 分数达到目标** ， 验证方式：在桌面和移动端运行 Lighthouse - [ ] **图片已优化且响应式** ， 验证方式：检查图片尺寸、格式和 srcset - [ ] **字体加载高效** ， 验证方式：检查字体加载策略（`font-display`、预加载） - [ ] **生产构建中无控制台错误** ， 验证方式：在部署站点打开浏览器控制台 - [ ] **已安装分析工具并跟踪数据** ， 验证方式：确认分析脚本已加载并跟踪页面浏览量 --- ## 安全 - [ ] **强制 HTTPS（无混合内容）** ， 验证方式：检查所有资源是否通过 HTTPS 加载 - [ ] **环境变量已在生产环境中设置** ， 验证方式：确认所有必需的环境变量已配置 - [ ] **前端代码中无 API 密钥暴露** ， 验证方式：搜索代码库中的密钥和令牌 - [ ] **表单上设置速率限制（防止垃圾邮件）** ， 验证方式：确认速率限制中间件/服务已配置 - [ ] **CORS 配置正确** ， 验证方式：测试跨域请求，确认预期行为 - [ ] **CSP 标头（如适用）** ， 验证方式：检查响应标头中的 Content-Security-Policy --- ## 跨平台 - [ ] **在 Chrome、Safari、Firefox（最新版）上测试** ， 验证方式：在每个浏览器中执行核心流程 - [ ] **在 iOS Safari、Android Chrome 上测试** ， 验证方式：在真实设备或模拟器上测试 - [ ] **在关键断点测试** ， 验证方式：在移动端、平板和桌面尺寸下检查布局 - [ ] **打印样式表（如果用户可能打印）** ， 验证方式：打印预览关键页面 --- ## 基础设施 - [ ] **域名已连接且 SSL 有效** ， 验证方式：确认 SSL 证书有效且无警告 - [ ] **配置 www/非 www 重定向** ， 验证方式：测试两个版本，确认重定向正确 - [ ] **404 页面已设计（非默认）** ， 验证方式：访问不存在的 URL，确认自定义 404 - [ ] **错误页面已设计（500、维护）** ， 验证方式：确认自定义错误页面存在 - [ ] **已配置备份（数据库，如适用）** ， 验证方式：确认备份已启用并测试恢复 - [ ] **已设置监控 / 正常运行时间检查** ， 验证方式：确认监控工具已激活并配置告警 --- ## 交接（如果是客户项目） - [ ] **客户可访问所有账户（托管、域名、分析）** ， 验证方式：确认凭据已共享且访问权限有效 - [ ] **文档完整（FORGOKBEY.md 或同等文件）** ， 验证方式：审查文档，确认覆盖所有关键领域 - [ ] **培训已安排或已录制** ， 验证方式：确认培训已安排或录制链接已共享 - [ ] **支持/维护协议明确** ， 验证方式：确认协议已签署且条款明确 --- ## 发射前关键项（必须修复） - [ ] **所有严重占位符已替换** ， 验证方式：完成上述占位符扫描 - [ ] **支付流程已使用真实沙箱测试** ， 验证方式：完成测试交易 - [ ] **HTTPS 已强制执行且 SSL 有效** ， 验证方式：检查证书和重定向 - [ ] **无 API 密钥暴露** ， 验证方式：搜索代码库和已部署站点 - [ ] **OG 图片是设计好的资源** ， 验证方式：在分享调试器中测试 - [ ] **Favicon 是品牌 favicon** ， 验证方式：检查浏览器标签页 - [ ] **所有关键用户流程已验证** ， 验证方式：完成端到端测试 - [ ] **无 lorem ipsum 或占位符文本** ， 验证方式：搜索代码库和已部署站点