告别啃生肉：一篇搞定LunaTranslator视觉小说实时翻译的完整指南

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

第一次打开日文Galgame时，满屏假名让人瞬间泄气。朋友递给我一个叫LunaTranslator的开源视觉小说实时翻译工具——它能直接读取游戏里的日文文本并即时翻成中文，从下载到看到第一句译文，其实只要五分钟。这篇文章就是为你准备的新手路线图，不讲废话，按"你遇到的问题"来写。

先别急着调参：这个翻译器到底能救什么急

LunaTranslator 的核心是"把游戏里的文本拿出来翻译"，靠三种文本捕获方式实现。搞清楚它们的分工，后面所有配置都是顺水推舟：

适合你：想玩日文原版Galgame、想体验模拟器游戏、甚至想边玩边学日语的人。不适合你：只玩官方中文版、或者完全不想碰任何配置的人。

5分钟最小路径：从下载到看到第一句翻译

第1步：下载解压。从项目发布页拿到最新版本压缩包，解压到任意目录。⚠️ 唯一要注意的是：别放进C:\Program Files这类受保护目录，否则可能无法保存配置甚至无法运行（详见 docs/zh/README.md）。

第2步：启动。双击LunaTranslator.exe即可。首次启动会引导你选界面语言、配翻译引擎和热键——翻译引擎先用"百度翻译"这类免费接口练手，后面再升级。

第3步：打开游戏，连接。启动游戏后，点击软件里的"选择游戏"按钮，在进程列表里选中游戏进程并确认。

第4步：选对文本行。确认后会自动弹出"选择文本"窗口。让游戏跑起来显示几句对话，窗口里会出现候选文本行，勾选与游戏画面一致的那条。

第5步：见证效果。选好文本行的瞬间，翻译就开始滚动出现了。全程不需要写任何代码，比想象中简单得多。详细步骤见 docs/zh/basicuse.md。

核心玩法拆解：按你的目标选一条路

场景A：只想畅玩日文Galgame——HOOK + 内嵌翻译

HOOK 是 LunaTranslator 的主场。遇到文本"每次只蹦出一两个字"或"刷得太快顶掉上一行"时，去 HOOK 设置里调高刷新延迟；遇到乱码文本，多半是代码页没对上（详见 docs/zh/hooksettings.md）。

更爽的是内嵌翻译：部分游戏支持把译文直接写进游戏画面，获得沉浸式体验。在"选择文本"窗口里，如果某行文本有"内嵌"按钮，激活它即可。⚠️ 两个提醒：内嵌有极小概率导致游戏崩溃，属于正常现象；古早游戏出现乱码时，试试激活"将汉字转换成繁体/日式汉字"或"修改游戏字体"来修复（详见 docs/zh/embedtranslate.md）。

场景B：模拟器游戏——NS、PSP、PSV、PS2

用模拟器玩主机游戏也能翻译。LunaTranslator 支持 HOOK 模拟器直接读取模拟器内存中的文本，对 NS/PSP/PSV/PS2 的大部分游戏都有效，支持的模拟器清单见 docs/zh/emugames.md。如果某个模拟器不支持 HOOK，退回 OCR 模式兜底即可。

场景C：老游戏或无法HOOK的游戏——OCR

切到 OCR 模式，框选游戏中的对话区域，软件就会自动周期截图识别并翻译。内置的 PP-OCRv5 轻量模型开箱即用，想要更高精度可以换 PP-OCRv6 等模型，支持 GPU 和 OpenVINO 加速（详见 docs/zh/useapis/ocrapi.md）。

两个实用细节：

• 框选区域越小越好，只框对话区，避免复杂背景干扰识别；
• 在 HOOK 模式下遇到选择肢时，用"进行一次OCR"按钮临时识别一次选项，选完再切回 HOOK，非常顺手。

场景D：边玩边学日语——注音、查词、制卡

这是很多人的隐藏需求。LunaTranslator 内置日语分词和假名注音，装上 mecab 的 unidic 词典后，译文上方会直接标出假名和语法高亮（详见 docs/zh/qa1.md）。配合内置查词工具，鼠标悬停或点击单词即可查词典（详见 docs/zh/internaldict.md）。

学到的生词还能一键推进 Anki 制卡，甚至挂载 Yomitan 浏览器插件做深度查词（详见 docs/zh/ankisync.md、docs/zh/yomitan.md）。玩着玩着日语水平就上去了，这是官方文档里最容易被忽视的宝藏功能。

最容易纠结的两个选择，我给你结论

HOOK 还是 OCR？

