LunaTranslator视觉小说游戏翻译新手教程指南【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款开源的视觉小说游戏翻译工具通过进程 HOOK、屏幕 OCR 和多引擎翻译把外文游戏对话实时翻译成中文部分游戏还支持把译文直接内嵌回游戏画面。它适配绝大多数视觉小说并对 NS、PSP、PSV 等模拟器提供文本提取支持。它适合两类人想无中文字幕玩外文游戏的玩家以及想边玩游戏边做分词、注音和 Anki 复习的语言学习者。 安装前需要准备什么克隆源码仓库获取完整工程。git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator确认本机有可用的 Python 3 运行时源码方式运行依赖它。python --version在src/目录下启动主程序即run.bat中的原始命令。cd src python -B LunaTranslator/main.py平台说明LunaTranslator 依赖 Windows 的进程注入与系统 OCR 接口建议 Windows 10/11 环境运行macOS 和 Linux 无法完成 HOOK 模式。 核心模块一览表| 能力 | 一句话说明 | 对应目录或配置文件路径 | | - | - | - | | HOOK 文本提取 | 直接从游戏进程内存读取对话文本延迟最低 | src/LunaTranslator/textio/textsource/texthook.py | | OCR 文本识别 | 框选屏幕区域识别文字适配不支持 HOOK 的游戏 | src/LunaTranslator/ocrengines/ | | 多引擎翻译 | 覆盖在线翻译、离线翻译、大模型翻译等接口 | src/LunaTranslator/translator/ | | 文本后处理 | 翻译前过滤噪声字符、做错误纠正 | src/LunaTranslator/transoptimi/ | | 语音合成 | 把译文转成日语、英语等语音朗读 | src/LunaTranslator/tts/ |建议先按下一节跑通 HOOK 主线翻译再对照表格按需回看各模块配置。 首次运行最短路径场景一HOOK 模式翻译主线流程先启动目标游戏再打开 LunaTranslator。在 HOOK 模式的进程选择窗口中选中游戏进程并确认注入。让游戏运行出一段对话选择文本界面会出现若干候选文本行。点选与游戏对话吻合的文本行点击“显示”即可持续翻译。若游戏支持内嵌翻译可改点“内嵌”列按钮把译文直接写进游戏画面。场景二OCR 模式兜底在工具栏切换到 OCR 模式。用区域选择工具框住游戏对话框区域。软件自动持续识别并翻译注意别误点“仅识别一次”的按钮。⚙️ 影响体验最大的配置项对照三项配置的默认模板位于 src/LunaTranslator/defaultconfig/首次运行后个人设置会保存在 userconfig 目录。1. 本地 OCR 模型与线程位置src/LunaTranslator/defaultconfig/ocrsetting.json改什么{ local: { args: { model: PP-OCRv5_mobile, thread: 4, gpu: false } } }预期效果model决定识别精度与速度的平衡thread和gpu控制本地推理资源识别卡顿时可降低线程数或改用在线引擎。2. 文本过滤开关位置src/LunaTranslator/defaultconfig/postprocessconfig.json改什么{ _remove_symbo: { use: false, name: 过滤英文标点 } }预期效果把use改为true后识别结果中的标点噪声会在送翻前被过滤避免翻译接口报错或译文带杂字。3. 翻译接口地址位置src/LunaTranslator/defaultconfig/translatorsetting.json改什么{ lingva: { args: { host: translate.plausibility.cloud } } }预期效果部分免费接口支持更换host端点当前节点不稳定时切换地址即可恢复翻译。 踩坑清单与快速排错提示“找不到重要组件 / Missing embedded Python3”→ 可能原因杀毒软件删除了内置组件 → 处理方式给软件目录添加信任排除项后重新下载解压。卡在“正在等待DLL注入到游戏中”→ 可能原因注入进程被安全软件拦截 → 处理方式同样添加信任确认LunaSubprocess相关文件未被隔离。报 PermissionError 或无法保存配置→ 可能原因软件放在C:\Program Files等受保护路径 → 处理方式解压到普通目录再运行且删除重装时保留 userconfig 文件夹。HOOK 后选择文本界面没有候选行→ 可能原因游戏尚未输出对话或选错了进程 → 处理方式让游戏先显示一段文字再重新点选正确的文本行。详细报错对照可查 docs/zh/README.md。 跑通之后可以探索的方向内嵌翻译部分游戏可以把译文直接替换进游戏窗口免去切窗对照。操作细节见 docs/zh/embedtranslate.md。模拟器 HOOKNS、PSP、PSV、PS2 上的多数游戏可被直接读取文本支持机型列表在 docs/zh/emugames.md 和 docs/emusupportlist/ 目录。结语LunaTranslator 把文本提取、翻译与语音合成整合在一个开源工具里是视觉小说玩家常用的游戏翻译方案。中文官方文档位于 docs/zh/ 目录docs/zh/basicuse.md 是最完整的上手参考。现在打开软件、把游戏拖进窗口就能开始第一次实时翻译。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
