LangForge LangForge
Page Update: 2026-04-09
langforge/docs

LangForge 使用者教學

適用於 Windows 平台的開源遊戲 AI 即時翻譯工具，支援主流雲端引擎與 OLLAMA 本地引擎、截圖翻譯、攻略分析與自動擷取。

作者：Toya Kyo　／　Copyright © 2026 GoOnSoft. All rights reserved.

什麼是 LangForge？

LangForge 是一款專為遊戲玩家設計的開源 AI 輔助翻譯工具，運行於 Windows 作業系統。它能自動偵測遊戲視窗、擷取畫面，並透過 AI 引擎將畫面中的外文即時翻譯成你指定的語言，翻譯結果以半透明疊圖方式顯示在原圖上方。支援雲端與本地（OLLAMA）雙模式，主流雲端引擎均可免費或低成本使用。

原始碼開放於 GitHub，歡迎自由使用、修改與貢獻。

測試階段公告
LangForge 目前仍處於積極開發階段，功能規格與介面設計均為未定案，可能隨時調整變更。如有問題或建議，歡迎加入官方 FB 社群討論。
加入 LangForge Facebook 社群
LangForge 主介面截圖（翻譯操作頁籤） LangForge 主介面截圖（翻譯操作頁籤）

主要功能

即時翻譯

截圖後 AI 直接辨識並翻譯畫面上所有目標語言文字，定位準確，支援橫排與直排。

攻略分析

AI 同步分析目前遊戲進度，列出 3～5 條具體攻略建議，讓你邊玩邊查。

自動擷取

畫面穩定偵測機制，場景靜止後自動翻譯，無須手動操作。

雙語介面

程式介面支援繁體中文與English切換，可於選單列隨時變更，翻譯輸出語言亦可自由選擇。

本地 OLLAMA 引擎

支援本地 OLLAMA 離線翻譯，不需 API Key，適合有自架模型需求的用戶，保護隱私。

多引擎備援

當前模型達到每日免費額度上限時，自動切換至下一個可用引擎，確保翻譯不中斷。

本地 OCR 模式

使用 EasyOCR 在本機辨識文字座標，搭配 Google 翻譯輸出結果，完全不需要 API Key。

場次錄製

一鍵錄製整個遊戲翻譯場次，儲存所有翻譯幀與截圖，事後可完整回放，方便複習劇情或查找遺漏內容。

系統需求

項目 需求
作業系統 Windows 10 / 11（64-bit 建議）
網路 使用雲端引擎時需連線；OLLAMA 本地模式可離線使用
API Key 使用雲端引擎需至少一組 API Key；OLLAMA 本地模式無需
OLLAMA（選用） 若要使用本地引擎，需另行安裝 OLLAMA 並下載模型
EasyOCR（選用） 使用本地 OCR 模式需安裝：pip install easyocr
注意
LangForge 目前僅支援 Windows，Linux / macOS 暫不支援。

程式沿革 / 版本歷程

V1.0.1-beta.7 2026-04-07
  • 新增 Grok（xAI）引擎支援：grok-2-vision-1212 / grok-4
  • 新增場次錄製功能（Tab 6）：可錄製並回放完整遊戲翻譯場次
  • 自動擷取翻譯機制優化，強化畫面穩定偵測邏輯
  • Mistral 模型更新：新增 mistral-medium-latest 視覺旗艦模型
  • Groq 新增 gpt-oss-120b 高品質推理模型
  • 引擎總數擴增至六種（Gemini / Groq / Mistral / OpenAI / Claude / Grok）
V1.0.1-beta.6 2026-04-02
  • 修正執行檔的設定檔位置問題
  • 補上相關依賴項
V1.0.1-beta.5 2026-03-31
  • 🎉 GitHub 開源發布，原始碼正式公開
  • 新增 🔍 本地 OCR + Google 翻譯模式（EasyOCR 辨識座標，無需 API Key）
  • 新增 OLLAMA 本地引擎支援（離線翻譯）
  • 新增 🖱 點選視窗功能（5 秒內點選目標視窗自動填入）
  • API Key 以機器碼加密儲存（XOR + base64）
  • Request Queue 機制，防止請求堆疊
  • 歷史翻譯新增 ROM 名稱欄位
  • GitHub 開源發布
V1.0.1 2026
  • 新增 OpenAI（gpt-4.1 系列）與 Claude（Sonnet / Haiku / Opus）引擎
  • 五引擎完整支援，可自訂模型清單
  • UI 介面語言切換（中文 / English）
  • 多螢幕環境支援
V1.0.0-alpha.1 2026
  • 新增 Groq（Llama 4）與 Mistral（Pixtral）免費引擎
  • 攻略分析功能（歷史攻略 Tab）
  • 全域快捷鍵支援
  • 自動擷取翻譯（畫面穩定偵測）
  • 歷史翻譯紀錄（SQLite）
