常用指令

摘要

本頁整理維護 AI知識庫時常用的本機預覽、建置與部署指令。

適用情境

• 第一次安裝專案。
• 本機預覽網站。
• 發布前檢查 build。
• 部署到 Cloudflare Pages。

安裝

pip install -r requirements.txt

若使用虛擬環境：

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

本機預覽

mkdocs serve

預設網址通常是：

http://127.0.0.1:8000

嚴格建置檢查

mkdocs build --strict

此指令會檢查導覽、連結與網站輸出。若失敗，應先修正錯誤再部署。

部署到 Cloudflare Pages

wrangler pages deploy site --project-name ai-knowledge-base

若 wrangler 尚未登入，需先授權 Cloudflare 帳號。不要把 token 或 credentials 寫入公開檔案。

常用檢查

檢查網站輸出是否存在：

ls site

檢查目前文件：

find docs -name '*.md'

注意事項

• 不要 commit site/、.venv/、.wrangler/。
• 不要把任何 secrets 放進指令範例。
• 正式部署前請執行 mkdocs build --strict。

相關頁面

• 更新知識庫流程
• 檔案結構

更新紀錄

• 2026-07-02：建立完整初始版。