企业官网建设流程全解析

LunaTranslator实践手册：一套实时视觉小说翻译链路怎么搭

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

游戏里刚弹出日文对白，悬浮窗口里中文已经同步出现——这是视觉小说翻译工具配合得当时该有的样子。LunaTranslator 是一款免费开源的游戏翻译工具，它通过 HOOK、OCR、剪贴板三条链路读取游戏文本，接入翻译引擎实时显示，还能把结果转成语音读出来。它运行在 Windows 上，也支持 HOOK 模拟器，直接读取 NS、PSP、PSV、PS2 上的游戏文本。

它是怎么读到游戏文字的

Galgame翻译的第一步是"抓字"，LunaTranslator 提供了三条捕获链路，按可靠性排序：

1. HOOK 读内存。向游戏进程注入钩子，在文本输出到画面的那一瞬间直接取走，不经过截图、不走识别，速度快且几乎不受字体样式影响。它对常见和冷门视觉小说的适配覆盖最广，是首选链路。
2. OCR 读画面。对游戏窗口截图，用本地 OCR 模型或在线引擎（百度、Tesseract5、Windows OCR、OCR.space 等）识别出文字。HOOK 接不住的游戏，走这条路。
3. 剪贴板监控。监听游戏里复制出来的文本，适合本身带"复制对话"功能的场景。

文本抓到之后的处理路径是固定的：先过翻译引擎，再呈现到悬浮窗口，可选地交给 TTS 引擎合成语音。翻译引擎有 10 余种实现，从 src/LunaTranslator/translator/ 目录可以直接看到全部源码，包括 DeepL、Google、百度、微软、Azure、Papago 等在线服务，以及 Sakura 大语言模型、本地 LLM 等离线方案。部分游戏还支持把译文直接内嵌回游戏窗口，省去看悬浮窗的切换动作。

在Windows上跑起来

先对照环境清单，四项全满足再动手：

• Windows 7 SP1 以上，推荐 Windows 10/11
• Python 3.6+，3.9+ 更好
• 至少 2GB 可用磁盘空间
• 稳定网络（安装依赖、调用在线引擎都要用）

安装步骤就三步：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator pip install -r requirements.txt

pip install会自动装齐 PyQt5、requests 等依赖，装完即可从src/LunaTranslator/main.py或仓库提供的run.bat启动。

三个容易踩的坑单独说：

• PATH 勾选。装 Git 时勾上 "Add Git to PATH"，装 Python 时勾上 "Add Python to PATH"，否则后续命令全部找不到。装完用git --version和python --version各验证一次。
• 管理员权限。HOOK 要读别家进程的内存，普通权限下会被系统拒绝，所以跑 HOOK 链路时以管理员身份启动 LunaTranslator。
• 位数匹配。32 位游戏配 32 位 HOOK 模式，64 位游戏配 64 位模式，选错了抓不到字。

第一次运行：给游戏配一条完整链路

给具体游戏配链路时，按"先抓、再译、后读"的顺序决策。

第一步，定捕获方式。优先试 HOOK：以管理员权限启动，按游戏位数选模式，能抓到字就定了。抓不到再切 OCR——先试内置的本地 OCR 模型，精度不够再换在线引擎。如果游戏自带复制文本的功能，剪贴板监控是成本最低的兜底。

第二步，定翻译引擎。在线引擎质量稳定、零配置，DeepL 对日语游戏中文的输出质量通常最省心；追求离线和速度就选 Sakura 或本地 LLM。日文源、中文目标是默认组合，也可以反着配成中译英。

第三步，定 TTS。需要边看边听就挂上 Edge TTS 或 Windows 系统 TTS，不朗读就关掉，省一点开销。

两组推荐组合可以直接抄：

• 在线主力：HOOK + DeepL + Edge TTS，日文游戏最通用的配置。
• 离线低延迟：HOOK + Sakura 本地模型 + 本地 TTS，断网也能玩。

用得更顺手

跑通之后，这几个地方值得再花十分钟：

• 语音朗读。翻译结果默认只显示文字，开启 TTS 后会随对白同步播出来，眼睛不用再在窗口和文字之间来回挪。
• 名词词典。游戏里的角色名、地名常被机翻翻岔，用 transoptimi/noundict.py 对应的功能建一份专名表，指定词固定译法。
• 翻译错误修正。transoptimi/transerrorfix.py 处理的是"翻对了字、翻错了意"这类残留问题，配几条规则能明显减少翻车。
• 界面主题。浅色、深色主题在src/files/LunaTranslator_qss/下，按显示环境切换，长时间盯窗口的话深色更护眼。
• 多语言界面。src/files/lang/里内置了 20 多种语言的界面文案，不是只有中文界面。

出问题先查这里

资源索引

链路搭好后，日常使用基本不用再碰配置。想深入某一块时，直接查这两处就够了：

• 官方文档（含 HOOK 设置、模拟器支持列表、TTS 引擎清单）：docs/zh/
• 出厂默认配置示例，改配置前可先对照：src/LunaTranslator/defaultconfig/

把捕获、翻译、语音三段各自选对，再按上表排一遍障，绝大多数视觉小说都能玩起来。

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