START HERE
先做這四項快速檢查
- 確認 Glaslate 已出現在「系統設定 → 隱私權與安全性 → 螢幕與系統錄音」並已開啟。
- 授權後完整結束 Glaslate，再重新啟動。
- 讓玻璃板完整位於同一個螢幕，並只框住清楚可見的文字。
- 確認目前翻譯引擎需要的 API Key、地區或模型名稱已填妥。
SCREEN CAPTURE & OCR
權限與畫面辨識
為什麼玻璃板沒有偵測到文字？
先確認螢幕擷取權限並重新啟動 App。接著縮小辨識範圍，讓文字清楚、完整地落在玻璃板內；過小、模糊、低對比或被其他視窗遮住的文字較難辨識。
權限清單裡沒有 Glaslate 怎麼辦？
前往「系統設定 → 隱私權與安全性 → 螢幕與系統錄音」，按清單下方的「＋」，手動選擇 Glaslate.app，開啟權限後再重新啟動 App。
為什麼跨螢幕時辨識不穩定？
請讓整個玻璃板完整位於單一螢幕內。不同螢幕可能有不同縮放比例與座標系統，跨越邊界會讓擷取範圍難以對齊。
Glaslate 會把自己的視窗也拍進去嗎？
App 會在畫面擷取時排除自己的玻璃板與控制視窗，辨識的是玻璃板下方的內容。
TRANSLATION SERVICE
翻譯引擎與 API Key
一定要申請 API Key 嗎？
不一定。macOS 15 以上可使用 Apple 內建翻譯；Google 引擎也支援不填 Key 的免費降級方式。Microsoft、Gemini、DeepL、OpenAI、Claude 與相容 API 則需要各自的憑證。
顯示「請至設定填入 API Key」怎麼辦？
打開 Glaslate 設定，確認目前選擇的引擎與填寫欄位相符。Microsoft Azure 還需要地區；OpenAI、Claude 與相容 API 也要確認模型名稱，相容 API 另需 Base URL。
為什麼有 Key 還是翻譯失敗？
請確認 Key 沒有多餘空格、尚未失效，帳戶仍有額度，模型名稱與服務端點正確。服務商的流量限制或暫時性網路錯誤也可能造成失敗。
API Key 儲存在哪裡？
API Key 會儲存在 macOS Keychain，並使用 Glaslate 專屬的 Keychain service 識別，不會寫入翻譯紀錄檔。
CONTROLS & HISTORY
操作與翻譯紀錄
可以只貼文字、不擷取畫面嗎？
可以。點玻璃板控制列的鍵盤圖示切換到文字模式，貼上文字後會自動翻譯，並可直接複製結果。
翻譯內容會保留嗎？
成功的畫面翻譯與文字翻譯會存入本機紀錄。你可以搜尋、加星號、複製或刪除；未加星號的舊項目會在紀錄過多時優先清理。
快捷鍵沒有反應怎麼辦？
先確認 Glaslate 仍在執行。顯示／隱藏玻璃板的快捷鍵可在設定中自訂；翻譯目前範圍固定為 ⌥ Return。
如何刪除翻譯紀錄？
在翻譯紀錄視窗中可刪除單筆項目，也能清除未加星號的紀錄。誤刪後可使用畫面上的復原操作。
SYSTEM & INSTALLATION
系統與安裝
支援哪些 Mac？
目前下載檔為 Universal App，可在 Apple Silicon 與 Intel Mac 上執行，系統需求為 macOS 14 或更新版本。
Apple 內建翻譯為什麼無法選用？
Apple 內建翻譯需要 macOS 15 或更新版本。macOS 14 可改用 Google 或其他支援的翻譯服務。