AI 網站克隆模板 - 一鍵復刻任何網站
JCodesMore/ai-website-cloner-template
用 AI 編碼代理一鍵克隆任何網站,自動提取設計元素、生成 Next.js 元件,支援 Claude Code 等多種 AI 工具
成熟度:維護活躍,最近提交25天前,34個 open issues,社群參與度高
项目体检
部署 · Docker Compose 双模式部署(生产 runner/开发 dev),默认端口 3000(生产)和 3001(开发),支持热重载卷挂载
成本 · 开箱即用无需外部 Key,但需配合 AI 编码代理(Claude Code/Cursor 等)执行克隆命令,代理本身可能需 API 订阅
技术 · TypeScript + Next.js 16(App Router/React 19) + Tailwind CSS v4 + shadcn/ui + Lucide React
许可 · MIT 协议,可商用,需保留原作者版权声明,禁止用于钓鱼/侵权等非法用途
活跃 · v0.3.1 发布于 2026-03-30,6 位贡献者,25 天前最后提交,维护活跃
解決什麼
當你需要將現有網站從 WordPress/Webflow 等平臺遷移到現代技術棧,或者原始碼丟失但網站仍線上時,傳統做法是手動重寫每個元件。這個模板通過 AI 編碼代理自動化整個流程:輸入目標 URL,AI 自動截圖、提取設計 token(顏色/字型/間距)、分析互動行為(懸停/點選/響應式),生成詳細的元件規格文件,然後並行構建所有元件,最終輸出完整的 Next.js 專案。整個過程從數天縮短到幾小時。
為何火
3 萬+ stars 的核心原因是抓住了"AI 編碼代理"這個新範式的實用場景。不同於簡單的網頁截圖轉程式碼工具,它提供了完整的工程化流程:多階段管道(偵察→基礎→規格→並行構建→組裝)、Git worktree 隔離構建、精確的 getComputedStyle() 值傳遞給 AI、自動下載資源並更新路徑。專案支援 15+ 主流 AI 編碼工具(Claude Code/Cursor/Windsurf 等),開發者可以用熟悉的工具鏈完成複雜任務,而不是學習新的專用工具。
核心功能
- 一鍵克隆命令:在 AI 代理中執行
/clone-website <URL>即可啟動全流程 - 多狀態捕獲:自動模擬滾動、點選、懸停,捕獲所有互動狀態和響應式斷點
- 精確規格生成:提取真實 CSS 計算值(非估算),包含多狀態內容、動畫引數、資源路徑
- 並行構建系統:每個元件在獨立 Git worktree 中由專門的 builder agent 構建,互不干擾
- 資源自動化:下載所有圖片/影片/SVG 到
public/,替換 Lucide 圖示為提取的 SVG - 現代技術棧:Next.js 16 App Router、React 19、Tailwind CSS v4(oklch 色彩空間)、shadcn/ui
安裝
# 1. 在 GitHub 點選 "Use this template" 建立自己的倉庫(不要直接 clone)
# 2. Clone 你的新倉庫
git clone https://github.com/YOUR-USERNAME/YOUR-REPO.git
cd YOUR-REPO
# 3. 安裝依賴
npm install
# 4. 啟動 AI 代理(以 Claude Code 為例)
claude --chrome
# 5. 在代理中執行
/clone-website https://example.com
# 開發模式
npm run dev # 或用 Docker: docker compose up dev
適合誰
- 平臺遷移需求者:需要將自有網站從 Webflow/Squarespace 遷移到 Next.js 的開發者
- 原始碼恢復場景:網站線上但程式碼庫丟失、開發者離職、或技術棧過時的團隊
- 前端學習者:想通過拆解真實生產網站學習佈局、動畫、響應式設計的實現方式
- AI 工具愛好者:已訂閱 Claude Code/Cursor 等 AI 編碼工具,想探索實際工程應用
不適合:釣魚網站製作、品牌冒充、違反目標網站 ToS 的爬取行為(README 明確禁止)。
社群評價
暫無足量社群公開討論,以下為基於專案本身的中立評估:
從 GitHub 資料看,該專案在 4 個月內獲得 3 萬 stars 和 4000+ forks,增長速度極快,說明擊中了"AI 輔助開發"的熱點需求。34 個 open issues 中多數是功能請求(如支援更多 AI 工具、Vue/Svelte 版本),而非嚴重 bug,表明核心流程相對穩定。Discord 社群活躍,但需注意專案明確要求使用者用 "Use this template" 而非 fork,避免 PR 汙染主倉庫,這種設計體現了作者對模板定位的清晰認知。
潛在爭議點:依賴 AI 代理的黑盒能力,輸出質量受模型版本影響(README 推薦 Opus 4.8);法律灰色地帶(雖然宣告禁止侵權,但技術上可克隆任何公開網站)。
選型對比
vs 商業工具(Webflow/Framer 匯出):
- 商業工具通常只能匯出自家平臺的專案,且程式碼質量參差不齊(冗餘 class、內聯樣式)
- 本專案可處理任意網站,輸出乾淨的 React 元件和 Tailwind 類名,但需要 AI 代理訂閱成本
vs 傳統爬蟲(Puppeteer + 手動重寫):
- 傳統方案需手動分析 DOM、提取樣式、重構元件,耗時數天
- 本專案自動化整個流程,但依賴 AI 理解能力,複雜互動(如 WebGL/Canvas)可能失敗
vs 截圖轉程式碼工具(Screenshot to Code):
- 截圖工具基於視覺推斷,精度有限且不保留語義結構
- 本專案直接讀取 DOM 和計算樣式,保留真實 CSS 值和 HTML 結構,但不適合純視覺稿
已知坑
- AI 代理依賴:必須配合 Claude Code/Cursor 等工具使用,不是獨立 CLI。中國大陸使用者訪問部分 AI 服務需要網路代理
- 複雜互動侷限:README 未明確說明對 WebGL、Canvas、複雜 JavaScript 動畫的支援程度,可能需要手動調整
- 法律風險:雖然技術上可行,但克隆他人網站前需確認版權和 ToS,商業使用需額外注意品牌資產歸屬
- 模型版本敏感:推薦 Opus 4.8,使用其他模型(如 GPT-4)可能效果不佳,且 AI 能力隨版本迭代波動
- 資源完整性:動態載入的資源(懶載入圖片、CDN 字型)可能遺漏,需檢查
public/目錄完整性 - 模板倉庫管理:必須用 "Use this template" 建立新倉庫,直接 clone 會導致後續更新衝突
安装方式:npm