LunaTranslator 3 种取词模式对比:游戏实时翻译实战指南
2026/9/12 9:47:48 网站建设 项目流程

LunaTranslator 3 种取词模式对比:游戏实时翻译实战指南

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

LunaTranslator 是一款开源的视觉小说翻译工具,它从游戏画面中提取对白并实时送入翻译引擎,把结果贴回游戏界面,让你在不读原文的情况下继续游戏。它主要面向不熟悉游戏原语言、又不想逐句截图查询的玩家。全文按功能清单、安装启动、取词模式选择、引擎配置、排错与进阶六个部分展开。

📦 LunaTranslator 功能清单

相比手动截图加在线查询,该工具的价值在于"取词—翻译—显示"整条链路在屏幕内自动完成,能力范围如下。

模块内容
取词HOOK 内存读取、OCR 截图识别、剪贴板监听三种模式
翻译在线 API、本地离线模型、AI 大模型三类来源
OCRTesseract、Windows OCR 等本地引擎,及百度、谷歌等云端引擎
附加语音朗读、日文词典查询、生词导出 Anki、七种语言界面

安装与启动

Windows 上的安装只有三个动作:先克隆仓库,再按清单安装 Python 依赖,装完直接运行 src/run.bat,32 位系统改用 src/run32.bat;入口脚本实际拉起的是 main.py。

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator pip install -r requirements.txt

🔀 HOOK、OCR 还是剪贴板

三种取词模式原理不同,选错是"出不了文本"最常见的原因,横向对比如下。

模式工作原理适用对象优点缺点
HOOK向游戏进程注入后从内存读取对白现代 PC 游戏、支持列表内的视觉小说延迟最低、文本完整、支持内嵌到画面依赖游戏实现,需选对进程
OCR定时截取固定区域并识别文字无法 HOOK 的游戏、老游戏、贴图渲染的文字兼容性最广、无需注入准确率与速度受截图质量影响
剪贴板监听系统剪贴板内容只偶尔查几句的情况配置最简单需要手动复制

决策顺序:现代 PC 游戏先试 HOOK——在进程列表里选定游戏进程,注入后于选词窗口点选与画面对白相符的一行即可;若选词窗口迟迟没有可选文本,再切到 OCR 并框选对白区域;如果只是偶尔翻译一两句,用剪贴板就够。主机模拟平台能否取词,可先查 模拟器支持列表。具体文本源实现在 src/LunaTranslator/textio/textsource/。

🌐 翻译与识别引擎在哪配置

翻译来源分三类,各有独立配置入口:

  • 在线:覆盖百度、谷歌、DeepL、腾讯等主流服务,走 API 直连,参数在 translatorsetting.json。
  • 本地:离线模型在本机推理,不依赖外网,模型清单见 llm_model_list.json。
  • AI:ChatGPT、Sakura 一类大模型翻译,实现位于 translator 目录。

OCR 侧的本地引擎(Tesseract、Windows OCR)与云端引擎(百度、谷歌等)集中在 src/LunaTranslator/ocrengines/,识别参数在 ocrsetting.json。

🛠 常见现象的原因与处置

首次使用最常遇到以下四类问题,按表排查即可。

现象可能原因处置
HOOK 模式选不到文本游戏架构不支持,或进程注入未生效重新注入并选对进程;仍无文本则切换 OCR
OCR 识别错误多选区包含背景、截图分辨率低将选区缩到对话框内,调整 ocrsetting.json 参数
翻译延迟高在线引擎网络往返慢改用本地离线模型,或更换其他在线服务
画面卡顿识别、翻译任务同时过多关闭不必要的附加功能,缩小 OCR 选区

🎙 语音、词典与多语言文档

  • 语音合成:Edge TTS 与本地引擎等多种朗读方案,位于 src/LunaTranslator/tts/。
  • 词典:日文词典、jisho、Weblio 等查词工具在 src/LunaTranslator/cishu/,生词可导出 Anki。
  • 文本后处理:翻译结果的规整与纠错位于 src/LunaTranslator/transoptimi/。
  • 文档:docs/ 提供中、英、日、韩、俄等七种语言,中文版在 docs/zh/。

建议先跑通一个游戏:用 HOOK 模式接入一款常玩的游戏,把选词到翻译的全流程走一遍,再按实际体验调整翻译引擎与 OCR 选区;遇到具体问题查中文文档对应章节。

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询