應用程式的錯誤提示會以目前的介面語言顯示。本頁引用的是繁體中文介面中的文字。模型服務商傳回的原始錯誤訊息(例如
HTTP 429: ...)不會翻譯。部署與存取
頁面能開啟,但解析時提示「未提供 API 金鑰」
頁面能開啟,但解析時提示「未提供 API 金鑰」
伺服器沒有有效的
DEEPSEEK_API_KEY 或 GEMINI_API_KEY,瀏覽器的設定中也沒有填入 Key。- Docker:修改
.env.production後,執行docker compose up -d重建容器。 - Vercel:在 Settings → Environment Variables 中新增變數後,重新部署。
- 本機開發:修改
.env.local後,重新啟動npm run dev。
只設定了 Gemini Key,解析仍然失敗
只設定了 Gemini Key,解析仍然失敗
應用程式預設使用 DeepSeek。開啟設定,把模型服務切換為 Gemini,然後點選儲存設定。
在伺服器本機用 curl 正常,但外部網路打不開
在伺服器本機用 curl 正常,但外部網路打不開
雲端服務商的安全性群組或系統防火牆沒有開放對應的連接埠。請開放
3002,或在設定反向 Proxy 後開放 80 和 443。HTTPS 憑證申請失敗
HTTPS 憑證申請失敗
網域尚未解析到伺服器,或
80 連接埠沒有開放。確認 A 記錄已生效後再試一次。解析與翻譯
串流輸出經常中斷
串流輸出經常中斷
在設定中關閉串流輸出,改為一次傳回完整結果。如果你使用 Nginx 反向 Proxy,還要確認已設定
proxy_buffering off。提示「解析結果未能完整還原原文」
提示「解析結果未能完整還原原文」
模型傳回的詞項拼接後與原文不一致。重新解析一次,或切換到另一個模型版本。
提示遭上游模型截斷(finish_reason: length)
提示遭上游模型截斷(finish_reason: length)
輸出超過了模型的長度上限。請縮短原文,或分幾次解析。
提示「上游介面請求逾時」
提示「上游介面請求逾時」
模型服務商在 60 秒內沒有回應。請檢查伺服器到模型服務商的網路,稍後再試。
提示「上游串流回應閒置逾時」
提示「上游串流回應閒置逾時」
串流輸出超過 90 秒沒有收到新內容。請重新解析一次。如果經常發生,請在設定中關閉串流輸出。
斷詞不準確,一個詞被拆成好幾段
斷詞不準確,一個詞被拆成好幾段
圈選這幾個詞,如果應用程式判斷它們是一個詞,請點選合併為一個詞。詳見單字詳解與多詞圈選。
其他功能
首頁的今日一句只在幾句固定的句子中輪替
首頁的今日一句只在幾句固定的句子中輪替
伺服器沒有可用的 API Key,或對外網路無法連線到模型服務商,應用程式因此改用了 7 句內建備用句。今日一句只使用伺服器 Key,不會使用瀏覽器中填入的 Key。
Gemini TTS 無法朗讀
Gemini TTS 無法朗讀
Gemini TTS 需要 Gemini API Key。請在伺服器設定
GEMINI_API_KEY,或在設定中填入 Gemini Key。你也可以切換回不需要 Key 的 Edge TTS。最近紀錄在重新整理後消失
最近紀錄在重新整理後消失
瀏覽器停用了本機儲存空間,或正處於無痕模式。請改用一般視窗,或允許網站儲存資料。
回報問題
如果以上內容沒有解決你的問題,請在 GitHub 提交 Issue。回報解析問題時,請附上:- 模型服務商和模型版本
- 介面語言
- 能重現問題的原文
