如何把 HTML 转换为 WordPress 主题：在 html2wp 应用中操作

安装把 HTML 转换为 WordPress 主题的应用

下载适用于 Apple 芯片 Mac（M1 或更新）或 Windows 的 html2wp 应用，像安装其他应用一样安装即可。Windows 版仍是预览版，Linux 版之后推出。

首次打开时，点击“Prepare environment”（准备环境）。应用随后会下载所需的一切。这只需要做一次，会花一些时间。

应用工作时需要 Docker Desktop，这是一个免费程序。Docker 运行一个临时 WordPress，应用把主题安装到那里并进行检查。如果你没有 Docker，应用会替你下载并启动安装程序。过程中电脑可能会要求你输入密码。

用 ChatGPT 登录

转换由你 ChatGPT 订阅中的 AI 完成，所以你不用向我们购买额度或 token。

在应用中点击“Connect with ChatGPT”（连接 ChatGPT）。应用会显示一个 9 位字符的代码，并在浏览器中打开 OpenAI 页面。在那里选择你的 ChatGPT 账号，或者登录。

接着，页面会要求你输入“来自终端”的代码，并提到 Codex CLI。这没有问题：html2wp 使用的就是 Codex，页面要的代码就是应用里显示的那个。把它粘贴进去（在应用中点击代码即可复制），然后点击“Continue”。登录完成后，应用会自动更新状态。

新建项目：要转换为主题的 HTML

点击“New project”（新建项目），选择网站所在的文件夹或 ZIP。它可以是 Lovable、Bolt 或 v0 的导出，Claude 做的设计，或普通的 HTML 网站。应用不接受网站地址（URL），因为它需要的是构建网站的源文件。

应用会自己判断哪个页面是首页，哪些是博客、文章或商品。

然后选择你想得到什么。通常是用 Flash 或 Full 模式把 HTML 转换成 WordPress 主题。如果你不需要 WordPress，可以改选 Astro 5 项目。这种转换更短，做好的网站可以直接从应用部署到 Cloudflare Pages，在那里免费托管。

Flash 还是 Full：把 HTML 转换为 WordPress 的两种方式

Flash 是快速转换，也是应用的默认选项。每个步骤只运行一次。菜单、博客、商店和表单会被立即识别并连接好。检查也只运行一次，结果可以在报告中找到。它大约需要半小时，适合大多数网站，也适合快速试用。

Full 是完整转换。它运行所有检查，并尝试修复发现的错误。它大约需要一小时，会消耗更多 ChatGPT 订阅额度。因此，它适合较复杂的网站，或者 Flash 在报告中留下很多待完善之处的情况。

两种模式都会把你的 HTML 转换成可用的 WordPress 主题，并对遗留问题加以说明。具体时间取决于页面数量和电脑速度。

选择把 HTML 转换为主题的模型

在应用中，你可以选择 AI 模型和推理强度（Reasoning effort）。

• GPT-6-Luna 配合 Extra high，足以应付常规转换。它便宜，占用的订阅额度少，大多数网站都能独立处理。
• GPT-6-Sol 配合 Medium 或 High，是需要修复问题时我们推荐的选择，例如 Full 转换，或通过聊天进行修改时。
• GPT-6-Astra 是最强也最贵的模型。常规工作用不到它，但当连 Sol 都解决不了问题时，它能派上用场。

只要没有转换在运行，你随时可以更换模型。每个项目都可以有自己的模型。

对照 HTML 检查 WordPress 主题

转换完成后，应用会通知你。如果有地方没处理好，它会先尝试自己修复。无论如何，它总会交付一个可用的主题，并注明还需要完善什么。

在“Preview”（预览）标签页中点击“Open website”，在浏览器中查看新网站。“Compare”（比对）标签页会并排显示原版和转换结果，并以百分比显示差异。把你不满意的地方写进聊天，应用就会修复。然后用“Make release”（发布版本）把完成的修改保存为新版本。

自动检查能发现大部分差异，但不是全部。所以在把主题交给客户之前，请把页面看一遍。在“Exports”（导出）标签页保存主题 ZIP，再到 WordPress 后台的“外观 → 主题 → 添加新主题 → 上传主题”中上传。

数据和隐私

主题由我们的服务器构建。不过，大部分工作（测量、与原版比对和修复）都在你的电脑上运行，由你 ChatGPT 账号中的 AI 驱动。OpenAI 按你账号的条款处理 AI 所处理的内容。

发送到服务器的内容

转换成 Astro 项目的网站（页面、样式、脚本、图片和字体），以及每个页面的信息。原始项目文件夹和已安装的库（node_modules）不会发送。上传的数据会在 48 小时后自动删除。只保留一个指纹（哈希值），有了它，重新运行才会算作同一次转换。

含密码和密钥的文件

看起来像登录凭据的文件根本不会放进上传包：.env、密钥（.pem、.key、id_rsa）、.npmrc、.netrc、.ssh 和 .aws 文件夹，以及任何含私钥的文件。应用排除的所有文件都按名称列在报告中。

检查结果

测试完主题后，应用只发送检查结果：哪些检查通过、哪些没有，页面数量，与原版的最大差异，以及未通过页面的短名称（例如“about”）。它不发送网站地址、域名、代码、文字、截图、文件路径、许可证密钥或网站名称。

检查针对的是你电脑上的 WordPress，我们的服务器永远看不到它。没有这些结果，服务器只能知道转换没有崩溃。所以，只有上一次转换发送了结果，下一次转换才会开始。应用会自动发送。完整说明见隐私页面。

用 Visual Edit 编辑

从 HTML 转换成 WordPress 主题的网站，不需要插件就能运行。页面、博客、表单、菜单、SEO 和重定向都是主题的一部分。重定向会把旧地址指向新地址：打开旧链接 /about.html 的人会被带到 /about/，因此网站能保住搜索排名。

点击编辑功能来自 Visual Edit，这是一个由你自己添加的 WordPress 插件。你点击什么，就改什么。没有页面构建器在底层重建页面代码。

Pro 是单独的年度许可证，在价格页面购买。每次转换，无论 Free 还是 Pro，都会附上免费 Lite 版的链接。如果你停用插件，页面照常显示，主题也完全可用。

许可证、订阅、测试版

重新运行

免费版在所有转换中共有 5 次重新运行，Pro 许可证则不限次数。重新运行是指再次上传同一个网站。服务器通过指纹（哈希值）识别它，所以算作重新运行，而不是新的转换。

管理和取消订阅

你在订阅页面管理订阅。链接在网站页脚和每封许可证邮件中。在 Paddle 客户门户中，你可以取消订阅、更换银行卡、下载发票，以及把按月 Pro 改为按年。它通过发送到你购买邮箱的链接让你登录，所以不需要密码。

取消会停止下一次续订。你的密钥在已付费周期结束前一直有效，你转换的每个主题都仍归你所有。取消不等于退款：退款按退款条款处理。

测试版的含义

应用会在 1440 和 390 px 两种宽度下把每个页面与原版比对，并把发现的每处差异写进报告。未通过的检查也会列在报告里，附上需要完善之处的说明。向客户承诺结果之前，先看一遍报告标出的页面。

如果你发现转换器本身的 bug，请按插件文档中的说明报告。会有人阅读，修复会以服务更新的形式发布。