疑難排解

疑難排解

docs-hub build 失敗

1. npm install 確認依賴齊。
2. npm run build 看錯誤;常見是 frontmatter 欄位拼錯、或 sidebar slug 對不上檔案路徑。
3. sidebar autogenerate(operations/)的頁面缺 frontmatter title 會 build 失敗。

Cloudflare Pages 部署失敗

• 確認 CLOUDFLARE_API_TOKEN 權限含 Pages → Edit,且 CLOUDFLARE_ACCOUNT_ID 正確。
• 本站 build output 是 dist/(astro build 預設)。Pages 專案 build command npm run build、output dist。
• token 過期 → 重新產,換 GitHub secret 或 .env。

各服務排查入口

• hotel-cms / omni-bot / topreview-hotel:先看各 repo 的 documentation/ 與 CHANGELOG.md;線上問題看 Cloudflare dashboard → Workers/Pages → Logs。
• hotel-intel:看 ~/backup/hotel-intel/backup.log 與 pipeline 各步驟 loguru 輸出。
• 排程中樞(llm-task-web):data/llm-task-web.db 的 system_log 表 + web 卡片詳情。

升級 OMC 提示一直出現

各 session 會顯示 [OMC UPDATE AVAILABLE]。非錯誤;要升級在該 session 跑 /update。

待補(給維護者)

• 各服務常見線上錯誤與處置 runbook
• on-call 聯絡與輪值