如何把 HTML 轉換為 WordPress 佈景主題：在 html2wp App 中操作

第一步：安裝 html2wp App

下載適用於 Apple 晶片 Mac（M1 或更新）或 Windows 的 html2wp App，像安裝其他 App 一樣安裝即可。Windows 版仍是預覽版，Linux 版之後推出。

首次開啟時，點選「Prepare environment」（準備環境）。App 隨後會下載所需的一切。這只需要做一次，會花一些時間。

App 工作時需要 Docker Desktop，這是一個免費程式。Docker 執行一個臨時 WordPress，App 把佈景主題安裝到那裡並進行檢查。如果你沒有 Docker，App 會替你下載並啟動安裝程式。過程中電腦可能會要求你輸入密碼。

用 ChatGPT 登入

轉換由你 ChatGPT 訂閱中的 AI 完成，所以你不用向我們購買額度或 token。

在 App 中點選「Connect with ChatGPT」（連線 ChatGPT）。App 會顯示一個 9 位字元的代碼，並在瀏覽器中開啟 OpenAI 頁面。在那裡選擇你的 ChatGPT 帳號，或者登入。

接著，頁面會要求你輸入「來自終端機」的代碼，並提到 Codex CLI。這是正常的：html2wp 使用的就是 Codex，頁面要的代碼就是 App 裡顯示的那個。把它貼上進去（在 App 中點選代碼即可複製），然後點選「Continue」。登入完成後，App 會自動更新狀態。

新增 HTML 專案

點選「New project」（新增專案），選擇網站所在的資料夾或 ZIP。它可以是 Lovable、Bolt 或 v0 的匯出，Claude 做的設計，或普通的 HTML 網站。App 不接受網址（URL），因為它需要的是建置網站的原始檔。

App 會自己判斷哪個頁面是首頁，哪些是部落格、文章或商品。

然後選擇你想得到什麼。通常是用 Flash 或 Full 模式把 HTML 轉換成 WordPress 佈景主題。如果你不需要 WordPress，可以改選 Astro 5 專案。這種轉換更短，做好的網站可以直接從 App 部署到 Cloudflare Pages，在那裡免費託管。

HTML 轉 WordPress 用 Flash 還是 Full

Flash 是快速轉換，也是 App 的預設選項。每個步驟只執行一次。選單、部落格、商店和表單會被立即識別並連線好。檢查也只執行一次，結果可以在報告中找到。它大約需要半小時，適合大多數網站，也適合快速試用。

Full 是完整轉換。它執行所有檢查，並嘗試修復發現的錯誤。它大約需要一小時，會消耗更多 ChatGPT 訂閱額度。因此，它適合較複雜的網站，或者 Flash 在報告中留下很多待完善之處的情況。

兩種模式都會把你的 HTML 轉換成可用的 WordPress 佈景主題，並對遺留問題加以說明。具體時間取決於頁面數量和電腦速度。

選擇模型

在 App 中，你可以選擇 AI 模型和推理強度（Reasoning effort）。

• GPT-6-Luna 配合 Extra high，足以應付一般轉換。它便宜，佔用的訂閱額度少，大多數網站都能獨立處理。
• GPT-6-Sol 配合 Medium 或 High，是需要修復問題時我們推薦的選擇，例如 Full 轉換，或透過聊天進行修改時。
• GPT-6-Astra 是最強也最貴的模型。一般工作用不到它，但當連 Sol 都解決不了問題時，它能派上用場。

只要沒有轉換在執行，你隨時可以更換模型。每個專案都可以有自己的模型。

對照 HTML 檢查 WordPress 佈景主題

轉換完成後，App 會通知你。如果有地方沒處理好，它會先嘗試自己修復。無論如何，它總會交付一個可用的佈景主題，並註明還需要完善什麼。

在「Preview」（預覽）分頁中點選「Open website」，在瀏覽器中檢視新網站。「Compare」（比對）分頁會並排顯示原版和轉換結果，並以百分比顯示差異。把你不滿意的地方寫進聊天，App 就會修復。然後用「Make release」（發布版本）把完成的修改儲存為新版本。

