LunaTranslator 快速上手：HOOK 与 OCR 让视觉小说翻译跑起来

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

玩日文视觉小说，卡在"文本读不出、翻译对不上、引擎挑不清"三件事上的人不少。LunaTranslator 是一个开源的视觉小说（Galgame）实时翻译工具，主打从游戏进程里直接抓取文本（HOOK），同时提供 OCR 图像识别作为兜底，翻译接口覆盖在线引擎、离线模型和大语言模型。它的目标人群很明确：想读日文原版游戏、又不想手动截图翻词典的玩家，以及有日语学习需求、希望顺便查词注音的用户。

一、先判断它适不适合你的场景

LunaTranslator 提供三条获取文本的路径，选择顺序基本决定了后续体验：

• HOOK 模式：游戏已启动或可启动时首选。它从游戏进程里提取文本，覆盖大多数常见和冷门视觉小说引擎，文本干净、无识别误差。
• OCR 模式：HOOK 抓不到文本时的兜底。框选屏幕上的文本区域，由 OCR 引擎识别后翻译，适合无法注入的窗口或纯图片文本。
• 剪贴板等辅助输入：手动复制文本进来翻译，最朴素但最通用。

如果你的游戏是 Windows 平台的常见视觉小说引擎，直接走 HOOK 路线；如果游戏跑在模拟器里（NS/PSP/PSV/PS2），它有专门的模拟器 HOOK 支持，可参考 docs/zh/emugames.md 里列出的机型范围。

二、最短上手路径：三步出第一条译文

拿到软件后有两条入口：

1. 使用官方发行版：到项目文档首页 docs/zh/README.md 下载对应的 Windows 安装包（Windows 10/11 用 64 位版本），安装后直接启动，不需要任何环境配置。
2. 从源码获取：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator

然后在仓库根目录运行src/run.bat（其内容就是调用python.exe -B LunaTranslator\main.py），启动前确保本地 Python 环境已装好项目所需依赖。

启动后完成第一条译文，通常只需三个动作：

1. 把游戏窗口拖入 LunaTranslator 主窗口，软件会自动启动（或附加）游戏并注入 HOOK；
2. 在弹出的"选择文本"窗口里，让游戏显示一段对话，从候选文本行里选中与游戏画面对应的那一行；
3. 点击该行对应的"显示"按钮，译文即出现在悬浮窗中。如果该游戏支持内嵌翻译，会出现"内嵌"按钮，点击后译文直接叠在游戏画面里。

整个流程的具体演示见官方文档 docs/zh/basicuse.md。

三、核心能力：哪些功能最影响日常体验

文本获取层是它和普通翻译器的分界线。HOOK 引擎适配了大量视觉小说引擎（源码位于src/NativeImpl/LunaHook/），并且支持为单个游戏单独设置 HOOK 参数——同一个软件配多款游戏互不干扰，这是长期使用的关键。

翻译层接入了覆盖面很广的接口，常见选择：

• 在线引擎：百度、谷歌、微软、DeepL 等，配置简单、速度快，适合日常；
• 离线/本地方案：支持 llama.cpp 等本地模型路线，适合在意隐私或网络环境差的场景；
• 大语言模型接口：可调用 ChatGPT 类模型做语境更好的翻译，还能把自定义词典塞进 prompt 里。

各类引擎的接入方式和取舍，可查 docs/zh/guochandamoxing.md（大模型配置）和src/LunaTranslator/translator/目录下的实现文件。

学习向功能对日语文学习者是隐藏价值：日语分词、假名注音（振假名）、Anki 同步、Yomitan 插件兼容，读游戏的同时完成查词和背词闭环。

四、配置策略：新手先动这三处

不建议一开始就翻遍设置界面，按下述优先级调整即可：

• 新手默认：HOOK 自动检测 + 任意一个稳定的在线翻译引擎 + 悬浮窗显示。这一组合能解决大多数游戏的翻译需求。
• 进阶可选项：
  • 为常用游戏建立"游戏管理"条目，单独固化 HOOK 参数与翻译设置，启动即生效；
  • 开启内嵌翻译，获得"字幕直接长在游戏里"的体验；
  • 配置 TTS 语音合成引擎，让悬浮窗朗读译文。
• 特定场景：文本反复只出一两个字、或整行顶掉上一行，属于刷新延迟与游戏打字速度不匹配，去 HOOK 设置里调整"刷新延迟"；文本大量乱码则多半是代码页设置问题。这些参数的作用说明在 docs/zh/hooksettings.md 里写得比较细。

五、遇到卡点时的排查方向

1. HOOK 后选不到正确文本：先确认选中的游戏进程是否为目标游戏（多开或模拟器时容易选错）；再试试让游戏实际显示一段对话后刷新候选列表；仍不行则在游戏设置中开启 Win32 通用钩子。
2. OCR 识别效果差：换引擎（离线模型与在线服务精度不同）、重新框选区域、确认区域里只有文本没有背景干扰；OCR 各引擎的参数说明见 docs/zh/ocrparam.md。
3. 翻译质量不稳：优先换引擎对比，而不是反复调参；对固定译错的专名、角色名，用翻译优化里的"专有名词翻译"加词条，比全局替换更稳，思路见 docs/zh/transoptimi.md。
4. 快捷键失灵：确认总开关"是否使用快捷键"已启用，具体按键映射在 docs/zh/fastkeys.md 中有完整列表。

下一步建议

跑通第一条译文后，建议按这个顺序深入：先把 2~3 款常玩游戏录入游戏管理并固化设置，再按需接入本地模型或 TTS，最后探索分词注音与 Anki 同步这类学习功能。文档站入口在 docs/zh/index.md，遇到无法提取文本的新引擎时，项目文档里也提供了反馈支持的渠道。

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