先看狀態，再找原因。

01 — 安裝與開始

完成安裝後，在要翻譯的分頁開啟譯格。

1. Chrome 116 或更新版本可使用譯格；若要使用預設的 Chrome Translator，請更新到桌面版 Chrome 138 或更新版本。
2. 打開含有英文或日文圖片的普通網頁，再點一下工具列的譯格圖示。
3. 側邊面板開啟後，按「選取網頁圖片」，點選頁面上的漫畫或圖片。
4. 選擇來源語言與翻譯引擎，開始辨識並把譯文貼回原圖。

Chrome 內建頁面（例如 chrome://）、Chrome Web Store 與部分受保護頁面不允許擴充功能注入選圖工具，請改在一般網頁測試。

02 — 選取圖片

看到「分頁尚未授權」或讀不到圖片。

• 先授權目前分頁：切回要翻譯的分頁，再點一次工具列的譯格圖示。
• 允許圖片網域：圖片若由另一個網域提供，Chrome 會要求額外網站存取權；允許後再選一次。
• 確認圖片已載入：先捲動到圖片實際顯示的位置；延遲載入圖片要等清晰內容出現後再選。
• 避開暫時網址：若圖片連結已過期或需要網站登入，重新整理原頁並確認你仍能直接看到圖片。

若錯誤訊息提到 CORS，通常是圖片來源禁止跨網域讀取。譯格會在需要時請求該圖片網域權限；若網站仍拒絕，請改用網頁試用版手動上傳你有權處理的圖片。

03 — PP-OCRv5 辨識

模型已隨擴充功能封裝，不需要另外下載。

第一次辨識會載入本機模型，可能比之後稍慢。若顯示「PP-OCRv5 無法完成辨識」，請重新載入擴充功能、重新開啟側邊面板並再試一次；也請確認裝置有足夠記憶體，且圖片不是損壞或極端尺寸。

• 日文漫畫請選「日本語」，英文圖片選「English」；自動判斷不準時可明確指定。
• 低解析、強烈透視、描邊字、手寫字與文字貼近背景時，辨識率可能下降。
• 完成後可在校對區直接修改 OCR 原文或譯文，再更新覆蓋層。

04 — 翻譯引擎

預設使用 Chrome Translator；相容 API 需主動設定。

Chrome Translator

不需要 API Key。Translator API 自桌面版 Chrome 138 起穩定提供；若顯示瀏覽器不支援，請更新 Chrome。部分語言組合可能需要 Chrome 先下載翻譯模型。Chrome Translator 無法使用時，OCR 原文仍會保留供你校對。

OpenAI 相容 API

選擇此引擎後才會顯示 Base URL、API Key 與 Model 欄位。Base URL 請填到 API 版本層級，例如 https://api.openai.com/v1；譯格會自行加上 /models 與 /chat/completions。

按「測試連線並載入模型」後，Model 欄位會在成功取得清單時成為可輸入、可篩選的選單。未提供 Models API 的服務仍可手動輸入模型名稱。

05 — 連線錯誤

依狀態碼修正，不必猜是哪一欄。

沒有狀態碼的錯誤

連線逾時

15 秒內沒有回應。確認網址、DNS、TLS 憑證與服務狀態；本機 API 也要先啟動。

Network / CORS

檢查網路、憑證與服務端 CORS 設定，並確認已允許譯格存取 API 網域。遠端服務必須使用 HTTPS；只有 localhost、127.0.0.1 或 ::1 可用 HTTP。

無效 JSON

端點有回應，但不是有效 JSON。確認 Base URL 指向 OpenAI 相容 API，而不是登入頁、代理首頁或一般網站。

模型格式不相容

Models API 回應必須含有 data 陣列，且每個模型要有字串 id。

空模型清單

連線成功，但 data 是空陣列；直接在 Model 欄手動輸入供應者提供的模型 ID。

06 — 譯文覆蓋

位置或字級不合適時，先讓頁面完成排版。

• 等圖片與頁面字型載入完成後再選圖，避免網站後續排版讓位置偏移。
• 原圖縮放時，譯格會同步更新覆蓋層；若網站用特殊動畫搬動圖片，請清除後重新選取。
• 直排日文會使用直排顯示；狹窄氣泡可在校對區縮短譯文，改善自動字體縮放。
• 按「清除覆蓋層」或重新整理目前分頁，即可移除所有貼回原圖的譯文。

07 — 仍需協助

帶著可重現資訊，問題會更快被定位。

請記下 Chrome 版本、譯格版本、發生步驟、畫面上的完整錯誤標題與狀態碼；不要貼出 API Key、Authorization 標頭或含私人內容的圖片。商店上架後，可從 Chrome Web Store 的譯格項目頁使用支援／聯絡開發人員管道回報。