V1.0.0-beta.7 2026-03-17
  • 更新安裝封裝，修正部分環境下無法啟動的問題
  • 更新 SHA256 雜湊值驗證資訊
  • 修改啟動時功能提示視窗：從每次啟動顯示改為循環顯示
V1.0.0-beta.6 2026-03-16
  • 🎉 首個公開對外發布版本，開放免費下載
  • 修正安裝封裝問題，EXE 可直接執行無需額外環境
  • 新增 SHA256 檔案驗證資訊於 README.TXT
V1.0.0-beta.5 2026（內部測試）
  • 首個測試版建立，Gemini 引擎 / gemini-2.5-flash
  • 基礎翻譯操作與擷取設定功能
  • 內部測試用，未對外發布

下載區

LangForge V1.0.1-beta.7
開源發布・GitHub Releases

LangForge 原始碼已正式在 GitHub 上架，並提供打包好的執行檔供直接下載使用。

GitHub 原始碼 / Releases
直接下載 ZIP
SHA256 驗證（V1.0.1-beta.7）
727AC25B6663BE8C9E4C0FA1A5C27018C1263BF0DEFAE21AAB5F012A92CBD537
PowerShell 驗證指令：
Get-FileHash .\LangForge.exe -Algorithm SHA256
執行需求
  • Windows 10 / 11（64 位元）
  • 雲端引擎：需申請 API Key
  • 本地引擎：需安裝 OLLAMA

安裝與啟動

LangForge 以 Windows 應用程式形式發布，下載後即可直接執行，無需額外安裝環境。

1
下載安裝程式

前往上方下載區或 GitHub Releases 頁面下載最新版本。

2
執行安裝

雙擊安裝程式，依照精靈指示完成安裝。安裝完畢後桌面與開始選單將自動建立捷徑。

3
啟動 LangForge

雙擊桌面捷徑或從開始選單啟動。首次執行請於「翻譯操作」頁籤填入 API Key 後即可開始使用。

快捷鍵需要管理員權限
若要使用全域快捷鍵，請在捷徑上按右鍵 → 以系統管理員身分執行，否則快捷鍵可能無法正常運作。
LangForge 安裝程式畫面截圖 LangForge 安裝程式畫面截圖

取得 API Key

LangForge 支援主流雲端引擎與本地 OLLAMA，你可依需求選擇。雲端引擎需申請對應的 API Key，本地 OLLAMA 模式則完全免費且不需網路。

引擎 費用 申請網址 備註
Gemini
Google		 免費額度 aistudio.google.com 20～500 RPD，依模型不同
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 Haiku / Sonnet / Opus
Grok
xAI		 付費 console.x.ai grok-2-vision-1212 / grok-4
🦙 OLLAMA
本地引擎		 完全免費 ollama.com 無需 API Key，需本地安裝
🔍 本地 OCR
EasyOCR + Google 翻譯		 完全免費 — 無需 API Key，需安裝 easyocr
新手推薦
建議從 Gemini（Google AI Studio）開始——免費帳號即可申請，無需信用卡，支援每日免費請求額度。

輸入 API Key

啟動 LangForge 後，在「翻譯操作」頁籤的 API Key 欄位輸入你的金鑰。程式會以機器碼加密後儲存至本機，下次開啟無需重新輸入。

翻譯操作頁籤中 API Key 輸入欄位 翻譯操作頁籤中 API Key 輸入欄位

翻譯操作（Tab 1）

翻譯操作是 LangForge 的核心頁籤。程式介面提供繁體中文與English兩種語言，可於選單列「檢視 → 切換介面語言」隨時切換。

視窗擷取翻譯

LangForge 自動擷取目標遊戲視窗的畫面，傳送給 AI 引擎翻譯，再以疊圖方式顯示結果。

1
設定目標視窗

至「擷取設定」頁籤輸入遊戲視窗標題的部分文字（部分匹配即可），例如模擬器名稱 Mesen。也可點擊「🖱 點選視窗」按鈕，於 5 秒內點選目標視窗自動填入。

2
選擇引擎與語言

選擇翻譯引擎（雲端或本地 OLLAMA）與對應模型，設定「遊戲語言」與「譯文語言」。

3
點擊「視窗擷取翻譯」

點擊按鈕觸發翻譯，或使用快捷鍵（預設 Ctrl+F2）。

4
查看翻譯疊圖

翻譯結果以半透明黑底白字疊加在遊戲截圖上，自動定位至對應文字區塊位置。

翻譯結果疊圖顯示示例 翻譯結果疊圖顯示示例（日文 RPG 翻譯成正體中文）

圖片翻譯

