FluentRead 雙語閱讀與翻譯設定

FluentRead 是開源瀏覽器擴充功能，可在原文下方顯示譯文，並提供選取翻譯、AI 閱讀卡、學習紀錄、文件閱讀與支援平台的雙語字幕。輸入為網頁文字、選取句子、文件或可讀取字幕；輸出與可用操作取決於安裝版本、瀏覽器及所選翻譯服務。

基本網頁翻譯可使用免 API key 的免費服務。AI 解說需另有可用的 AI 服務與模型；使用本機模型也只改變對應功能的處理路徑，不能推論所有工具都離線執行。

官方 README 提供下列安裝入口。從對應瀏覽器安裝後，重新整理已開啟的網頁，再固定工具列上的 FluentRead 圖示。

Chrome 可從網址列旁的擴充功能選單找到 FluentRead，再點選固定圖示。其他瀏覽器的固定入口可能不同；以能打開 FluentRead 選單為檢查起點。

網頁選取卡不會因開啟就自動呼叫 AI。使用者主動啟動學習操作時，才將選取內容與允許的語境送往設定的服務。

在 Settings → Translation services 選擇服務，依供應商填入 URL、金鑰與必要欄位；AI 服務還需選擇帳號可用的模型。按下 Check connection 會送出短請求，可能使用額度；成功只證明該次檢查通過。

1. 確認供應商支援所需語言，並核對帳號的 API 額度、地區與模型權限。

2. 完成連線設定與檢查後，選擇 Set as default translation service。

3. 以一小段一般文字測試，再翻譯整篇文章。

4. 文件、字幕與閱讀卡可有不同服務設定，逐一核對正在使用的服務。

免費服務的自動分配或備援可能將同一段文字送往另一供應商。若只允許單一供應商接收內容，停用其他候選服務，或直接選擇該供應商的獨立服務。

額外 AI 語境與 AI 多段翻譯預設關閉。啟用語境會增加提交的網頁內容，可能影響額度與等待時間；語境有範圍限制，仍需核對術語與重要資訊。

Ollama 的預設位址為 http://127.0.0.1:11434，不需 API key；其他裝置或連接埠需依文件提供完整的 /v1/chat/completions URL。較慢的電腦可在 Request limits → Entire service → Custom 將並行數設為 1，再觀察回應與資源用量。

本機模型首次下載仍需網路，下載大小也不等於執行時記憶體用量。模型檔保留於目前瀏覽器，設定備份不包含模型；Ollama 自行管理模型常駐狀態。

文件匯入與下載

開啟 Document translation 後匯入檔案，或提供線上 PDF 的直接連結。若連結需要登入而無法開啟，先下載檔案，再從本機匯入。

文件可暫停、續譯與重試，已完成的結果與編輯會保留。更換語言或部分設定後執行 Retranslate 會取代原有譯文與人工編輯；需要保留時先下載目前版本。

未翻譯的段落在部分下載中保留原文，下載不代表全部內容都已翻譯。掃描辨識、公式與專業術語仍可能有誤，請對照原始檔；瀏覽器資料被清除也可能使本機文件與編輯紀錄消失。

影片與會議字幕

官方文件列出 YouTube、X、Udemy、Disney+ 及 Google Meet、Teams、Zoom 網頁會議等路線。多數情境需要平台本身提供可讀字幕，帳號、地區、播放器與會議主持權限也可能限制可用性。

先啟用 Video subtitle translation，再開啟播放器原生字幕。X 上沒有字幕的影片可在支援的桌面 Chrome、Edge、Firefox 擴充功能使用瀏覽器內 Whisper；首次需下載模型，文件限制每部影片最長 20 分鐘。

Whisper 辨識可以在本機執行，但辨識後的文字仍可能送給所選翻譯服務。FluentRead 不會替沒有字幕的會議產生字幕，也不控制桌面會議程式。

Userscript 需搭配 Tampermonkey、Violentmonkey、Via 或 Safari Userscripts 等相容管理器。只保留一份 FluentRead 腳本，確認站點權限與腳本已啟用，再重新載入一般網頁。

原生 Safari 預覽仍缺少 Chrome 內建翻譯、圖片 OCR、區域擷取及部分平台功能。iOS 系統影片全螢幕不顯示一般網頁覆蓋層；目前文件描述的系統字幕路徑仍需實體裝置驗證。

AI 句構的角色標示與詞性是不同層次，分析也可能因模型輸出格式而退回文字說明。將結果當成閱讀參考，對照原句與上下文；重要專業用語可搭配術語表維持一致。

此範例使用可公開閱讀的一般文章，目標為繁體中文。先使用免費翻譯，不配置 API key；AI 解說留作已具備可用服務時的選項。

本例依官方介面文件整理；本次研究未執行外掛。實際驗收時，記錄瀏覽器、已安裝版本、服務、語言與文章網址，並保留已遮蔽私人內容的畫面。

設定與學習紀錄預設留在本機；雲端翻譯會把相關文字送給所選供應商，備援也可能改由其他供應商接收。額外 AI 語境、文件內容與字幕各有處理路徑，使用敏感資料前先核對對應功能及服務。

API key 會持續保存在本機設定，不是關閉瀏覽器即清除的暫存憑證。設定儲存的加密使用公開的應用程式材料，不能視為使用者自有密碼的秘密保護；可存取瀏覽器設定檔或備份的人仍可能讀取憑證。

Google Drive 與 WebDAV 的雲端設定備份由使用者手動執行，修改設定不會自動上傳。敏感設定的同意會保存在目前瀏覽器，直到關閉該選項；取消、失敗或更換帳號不會自動清除這項選擇。

官方備份文件與隱私文件說明，關閉敏感設定、撤銷授權或卸載不會刪除舊雲端檔。需要移除既有秘密時，確認儲存或合併基本設定，並另外管理雲端歷史版本及其他副本。

免費端點、服務模型與瀏覽器限制會變動，文件中的功能也可能尚未進入所用商店版本。回報時提供實際安裝版本及可公開重現的步驟；文字辨識、翻譯與 AI 解說均需人工核對重要內容。

一般讀者可直接使用商店版。需要研究或修改程式時，固定至本次查證 commit，依 .nvmrc 使用 Node.js 22.23.4，並透過 Corepack 採用套件指定的 pnpm 12.18.0。

corepack pnpm dev 啟動本機開發；Chrome 打包入口為 corepack pnpm zip。這些是上游工程命令，本次研究未執行安裝、建置或外掛載入測試。

維護者發版文件另列 Edge、Firefox、Userscript 與 Safari 的建置方式。產生 ZIP 不代表已完成商店審核或簽署；Firefox 與 Safari 等平台還有各自的分發流程。

先完成基本翻譯與還原，再依需求設定 AI、文件或字幕的服務。需要減少文字對外傳送時，評估本機翻譯路徑並逐項確認其他工具的網路行為。

• 官方使用指南：查詢目前介面與支援範圍。

• 來源儲存庫與 Issues：回報版本、公開網址、重現步驟與遮蔽後的畫面。

• GPL-3.0 授權檔：散布或修改程式前，連同第三方授權聲明閱讀。

官方 README 歡迎程式碼、文件、介面翻譯及網站適配的貢獻。先以可重現的單一問題描述預期與實際結果，再提出對應修改。