NodeLane 漫譯
下載插件
繁體中文

本機翻譯教學

本機漫畫翻譯教學：將 manga-translator-ui 連接至 NodeLane

從啟動 manga-translator-ui Web 服務、填寫位址與帳號，到在瀏覽器翻譯第一張漫畫，逐步完成本機翻譯設定，並排查連線、密碼、等待及快取問題。

NodeLane 漫譯 編輯團隊8 分鐘

截圖來自真實桌面擴充功能，提供中、日、韓、英四版；漫畫樣張為專案原創。連線表單僅展示設定入口，不代表已連線服務。

開始前：準備擴充功能與翻譯服務

NodeLane 漫譯負責在瀏覽器閱讀漫畫，manga-translator-ui（以下簡稱 MTU）負責處理圖片。連接自己的 MTU 服務不需要 NodeLane 帳號，也不消耗官方翻譯額度；硬體、模型或第三方 API 的費用由你自行負擔。

請準備桌面瀏覽器中的最新版擴充功能、已安裝相依套件的 MTU，以及該服務的使用者名稱和密碼。本教學以同一台電腦上的 http://127.0.0.1:8000 為例，連接埠請依實際服務調整。

第一步：啟動 MTU 的 Web 服務

擴充功能需要能透過 HTTP 存取的 Web 服務，只開啟 MTU 桌面視窗還不夠。完成官方安裝流程後，在 MTU 專案目錄執行以下指令，並保持服務運作。已透過 Docker 或其他方式啟動 Web 服務者可略過此指令。

此範例未啟用 GPU；已設定好支援的 GPU 環境者，可依官方說明加入 --use-gpu。模型、驅動程式及硬體需求以所安裝的 MTU 版本為準。

uv run --no-sync python -m manga_translator web --host 127.0.0.1 --port 8000

第二步：先在服務頁面完成一次翻譯

用瀏覽器開啟 http://127.0.0.1:8000，完成 MTU 的帳號初始化並登入。如果服務要求變更初始密碼，請先在服務頁面修改，再連接擴充功能。此處使用 MTU 帳號，與 NodeLane 帳號分開。

在服務端設定翻譯器、模型及所需 API Key，以一張有權處理的測試圖確認能產生譯圖。擴充功能只指定目標語言，其餘參數使用服務端預設值；請確認 Web 服務已套用預期設定。不要將模型 API Key 填入擴充功能的密碼欄位。

第三步：新增翻譯管道

第三步：新增翻譯管道
第三步：新增翻譯管道檢視大圖 ↗

開啟擴充功能的設定頁面，找到翻譯管道區塊。連線成功後，擴充功能會將密碼和服務權杖儲存於本機。重新連接相同服務位址和使用者名稱時，可將密碼留空以使用已儲存的密碼；變更位址或使用者名稱，或密碼已變更、失效時，請重新輸入密碼。以下名稱對應介面中相同用途的控制項。儲存密碼及留空密碼重新連線需擴充功能 0.10.2 或更新版本；較舊版本每次重新連線都需輸入密碼。

  1. 點選新增翻譯管道，確認服務類型為 manga-translator-ui；可填寫容易辨識的名稱，例如「我的電腦」。
  2. 服務位址填入 http://127.0.0.1:8000。請填服務根位址，不要加上 /auth/login、/translate/with-form/image 或管理頁面路徑。
  3. 填寫 MTU 的使用者名稱與密碼，點選連接並使用。連線不會另外申請該位址的存取權限；若瀏覽器已限制存取，請在擴充功能設定中恢復「所有網站」存取後重試。
  4. 連線完成後，確認目前管道為剛新增的服務。可以儲存多個服務設定，但每次只使用目前選取的一個。

第四步：選擇翻譯，閱讀第一張譯圖

第四步：選擇翻譯，閱讀第一張譯圖
第四步：選擇翻譯，閱讀第一張譯圖檢視大圖 ↗

匯入本機漫畫或 EPUB，或從已適配網站、OPDS 開啟閱讀器。選擇目標語言與翻譯，先確認目前圖片的結果。擴充功能的官方與 MTU 管道都支援圖片翻譯；EPUB 正文不翻譯。

擴充功能優先處理目前圖片，依閱讀位置補齊有限的相鄰圖片，同一 MTU 管道逐張執行。切回原圖或並排對照均保留位置；網頁整頁、右鍵單圖與劃圖也使用目前管道。

若某頁失敗，先處理該頁提示的原因，再手動重試。關閉頁面或連線中斷不代表 MTU 已停止運算，服務仍忙碌時請避免重複提交。

連線失敗、登入失敗或一直等待，如何排查？

先確認 MTU 本身能正常運作，再回到擴充功能重試。回報問題時不要分享密碼、權杖或完整私人漫畫。

現象檢查與處理
無法開啟服務位址確認 Web 服務仍在執行且連接埠正確。127.0.0.1 指瀏覽器所在電腦；服務位於另一台裝置時，請使用該裝置實際可連線的位址。
瀏覽器能開啟，擴充功能卻無法連接檢查是否誤填管理頁面路徑、是否授予位址存取權限，以及 MTU 版本是否提供相容的登入與圖片翻譯介面。
帳密錯誤或要求變更初始密碼先在 MTU 頁面登入或變更初始密碼，再重新連接。使用 MTU 帳密，不使用 NodeLane 密碼或模型 API Key。
原本可用，現在登入失效在管道設定選擇重新連接。相同服務位址和使用者名稱可留空密碼，使用已儲存的密碼；舊版僅儲存權杖的設定，首次重新連接時需補填一次密碼。變更位址或使用者名稱，或密碼已變更、失效時，請重新輸入密碼。擴充功能不會自動重送上一次翻譯。儲存密碼及留空密碼重新連線需擴充功能 0.10.2 或更新版本；較舊版本每次重新連線都需輸入密碼。
已連接但翻譯一直等待檢查模型下載、引擎載入、佇列、API 餘額與硬體資源；在 MTU 頁面測試相同設定。連線成功只表示登入可用。
中斷、逾時或回傳內容不是圖片檢查 MTU 任務、反向代理逾時與回傳內容，修復後手動重試失敗頁。擴充功能不會從 MTU 歷史任務自動恢復結果。

快取、離線與圖片去向

本機管道的譯圖快取存放於目前瀏覽器的本機儲存空間。清除快取，或將譯圖快取容量設為 0 並關閉仍持有譯圖的頁面，可能使結果遺失；需要時只能手動重新翻譯，無法從 MTU 自動補回。

圖片會傳送至你選取的 MTU 服務。本機執行 MTU 不等於全程離線：若使用線上翻譯器、OCR 或圖像模型，相關文字或圖片仍可能交由供應商處理。能否離線產生新譯圖，取決於原圖、模型及完整處理流程。