LunaTranslator：面向视觉小说玩家的游戏实时翻译使用指南

LunaTranslator面向视觉小说玩家的游戏实时翻译使用指南【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator打开游戏后对话框只有原文、翻译迟迟不出现多半是文本捕获方式没配对。LunaTranslator 是一款面向视觉小说的开源游戏翻译器通过 HOOK 读取、OCR 截图识别与多引擎翻译把游戏内文字转成你看得懂的语言。本文适合想为日文、韩文视觉小说配置实时翻译的使用者。 确认运行环境LunaTranslator 是 Windows 桌面程序且 HOOK 注入依赖 32 位进程环境不满足时后续步骤都会卡住项目要求操作系统Windows游戏需支持 32 位进程注入主流视觉小说引擎均可Python3.7 及以上32 位游戏建议同时准备 32 位 Python启动方式仓库内已内置src/run.bat64 位与src/run32.bat32 位两个启动脚本网络在线翻译引擎百度、DeepL、微软等需联网本地 LLM 方案可离线依赖方面无需逐个手动安装仓库根目录没有独立requirements.txt启动脚本直接以python.exe -B LunaTranslator\main.py拉起 主程序缺少模块时会按提示自行补装。 完成首次启动最小配置从克隆到看到翻译结果只需要三条命令git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator—— 把源码拉到本地包含 Python 程序、原生模块与文档。双击src/run.bat32 位游戏改用src/run32.bat—— 以-B参数启动main.py首次运行会自动检测并补齐依赖。在弹出的主界面选择文本输入源 —— 选择 HOOK、OCR 或剪贴板模式随后按下一节对应路径操作。启动后如果 32 位游戏无法注入直接改用run32.bat重启程序即可。 走通三条使用路径用 HOOK 模式读取游戏内存适用场景引擎成熟、启动正常的视觉小说延迟最低是首选模式。关键入口文本源实现在 textsource 目录其中 texthook.py 负责内存读取。最短操作序列先启动游戏再启动 LunaTranslator切换到 HOOK 模式打开选择游戏进程窗口从列表里选中游戏进程并确认程序会向该进程注入在弹出的候选文本列表中选中与游戏台词一致的一行点击显示或内嵌翻译即出现在游戏旁或画面内。用 OCR 模式框定识别区域适用场景无法注入的老游戏、特殊引擎或 HOOK 候选文本里找不到正确台词时。关键入口ocrengines 目录含本地 Tesseract、Windows OCR、百度 OCR、MangaOCR 等多种实现。最短操作序列切换到 OCR 模式在屏幕上框选游戏对话框所在区域按 ocrparam 文档 选择 OCR 引擎与目标语言确认区域后程序开始自动持续识别并翻译。注意工具栏上有一个图标几乎相同的临时识别一次按钮它只执行单次识别不是持续识别入口。用剪贴板模式自动翻译复制文本适用场景只需要翻译少量文本或不想在游戏进程上做注入的场景。关键入口copyboard.py 负责监听剪贴板变化。最短操作序列把文本输入源切换为剪贴板在游戏中选中并复制台词程序检测到剪贴板变化后自动送翻在文本输出区查看结果或配合快捷键复制到剪贴板。 调整性能与质量参数优化性能现象原因操作翻译过程游戏掉帧OCR 高频截屏占用了 CPU 与显示资源缩小识别区域只框对话条降低识别频率32 位游戏注入失败64 位程序无法注入 32 位进程用src/run32.bat重新启动首次翻译慢、之后重复内容更快在线引擎逐条请求依赖内置翻译缓存重复台词不再请求启动后长时间卡住首次运行在补齐 Python 依赖等待完成或提前自行安装依赖包提升翻译质量现象原因操作翻译内容对不上台词选错了候选文本行让游戏先显示一句台词再选中与之匹配的候选行OCR 识别出乱码识别区域包含背景花纹、字体过细收紧选区换 MangaOCR 或调整二值化参数见 ocrparam 文档人名、术语译法前后不一引擎各自发挥在 transoptimi 目录 的自定义词典与错误纠正配置中补充词条英文断句异常原文分句方式与引擎习惯不符参考 englishanalyze 文档 调整分析规则 浏览项目周边模块语音朗读tts 目录 提供 edge-tts、VoiceVox、GPT-SoVITS 等引擎可把识别结果即时读出来方法详见 ttsengines 文档。词典与学习cishu 目录 集成 Moji 词典、Jisho、Weblio 等词源配合 ankisync 文档 把生词同步进 Anki。翻译后处理transoptimi 目录 提供无词典匹配跳过、标点过滤、错误纠正等流程配置说明在 textprocess 文档。多语言文档docs 目录 提供 zh、en、cht、ja、ko、ru、vi 等语言版本基础用法见 basicuse 文档。 下一步怎么做先按 HOOK 模式跑通一款你最想玩的游戏确认候选文本能对上台词再视情况切到 OCR 模式调识别区域最后才动引擎、词典这类翻译质量参数。遇到具体报错优先翻 qa1 与 qa2 两篇常见问题文档能覆盖大部分启动与识别问题。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考