疑難排解

建置失敗：找不到 vitepress

確認依賴已安裝，且 Cloudflare Pages 會在建置前執行安裝步驟。

npm install
npm run build

建置成功但頁面回傳 404

確認建置輸出目錄是 .vitepress/dist。輸出目錄錯誤會部署到錯誤檔案。

.vitepress/dist

docs.hideapps.top 無法開啟

1. 確認 docs.hideapps.top 已加入 Pages Custom domains。
2. 確認 docs CNAME 記錄存在。
3. 確認目標為 Pages 專案網域。
4. 如果剛加入網域，等待 Cloudflare 完成憑證簽發。

HTTPS 憑證長時間未生效

檢查 hideapps.top 是否有 CAA 記錄限制憑證簽發。如有，需要允許 Cloudflare 使用的憑證機構。

本機預覽正常，線上樣式遺失

本專案部署在子網域根路徑，因此 VitePress 不需要 base。只有部署到 /docs/ 這類子路徑時才需要設定 base。