本文件為英文原版的機器翻譯。若翻譯版本與英文原版之間存在任何歧義，概以英文原版為準。 閱讀英文原版

疑難排解

有什麼無法運作嗎？從這裡開始。

瀏覽器擴充功能問題

擴充功能無法載入

  1. 確保您是從 Chrome 線上應用程式商店安裝（而非開發版本）
  2. 前往 chrome://extensions 查看是否有錯誤訊息
  3. 嘗試停用擴充功能並重新啟用
  4. 如果無效，請完全重啟 Chrome

側邊欄無法開啟

  1. 點擊工具列（右上角）中的 Caiioo 圖示
  2. 確保您位於一般網頁上（某些頁面如 Chrome 設定不允許擴充功能）
  3. 前往 chrome://extensions，找到 Caiioo，然後點擊「重新載入」
  4. 再次嘗試點擊圖示

更新後側邊欄空白或損壞

  • 清除瀏覽器快取並重新載入擴充功能
  • 關閉並重新開啟側邊欄
  • 如果都沒用，請停用並重新啟用擴充功能

登入問題

無法使用 Google / Apple / Microsoft 登入

  1. 確保您的瀏覽器未封鎖彈出視窗 —— OAuth 需要彈出視窗
  2. 在 iOS 上，如果 Google 登入卡住，請嘗試改用「透過 Apple 登入」選項
  3. 清除 caiioo.ai 的 Cookie 並重試
  4. 如果您最近更改了密碼，請先在瀏覽器中登出該提供商，然後重試

登入後卡在登入畫面

  • 等待幾秒鐘 —— 應用程式正在獲取您的個人資料
  • 如果仍然卡住，請關閉並重新開啟應用程式（或重新載入擴充功能）
  • 確保您的裝置時鐘正確 —— 如果時鐘偏差，OAuth 權杖驗證將失敗

API 金鑰問題

API 金鑰無法運作

  1. 從提供商網站再次複製您的金鑰，並小心貼上（不要有前導/結尾空格）
  2. 檢查您的帳戶是否還有額度
  3. 嘗試產生一把新金鑰並改用該金鑰
  4. 檢查金鑰格式是否正確——OpenRouter 金鑰開頭為 sk-or-

找不到我的 API 金鑰

  • OpenRouter: openrouter.ai/keys
  • Ollama: 不需要金鑰——確認您的本機伺服器正在 http://localhost:11434 執行

詳情請參閱 AI 提供商與 API 金鑰。

所選模型顯示「達到速率限制」或「過載」

這是提供商端的問題，而不是您的金鑰有問題。當您選擇的模型受到速率限制、過載或無法使用時，Caiioo 會指明該模型並說明發生了什麼，而不是悄悄將您切換到其他模型。請稍等一分鐘後再傳送一次，或自行選擇其他模型。（如果是 Caiioo 為您挑選的模型，它仍然會自動切換——這就是差異所在。）

某個免費模型一直拒絕我的請求

部分免費的 OpenRouter 模型會拒絕來自不在其許可清單上的應用程式的請求。Caiioo 會記住拒絕過請求的模型，在選擇器中加以標記，並在自動遞退到其他模型時跳過它——稍後會重新檢查該封鎖是否已解除。在此期間，請選擇其他模型。

Google 整合（Pro 方案）

無法連線至 Google

  1. 前往 設定 > 帳戶 > 帳戶授權與權限
  2. 點擊「連線 Google 帳戶」
  3. 確保您核准了所有要求的權限
  4. 檢查您的帳戶是否顯示為已連線
  5. 若仍無法運作，請中斷連線後重試

Google 工具無法運作

  1. 確認 Google 已連線（設定 > 帳戶 > 帳戶授權與權限）
  2. 嘗試重新整理您的 Google 連線（「重新連線 Google」按鈕）
  3. 確保已啟用特定工具（設定 > 工具、模式與應用程式 > 工具組態）

私有同步問題

同步無法運作

  1. 檢查是否已啟用私有同步（設定 > 連線 > 私有同步）
  2. 確認您的 Google 帳戶已連線
  3. 確認您的 Google 雲端硬碟仍有儲存空間
  4. 如果您的權杖已過期，請點選「重新連線 Google」
  5. 嘗試將同步開關關閉後再重新開啟

資料未跨裝置同步

  • 私有同步在背景運作——請稍等數秒
  • 檢查所有裝置是否使用相同的 Google 帳戶
  • 確認另一台裝置上也啟用了私有同步
  • 透過關閉並重新開啟同步開關進行手動重新整理

遠端瀏覽器存取問題

relay.caiioo.ai/app 頁面無法連線

  • 在您的主要裝置上，確保 私密轉發 已開啟（設定 > 連線能力 > 連線）並且顯示「已連線」
  • 在遠端瀏覽器上使用與主要裝置相同的帳戶登入 — 轉發功能僅能連線至您自己的執行個體
  • 主要裝置的擴充功能或桌面應用程式必須保持執行且連線線上，遠端瀏覽器才能驅動它
  • 在冷開機時，頁面可能會顯示幾秒鐘的「連線中」載入轉輪，以便建立加密工作階段 — 請讓它完成後再重新載入