选HOOK的3种情况：①玩的是主流视觉小说引擎（KiriKiri、吉里吉里、Renpy等）；②追求零延迟的顺畅体验；③游戏支持内嵌翻译，想要沉浸感。

选OCR的3种情况：①游戏是老古董或特殊引擎，HOOK 完全没反应；②玩的是模拟器且不支持HOOK；③你懒得折腾，只想框个区域就开翻。

一句话：先试 HOOK，不行再退 OCR，两个模式在软件里一键切换，没有任何成本。

翻译引擎怎么选？

大模型接口支持 OpenAI、Gemini、Claude、DeepSeek、通义、火山等主流平台，填好 API 地址和 Key 即可，还支持多 Key 轮询（详见 docs/zh/guochandamoxing.md）。进阶玩家建议直接上大模型接口，翻译质量碾压传统引擎，这也是目前社区的主流玩法。

故障自愈指南：症状、原因、解法

症状：HOOK 后一直提示"正在等待DLL注入到游戏中……"原因：杀毒软件把注入组件当病毒删了（HOOK 需要向游戏注入Dll，极易被误报）。解法：把软件整个文件夹加入杀毒软件信任名单，重新下载解压（详见 docs/zh/README.md）。

症状：选中的文本行全是乱码或抓不到正确的行原因：多半是代码页不对，或文本被重复绘制导致重复字符。解法：先调代码页；文本重复时，在"文本处理"里启用"HOOK去除重复字符/重复行"，这是最常用的过滤器（详见 docs/zh/textprocess.md）。

症状：OCR 识别不出或频繁重复翻译原因：OCR 结果不稳定，画面轻微变化就会重新识别。解法：在 OCR 设置里开启"分析图像更新"并调整稳定性阈值，同时设置"文本相似度阈值"过滤微小变化（详见 docs/zh/ocrparam.md）。

症状：软件报 Error/FileNotFoundError、PermissionError原因：前者是被杀软删了组件，后者是放在了受保护目录。解法：加信任重下，或换个普通目录解压。

症状：游戏卡顿原因：内嵌翻译的原理是"停住游戏等翻译"，翻译慢必然卡。解法：在设置里限制"翻译等待时间"，或改用外挂显示模式。

效率进阶：老玩家都在用的8个技巧

1. 拖拽启动游戏：把游戏 exe 直接拖进软件窗口，自动转区启动并自动 HOOK，省去手动选进程（docs/zh/basicuse.md）。
2. 一键临时OCR：HOOK 模式下遇到选择肢，用"进行一次OCR"秒查选项。
3. 专有名词词典：从 VNDB 自动拉取游戏人名，配合大模型 prompt 让角色名翻译始终统一（docs/zh/transoptimi.md）。
4. 翻译结果修正：用正则对译文做后处理，比如修正语气、清理格式符号。
5. 鼠标穿透窗口：把翻译窗盖在游戏文字上方，点鼠标仍能操作游戏，像内嵌一样自然。
6. 多配置文件：用--userconfig=XXX参数启动，一份软件跑多套配置，玩不同游戏互不干扰（docs/zh/gooduse/multiconfigs.md）。
7. 把翻译接到别处：内置 HTTP/WebSocket 服务，可用/api/translate等接口把翻译能力嵌进自己的脚本（docs/zh/apiservice.md）。
8. 快捷键自动化：绑定"自动模式/手动执行/取词翻译"等快捷键，鼠标都不怎么用碰（docs/zh/fastkeys.md）。

资源地图：官方文档与入口

• 基础使用：docs/zh/basicuse.md —— 三种模式的图文流程
• HOOK设置：docs/zh/hooksettings.md —— 刷新延迟、代码页、特殊码
• OCR参数：docs/zh/ocrparam.md —— 四种自动截图策略
• 翻译引擎：docs/zh/guochandamoxing.md —— 大模型与离线模型配置
• 文本处理：docs/zh/textprocess.md —— 乱码与重复文本的过滤器
• 模拟器支持：docs/zh/emugames.md —— NS/PSP/PSV/PS2 清单
• 语音能力：docs/zh/ttsengines.md、docs/zh/sr.md —— 朗读与语音识别

从下载到看到第一句译文只要五分钟，剩下的都是在"越用越顺手"的路上。找个想玩很久的日文游戏，解压、连接、选文本，剩下的交给 LunaTranslator——翻译引擎先用免费的百度，等你玩明白了再上大模型，体验还会再上一个台阶。祝玩得开心，也欢迎把遇到的问题反馈给作者，让这个工具越来越好用。

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