點擊「選擇圖片翻譯」按鈕，選取 PNG / JPG 圖片檔案，AI 將直接分析該圖片並輸出翻譯疊圖。

自動擷取翻譯

自動擷取的用意是讓你不需要每次手動按快捷鍵——LangForge 會持續在背景監測遊戲畫面，當偵測到畫面停止變動（對話框出現、劇情停頓等）且維持穩定一定時間後，自動觸發截圖並送出翻譯。這對於對話密集的 JRPG 或視覺小說尤其實用，讓你能專心遊玩而不被操作打斷。

自動擷取參數說明
  • 差異門檻：相鄰截圖的平均像素差，低於此值視為畫面靜止（預設 10）。
  • 穩定次數：連續幾次均低於門檻才觸發翻譯（預設 4 次，約 2 秒）。
自動擷取開啟狀態介面 自動擷取開啟狀態下的介面截圖

文字排版模式

  • 橫排（文句左至右）：適合英文、歐美遊戲。
  • 直排（文上至下、句右至左）：適合日系傳統 RPG、視覺小說。

擷取設定（Tab 2）

視窗依附模式

翻譯疊圖視窗有四種顯示位置可選：

依附主視窗

翻譯結果視窗跟隨 LangForge 主視窗移動。

依附目標視窗

翻譯結果視窗緊貼遊戲視窗旁邊顯示。

螢幕角落

翻譯顯示於右上角，攻略顯示於右下角。

目標視窗兩側

攻略顯示於遊戲視窗左側，翻譯顯示於右側。

四種視窗依附模式示意圖 四種視窗依附模式示意圖

快捷鍵設定

LangForge 支援兩組全域快捷鍵：

  • 擷取翻譯快捷鍵（預設 Ctrl+F2）
  • 攻略資訊快捷鍵（獨立觸發攻略分析）

頂部裁切（Crop Top）

若遊戲視窗有選單列，可設定裁切頂部的像素數（例如 30px）。設為 0 表示不裁切。

引擎配額（Tab 3）

顯示今日每個 AI 模型的使用次數與每日上限（RPD）。配額依太平洋時間（PST/PDT）重置。

RPD / RPM 對翻譯的影響
  • RPD（每日請求上限）：免費方案每天只能呼叫固定次數。每次截圖翻譯消耗 1 次；自動擷取或場次錄製模式下頻繁截圖會快速消耗配額。
  • RPM（每分鐘請求上限）：短時間內連續翻譯（如自動擷取）可能觸發冷卻，LangForge 會自動等待冷卻時間後再送出下一次請求。
  • OLLAMA 本地引擎：完全不受 RPD / RPM 限制，翻譯次數無上限，速度僅取決於你的硬體效能（GPU / CPU），適合高頻翻譯場景。
  • 本地 OCR 模式：EasyOCR 在本機執行，Google 翻譯使用免費公開端點，同樣不受 API 配額限制，但大量使用仍建議適度控制頻率。
引擎配額頁籤截圖 引擎配額頁籤截圖（各模型今日使用量）

歷史翻譯（Tab 4）

每次翻譯完成後，程式自動將截圖與翻譯結果儲存至本機 SQLite 資料庫。

  • 依遊戲名稱 / 視窗 / 平台篩選紀錄。
  • 切換「疊圖模式」或「純圖模式」。
  • 可修正平台資訊並套用至所有同遊戲紀錄。
  • 點擊「刪除此筆」移除單筆紀錄。
歷史翻譯頁籤截圖 歷史翻譯頁籤截圖

歷史攻略（Tab 5）

勾選「截取翻譯時同時要求攻略」，或點擊「目前攻略資訊」，AI 會同步回傳：

  • 目前進度：一句話描述玩家所在位置與劇情進度。
  • 攻略建議：3～5 條具體建議，包含必拿道具、任務方向、隱藏要素。
AI 攻略建議顯示示例 AI 攻略建議顯示示例

歷史錄製（Tab 6）

場次錄製的用意是讓你將整段遊戲翻譯過程完整保存下來。啟動錄製後，LangForge 會自動將每一次翻譯的截圖與譯文依序記錄成一個「場次」；結束後可隨時回放，畫面會按照當時的順序重現所有翻譯幀。

這個功能適合以下情境：

  • 回頭複習長篇劇情，不需重複遊玩
  • 整理並查閱遊戲中出現過的所有對話翻譯
  • 與朋友分享翻譯紀錄
場次錄製說明
  • 在「翻譯操作」頁籤點擊「開始場次錄製」後，每次截圖翻譯都會自動存入場次。
  • 點擊「結束場次」完成錄製，場次資料儲存於「歷史錄製」（Tab 6）。
  • 選取場次後點擊「▶ 回放此場次」即可重播所有翻譯幀。

