常见问题

部署

Q：一定要有 Cloudflare 账号吗？

是。核心依赖是 Workers、D1、R2、KV。没有 Cloudflare 的话，这套方案不适用。

Q：可以不用 WordPress 吗？

可以。独立 CMS 路线只需要 Worker + D1 + R2 + KV，后台自带编辑器和媒体库。

Q：能绑定自己的域名吗？

能。在 Worker 的 Settings → Domains & Routes 里绑定，HTTPS 自动签发。

Q：免费额度够用吗？

个人站基本够：10 万请求/天、D1 5GB、R2 10GB。图片多、流量大时主要成本在 R2 的出站流量（Cloudflare 目前不收 R2 出站费，但有自己的免费额度规则，建议以官网为准）。

内容

Q：Markdown 和富文本能互相转换吗？

不能自动互转。一篇文章的格式在创建时确定，另一个页签只读。这是为了避免切换页签把原稿污染。

Q：文章 slug 能用中文吗？

能。slug 会按 URL 编码存储，访问时浏览器显示中文，R2 key 用解码后的原文。

Q：怎么批量导入？

• 文章：WP 插件批量导出，或后台批量发布；
• 大量文章：用 tools/bulk-export-worker.php 走 CLI，分片并发导出。

风格

Q：换风格后为什么单页没变？

单页是 R2 里的静态快照。换风格只影响之后的渲染，需要「重建全部单页」。

Q：能直接用 WordPress 主题吗？

可以用插件抓取，但复杂主题可能需要手工微调。抓取的是渲染结果，不是主题源码。

Q：内置风格有多少套？

当前 14 套左右，覆盖博客、企业站、文档站、杂志网格、暗色等形态。都在 worker/static/wp-content/themes/。

评论

Q：静态站怎么处理评论？

评论存 D1，单页响应时注入。审核后立即生效，不需要重建页面。

Q：评论会丢吗？

写入 D1 后不会因为重建页面丢失。删文章会连带删除其评论。

Q：能接第三方评论吗？

能。comments.mode=embed 时可以把 Disqus、Giscus 之类的片段注入单页。

数据与迁移

Q：数据能导出吗？

后台支持导出站点数据（文章、分类、设置），格式可以再导入 WordPress。

Q：能从 WordPress 迁到独立 CMS 吗？

能。用插件把文章同步进 D1，然后在 CMS 里继续管理。注意 md 文章不会被 WP 覆盖。

Q：误删了文章怎么办？

D1 没有回收站。建议定期导出备份；R2 里的单页也可能还在，可以作为内容恢复的来源。

其它

Q：支持多站点吗？

插件侧支持一个 WordPress 推送到多个目标；CMS 侧一个 Worker 对应一个站点。多站点托管在路线图上，还不是现成功能。

Q：有 API 文档吗？

后台的写入口兼容 WP REST 子集，见用 REST API 接入任何编辑器。