AI 网站克隆模板:一条命令复刻任意前端架构

痛点直击:网站重建为何总让开发者头疼

当你的团队需要将一个 WordPress 站点迁移到现代技术栈,或者因源代码丢失、开发者离职导致项目无法维护时,传统方案是逐行分析 HTML、手动提取 CSS 变量、重新切图——这个过程通常消耗 40-80 个工时,且容易遗漏响应式断点或交互动效。

ai-website-cloner-template

ai-website-cloner-template 提供了一个开源替代方案:输入目标 URL,执行 /clone-website 命令,AI 代理将在 15-30 分钟内输出可运行的 Next.js 16 代码库,包含完整的 TypeScript 类型定义、Tailwind CSS v4 设计令牌和组件化结构。


技术架构解析:五阶段流水线如何运作

阶段一:侦察与资产提取

AI 代理首先对目标站点执行多维度扫描:

扫描维度具体操作输出物
视觉层全尺寸截图、视口断点截图(移动端/平板/桌面)docs/design-references/
设计令牌提取颜色(oklch 格式)、字体栈、间距系统globals.css 更新
交互映射记录 hover 状态、点击事件、滚动触发器交互规格文档
资产下载图片、SVG 图标、视频、SEO 元数据public/images/, public/seo/

阶段二:组件规格生成

不同于简单的"查看源代码",该模板要求 AI 代理生成精确计算样式的规格文档。每个组件的规格文件包含:

  • getComputedStyle() 获取的精确像素值

  • 多状态内容(默认、hover、active、disabled)

  • 响应式断点规则(min-widthmax-width 组合)

  • 无障碍属性要求(ARIA 标签、键盘导航)

阶段三:并行构建与组装

项目采用 git worktree 实现并行开发:

  1. 主代理创建独立工作区,每个工作区对应一个页面区块(Hero、Features、Footer 等)

  2. 子代理根据规格文档独立编码,避免上下文窗口溢出

  3. 完成后合并至主分支,执行视觉差异比对(visual diff)


实操指南:从零开始克隆一个网站

前置条件检查

# 验证 Node.js 版本(要求 24+)
node -v

# 克隆模板仓库
git clone https://github.com/JCodesMore/ai-website-cloner-template.git my-clone
cd my-clone
npm install

五步执行流程

  1. 启动 AI 代理
    推荐使用 Claude Code(Opus 4.6 模型),或选择以下任一支持的代理:Codex CLI、Cursor、Windsurf、Cline、Roo Code、Gemini CLI 等。

  2. 执行克隆命令

    /clone-website https://example.com

    支持同时处理多个 URL:/clone-website https://site1.com https://site2.com

  3. 审查生成的规格文档
    检查 docs/research/components/ 目录下的 .md 文件,确认颜色值、字体、间距是否符合预期。

  4. 本地验证构建

    npm run check    # 执行 lint + typecheck + build
    npm run dev      # 启动开发服务器(端口 3000)
  5. 定制化调整
    基础克隆完成后,修改 src/components/ 下的 React 组件,替换业务逻辑或接入后端 API。


适用场景与边界

推荐使用场景

场景预期收益
平台迁移将 Webflow/WordPress 站点转为可维护的 Next.js 代码库
源代码恢复站点在线但原始仓库丢失,重建可版本控制的代码
学习研究解构生产级网站的布局技巧、动画实现、响应式策略

明确禁止用途

  • 网络钓鱼或冒充:不得用于创建欺骗性页面

  • 侵犯知识产权:品牌标识、原创文案、独特设计元素归原所有者所有

  • 违反服务条款:部分网站明确禁止爬虫或复制行为,使用前需查阅 robots.txt 及法律声明


技术栈与扩展性

该模板基于以下技术选型,确保生成代码的长期可维护性:

  • Next.js 16(App Router + React 19 + TypeScript 严格模式)

  • shadcn/ui(Radix 基础组件 + Tailwind CSS v4)

  • Tailwind CSS v4(oklch 设计令牌系统)

  • Lucide React(图标库,克隆过程中自动替换为目标站点的 SVG)

对于需要 Docker 化部署的团队,项目提供 docker-compose.yml,支持开发模式(端口 3001)与生产构建两种配置。


总结

ai-website-cloner-template 将网站重建从人工密集型任务转化为可自动化执行的工程流程。其价值不在于"一键复制",而在于标准化的逆向工程规范——通过结构化的侦察、规格生成、并行构建流程,确保输出代码具备生产环境所需的类型安全、组件化和可维护性。

对于需要快速迁移遗留站点、恢复丢失代码库或学习现代前端架构实践的团队,该开源模板提供了一个经过验证的技术框架。