常见问题
关于 EmDash CMS、本站架构、部署选项以及从 WordPress 迁移路径的常见问题。
一句话说明：EmDash CMS 是什么？
EmDash CMS 是基于 Astro 构建的全栈 TypeScript CMS，具备现代内容模型、管理界面，以及面向在 Cloudflare 上更安全执行而设计的插件架构。
EmDash 是无头 CMS 吗？
不完全是通常意义上的无头。公开文档将其定位为 Astro 原生 CMS，而不是可从任意前台查询的独立内容服务。
这很重要，因为产品设计为嵌入站点架构之内，而非架构之外。
EmDash 只能跑在 Cloudflare 上吗？
不是。官方材料将 Cloudflare 视为最契合的运行时，尤其针对沙箱化插件、D1 与 R2。但 EmDash 也描述为可移植到 Node.js 以及兼容 SQLite 或 S3 的部署。
简而言之：
- Cloudflare 是最强的生产叙事
- Cloudflare 并非唯一可能的环境
为何本站以静态 Astro 站点起步，而不是完整 EmDash 运行时？
因为本站主要是公共内容面：
- 文档
- 插件页
- 模板页
- 常见问题
- 迁移内容
- 更新
这些都极适合在 Cloudflare Pages 上静态交付。这样起步可降低复杂度与成本，又不阻碍未来迁到完整运行时。
为何不把官方网站直接建在 WordPress 上？
因为站点本身应体现其所推广的产品方向。
当前站点结构反映了这一方向：
- 基于文件的内容
- 现代前端工具链
- 清晰的 Git 驱动发布
- 与 AI 辅助编辑的良好兼容
用 WordPress 来营销「WordPress 继任者」也会削弱架构叙事。
EmDash 是否支持从 WordPress 迁移？
支持。官方文档描述三种导入方式：
- WXR 文件上传
- WordPress.com 导入
- REST API 探测
并描述对文章、页面、媒体、分类法、状态映射以及 Gutenberg 到 Portable Text 的转换支持。
EmDash 是否内置身份认证？
是。官方文档将 EmDash 描述为通行密钥优先，以 WebAuthn 为主要模型；并描述魔法链接回退、可选 OAuth，以及在 Cloudflare 部署下可使用 Cloudflare Access。
在静态站点上，插件与模板页还能像真实产品页吗？
可以。在本项目中，每个插件或模板条目可包含：
- 截图
- 版本
- 价格
- 状态
- 发布日期
- 下载链接
- GitHub 链接
- 演示链接
- 更新日志
这足以在无需后端的情况下，搭建有说服力的公共「市场」层。
何时应迁到完整 EmDash 运行时？
当静态交付不再足够时，例如需要：
- 非技术用户的浏览器内编辑
- 需认证的提交流程
- 运行时管理的媒体与上传
- 复杂的编辑权限
- 需要管理界面而非 Git 的生态运营
在此之前，静态交付仍是更低维护的选择。
完整 EmDash 运行时是否必须付费 Cloudflare 功能？
官方 GitHub README 指出，沙箱化插件依赖 Dynamic Workers，该功能目前需要付费 Cloudflare 账户；并指出若不想使用沙箱化插件，可关闭 worker loader 配置。
这也是当前公共站点先从 Cloudflare Pages 起步的另一原因。
AI 能帮助维护本站吗？
可以，这也是保持公共站点内容优先的最强理由之一。
AI 在以下场景表现更好：
- 离散的 MDX 文件
- 明确的 frontmatter
- 稳定的路由结构
- 可审阅的 diff
本项目正是为此搭建的。