Grok 引擎（xAI）

Grok 是由 xAI（Elon Musk 創辦）開發的多模態 AI 引擎，LangForge 從 V1.0.1-beta.7 起新增支援。Grok 使用 OpenAI 相容的 API 介面，端點為 api.x.ai。

模型 特色 費用
grok-2-vision-1212 穩定視覺模型，適合遊戲截圖翻譯 付費
grok-4 旗艦多模態模型（2025/07），理解能力更強 付費
申請 Grok API Key
前往 console.x.ai 申請 API Key，在 LangForge 翻譯操作頁籤的引擎選擇中選擇「Grok」後輸入即可。

OLLAMA 本地引擎

除主流雲端引擎外，LangForge 亦支援 OLLAMA 本地引擎模式，讓你在完全離線的環境下進行翻譯，無需 API Key，保護隱私。

1
安裝 OLLAMA

前往 ollama.com 下載並安裝 OLLAMA，完成後於命令列執行 ollama serve 啟動服務。

2
下載模型

執行 ollama pull 模型名稱 下載支援視覺的多模態模型，例如 ollama pull llava。

3
在 LangForge 切換至本地引擎

在「翻譯操作」頁籤選擇「🦙 本地引擎 (OLLAMA)」，LangForge 會自動偵測已安裝的模型清單供你選擇。

注意
OLLAMA 本地推理需要足夠的顯示卡或 CPU 效能，建議使用支援 GPU 加速的機器以獲得合理的翻譯速度。

引擎比較

引擎 推薦模型 免費額度 適合場景
Gemini Flash gemini-2.5-flash 20 RPD 多語言翻譯，視覺理解強
Gemini Lite gemini-3.1-flash-lite-preview 500 RPD 高頻使用，輕量快速
Groq llama-4-scout-17b 1000 RPD 高頻翻譯，速度極快
Mistral pixtral-12b-2409 500 RPD 視覺模型，複雜排版佳
OpenAI gpt-4.1-mini 付費 翻譯品質穩定
Claude claude-haiku-4-5 付費 語意理解強，長文本佳
🦙 OLLAMA （本地模型） 完全免費 離線使用，隱私保護，需自備硬體
Grok grok-2-vision-1212 付費 xAI 旗艦視覺模型，多模態理解強
🔍 本地 OCR EasyOCR + Google 翻譯 完全免費 無需 API Key，適合輕量離線使用

平台 / 模擬器設定

翻譯紀錄會附記遊戲平台資訊（如 FC、SFC、PS1）或模擬器名稱（如 Mesen、RetroArch）。在「翻譯操作」頁籤選擇紀錄方式：

  • 以遊戲平台為主：選擇主類別（如 任天堂）及子平台（如 SFC）。
  • 以模擬器為主：選擇正在使用的模擬器軟體。

LangForge 由個人獨立開發，完全開源且無廣告。如果你覺得這個工具對你有幫助，歡迎透過以下方式支持開發者，讓更多功能得以持續更新 🙏

Ko-fi（一次 / 多次性支持）

一杯咖啡的費用即可支持開發，$1～$3 USD，隨心所欲，無月費壓力。

☕ 前往 Ko-fi 支持
Patreon（月費支持）

每月固定支持開發，$1～$3 USD / 月，提前體驗新功能與開發動態。

💜 前往 Patreon 支持
加入社群
有任何問題、功能建議或想交流遊戲翻譯心得，歡迎加入官方 Facebook 社群：
LangForge Facebook 社群

疑難排解

找不到目標視窗

確認「目標視窗標題」欄位中輸入的文字與遊戲 / 模擬器視窗標題相符（部分匹配即可）。也可使用「🖱 點選視窗」功能直接點選目標視窗。

翻譯結果文字位置跑掉

可嘗試切換不同模型，或調整「文字排版模式」（橫排 / 直排）。

所有模型額度已用完

免費模型每日有請求上限，用完後須等隔日太平洋時間重置。建議設定多個引擎 API Key 以自動備援切換。

快捷鍵無法運作

在捷徑上按右鍵選擇「以系統管理員身分執行」。部分防毒軟體可能封鎖全域鍵盤監聽，可嘗試加入防毒允許清單。

JSON 解析失敗

AI 偶爾回傳格式不正確的 JSON，LangForge 會自動嘗試修復。若持續發生，請更換模型。

OLLAMA 本地引擎無回應

確認 OLLAMA 服務正在執行（ollama serve），並已下載所選模型（ollama pull 模型名稱）。若推理時間過長，可在擷取設定中增加 Timeout 秒數，或改用較小的模型。

狀態列顯示錯誤訊息的範例截圖 狀態列顯示錯誤訊息的範例截圖

Copyright © 2026 GoOnSoft. All rights reserved.