自動檢查能發現大部分差異，但不是全部。所以在把佈景主題交給客戶之前，請把頁面看一遍。在「Exports」（匯出）分頁儲存佈景主題 ZIP，再到 WordPress 後台的「外觀 → 佈景主題 → 安裝佈景主題 → 上傳佈景主題」中上傳。

資料和隱私

佈景主題由我們的伺服器建置。不過，大部分工作（測量、與原版比對和修復）都在你的電腦上執行，由你 ChatGPT 帳號中的 AI 驅動。OpenAI 按你帳號的條款處理 AI 所處理的內容。

傳送到伺服器的內容

轉換成 Astro 專案的網站（頁面、樣式、指令碼、圖片和字型），以及每個頁面的資訊。原始專案資料夾和已安裝的套件（node_modules）不會傳送。上傳的資料會在 48 小時後自動刪除。只保留一個指紋（雜湊值），有了它，重新執行才會算作同一次轉換。

含密碼和金鑰的檔案

看起來像登入憑證的檔案根本不會放進上傳內容：.env、金鑰（.pem、.key、id_rsa）、.npmrc、.netrc、.ssh 和 .aws 資料夾，以及任何含私鑰的檔案。App 排除的所有檔案都按名稱列在報告中。

檢查結果

測試完佈景主題後，App 只傳送檢查結果：哪些檢查通過、哪些沒有，頁面數量，與原版的最大差異，以及未通過頁面的短名稱（例如「about」）。它不傳送網址、網域、程式碼、文字、截圖、檔案路徑、授權金鑰或網站名稱。

檢查針對的是你電腦上的 WordPress，我們的伺服器永遠看不到它。沒有這些結果，伺服器只能知道轉換沒有崩潰。所以，只有上一次轉換傳送了結果，下一次轉換才會開始。App 會自動傳送。完整說明見隱私頁面。

用 Visual Edit 編輯

從 HTML 轉換成 WordPress 佈景主題的網站，不需要外掛就能執行。頁面、部落格、表單、選單、SEO 和重新導向都是佈景主題的一部分。重新導向會把舊網址指向新網址：開啟舊連結 /about.html 的人會被帶到 /about/，因此網站能保住搜尋排名。

點選編輯功能來自 Visual Edit，這是一個由你自己新增的 WordPress 外掛。你點選什麼，就改什麼。沒有頁面編輯器在底層重建頁面程式碼。

Pro 是單獨的年度授權，在價格頁面購買。每次轉換，無論 Free 還是 Pro，都會附上免費 Lite 版的連結。如果你停用外掛，頁面照常顯示，佈景主題也完全可用。

授權、訂閱、測試版

重新執行

免費版在所有轉換中共有 5 次重新執行，Pro 授權則不限次數。重新執行是指再次上傳同一個網站。伺服器透過指紋（雜湊值）識別它，所以算作重新執行，而不是新的轉換。

管理和取消訂閱

你在訂閱頁面管理訂閱。連結在網站頁尾和每封授權郵件中。在 Paddle 客戶入口網站中，你可以取消訂閱、更換信用卡、下載發票，以及把按月 Pro 改為按年。它透過傳送到你購買時用的電子郵件地址的連結讓你登入，所以不需要密碼。

取消會停止下一次續訂。你的金鑰在已付費週期結束前一直有效，你轉換的每個佈景主題都仍歸你所有。取消不等於退款：退款按退款條款處理。

測試版的含義

App 會在 1440 和 390 px 兩種寬度下把每個頁面與原版比對，並把發現的每處差異寫進報告。未通過的檢查也會列在報告裡，附上還需要完善之處的說明。向客戶承諾結果之前，先看一遍報告標出的頁面。

如果你發現轉換器本身的 bug，請按外掛文件中的說明報告。會有人閱讀，修復會以服務更新的形式發布。