LunaTranslator实践手册：一套实时视觉小说翻译链路怎么搭

LunaTranslator实践手册一套实时视觉小说翻译链路怎么搭【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator游戏里刚弹出日文对白悬浮窗口里中文已经同步出现——这是视觉小说翻译工具配合得当时该有的样子。LunaTranslator 是一款免费开源的游戏翻译工具它通过 HOOK、OCR、剪贴板三条链路读取游戏文本接入翻译引擎实时显示还能把结果转成语音读出来。它运行在 Windows 上也支持 HOOK 模拟器直接读取 NS、PSP、PSV、PS2 上的游戏文本。它是怎么读到游戏文字的Galgame翻译的第一步是抓字LunaTranslator 提供了三条捕获链路按可靠性排序HOOK 读内存。向游戏进程注入钩子在文本输出到画面的那一瞬间直接取走不经过截图、不走识别速度快且几乎不受字体样式影响。它对常见和冷门视觉小说的适配覆盖最广是首选链路。OCR 读画面。对游戏窗口截图用本地 OCR 模型或在线引擎百度、Tesseract5、Windows OCR、OCR.space 等识别出文字。HOOK 接不住的游戏走这条路。剪贴板监控。监听游戏里复制出来的文本适合本身带复制对话功能的场景。文本抓到之后的处理路径是固定的先过翻译引擎再呈现到悬浮窗口可选地交给 TTS 引擎合成语音。翻译引擎有 10 余种实现从 src/LunaTranslator/translator/ 目录可以直接看到全部源码包括 DeepL、Google、百度、微软、Azure、Papago 等在线服务以及 Sakura 大语言模型、本地 LLM 等离线方案。部分游戏还支持把译文直接内嵌回游戏窗口省去看悬浮窗的切换动作。在Windows上跑起来先对照环境清单四项全满足再动手Windows 7 SP1 以上推荐 Windows 10/11Python 3.63.9 更好至少 2GB 可用磁盘空间稳定网络安装依赖、调用在线引擎都要用安装步骤就三步git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator pip install -r requirements.txtpip install会自动装齐 PyQt5、requests 等依赖装完即可从src/LunaTranslator/main.py或仓库提供的run.bat启动。三个容易踩的坑单独说PATH 勾选。装 Git 时勾上 Add Git to PATH装 Python 时勾上 Add Python to PATH否则后续命令全部找不到。装完用git --version和python --version各验证一次。管理员权限。HOOK 要读别家进程的内存普通权限下会被系统拒绝所以跑 HOOK 链路时以管理员身份启动 LunaTranslator。位数匹配。32 位游戏配 32 位 HOOK 模式64 位游戏配 64 位模式选错了抓不到字。第一次运行给游戏配一条完整链路给具体游戏配链路时按先抓、再译、后读的顺序决策。第一步定捕获方式。优先试 HOOK以管理员权限启动按游戏位数选模式能抓到字就定了。抓不到再切 OCR——先试内置的本地 OCR 模型精度不够再换在线引擎。如果游戏自带复制文本的功能剪贴板监控是成本最低的兜底。第二步定翻译引擎。在线引擎质量稳定、零配置DeepL 对日语游戏中文的输出质量通常最省心追求离线和速度就选 Sakura 或本地 LLM。日文源、中文目标是默认组合也可以反着配成中译英。第三步定 TTS。需要边看边听就挂上 Edge TTS 或 Windows 系统 TTS不朗读就关掉省一点开销。两组推荐组合可以直接抄在线主力HOOK DeepL Edge TTS日文游戏最通用的配置。离线低延迟HOOK Sakura 本地模型 本地 TTS断网也能玩。用得更顺手跑通之后这几个地方值得再花十分钟语音朗读。翻译结果默认只显示文字开启 TTS 后会随对白同步播出来眼睛不用再在窗口和文字之间来回挪。名词词典。游戏里的角色名、地名常被机翻翻岔用 transoptimi/noundict.py 对应的功能建一份专名表指定词固定译法。翻译错误修正。transoptimi/transerrorfix.py 处理的是翻对了字、翻错了意这类残留问题配几条规则能明显减少翻车。界面主题。浅色、深色主题在src/files/LunaTranslator_qss/下按显示环境切换长时间盯窗口的话深色更护眼。多语言界面。src/files/lang/里内置了 20 多种语言的界面文案不是只有中文界面。出问题先查这里症状自查步骤HOOK 抓不到文本确认已用管理员权限启动 → 确认游戏 32/64 位并切到对应 HOOK 模式 → 都失败就降级走 OCR 链路OCR 识别准确率低给 Tesseract 装上日语语言包 → 调大游戏窗口分辨率、换清晰字体 → 换用精度更高的本地或在线 OCR 引擎翻译速度慢检查网络与代理是否正常 → 换响应更快的在线引擎如 DeepL→ 仍慢就改用本地翻译模型资源索引链路搭好后日常使用基本不用再碰配置。想深入某一块时直接查这两处就够了官方文档含 HOOK 设置、模拟器支持列表、TTS 引擎清单docs/zh/出厂默认配置示例改配置前可先对照src/LunaTranslator/defaultconfig/把捕获、翻译、语音三段各自选对再按上表排一遍障绝大多数视觉小说都能玩起来。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考