支援的引擎 · Electron VN
Electron VN 翻譯工具 - 翻譯自訂的 Electron 視覺小說外殼
有些日本視覺小說工作室會把遊戲做成非 TyranoBuilder 的自訂 Electron 應用程式:一個 JavaScript 轉譯器,加上內建的 Chromium 執行環境,封裝在 resources/app.asar 裡。RuneTranslate 的 Electron VN 轉接器就是針對這類遊戲的通用方案:它用自己的封存檔讀取器讀取並重新封裝 app.asar,翻譯已知的內容檔(files/text.js、html/chat.html),並對封存檔裡的 .js、.html、.json 和 .ks 檔執行通用的原文掃描器(預設為日文,任何來源語言都行)。匯出的是遊戲的翻譯副本,修改後的 app.asar 放在它的 resources/ 裡,不需要修補 Electron 執行環境。
每個自訂 Electron VN 都有各自專屬的配置,RuneTranslate 的通用原文掃描器(針對日文調校,也能辨認其他來源語言)找得到字串,卻無法判斷哪些是說話者名稱、哪些是自由格式的對話。請在詞彙表裡鎖定角色,讓用啟發式擷取出來的部分保持一致:聊天面板裡的每個名字、每則有名稱的系統訊息,以及任何世界觀內的術語。詞彙表一旦設好,你就可以換一家供應商重新翻譯,有名稱的實體仍會與上一次的結果相符。
如何翻譯 Electron VN
- 步驟 1
開啟 Electron VN 遊戲資料夾
把 RuneTranslate 指向含有 Electron .exe 的遊戲目錄。轉接器會尋找 resources/app.asar,並確認它不是 TyranoBuilder 的配置(那種有專用的轉接器)。RuneTranslate 會自行讀取該封存檔,所以不需要手動解包。
- 步驟 2
執行原文掃描器
通用掃描器會走訪 asar 內每一個 .js、.html、.json 和 .ks 檔,並擷取來源語言的字串常值(預設為日文;任何支援的來源語言皆可)。已知格式的檔案(files/text.js、html/chat.html)走結構化擷取;未知的檔案則走啟發式掃描器。二進位檔會被跳過。
- 步驟 3
用你偏好的供應商翻譯
選擇一家供應商。對這類外殼常見的、嵌在 JS 裡的對話式字串,Anthropic Claude 和 OpenAI GPT-4o 的表現最好。DeepL 是可靠的備選。免費的 Google Translate 可透過供應商路由處理簡短的 UI 字串。
- 步驟 4
重新封裝 app.asar 並匯出
匯出時,RuneTranslate 會寫出遊戲的翻譯副本,它的 resources/ 資料夾裡是嵌入翻譯字串的修改版 app.asar(如果你直接匯出到遊戲上,則會就地改寫該封存檔)。翻譯好的版本在原本的 Electron 執行環境中執行。
支援內容
- 自訂的 Electron 視覺小說外殼(非 TyranoBuilder)
- resources/app.asar 的讀取 + 重新封裝
- files/text.js 和 html/chat.html 的結構化擷取
- 針對 .js / .html / .json / .ks 檔的通用原文掃描器
- 包在 Electron 裡的 Cocos Creator 遊戲,遊戲自己的資源清單可確保資源名稱安全無虞
限制
- 屬於啟發式做法,對話是純 JS 字串常值的外殼效果最好
- 高度混淆的 JS 原始碼可能無法擷取出字串
- 原生綁定的對話(在執行階段從 C++ DLL 載入)無法用這種方式翻譯

