LangForge
LangForge 使用者教學
適用於 Windows 平台的開源遊戲 AI 即時翻譯工具，支援主流雲端引擎與 OLLAMA 本地引擎、截圖翻譯、攻略分析與自動擷取。
什麼是 LangForge？
LangForge 是一款專為遊戲玩家設計的開源 AI 輔助翻譯工具，運行於 Windows 作業系統。它能自動偵測遊戲視窗、擷取畫面，並透過 AI 引擎將畫面中的外文即時翻譯成你指定的語言，翻譯結果以半透明疊圖方式顯示在原圖上方。支援雲端與本地（OLLAMA）雙模式，主流雲端引擎均可免費或低成本使用。
原始碼開放於 GitHub，歡迎自由使用、修改與貢獻。
LangForge 主介面截圖（翻譯操作頁籤）
主要功能
- 即時翻譯：截圖後 AI 直接辨識並翻譯畫面上所有目標語言文字，定位準確，支援橫排與直排。
- 攻略分析：AI 同步列出 3～5 條具體攻略建議，讓你邊玩邊查。
- 自動擷取：畫面穩定偵測機制，場景靜止後自動翻譯，無須手動操作。
- 場次錄製：一鍵錄製完整遊戲翻譯場次，事後可回放複習劇情。
- 主流雲端引擎：支援 Gemini / Groq / Mistral / OpenAI / Claude / Grok，免費額度可多引擎備援自動切換。
- 本地 OLLAMA 引擎：完全離線翻譯，不需 API Key，保護隱私。
- 本地 OCR 模式：EasyOCR 辨識座標搭配 Google 翻譯，完全免費，無需任何 API Key。
- 雙語介面：程式介面支援繁體中文與 English，可於選單列隨時切換。
- 深色 / 淺色主題：可依個人喜好切換視窗主題色調。
- 平台編輯器：直接在程式內管理遊戲平台與模擬器分類，無需手動編輯 JSON。
系統需求
| 項目 | 需求 |
|---|---|
| 作業系統 | 建議 Windows 10 / 11（64-bit）；Windows 7 / 8 可嘗試但不保證相容 |
| 網路 | 使用雲端引擎時需連線；OLLAMA 本地模式可離線使用 |
| API Key | 使用雲端引擎需至少一組 API Key；OLLAMA 與本地 OCR 模式無需 |
| 儲存空間 | 翻譯截圖與場次錄製會累積於本機，建議預留至少 2 GB 以上空間 |
| 顯示卡（OLLAMA 專用） | 建議具備支援 CUDA 的 NVIDIA GPU（4 GB VRAM 以上）；無 GPU 亦可使用 CPU 推理，但速度較慢 |
| OLLAMA（選用） | 若要使用本地引擎，需另行安裝 OLLAMA 並下載 VLM 模型 |
| EasyOCR（選用） | 使用本地 OCR 模式需安裝：pip install easyocr |
程式沿革 / 版本歷程
- 新增疊字顯示設定：可自訂翻譯疊圖的字體大小
- 新增自動備援設定：可選擇「只考慮已填入 API Key 的引擎」進行備援切換
- 歷史翻譯新增遊戲名稱重新命名功能（雙擊遊戲名稱即可修改）
- 程式整體優化與穩定性改善
- 版本號正式升至 V1.1.0，脫離 beta 測試階段
- 各引擎模型清單更新，現可自動拉取最新 VLM（視覺語言模型）清單
- 疊圖字體依目標語言自動選擇最適合的系統字型（韓 / 日 / 俄 / 歐文各自對應）
- 程式整體優化與效能調整
- 版本號正式升至 V1.1.0，脫離 beta 測試階段
- 各引擎模型清單更新，現可自動拉取最新 VLM（視覺語言模型）清單
- 疊圖字體依目標語言自動選擇最適合的系統字型（韓 / 日 / 俄 / 歐文各自對應）
- 程式整體優化與效能調整
- 新增深色 / 淺色主題切換（選單列「檢視 → 切換視窗主題」）
- 新增平台編輯器：可直接在程式內新增、改名、刪除遊戲平台與模擬器
- OLLAMA 引擎新增「僅顯示 VLM（視覺語言模型）」篩選功能
- 三層執行環境自動偵測（開發 / Git 模組化 / 發佈 EXE），路徑管理全面重構
- 狀態訊息大量補全：API Key 無效、429 限流、503 服務繁忙、佇列滿載等提示
- 新增 Grok（xAI）引擎支援：grok-2-vision-1212 / grok-4
- 新增場次錄製功能（Tab 6）：可錄製並回放完整遊戲翻譯場次
- 自動擷取翻譯機制優化，強化畫面穩定偵測邏輯
- Mistral 模型更新：新增 mistral-medium-latest 視覺旗艦模型
- Groq 新增 gpt-oss-120b 高品質推理模型
- 引擎總數擴增至六種（Gemini / Groq / Mistral / OpenAI / Claude / Grok）
- 修正執行檔的設定檔位置問題
- 補上相關依賴項
- 🎉 GitHub 開源發布，原始碼正式公開
- 新增 🔍 本地 OCR + Google 翻譯模式（EasyOCR 辨識座標，無需 API Key）
- 新增 OLLAMA 本地引擎支援（離線翻譯）
- 新增 🖱 點選視窗功能（5 秒內點選目標視窗自動填入）
- API Key 以機器碼加密儲存（XOR + base64）
- Request Queue 機制，防止請求堆疊
- 歷史翻譯新增 ROM 名稱欄位
- GitHub 開源發布
- 新增 OpenAI（gpt-4.1 系列）與 Claude（Sonnet / Haiku / Opus）引擎
- 五引擎完整支援，可自訂模型清單
- UI 介面語言切換（中文 / English）
- 多螢幕環境支援
- 新增 Groq（Llama 4）與 Mistral（Pixtral）免費引擎
- 攻略分析功能（歷史攻略 Tab）
- 全域快捷鍵支援
- 自動擷取翻譯（畫面穩定偵測）
- 歷史翻譯紀錄（SQLite）
- 更新安裝封裝，修正部分環境下無法啟動的問題
- 更新 SHA256 雜湊值驗證資訊
- 修改啟動時功能提示視窗：從每次啟動顯示改為循環顯示
- 🎉 首個公開對外發布版本，開放免費下載
- 修正安裝封裝問題，EXE 可直接執行無需額外環境
- 新增 SHA256 檔案驗證資訊於 README.TXT
- 首個測試版建立，Gemini 引擎 / gemini-2.5-flash
- 基礎翻譯操作與擷取設定功能
- 內部測試用，未對外發布
下載區
LangForge 原始碼已正式在 GitHub 上架，並提供打包好的執行檔供直接下載使用。
1E9DF0E89E91E9D799E56049E7F5FBA5D08C36E6706F4140F38E38413697FE80
Get-FileHash .\LangForge.exe -Algorithm SHA256
- Windows 10 / 11（64 位元）
- 雲端引擎：需申請 API Key
- 本地引擎：需安裝 OLLAMA
安裝與啟動
LangForge 以 Windows 應用程式形式發布，下載後即可直接執行，無需額外安裝環境。
下載安裝程式
前往上方下載區或 GitHub Releases 頁面下載最新版本。
執行安裝
雙擊安裝程式，依照精靈指示完成安裝。安裝完畢後桌面與開始選單將自動建立捷徑。
啟動 LangForge
雙擊桌面捷徑或從開始選單啟動。首次執行請於「翻譯操作」頁籤填入 API Key 後即可開始使用。
取得 API Key
LangForge 支援主流雲端引擎與本地 OLLAMA，你可依需求選擇。雲端引擎需申請對應的 API Key，本地 OLLAMA 模式則完全免費且不需網路。
| 引擎 | 費用 | 申請網址 | 備註 |
|---|---|---|---|
| Gemini |
免費額度 | aistudio.google.com | 依模型而異：gemini-3-flash 500 RPD；gemini-2.5-flash 20 RPD（RPM=5） |
| Groq Meta/Groq |
免費額度 | console.groq.com | Llama 4 Scout 免費 1000 RPD |
| Mistral Mistral AI |
免費額度 | console.mistral.ai | 免費 200～500 RPD |
| OpenAI OpenAI |
付費 | platform.openai.com | gpt-4.1-mini / 4.1 / 4o |
| Claude Anthropic |
付費 | console.anthropic.com | claude-haiku-4-5 / claude-sonnet-4-6 / claude-opus-4-6 |
| Grok xAI |
付費 | console.x.ai | grok-2-vision-1212 / grok-4 |
| 🦙 OLLAMA 本地引擎 |
完全免費 | ollama.com | 無需 API Key，需本地安裝 |
| 🔍 本地 OCR EasyOCR + Google 翻譯 |
完全免費 | — | 無需 API Key，需安裝 easyocr |
輸入 API Key
啟動 LangForge 後，在「翻譯操作」頁籤的 API Key 欄位輸入你的金鑰。
翻譯操作頁籤中 API Key 輸入欄位
翻譯操作（Tab 1）
翻譯操作是 LangForge 的核心頁籤。程式介面提供繁體中文與English兩種語言，可於選單列「檢視 → 切換介面語言」隨時切換。
引擎模式選擇
LangForge 提供三種引擎模式，可依需求選擇：
透過 API 呼叫 Gemini / Groq / Mistral / OpenAI / Claude / Grok，翻譯品質高。需要網路與 API Key，受 RPD / RPM 配額限制。
在本機執行 AI 模型，完全離線、無配額限制，翻譯次數無上限。需安裝 OLLAMA 並具備足夠硬體效能。
EasyOCR 在本機辨識文字座標，搭配 Google 翻譯輸出，完全免費且無需 API Key。適合輕量離線使用，但翻譯精準度相對較低。
視窗擷取翻譯
LangForge 自動擷取目標遊戲視窗的畫面，傳送給 AI 引擎翻譯，再以疊圖方式顯示結果。
設定目標視窗
至「擷取設定」頁籤輸入遊戲視窗標題的部分文字（部分匹配即可），例如模擬器名稱 Mesen。也可點擊「🖱 點選視窗」按鈕，於 5 秒內點選目標視窗自動填入。
選擇引擎與語言
選擇翻譯引擎（☁ 雲端引擎 / 🦙 本地 OLLAMA / 🔍 本地 OCR）與對應模型，設定「遊戲語言」與「譯文語言」。
點擊「視窗擷取翻譯」
點擊按鈕觸發翻譯，或使用快捷鍵（預設 Ctrl+F2）。
查看翻譯疊圖
翻譯結果以半透明黑底白字疊加在遊戲截圖上，自動定位至對應文字區塊位置。
翻譯結果疊圖顯示示例（日文 RPG 翻譯成正體中文）
圖片翻譯
點擊「選擇圖片翻譯」按鈕，選取 PNG / JPG 圖片檔案，AI 將直接分析該圖片並輸出翻譯疊圖。
自動擷取翻譯
自動擷取的用意是讓你不需要每次手動按快捷鍵——LangForge 會持續在背景監測遊戲畫面，當偵測到畫面停止變動（對話框出現、劇情停頓等）且維持穩定一定時間後，自動觸發截圖並送出翻譯。這對於對話密集的 JRPG 或視覺小說尤其實用，讓你能專心遊玩而不被操作打斷。
- 差異門檻：相鄰截圖的平均像素差，低於此值視為畫面靜止（預設 10）。
- 穩定次數：連續幾次均低於門檻才觸發翻譯（預設 4 次，約 2 秒）。
自動擷取開啟狀態下的介面截圖
文字排版模式
- 橫排（文句左至右）：適合英文、歐美遊戲。
- 直排（文上至下、句右至左）：適合日系傳統 RPG、視覺小說。
疊圖字體會依你設定的「譯文語言」自動選擇最合適的系統字型，例如日文使用 Meiryo、韓文使用 Malgun Gothic、歐文使用 Arial，確保譯文正確顯示。
擷取設定（Tab 2）
視窗依附模式
翻譯疊圖視窗有四種顯示位置可選：
翻譯結果視窗跟隨 LangForge 主視窗移動。
翻譯結果視窗緊貼遊戲視窗旁邊顯示。
翻譯顯示於右上角，攻略顯示於右下角。
攻略顯示於遊戲視窗左側，翻譯顯示於右側。
四種視窗依附模式示意圖
快捷鍵設定
LangForge 支援兩組全域快捷鍵：
- 擷取翻譯快捷鍵（預設 Ctrl+F2）
- 攻略資訊快捷鍵（獨立觸發攻略分析）
頂部裁切（Crop Top）
若遊戲視窗有選單列，可設定裁切頂部的像素數（例如 30px）。設為 0 表示不裁切。
主視窗位置
可設定 LangForge 主視窗停靠在螢幕的固定位置，方便在多螢幕環境下操作，避免主視窗與遊戲畫面重疊。
OLLAMA VLM 篩選器
使用本地 OLLAMA 引擎時，可勾選「僅顯示 VLM（視覺語言模型）」篩選器，模型清單將只顯示支援圖片輸入的多模態模型，避免誤選純文字模型導致翻譯失敗。
自動備援設定
在「翻譯操作」頁籤可設定自動備援策略：勾選「只考慮已填入 API Key 的引擎」後，當模型配額用完自動切換時，LangForge 只會嘗試你已設定 API Key 的引擎，避免切換到未設定的引擎而報錯。
主視窗位置
可設定 LangForge 主視窗固定停靠在螢幕的哪個位置，方便在多螢幕環境下快速找到主控台。
OLLAMA VLM 篩選器
使用 OLLAMA 本地引擎時，可勾選「僅顯示 VLM（視覺語言模型）」，過濾掉不支援圖片輸入的純文字模型，避免選錯模型導致翻譯失敗。
引擎配額（Tab 3）
顯示今日每個 AI 模型的使用次數與每日上限（RPD）。配額依太平洋時間（PST/PDT）重置。
- RPD（每日請求上限）：免費方案每天只能呼叫固定次數。每次截圖翻譯消耗 1 次；自動擷取或場次錄製模式下頻繁截圖會快速消耗配額。
- RPM（每分鐘請求上限）：短時間內連續翻譯（如自動擷取）可能觸發冷卻，LangForge 會自動等待冷卻時間後再送出下一次請求。
- OLLAMA 本地引擎：完全不受 RPD / RPM 限制，翻譯次數無上限，速度僅取決於你的硬體效能（GPU / CPU），適合高頻翻譯場景。
- 本地 OCR 模式：EasyOCR 在本機執行，Google 翻譯使用免費公開端點，同樣不受 API 配額限制，但大量使用仍建議適度控制頻率。
引擎配額頁籤截圖（各模型今日使用量）
歷史翻譯（Tab 4）
每次翻譯完成後，程式自動將截圖與翻譯結果儲存至本機 SQLite 資料庫。
- 依遊戲名稱 / 視窗 / 平台篩選紀錄。
- ROM 名稱欄位：紀錄清單顯示 ROM 檔名，方便辨識同一模擬器下的不同遊戲。
- 重新命名遊戲：雙擊遊戲名稱可重新命名，點擊「套用改名」後將更新所有相關紀錄。
- 切換「疊圖模式」（翻譯文字疊加於截圖上）或「純圖模式」（僅顯示原始截圖）。
- 修正平台：若平台分類有誤，可在此重新選擇並點擊「套用至此遊戲所有紀錄」，一次修正該遊戲的全部歷史紀錄。
- 點擊「刪除此筆」移除單筆紀錄。
歷史翻譯頁籤截圖
歷史攻略（Tab 5）
勾選「截取翻譯時同時要求攻略」，或點擊「目前攻略資訊」，AI 會同步回傳：
- 目前進度：一句話描述玩家所在位置與劇情進度。
- 攻略建議：3～5 條具體建議，包含必拿道具、任務方向、隱藏要素。
AI 攻略建議顯示示例
歷史錄製（Tab 6）
場次錄製的用意是讓你將整段遊戲翻譯過程完整保存下來。啟動錄製後，LangForge 會自動將每一次翻譯的截圖與譯文依序記錄成一個「場次」；結束後可隨時回放，畫面會按照當時的順序重現所有翻譯幀。
這個功能適合以下情境：
- 回頭複習長篇劇情，不需重複遊玩
- 整理並查閱遊戲中出現過的所有對話翻譯
- 與朋友分享翻譯紀錄
- 在「翻譯操作」頁籤點擊「開始場次錄製」後，每次截圖翻譯都會自動存入場次。
- 點擊「結束錄製」完成錄製，場次資料儲存於「歷史錄製」（Tab 6）。
- 選取場次後點擊「▶ 回放此場次」即可重播所有翻譯幀；回放中可使用「⏸ 暫停」與「▶ 繼續」控制播放進度。
- 延遲播放模式：錄製進行中即可同步開啟播放視窗（🎬 LangForge 延遲播放），以固定延遲追蹤最新翻譯幀，適合直播或實況場景。
OLLAMA 本地引擎
除主流雲端引擎外，LangForge 亦支援 OLLAMA 本地引擎模式，讓你在完全離線的環境下進行翻譯，無需 API Key，保護隱私。
安裝 OLLAMA
前往 ollama.com 下載並安裝 OLLAMA，完成後於命令列執行 ollama serve 啟動服務。
下載模型
執行 ollama pull 模型名稱 下載支援視覺的多模態模型，例如 ollama pull llava。
在 LangForge 切換至本地引擎
在「翻譯操作」頁籤選擇「🦙 本地引擎 (OLLAMA)」，LangForge 會自動偵測已安裝的模型清單供你選擇。
引擎比較
| 引擎 | 推薦模型 | 免費額度 | 適合場景 |
|---|---|---|---|
| Gemini Flash | gemini-3-flash | 500 RPD | 新一代 Flash，多語言翻譯，視覺理解強 |
| Gemini Lite | gemini-2.5-flash-lite | 500 RPD | 高配額，高頻使用，輕量快速 |
| Groq | llama-4-scout-17b | 1000 RPD | 高頻翻譯，速度極快 |
| Mistral | mistral-small-latest | 500 RPD | 視覺支援，高配額，複雜排版佳 |
| OpenAI | gpt-4.1-mini | 付費 | 翻譯品質穩定 |
| Claude | claude-sonnet-4-6 | 付費 | 語意理解強，長文本佳 |
| 🦙 OLLAMA | （本地模型） | 完全免費 | 離線使用，隱私保護，需自備硬體 |
| Grok | grok-2-vision-1212 | 付費 | xAI 旗艦視覺模型，多模態理解強 |
| 🔍 本地 OCR | EasyOCR + Google 翻譯 | 完全免費 | 無需 API Key，適合輕量離線使用 |
平台 / 模擬器設定
翻譯紀錄會附記遊戲平台資訊（如 FC、SFC、PS1）或模擬器名稱（如 Mesen、RetroArch）。在「翻譯操作」頁籤選擇紀錄方式：
- 以遊戲平台為主：選擇主類別（如 任天堂）及子平台（如 SFC）。
- 以模擬器為主：選擇正在使用的模擬器軟體。
贊助支持
LangForge 由個人獨立開發，完全開源且無廣告。如果你覺得這個工具對你有幫助，歡迎透過以下方式支持開發者，讓更多功能得以持續更新 🙏
疑難排解
找不到目標視窗
確認「目標視窗標題」欄位中輸入的文字與遊戲 / 模擬器視窗標題相符（部分匹配即可）。也可使用「🖱 點選視窗」功能直接點選目標視窗。
翻譯結果文字位置跑掉
可嘗試切換不同模型，或調整「文字排版模式」（橫排 / 直排）。
所有模型額度已用完
免費模型每日有請求上限，用完後須等隔日太平洋時間重置。建議設定多個引擎 API Key 以自動備援切換。
快捷鍵無法運作
在捷徑上按右鍵選擇「以系統管理員身分執行」。部分防毒軟體可能封鎖全域鍵盤監聽，可嘗試加入防毒允許清單。
JSON 解析失敗
AI 偶爾回傳格式不正確的 JSON，LangForge 會自動嘗試修復。若持續發生，請更換模型。
OLLAMA 本地引擎無回應
確認 OLLAMA 服務正在執行（ollama serve），並已下載所選模型（ollama pull 模型名稱）。若推理時間過長，可在擷取設定中增加 Timeout 秒數，或改用較小的模型。
翻譯結果空白 / 無文字輸出
OCR 模式下，EasyOCR 若信心值不足會略過辨識結果；雲端引擎或 OLLAMA 若判斷畫面無可翻譯文字也會靜默略過。可嘗試：調高截圖亮度、換用較大的模型，或改用其他引擎模式。
429 限流 / 503 服務繁忙
429：短時間請求次數超過引擎的 RPM 上限，LangForge 會自動等待冷卻後重試，無需手動操作。若頻繁發生，可降低自動擷取的觸發頻率或增加穩定次數設定。
503：引擎伺服器暫時繁忙，通常幾秒後自動恢復，可稍待後重試或切換至其他引擎。
切換至 OCR 模式後出現套件錯誤
本地 OCR 模式需要額外安裝 easyocr 套件。請開啟命令提示字元執行：pip install easyocr，安裝完成後重新啟動 LangForge 即可。
Copyright © 2026 GoOnSoft. All rights reserved.