FAQ
關於 EmDash CMS、本網站架構、部署選擇與從 WordPress 遷移的常見問題。
一句話說明 EmDash CMS 是什麼？
EmDash CMS 是以 Astro 為核心的全端 TypeScript CMS，具現代內容模型、管理介面，以及為在 Cloudflare 上更安全執行而設計的外掛架構。
EmDash 是無頭（headless）CMS 嗎？
不是一般意義上的無頭。公開文件將其定位為 Astro 原生 CMS，而非可從任意前台查詢的獨立內容服務。
這很重要，因為產品設計為嵌入網站架構之內，而非之外。
EmDash 只能用於 Cloudflare 嗎？
不是。官方資料將 Cloudflare 視為完整平台最合適的執行環境，尤其對沙盒外掛、D1 與 R2。但 EmDash 也描述為可移植到 Node.js 以及 SQLite 相容或 S3 相容的設定。
簡短結論：
- Cloudflare 是最強的生產環境敘事
- Cloudflare 並非唯一可能環境
為何本網站以靜態 Astro 網站起步，而非完整 EmDash 執行期？
因為本站主要是對外內容介面：
- 文件
- 外掛頁面
- 模板頁面
- FAQ
- 遷移內容
- 更新
這些都非常適合在 Cloudflare Pages 以靜態方式提供。從此起步可降低複雜度與成本，又不阻擋日後遷到完整執行期。
為何不直接用 WordPress 建官方網站？
因為網站應體現它所推廣的產品方向。
目前網站結構反映該方向：
- 以檔案為主的內容
- 現代前端工具鏈
- 清楚的 Git 驅動發佈
- 與 AI 輔助編輯的良好相容性
用 WordPress 行銷「WordPress 的後繼者」也會讓架構故事變弱。
EmDash 是否支援從 WordPress 遷移？
是。官方文件描述三種匯入方式：
- WXR 檔上傳
- WordPress.com 匯入
- REST API 探測
並描述對文章、頁面、媒體、分類法、狀態對應，以及 Gutenberg 轉 Portable Text 的遷移支援。
EmDash 是否內建驗證？
是。官方文件描述 EmDash 以通行金鑰（passkey）為預設，以 WebAuthn 為主要模型；並描述魔法連結後援、選用 OAuth，以及 Cloudflare 部署可使用 Cloudflare Access。
在此靜態網站上，外掛與模板頁面仍能像真實產品頁嗎？
可以。在本專案中，每個外掛或模板條目可包含：
- 螢幕截圖
- 版本
- 價格
- 狀態
- 發佈日期
- 下載連結
- GitHub 連結
- 示範連結
- 變更紀錄
這已足以建立有說服力的市集風格公開層，而不需要後端。
何時應遷移到完整 EmDash 執行期？
當靜態提供不再足夠時再遷移，例如你需要：
- 非技術使用者以瀏覽器編輯
- 已驗證的提交流程
- 執行期管理的媒體與上傳
- 複雜的編輯權限
- 需要管理介面而非 Git 的生態營運
在此之前，靜態提供仍是較低維護成本的選擇。
完整 EmDash 執行期是否必須使用付費 Cloudflare 功能？
官方 GitHub README 指出沙盒外掛依賴 Dynamic Workers，該功能目前需要付費 Cloudflare 帳戶；並指出若要在無沙盒外掛下運行，可停用 worker loader 設定。
這也是目前公開網站先從 Cloudflare Pages 起步的另一原因。
AI 能協助維護本站嗎？
可以，這也是保持公開網站以內容為先的強力理由之一。
AI 在下列情況表現較好：
- 離散的 MDX 檔
- 明確的 frontmatter
- 穩定的路由結構
- 可審閱的 diff
本專案正是為此而配置。