5分钟跑通视觉小说翻译：LunaTranslator 从克隆到翻译首句

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.9+：

python --version

应显示Python 3.9或更高。没有安装的话，从 Python 官网装一个，安装界面务必勾选Add Python to PATH——这是新手 80% 的"pip 不是内部命令"问题的根源。

3. 启动

仓库提供 src/run.bat 作为 64 位启动脚本（内部执行python.exe -B LunaTranslator\main.py），32 位环境可用 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