用途:把 Lovable 项目(Vite + React Router 或 TanStack Start)在同一 Git 仓库内迁移到 Next.js 16 App Router,采用 10 阶段流水线,每阶段有输入、步骤和门禁,门禁通过才进入下一阶段。核心原则是迁移等于传输加规范化:页面内容、文案、交互和视觉保持 1:1,同时把硬编码值改为设计令牌、拆分大文件、补类型、整理目录。
主要能力:阶段 0 做清单与诊断,创建迁移分支、检测技术栈、生成路由映射表、分类依赖、运行质量诊断;阶段 1 初始化 Next.js 16 骨架、提取设计令牌、配置安全头与 next/font、复制 UI 基础组件;阶段 2 迁移组件并替换旧路由 API、拆分超 300 行文件、替换硬编码样式;阶段 3 迁移数据、类型与 hooks;阶段 4 创建页面路由与 SEO 元数据、JSON-LD;阶段 5 可选处理 API/工具页;阶段 6 清理旧栈并开启 TypeScript 严格模式;阶段 7 本地验证;阶段 8 生成 sitemap 与 robots;阶段 9 部署到 Vercel。
使用方式:按阶段执行,命令保持原样,如 git checkout -b feature/nextjs-migration、npx create-next-app@latest . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*"、npx tsc --noEmit、npm run build。Next.js 16 默认 React 19,params 与 searchParams 为同步解构;若项目必须留在 React 18,则改用 Promise 风格,但不可混用。
适用场景:需要把 Lovable 生成的 Vite/React Router 或 TanStack Start 项目升级到 Next.js 16 App Router,并希望迁移过程中同步提升代码质量。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分脚本(如 detect-lovable-stack.ps1、quality-diagnostic.ps1、validate-migration.ps1)与参考文档在资料中仅被提及,未给出完整内容;阶段 5 为可选,API 集成需后续用 Route Handlers 完成。