LunaTranslator 快速上手：10 分钟从零跑通游戏实时翻译

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

玩过日文视觉小说的人都有同一个卡点：剧情走到一半，满屏台词只能靠猜。LunaTranslator 是面向视觉小说和 Galgame 的游戏实时翻译工具——它在你玩游戏的同时持续抓取台词，当场翻成中文。抓字走三条路径：HOOK 直接读游戏内存、OCR 截图识别、剪贴板监控，各管一段场景。这篇文章按"先跑通、再扩展"的顺序写，跟着做，10 分钟可以让译文跟上手头的剧情。

1. 先把软件跑起来

原理一句话：工具要往安装目录写配置和缓存，所以它需要一个能写进去的"家"，解压位置和启动方式就都围绕这一点。

1. 下载官方 Windows 预编译包，解压到任意非系统目录，比如D:\Tools。
2. 双击LunaTranslator.exe启动。平时就用它，不用管理员模式。
3. 习惯源码的话，执行git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator，然后双击仓库里的src/run.bat，它会直接拉起主程序。

成功标志：主窗口弹出，顶部能切 HOOK、OCR 等模式，工具栏一排功能按钮就位。

坑位提醒：别解压到C:\Program Files这类受保护路径，配置和缓存会写不进去，严重时连启动都失败。

2. 四步用 HOOK 抓住游戏文本

原理一句话：HOOK 是往游戏进程里注入一个 DLL，直接读内存里的文本，不截图、不做识别，延迟和误差都是三条路径里最小的，所以它是首选。

1. 先开游戏，再开工具。游戏进程不存在，注入就无从谈起，顺序别反。
2. 切到 HOOK 模式，在进程列表里找到你的游戏并确认。想省事的，把游戏快捷方式直接拖进工具窗口，它会自动启动游戏并 HOOK。
3. 注入成功后弹出"选择文本窗口"。让游戏往前走几段、显示几句台词，窗口里会陆续列出若干候选文本行。
4. 选中真正对应台词的那一行，完事。

成功标志：界面右侧开始实时刷出译文，游戏继续走剧情，翻译一直跟上。如果该游戏支持内嵌翻译，候选行里会多一个"内嵌"按钮，点一下译文就直接嵌进游戏画面，不用来回切窗口。

坑位提醒：一直卡在"等待 DLL 注入"，多半是杀软把注入组件隔离了——把软件目录加入信任，重新解压一次。

3. 卡住了？对症状下药

跑 HOOK 的过程中绝大多数问题就出在这几个症状上，对号入座：

• 选不到文本：回到选择文本窗口换一条候选行再试；连续几条都不对，说明这个游戏读不到内存文本，直接看下一节切 OCR。
• HOOK 挂不进去：游戏如果以管理员权限运行，普通进程注不进去，改用LunaTranslator_admin.exe启动工具再 HOOK，其他情况普通模式即可。
• 被杀毒拦截、提示缺组件：软件目录加信任、重新解压，两条一起做。
• 翻译延迟高：换低延迟的在线引擎，或后面会讲的本地模型。
• 译文读着不顺：打开错译修正、纯标点跳过这类后处理，高频术语再补一个自定义词典。

4. HOOK 挂了的两条退路

原理一句话：HOOK 需要游戏"配合"，而 OCR 和剪贴板不需要——一个靠看屏幕，一个靠你复制，所以游戏怎么设防都影响不到它们。

OCR 截图识别，适合游戏读不到内存文本、HOOK 挂不进去的场景：

1. 切到 OCR 模式。
2. 框选游戏里的文本区域。
3. 它按固定频率自动截图、识别、送翻，引擎有 Tesseract、百度、Windows OCR 等可选，实现都在 src/LunaTranslator/ocrengines/。
4. 参数拿不准就选"周期执行"，这是最简单、最不容易出错的策略。

成功标志：游戏里台词一换，界面里的译文跟着变，且没有漏句。

坑位提醒：工具栏上相邻两个图标长得很像，第一个是持续识别，第二个只识别一次，别按错。另外 OCR 太勤（疯狂翻译重复内容）或太迟钝（换台词半天不翻），去调"图像一致性阈值"和"图像稳定性阈值"，说明见 docs/zh/ocrparam.md。

剪贴板监控则更轻：不开游戏，只想翻某段外文时，打开剪贴板监控，在游戏或浏览器里 Ctrl+C 复制，译文自动出现在界面。源码在 src/LunaTranslator/textio/textsource/copyboard.py。

5. 翻译之外，顺手开的三个附加能力

跑通主流程后，下面三个能力基本零成本，值得顺手打开：

• 查词：译文里的词可以直接查释义，词源涵盖 Jisho、Weblio、有道以及 mdict 本地词库，实现在 src/LunaTranslator/cishu/。边玩边记词的人用得上。
• 朗读：Edge-TTS、Google TTS、Voicevox、GPT-SoVITS 等引擎任选，中日英语音色都有，适合"听"着剧情走，实现在 src/LunaTranslator/tts/。
• 本地模型离线翻译：内置 LLaMA.cpp 集成，配好之后断网、内网、模拟器环境都能翻，默认模型配置见 src/LunaTranslator/defaultconfig/Magpie/config.json。另外生词支持一键导入 Anki 做成记忆卡，配合查词一起用。

6. 想深入：去仓库里翻什么

• 入门图解：docs/zh/basicuse.md——HOOK、OCR、快捷启动三种模式都配了图，第一份读它。
• 内嵌翻译专题：docs/zh/embedtranslate.md。
• OCR 四种自动执行方式和参数：docs/zh/ocrparam.md。
• 翻译引擎清单与默认参数：src/LunaTranslator/defaultconfig/translatorsetting.json，各家引擎实现在 src/LunaTranslator/translator/。
• 本地模型部署：docs/zh/sakurallmcolab.md。
• 卡住问人：docs/zh/README.md 里列了作者的视频和官方群入口。

LunaTranslator 的哲学其实就一句：文本抓得稳，比翻译翻得炫更重要——HOOK 抓不到再谈 OCR，OCR 再不行还有剪贴板，翻译引擎随时可换。现在就挑一部想玩的视觉小说，把上面四步 HOOK 走一遍，当右侧刷出第一行译文的时候，这个故事就正式开始了。

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