LunaTranslator：视觉小说实时翻译上手指南（HOOK/OCR 双模式）
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
日文视觉小说一打开，满屏平假名、片假名和汉字，看得懂的只有第一句「真的吗？」想查个词，连角色在对谁说话都找不到上下文；拿手机截图逐句翻译，游戏还在那放着，耐心一点点没了。开源的 LunaTranslator 能直接在游戏里给你实时翻译，省掉这一整套流程。
它是一款免费开源的视觉小说翻译器，和截图类翻译工具的差别在取文本的方式：一是把 HOOK（一个把翻译程序挂进游戏进程的技术）注入游戏后，直接从游戏内存里读出剧情文字，省去截图这一步；二是用 OCR 从游戏画面上识别文字，作为兜底。翻译结果默认显示在软件窗口里，支持内嵌的游戏还能把翻译直接写进游戏对话框。
🚀 上手：从下载到第一次翻译
下载最新版，解压到任意目录（避开C:\Program Files这类系统保护目录，否则配置文件存不进去），双击LunaTranslator.exe即可启动；游戏需要管理员权限时改用LunaTranslator_admin.exe。首次启动会自动更新组件，若报Missing embedded Python3，基本是杀毒软件删了组件，把文件夹加入信任后重新解压一份。还有个省事的办法：把游戏 exe 直接拖进主窗口，它会自动启动游戏并完成 HOOK。
🎮 游戏能直接读文本时：HOOK 模式三步挂上
前提是把游戏先运行起来。在主界面切到 HOOK 模式，从进程列表里选中游戏，注入成功后弹出选择文本窗口；让游戏多说几句台词，窗口里会出现若干候选文本行，挑一条和游戏里显示的文字对得上的，翻译就开始跑。候选行有好几条时，哪条内容对得上就选哪条，选错了随时可以换。
选中的条目旁边如果带「内嵌」按钮，说明这个游戏支持内嵌翻译：激活后，翻译会直接替换对话框里的原文，翻译窗口都可以不看。「显示」和「内嵌」可以同时激活，游戏内嵌一份，软件窗口里再留一份带原文的完整结果。
踩坑提示：选完进程后卡在「正在等待 DLL 注入到游戏中」，多半是杀毒软件拦了注入用的 DLL，把 LunaTranslator 所在文件夹加入信任再试。内嵌出来乱码时，先查是不是游戏缺中文字体（有修改游戏字体的选项），古早日系游戏可以试「将汉字转换成繁体/日式汉字」，字体、字符集、等待时间的细节在 docs/zh/embedtranslate.md 里讲得很细。
📷 游戏读不到文本时：OCR 识别区域怎么框最准
HOOK 挂不上，或者想翻的不是剧情文本（菜单、物品说明之类），就切到 OCR 模式：在游戏画面上框一个包含文字的矩形区域，它会自动识别并翻译。可以手动单次识别，也可以开自动持续识别；引擎里有本地选项，完全断网也能离线识别。
踩坑提示：框尽量小，包住文字就行，框成整屏精度和速度一起掉；文字偏小时换更精准的识别引擎，别图快。参数怎么调见docs/zh/ocrparam.md。
📚 想边玩边学日语：假名注音、查词与 Anki 导出
最实用的组合是三步走。先在辞书设置里点一下下载按钮把 unidic 词典拿下来，原文就会逐行标上假名注音，还可以开语法加亮；遇到不认识的词，用内置辞书直接查；打完一章把生词导出到 Anki，通勤路上接着背。想「听」剧情还能开 TTS，翻译直接念出来，引擎从 edge-tts 到本地合成都有。
踩坑提示：一次性导出的卡片太多，可能超出 Anki 同步体积上限，这时可以按docs/zh/ankisync.md的步骤启用 Anki 的本地同步服务器。注音的完整配置在docs/zh/qa1.md。
⚙️ 翻译引擎怎么选、内嵌卡顿怎么防
引擎一行带过：在线有百度、谷歌、DeepL、Azure、腾讯等及各自的 API 版，离线有基于 llama.cpp 的 SakuraLLM 本地模型，随便换，够用。三条防卡顿建议：其一，内嵌翻译的原理是停住游戏、等翻译回来再把内存里的文本改掉，引擎慢一定卡，内嵌优先选快引擎，并限制翻译等待时间，避免长时间卡顿；其二，HOOK 模式里翻译延迟可以按游戏节奏调，剧情推进快的游戏延迟调短；其三，OCR 的精度和速度是反的，框越小越好，这条前面说过了。
给开发者
项目是 C++/Python 混合开发：HOOK、OCR 这类性能关键部分在 C++，翻译与扩展逻辑在 Python。读代码建议从翻译引擎源码开始，再看src/LunaTranslator/ocrengines/的 OCR 引擎目录。
资源索引
- 官方文档入口：docs/zh/index.md
- 基本用法（HOOK / OCR / 内嵌）：docs/zh/basicuse.md
- 假名注音与分词：docs/zh/qa1.md；Anki 本地同步：docs/zh/ankisync.md
- 核心源码：src/LunaTranslator/translator/（翻译）、src/LunaTranslator/ocrengines/（OCR）、src/LunaTranslator/textio/（文本管道）、src/LunaTranslator/tts/（TTS）
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
