疑難排解
從症狀出發，找到導致它的那個設定。
每個功能頁都有自己的排解小節。本頁是索引：找到症狀，點連結過去。
完全沒反應
| 你看到的 | 通常是 |
|---|---|
| 某個網站上沒有懸浮按鈕、沒有工具列、什麼都沒有 | 該網站被網站控制排除了 |
| 所有網站上都沒反應 | 擴充功能在瀏覽器的擴充功能頁面裡被停用了 |
| 懸浮按鈕在，但點了沒用 | 沒有已啟用的服務商，去設定服務商與 API Key看看 |
| 快速鍵沒反應 | 被別的擴充功能或網站搶走了，在快速鍵裡改綁 |
| 右鍵選單項點了沒用 | 該網站被網站控制排除了。選單項在被排除的網站上仍會顯示，但點擊不會有任何效果 |
頁面有一部分沒被翻譯
陪讀蛙有意跳過文字的情況比大家以為的多。
- 導覽、頁首、頁尾保持原文 —— 翻譯範圍設成了「主要內容」。在整頁與段落翻譯裡改。
- 短句保持原文 —— 翻譯控制裡的小段落過濾設了最小長度。
- 混合語言頁面上某些段落保持原文 —— 語言跳過判定它們已經是目標語言了。同一頁。
- 控制項、canvas 或特殊元素裡的文字 —— 內容偵測沒把它當成文字。針對單一網站的修正見網站控制與網站規則。
- 往下捲動時不再出現新譯文 —— 預翻譯範圍，在請求控制與批次翻譯裡。
譯文本身不對
- 某個人名或術語在段落之間變來變去 —— 在術語庫裡給它固定譯法。注意術語庫只對 LLM 服務商生效。
- 意思對但讀著彆扭 —— 換「精翻重寫」提示詞，或者自己寫一個，見自訂提示詞。
- 代名詞和指代關係錯了 —— 在整頁與段落翻譯裡開啟 AI 智慧上下文。
- 回傳的是說明、標籤或
%%而不是譯文 —— 提示詞丟了佔位符，或者和批次規則衝突。一次請求是怎麼拼出來的說明了模型到底被要求做什麼。 - 某段譯文是空的 —— 模型判定它已經是目標語言了，空譯文不算繪任何內容。見一次請求是怎麼拼出來的裡「處理『不需要翻譯』」那節。
很慢，或者中途停了
- 慢，或者請求成片失敗 —— 在請求控制與批次翻譯裡降低速率和突發上限。免費階服務商的限制很嚴。
- 長頁面翻到一半停了 —— 同一頁：佇列重試後放棄了。調小批次大小。
- 本機模型上每次翻譯都很慢 —— 反過來，調大批次；本機模型的開銷在每次請求上，不在 token 上。
- 改完提示詞之後行為變了 —— 編輯提示詞會丟棄已快取的譯文，下次閱讀會重新請求全部內容。
排版亂了
- 譯文重疊或把頁面撐變形 —— 換一個預設樣式，或者自己寫，見自訂翻譯樣式。
- 只在某一個網站上亂 —— 網站控制與網站規則可以只針對那個網站覆蓋選擇器和門檻值。
- 字幕位置不對或擋住播放器 —— 自訂字幕樣式。
字幕
- 播放器裡沒有翻譯按鈕 —— 這部影片沒有 YouTube 暴露給播放器的字幕，或者字幕功能在影片字幕裡是關著的。
- 字幕在句子中間被切斷 —— 在 AI 斷句與額度裡開啟 AI 智慧斷句。
- 開啟之後字幕和畫面對不上了 —— AI 分段會自己重設時間軸；如果漂移比切斷更讓你困擾，就關掉它。
帳號、儲存與複習
- 在網站登入後彈出視窗裡還顯示 Guest —— 重新整理目前頁面；擴充功能是在分頁載入時讀取登入狀態的。
- 沒有儲存到筆記庫的入口 —— 這個自訂 AI 指令沒有設定筆記庫連線，或者它的服務商不支援結構化輸出。見從擴充功能儲存結果。
- 自訂 AI 指令回傳空的或格式錯亂的欄位 —— 模型對結構化輸出支援不好。換一個，或者在服務商提供該選項時關掉推理。
- 助理連不上 MCP —— MCP 需要 Ultra 方案，見連接 AI 助理。
這裡沒有符合的
在設定、同步與備份裡不勾選 API 金鑰匯出設定，附到 GitHub issue 裡，或者到 Discord 問。匯出檔案會說明目前用的是哪些服務商、提示詞和規則，這通常就是答案本身。