LunaTranslator 新手使用指南从启动游戏到内嵌翻译的完整配置流程【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款面向视觉小说与 Galgame 的开源游戏翻译工具通过 HOOK 读取游戏内存、OCR 识别屏幕区域、剪贴板捕获三种方式获取文本再交给内置的几十种翻译引擎处理。配置完成后译文可以显示在跟随游戏的独立窗口里也可以直接内嵌到游戏对话框中还可附加 TTS 朗读与词典查询。本指南按实际使用顺序覆盖从装好软件到内嵌翻译生效的路径适合第一次接触该工具的 Windows 用户。装好 LunaTranslator 并跑通第一个界面从仓库拉取代码并运行主程序git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator启动后先做两件基础设置在设置中选择一种翻译引擎默认配置位于 translatorsetting.json然后按 基础使用文档 的流程完成第一次文本获取。软件本体运行在 Windows 桌面环境游戏与软件需同时启动。32 位游戏可配合src/run32.bat使用引擎适配范围可参考 游戏支持列表。HOOK 模式多数视觉小说的首选路径HOOK 模式的延迟最低因为文本直接从游戏内存中读取不经过截图识别。以一款 RenPy 或 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 等无需云端接口的引擎。全部走本地后翻译延迟取决于本机硬件速度较慢时建议只走外挂显示窗口或在内嵌设置中调低“翻译等待时间”上限避免游戏长时间卡帧。用快捷键与窗口行为提升游玩体验快捷键需先在设置中激活总开关再逐项绑定。日常使用频率最高的几个暂停/继续自动读取剧情回顾或切场景时用、手动执行一次、鼠标穿透窗口与窗口透明把译文窗口压在对话框上方且不抢焦点、隐藏工具栏。完整列表见 快捷按键文档。译文窗口的位置、大小、字体均可在显示设置中按游戏逐个保存配合“放弃窗口焦点”快捷键后软件基本可以做到只在需要时被感知。下一步建议先用 HOOK 模式跑通一款熟悉的游戏建立基准手感再按上文的顺序处理 OCR 与内嵌场景遇到具体游戏的问题可查阅 中文文档目录 中对应章节。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
LunaTranslator 新手使用指南从启动游戏到内嵌翻译的完整配置流程【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款面向视觉小说与 Galgame 的开源游戏翻译工具通过 HOOK 读取游戏内存、OCR 识别屏幕区域、剪贴板捕获三种方式获取文本再交给内置的几十种翻译引擎处理。配置完成后译文可以显示在跟随游戏的独立窗口里也可以直接内嵌到游戏对话框中还可附加 TTS 朗读与词典查询。本指南按实际使用顺序覆盖从装好软件到内嵌翻译生效的路径适合第一次接触该工具的 Windows 用户。装好 LunaTranslator 并跑通第一个界面从仓库拉取代码并运行主程序git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator启动后先做两件基础设置在设置中选择一种翻译引擎默认配置位于 translatorsetting.json然后按 基础使用文档 的流程完成第一次文本获取。软件本体运行在 Windows 桌面环境游戏与软件需同时启动。32 位游戏可配合src/run32.bat使用引擎适配范围可参考 游戏支持列表。HOOK 模式多数视觉小说的首选路径HOOK 模式的延迟最低因为文本直接从游戏内存中读取不经过截图识别。以一款 RenPy 或 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 等无需云端接口的引擎。全部走本地后翻译延迟取决于本机硬件速度较慢时建议只走外挂显示窗口或在内嵌设置中调低“翻译等待时间”上限避免游戏长时间卡帧。用快捷键与窗口行为提升游玩体验快捷键需先在设置中激活总开关再逐项绑定。日常使用频率最高的几个暂停/继续自动读取剧情回顾或切场景时用、手动执行一次、鼠标穿透窗口与窗口透明把译文窗口压在对话框上方且不抢焦点、隐藏工具栏。完整列表见 快捷按键文档。译文窗口的位置、大小、字体均可在显示设置中按游戏逐个保存配合“放弃窗口焦点”快捷键后软件基本可以做到只在需要时被感知。下一步建议先用 HOOK 模式跑通一款熟悉的游戏建立基准手感再按上文的顺序处理 OCR 与内嵌场景遇到具体游戏的问题可查阅 中文文档目录 中对应章节。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
