LunaTranslator 新手使用指南：从启动游戏到内嵌翻译的完整配置流程-开发者社区

LunaTranslator 新手使用指南：从启动游戏到内嵌翻译的完整配置流程

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

LunaTranslator 是一款面向视觉小说与 Galgame 的开源游戏翻译工具，通过 HOOK 读取游戏内存、OCR 识别屏幕区域、剪贴板捕获三种方式获取文本，再交给内置的几十种翻译引擎处理。配置完成后，译文可以显示在跟随游戏的独立窗口里，也可以直接内嵌到游戏对话框中，还可附加 TTS 朗读与词典查询。本指南按实际使用顺序，覆盖从装好软件到内嵌翻译生效的路径，适合第一次接触该工具的 Windows 用户。

装好 LunaTranslator 并跑通第一个界面

从仓库拉取代码并运行主程序：

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

启动后先做两件基础设置：在设置中选择一种翻译引擎（默认配置位于 translatorsetting.json），然后按基础使用文档的流程完成第一次文本获取。

软件本体运行在 Windows 桌面环境，游戏与软件需同时启动。32 位游戏可配合src/run32.bat使用，引擎适配范围可参考游戏支持列表。

HOOK 模式：多数视觉小说的首选路径

HOOK 模式的延迟最低，因为文本直接从游戏内存中读取，不经过截图识别。以一款 Ren'Py 或 KiriKiri 游戏为例，操作步骤是：

先启动游戏并推进到出现对话的界面。
在软件工具栏点选 HOOK 模式，打开进程选择窗口，选中游戏进程。
弹出的文本选择窗口会列出若干候选文本行，让游戏正常滚动两句对白后，选中内容跟随剧情变化的那一行。
点“显示”按钮，译文窗口即跟随游戏内容刷新；支持内嵌的条目还会有“内嵌”按钮。

选错文本行是新手最常见的情况：候选行里混杂了背景描述、按钮文字甚至空字符串，判断标准只有一条——译文窗口里出现的内容必须与画面上的对白同步变化。选错后随时可以重新打开文本选择窗口更换。

OCR 模式：HOOK 取不到文本时的替代方案

部分老游戏、模拟器游戏或 Hook 引擎未适配的引擎会提取不到正确文本，此时切换到 OCR 模式，框选文本区域后软件会按截图节奏自动识别。两个操作要点：

框选区域尽量只包住文本框内部。对话框背景越静态，识别越稳定；混入动画元素的区域会频繁触发重复识别。
截图策略默认选“周期执行”即可，它是文档中注明最不易出错的选项。若游戏有动态背景导致识别过频，可提高“图像一致性阈值”；识别迟钝则调低。

区域框选时注意使用“选取 OCR 范围”按钮而非外观相似的“识别一次”按钮，前者是持续识别，后者只对当前画面执行单帧 OCR，适合临时识别选择肢等偶发文本。详细参数说明在 OCR 自动化执行文档。

翻译结果不理想时从哪里调起

翻译质量差通常卡在三个环节，排查顺序与症状对应：

文本提取环节：译文每次只蹦出几个字、整行被反复顶掉，多为 HOOK 的“刷新延迟”过低，调高即可；识别出的文字含错字，则检查 OCR 区域是否过大或字体过小。
翻译环节：某类句子机翻感明显，可更换引擎对比同一文本的输出，翻译引擎目录下几十种实现可直接在设置中切换。
后处理环节：重复文本被反复翻译、纯标点也触发请求，可在 transoptimi 目录对应的设置中启用错误修正与纯标点跳过。

先定位症状属于哪一环，再动对应参数，比逐项全改更容易收敛。

内嵌翻译：让译文直接显示在游戏对话框里

支持内嵌的游戏在文本选择窗口中会多出一列“内嵌”按钮，激活后软件会在游戏显示文本前拦截它，替换为译文再放行，效果等同于汉化补丁。两个前置提醒：并非所有游戏支持内嵌；内嵌修改游戏内存，个别游戏存在崩溃风险。

内嵌后出现乱码的两种典型处理：英文游戏显示方块，通常是游戏缺中文字体，激活“修改游戏字体”并指定一个本机中文字体；古早日系游戏出现缺字或错位，可尝试“将汉字转换成繁体/日式汉字”。完整排错步骤见内嵌翻译文档。

离线与本地化配置

断网环境下的思路是用本地组件替换在线服务。翻译侧，设置中的本地模型方案可配合 llama.cpp 运行时加载本地权重完成翻译，不产生网络请求：

本地模型离线翻译示意

识别侧，[本地 OCR 目录](https://link.gitcode.com/i/89b518c1e0b42e568f1c51f7369ef3c5)提供 Tesseract、MangaOcr、Windows 系统 OCR 等无需云端接口的引擎。全部走本地后，翻译延迟取决于本机硬件，速度较慢时建议只走外挂显示窗口，或在内嵌设置中调低“翻译等待时间”上限，避免游戏长时间卡帧。