Skip to main content
應用程式的所有伺服器端設定都透過環境變數完成。本機開發使用 .env.local，Docker 部署使用 .env.production，Vercel 則在專案的 Settings → Environment Variables 中設定。

​
環境變數

DEEPSEEK_API_KEY 和 GEMINI_API_KEY 至少要填一個。兩個都沒填時，訪客必須在設定中填入自己的 Key 才能使用，首頁的今日一句也會改用內建備用句。
完整範例：
.env.production

​
模型服務商

應用程式透過 OpenAI 相容的 Chat Completions 介面呼叫模型。 伺服器端會依服務商自動調整請求參數：
  • DeepSeek：使用 json_object 格式傳回結構化結果，並關閉思考模式。
  • Gemini：使用嚴格的 JSON Schema 傳回結構化結果。gemini-flash-latest 使用 low 推理等級，gemini-flash-lite-latest 使用 minimal 推理等級。

​
使用自訂介面位址

如果你透過 Proxy 或相容閘道存取模型服務商，可以設定 DEEPSEEK_API_URL 或 GEMINI_API_URL。位址必須是完整的 Chat Completions 端點，而不是 Base URL。
介面位址只能在伺服器環境變數中設定。瀏覽器請求中若帶有自訂 API URL，伺服器端會直接拒絕，以免應用程式被當成任意位址的轉送 Proxy。

​
請求逾時

​
存取密碼

設定 CODE 後，訪客開啟網站時需要先輸入存取密碼。
  • 驗證通過後，伺服器端會寫入一個 HttpOnly 工作階段 Cookie ja_session，有效期限 7 天。
  • 工作階段權杖以 CODE 作為金鑰，使用 HMAC-SHA256 簽署。修改 CODE 後，所有已登入的工作階段會立即失效。
  • 未通過驗證時，解析、翻譯、釋義、圖片辨識、朗讀、對話和今日一句等介面都會傳回 401。
  • 正式環境中的 Cookie 帶有 Secure 標記，需要透過 HTTPS 存取。
CODE 適合簡單的私人部署，用來防止陌生人消耗你的 API 額度。它無法取代完整的帳號與權限系統。

​
Umami 統計

同時填寫以下兩個變數後，應用程式會載入 Umami 統計指令碼：
任一變數為空時，應用程式不會載入 Umami。這兩個變數由伺服器端在執行階段讀取，修改後重新啟動服務即可生效，Docker 部署不需要重新建置映像檔。 統計只記錄功能使用量，不記錄任何內容。詳見金鑰與隱私。