已登入但遠端頁面停留在登入畫面

  • 請稍候幾秒鐘 — 它只有在加密工作階段建立後才會啟動應用程式
  • 如果依然卡住，請確認您的主要裝置已連線線上且私密轉發已連線，然後重新載入頁面

效能問題

回應緩慢

  1. 檢查 AI 提供者是否有問題（查看其狀態頁面）
  2. 嘗試使用更快、更便宜的模型（如 Gemini Flash 或 Mistral）
  3. 如果有數百個舊對話，請將其封存
  4. 檢查您的網路連線

對話進行得非常慢

  • AI 正在運作—請查看旋轉的指示器
  • 有些模型比其他模型慢。如果您趕時間，請切換到較快的模型
  • 如果超過幾分鐘，AI 可能卡住了。點擊停止並重試

訂閱與計費

找不到「管理方案」

  • 請確保您使用的是持有訂閱的帳戶登入
  • 如果您是在 iOS 上訂閱，管理方案按鈕會導向 Apple 的訂閱設定
  • 如果您是在網路版上訂閱，它會導向 Stripe 計費入口網站
  • 登出後重新登入以重新整理您的訂閱狀態

「管理方案」開啟了錯誤的頁面

  • iOS 應用程式內購買是在 設定 > Apple ID > 訂閱 中管理 — 而不是在 caiioo.ai/account
  • Stripe 訂閱是透過 設定 >帳戶 > 使用者設定檔 中的入口網站連結或在 caiioo.ai/account 進行管理
  • Caiioo 會根據您訂閱的位置自動進行路由 — 這是預期的行為

已升級但仍停留在舊方案

  • Stripe 升級需要一分鐘的時間生效 — 請重新載入應用程式
  • Apple IAP 可能需要最多 24 小時來驗證。點擊 設定 > 帳戶 > 使用者設定檔 中的「恢復購買」以加速此過程
  • 如果您已經在其他平台上擁有訂閱，「訂閱」按鈕會提示您改往該處進行管理

其他問題

桌面版或行動應用程式出現空白畫面

  • 完全重新啟動應用程式
  • 檢查您是否已連線至網際網路
  • 嘗試清除應用程式快取（依平台而異）
  • 更新至最新版本

工具無法運作

  1. 前往 設定 > 工具、模式與應用程式 > 工具組態，並檢查該工具是否已啟用
  2. 某些工具需要權限或設定（例如 Google 工具需要已連線的 Google 帳戶）
  3. 如果您看到「需要權限」的錯誤，請在 設定 > 帳戶 > 帳戶授權與權限 中重新連線該提供者並重新核准範圍

擴充功能無法連線至桌面應用程式

  • 首先，檢查 啟用 Caiioo 橋接 是否已開啟（設定 > 連線能力 > 連線） — 它的預設為關閉，在關閉狀態下，擴充功能永遠不會連線到桌面應用程式，且「重新連線」與「連接埠」控制項會呈現灰色停用狀態
  • 如果您同時使用瀏覽器擴充功能與桌面應用程式，擴充功能會透過本機 WebSocket 連線至桌面應用程式（功能橋接，而非同步）
  • 重新啟動桌面應用程式，然後重新載入擴充功能
  • 確保沒有執行其他份桌面應用程式副本 — 多個執行個體會發生衝突

macOS 上出現「瀏覽器未連線」警告，但瀏覽器明明開著

  • Caiioo 現在可辨識 Chrome、Safari、Edge 和 Firefox — 只要其中任何一個連線，警告就會消失
  • Safari 透過不同的通道連線，當它不是前景應用程式時可能會短暫進入休眠狀態；它會保持連線狀態，當有指令需要時，Caiioo 會自動喚醒它
  • 如果警告持續存在，請將您的瀏覽器切換至前景一次，然後重試

訊息附件無法上傳

  • 檢查是否支援該檔案格式（PDF、圖片、Word 文件、試算表、簡報）
  • 嘗試較小的檔案
  • 確保您的網際網路連線正常

取得協助

  • 快速解答： 點擊標頭中的 ? 圖示
  • 設定與疑難排解： 點擊齒輪圖示
  • 本指南： 設定 > 說明 > 文件與法律聲明
  • 讓 Caiioo 為您提交錯誤回報： 請它回報問題，它會開啟內建的支援表單，其中已預先填好詳細的說明供您審查並傳送。只要說「直接提交」 — — 在您的核准下 — — 它就會直接送出票券，並附上對話的技術詳細資料，以便團隊重現您所遇到的狀況。

參閱

This guide is maintained by the Caiioo team using Slate, our built-in editor.