30分钟零基础上手：用LunaTranslator一遍跑通日漫视觉小说的实时翻译-编程实验室

30分钟零基础上手：用LunaTranslator一遍跑通日漫视觉小说的实时翻译

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

如果你想在没有中文补丁的情况下读懂日文视觉小说，LunaTranslator 会是你需要的工具。它是一款免费开源的视觉小说翻译器：通过 HOOK 直接从游戏内存读取文本，用 OCR 识别画面文字兜底，再把文本交给翻译引擎实时显示译文。下面带你用 30 分钟走完从首次启动到第一句译文上屏的完整过程。

LunaTranslator 取文本有两条路线，先想清楚走哪条，后面的操作就清晰了。

建议始终先试 HOOK，确认无效再切 OCR。两条路线可以并存，游戏过程中随时切换。

HOOK 的原理是把 DLL 注入游戏进程，LunaHost32.dll、LunaSubprocess32.exe这类文件因此极易被杀毒软件误报。首次启动的大多数报错都源于此，所以白名单要放在下载之后、启动之前做。

以 Windows Defender 为例：「病毒和威胁防护」→「排除项」→「添加或删除排除项」→ 把 LunaTranslator 所在目录作为文件夹排除。第三方杀软同理，把整个软件目录加入信任列表。

发布包解压到普通目录即可，不要放进C:\Program Files这类受限路径，否则即使开管理员权限，配置和缓存文件也可能无法写入，甚至直接起不来。

如果做完上述准备，启动时仍提示「找不到重要组件 / Missing embedded Python3」，说明内置组件已被杀毒软件删除。把白名单补好，重新下载解压一次即可。

先启动游戏，再双击LunaTranslator.exe。多数情况普通版足够；仅当游戏本身以管理员权限运行、普通模式注入失败时，才换用LunaTranslator_admin.exe。

从工具栏打开「选择游戏进程」窗口，在列表里选中游戏进程并确认。片刻之后弹出「选择文本」窗口，说明注入成功。

回到游戏里让角色说一句台词。选择文本窗口会出现若干候选行，勾选与台词对应的那一行，译文立即开始在悬浮窗滚动。

候选行中如果出现「内嵌」按钮，说明这款游戏支持内嵌翻译：译文直接写进游戏对话框，观感接近官方汉化，比外挂悬浮窗更沉浸。

还有一个省事的入口：把游戏的 exe 直接拖进 LunaTranslator 窗口，软件会自动转区启动游戏并自动完成 HOOK，之后按上面的步骤继续。

典型场景：游戏在播 CG 或过场动画、引擎未被 HOOK 覆盖、以及部分模拟器游戏。把模式切到 OCR，在游戏画面上框选文字区域，框对之后它会持续识别、持续翻译，不需要反复操作。

这里有个高频错误：OCR 模式下有两个图标相同的按钮，后一个是「临时识别一次」，前一个才是自动持续识别，点错会导致你以为功能坏了。

识别结果一直不理想时按两个方向排查：一是重新框选对比度更高的文字区域，画面偏暗和特殊字体是主要干扰源；二是更换 OCR 引擎，软件自带本地高精度 OCR 模型，也可以接入多种在线与离线 OCR 引擎，换引擎后通常立刻改善。

文本到手后需要引擎来翻译，三档选择：

接入参数、平台列表和 prompt 字段都在官方文档里。首次跑通不必纠结最优引擎，先把整条链路接起来再说。

第一句译文出来后，这些能力值得逐项打开：

注音与查词：在辞书设置里下载 unidic 词典，开启假名注音显示，再双击生词即可查询，还能接入 Anki 做词汇卡片。细节见 docs/zh/qa1.md。
HOOK 行为微调：文本一次只出一两个字、或刷新明显滞后，去 HOOK 设置里调刷新延迟、缓冲区长度等参数。方法见 docs/zh/hooksettings.md。
语音合成：接一个 TTS 引擎让译文直接朗读，玩着玩着听。

遇到具体报错，优先翻 docs/zh/qa1.md 和 docs/zh/qa2.md，多数问题都已有现成答案。