LunaTranslator上手指南：5分钟让视觉小说跑出实时翻译-开发者社区

LunaTranslator上手指南：5分钟让视觉小说跑出实时翻译

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

LunaTranslator是一款免费开源的视觉小说实时翻译工具：游戏运行到某句对话时，它能把这句话捕获出来并立刻翻译成中文，显示在屏幕角落或直接写回游戏画面。全文按"先会选、再会抓、再调顺"的顺序讲，第一次接触这类工具也能照着做完。

翻译的前提是先拿到原文。LunaTranslator提供三种文本捕获方式，选错方式后面全白配，所以第一步是判断你的游戏适合哪一种：

捕获方式	工作原理	适合的游戏	代价
HOOK	把钩子注入游戏进程，直接从内存里读取游戏准备显示的文本，延迟最低	绝大多数原生视觉小说	少数有反作弊或特殊保护的游戏可能失败
OCR	对屏幕截图做文字识别，把画面当图片读	无法HOOK的游戏、部分模拟器游戏	需要你框选识别区域，速度略慢、可能识别错字
剪贴板	监听你复制的文字	游戏内支持 Ctrl+C 复制文本的场景	依赖游戏本身支持复制

经验法则：原生日文Galgame优先试HOOK；模拟器（NS/PSP/PSV/PS2等）里的游戏两者都可能行，HOOK不行就转OCR，模拟器适配细节见 emugames.md。

HOOK路线是体验最顺的，正常游戏两分钟就能跑通：

启动游戏和软件。两种方式任选：游戏已经开着的话，用软件工具栏的"选择游戏进程"按钮选中它；更省事的做法是把游戏的.exe直接拖进LunaTranslator窗口，它会代为启动并自动HOOK。
选中文本。注入成功后会弹出"选择文本"窗口，先让游戏随便显示几句对话，窗口里会列出多条候选文本，找到和屏幕上对话一致的那一条，点它右边的"显示"。
看结果。此后游戏每说一句话，软件窗口就会跟出原文和译文。如果这款游戏支持内嵌翻译，同一行还会出现"内嵌"按钮——点它会把译文直接写进游戏对话气泡里，而不是显示在外部窗口。

完整的界面操作截图版说明在 docs/zh/basicuse.md，第一次用建议对照着看。

当HOOK注入失败、或游戏根本不经过常规文本函数时，切到OCR模式：

用"选取OCR范围"按钮在游戏画面上框出对话区域，框尽量只包住文字、少带背景花纹，识别率和速度都会更好。
框好后软件会持续截图识别，行为上等价于自动翻译。注意工具栏上图标相近的另一个按钮是"临时识别一次"，不是持续识别，别点混了。
识别区域大、背景复杂时容易出错，此时可以尝试更换OCR引擎（Windows自带OCR、Tesseract、在线OCR服务等，列表随软件版本变化），并在 OCR参数文档里按提示调阈值。

拿到原文后交给哪个翻译器，在"翻译设置"里切。常见几类：

各通道的参数项都写在 src/LunaTranslator/defaultconfig/translatorsetting.json 对应的界面里，不用手改文件。想细看每个引擎的适用场景，参考 docs/zh/guochandamoxing.md。

HOOK抓不到、或抓出来的文字缺字错字时，按这个顺序排查，比盲目重试有效：

每次只出一两个字、或只显示最后一行：游戏文字显示慢于软件刷新节奏，调高"刷新延迟"。
文本反复刷、不停变：调低"最大允许输出文本长度"过滤掉Skip等场景的爆发文本。
老游戏中文乱码或找不到正确文本：确认代码页设置，但大多数情况这一项不该动——找不到的时候更有效的做法是直接提交issue反馈，而不是反复试代码页。
注入后游戏卡死或闪退：先确认LunaTranslator和游戏的权限等级一致，游戏是管理员权限运行时，用LunaTranslator_admin.exe启动软件再试；全屏游戏可先切窗口模式验证。
确实抓不到任何文本：在游戏管理里为该游戏开启"Win32通用钩子"这类额外钩子再试一次。

这几项在 docs/zh/hooksettings.md 中都有逐项解释，包括特殊码这类进阶配置。