Skip to main content
儲存庫提供了一份專門寫給 AI 程式設計助手的部署指南 docs/agent-deploy.md。你只需要把下面這句話傳給 Claude Code、Codex、Cursor 或 Gemini CLI：
AI 助手會先問你要部署到哪裡、要使用哪些 Key，然後完成安裝和驗證，最後告訴你存取網址。

​
部署流程

1

一次問清楚

AI 助手會一次問你以下問題：
  1. 部署到哪裡？
    • A. 目前這台 Linux 伺服器，使用 Docker（建議）
    • B. Vercel
    • C. 只在本機執行試用
  2. DeepSeek API Key。沒有的話，也可以只提供 Gemini Key。
  3. 選填項目：Gemini API Key、存取密碼 CODE、網域（僅 A 需要）。
2

執行部署

  • Docker：檢查 Docker 和連接埠，下載 Compose 檔案，寫入 .env.production 並設定 600 權限，然後啟動容器。如果提供了網域，會繼續設定反向 Proxy 和 HTTPS。
  • Vercel：由你本人登入 Vercel 授權，AI 助手會引導你匯入儲存庫和新增環境變數。
  • 本機：複製儲存庫、安裝相依套件、建置並啟動。
3

驗收

AI 助手會檢查容器狀態和日誌，並用 curl 確認傳回 200。
4

交付

AI 助手會告訴你：
  • 存取網址（IP 加連接埠，或網域）
  • 如果設定了 CODE，第一次存取時需要輸入密碼
  • 如果只設定了 Gemini Key，需要在設定中把服務商切換為 Gemini
  • 更新和查看日誌的指令

​
AI 助手遵守的規則

指南要求 AI 助手遵守以下規則，以保護你的伺服器和金鑰：

保護金鑰

API Key 只向你索取。不印出、不寫入日誌、不提交到 git。

先問再做

刪除容器或檔案、占用或更換連接埠、安裝系統軟體，或修改現有的 Nginx、Caddy 或防火牆設定之前，先徵得你的同意，並先備份設定。

不終止程序

連接埠被占用時，告訴你是哪個程序在使用，由你決定要換連接埠還是自行處理。

失敗就停

某個步驟失敗時，提供關鍵錯誤訊息和判斷，不會一再盲目重試。
你也可以依照部署頁面的步驟，手動完成相同的流程。