常見問題對照表
按現象查找；仍不行可在 App 設置 → 幫助與反饋 → 問題反饋 提交（可附截圖與問題日誌），或用 反饋郵箱。請儘量寫清：系統、工具（Ollama / LM Studio / KoboldCPP 等）、Base URL（可打碼 IP 後兩段）、報錯原文。
連接 / 測連
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 連接超時 | 不在同一 Wi‑Fi、防火牆攔端口、服務未監聽 0.0.0.0 | 確認同網；放行端口；按各工具「開服務 / 局域網」章節操作 |
| 立刻失敗 / 無法連接 | IP 錯、端口錯、服務沒開 | 電腦瀏覽器先打開 http://IP:端口/v1/models；核對 Base URL |
| 填了 localhost 仍失敗 | 手機上的 localhost 是手機自己 | 改成電腦局域網 IP |
| 401 / 密鑰錯誤 | 少數本地棧校驗 Key | 填任意非空佔位，或按該工具文檔關閉鑑權 |
| 404 / 模型不存在 | 模型名與本地不一致 | ollama list 或各工具 /v1/models 複製 完整 id |
| 有響應但聊天空白/報錯 | 兼容性、超時過短、模型未加載 | 增大超時；確認模型已 load；換較小模型驗證通路 |
網絡與系統
| 現象 | 可能原因 | 處理 |
|---|---|---|
| 電腦能連、手機不能 | 訪客 Wi‑Fi 隔離、AP 隔離 | 改用主網絡；臨時用手機熱點讓電腦接入再試 |
| 偶發斷開 | 電腦休眠、IP 變化 | 禁止休眠；重查 IP 並更新連接 |
| VPN 開啟後異常 | 分流/虛擬網卡 | 測試時先關 VPN 或排除局域網 |
URL 寫法
| 正確示例 | 錯誤示例 |
|---|---|
http://192.168.1.8:11434/v1 | http://localhost:11434/v1 |
http://192.168.1.8:1234/v1 | http://192.168.1.8:1234/v1/chat/completions |
http://192.168.1.8:5001/v1 | https://192.168.1.8:11434/v1（本地未配證書時不要強行 https） |
http://192.168.1.8:8080/v1 |
HTTP 明文
MiniTavern Android 已允許明文 HTTP（局域網常用）。若仍被攔：
- 確認 Base URL 是
http://而非錯誤協議 - 確認系統/廠商網絡保護未攔截局域網
- iOS 若遇 ATS 限制，優先保證使用文檔中的局域網地址；仍失敗請反饋系統版本與報錯
CORS
瀏覽器網頁才常受 CORS 限制；原生 App 直連 API 一般不受 CORS 影響。若你在電腦瀏覽器裡測前端頁面失敗，不代表 MiniTavern 會失敗——請以 App 內測連為準。
性能
| 現象 | 處理 |
|---|---|
| 首字極慢 | 換更小量化/更小參數；確認在用 GPU |
| 生成中途卡住 | 增大超時；關其它佔顯存程序；看電腦端日誌是否 OOM |