5分钟跑通视觉小说翻译LunaTranslator 从克隆到翻译首句【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator打开一款日版视觉小说满屏的假名和汉字让人寸步难行LunaTranslator 是一款专为 Galgame / 视觉小说设计的开源翻译工具它通过 HOOK、OCR、剪贴板三种方式捕获游戏文字接入你选定的翻译引擎后实时输出译文还能把结果变成语音读出来。本教程带你完成定位它能做什么 → 克隆并跑起来 → 配置一个顺手的翻译引擎 → 绕开新手最常踩的几个坑。一、先搞清楚LunaTranslator 替你解决了什么这一节用一分钟帮你建立对工具全貌的认知后面配置时心里有数。HOOK 文本捕获直接读取游戏内存里的文字不用你手动复制覆盖绝大多数常见与冷门引擎的游戏OCR 兜底识别HOOK 不灵或游戏是图片文本时它从画面里扫出文字内置高精度模型也支持外接多家 OCR 引擎翻译引擎从传统翻译接口到大语言模型接口都有对应入口译文质量取决于你填的接口TTS 语音输出把译文读出来通勤式听剧情语言学习向日语分词、假名注音、Anki 同步等边玩边学。详细能力清单可对照 docs/zh/index.md 中的官方特性页。二、跑通从克隆到看到翻译窗口这一节把环境检查和安装合并成一条最短路径克隆 → 装依赖 → 启动。1. 克隆代码git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator应看到src/、docs/两个目录即克隆完整。2. 检查 Python 环境项目主体是 Python 代码入口见 src/LunaTranslator/main.py需要 3.9python --version应显示Python 3.9或更高。没有安装的话从 Python 官网装一个安装界面务必勾选Add Python to PATH——这是新手 80% 的pip 不是内部命令问题的根源。3. 启动仓库提供 src/run.bat 作为 64 位启动脚本内部执行python.exe -B LunaTranslator\main.py32 位环境可用 src/run32.bat。在src目录下双击运行界面出现主窗口即成功命令行窗口里滚过一串依赖加载日志而无红色 traceback说明环境就绪。小贴士如果不想从源码跑也可以直接去 docs/zh/README.md 下载免安装的 Windows 64 位版本解压即用本教程后续配置部分同样适用。三、关键配置翻译引擎填什么、怎么填这一节只讲两个真正需要你动手的地方其余配置保持默认即可。翻译接口启动后进入 翻译设置推荐路线有 AI 平台 Key 的新手选大模型通用接口填入接口地址、API Key点 model 旁的刷新按钮拉取模型列表。多个 Key 用|分隔可自动轮询。选它的原因视觉小说里的机翻腔最重大模型译文最接近人话且支持附带上下文让前后句风格一致不想花钱选内置的 Bing 等免费接口先跑通流程之后再升级。判断成功的标志软件顶部测试栏点一下测试翻译输入一句日语几秒内返回中文。OCR 语言包仅在 HOOK 不工作时才需要HOOK 能工作的游戏不需要这一步。若你走 OCR 路线内置本地 OCR 引擎见 src/ocrengines/local.py开箱即用使用 Tesseract 等外部引擎时把jpn日语、chi_sim简体中文两个语言包放进引擎的tessdata目录识别语言设置里勾选日语。识别框选住游戏对话框、译文随之刷新即配好。四、常见问题三个报错的对症药方这一节按现象 → 原因 → 解法处理新手最高频的三类异常。1. 提示找不到重要组件 / Missing embedded Python3或 HOOK 后报 FileNotFoundError现象启动失败或选完进程后弹错误。 原因HOOK 需要把 DLL 注入游戏进程LunaSubprocess32.exe等文件杀毒软件极易把这类行为当病毒悄悄删掉组件。 解法先给软件目录加杀软排除项Windows Defender病毒和威胁防护 → 排除项 → 添加文件夹再重新下载解压。详见 docs/zh/README.md 的常见错误一节。2. HOOK 选完游戏进程候选文本列表一直是空的现象注入成功但没有任何文本行出现。 原因进程位数不匹配32 位游戏要用 32 位注入器或游戏有保护机制。 解法确认游戏 exe 是 32 位还是 64 位用对应版本启动软件仍不行就改用 OCR 模式框选文本区域或尝试管理员权限启动。3. 安装/更新后界面打不开报 PermissionError现象双击没反应或弹权限错误。 原因软件被放在了C:\Program Files这类受保护目录无法写配置和缓存。 解法把整个目录挪到如D:\Tools\LunaTranslator的普通路径注意迁移时别丢userconfig文件夹否则之前设置全部丢失。跑通到这里你已经能一边推进游戏剧情、一边看到中文浮现了。想继续深挖 HOOK 参数、TTS 引擎或内嵌翻译docs/zh/ 下有完整文档目录可供查阅。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
