用途:在将全栈 Next.js 应用发布到生产环境前,或在大规模改动 UI、SEO、鉴权、API、数据库、依赖后,执行一套命令驱动的启动就绪检查清单。
主要能力:分为 13 个阶段,需按顺序执行,通过后再进入下一阶段。1 代码完整性(tsc --noEmit、eslint、npm test);2 构建验证(npm run build,检查页面静态/SSG 符号);3 API 会话与鉴权(端点响应、受保护路由返回 401/403、Cookie 的 HttpOnly/Secure/SameSite);4 路由回归(核心页、sitemap、robots.txt 均 200);5 SEO(title 30–60 字符、meta description、og:*、twitter:card、canonical、favicon、hreflang、JSON-LD、slug);6 API 行为(状态码、Content-Type、统一错误 JSON、响应时间、CORS);7 Git 卫生(无密钥、无构建产物、规范提交信息);8 部署后冒烟测试;9 页面速度、懒加载与包体积(Lighthouse ≥ 90、FCP/LCP/CLS、WebP/AVIF、动态导入、单 JS chunk < 200KB gzip、font-display: swap);10 清理与漏洞扫描(npm audit、depcheck、无 console.log/eval);11 UI/UX(卡片布局、触摸目标 ≥ 44×44px、动画只用 transform+opacity、prefers-reduced-motion、错误边界与加载态);12 数据库与数据层(连接池、索引、无 N+1、无硬编码连接串、迁移幂等);13 安全数据渲染(无客户端密钥、无未净化 dangerouslySetInnerHTML、无堆栈泄露、UUID)。
使用方式:先设置环境变量 export PROD_URL="https://yourdomain.com",可选 QA_AUTH_HEADER 与 PAGESPEED_API_KEY;再运行 qa:all 或 qa:full 等合并执行函数。提供 pre-commit 钩子与 GitHub Actions 示例。
限制:所有 qa:* 函数为只读(tsc、lint、test、build、curl、grep);部分检查依赖具体工具(Prisma、NextAuth 等);鉴权测试对生产环境有破坏性,应使用预发布环境;通过全部阶段降低风险但不消除生产缺陷;SEO 仅校验原始 HTML,不验证社交预览渲染;路由检查只验证状态码,不验证内容正确性;关键用户路径仍需人工 UX 测试。官方文档未提供收费、价格与平台信息,暂未提供。