企业官网建设流程全解析

LunaTranslator 完整指南：免费开源的游戏翻译工具，日语游戏实时翻译

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

LunaTranslator 是面向视觉小说与 PC 游戏的开源游戏翻译工具，实时抓取游戏对话并翻译成中文显示在桌面，还可朗读译文。适合想玩原版日语游戏的玩家、视觉小说爱好者与外语学习者。核心价值在于：HOOK、OCR、剪贴板监控三种捕获方式，配合十余种在线与离线翻译引擎，游戏文字拿不到 hook 时依然有翻译可用。

LunaTranslator 能做什么：捕获、翻译、朗读三件事

一句话定位：把外语游戏的对话实时转成目标语言文字，悬浮显示在桌面。三个核心能力如下。

• 文本捕获：HOOK 直接读游戏内存、OCR 识别截图、剪贴板监控复制文本，三种方式任选
• 翻译：10+ 引擎，在线有 DeepL、Google、百度等，离线有 Sakura、本地 LLM
• 语音朗读：系统 TTS、Edge TTS、第三方引擎，语速与音量可调

Windows 环境准备与源码安装命令

LunaTranslator 运行在 Windows 上，环境满足后直接装源码即可。

• 系统：Windows 7 SP1 及以上（推荐 Win10 / Win11）
• 运行环境：Python 3.6+
• 磁盘：至少 2GB 可用空间

克隆仓库后运行主程序：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator python src/LunaTranslator/main.py

首次配置步骤：选捕获、选引擎、验证跑通

第一次配置的目标是跑通，不是配全。按顺序做 4 件事。

1. 确认游戏进程：启动主程序后选定游戏进程，注意 32 位 / 64 位程序要与游戏位数对应。
2. 选择捕获方式：受支持的视觉小说选 HOOK；拿不到 hook 就改用 OCR，把识别区域拖到对话框上。
3. 选翻译引擎：先用 Google 或 DeepL 等在线引擎试跑，源语言日语、目标语言中文。
4. 验证输出：启动游戏，确认悬浮窗出现译文，再调整窗口位置与字号。

功能拆解：捕获方式与翻译引擎对照表

翻译引擎代码位于 translator 模块，文本捕获在 textio 模块。选型前先对照下表。

三套用法配方：新手极简、全离线、语音沉浸

按使用环境挑一套照做，每套配置都在 10 分钟内完成。

新手极简（OCR + 在线翻译）

1. 选 OCR 捕获，识别区域拖到对话框
2. 翻译引擎选 DeepL，目标语言中文
3. 启动游戏确认出字
4. 保存该游戏的配置，下次一键套用

全离线（本地 OCR + Sakura）

1. 在 OCR 引擎目录 中选本地引擎并下载日语语言包
2. 翻译引擎选 Sakura，或接入本地 LLM
3. 断网验证翻译仍然可用
4. 保存为独立配置，离线环境直接调用

语音沉浸（边玩边听）

1. 先完成上面的基础翻译流程
2. 在 TTS 模块 设置里启用朗读，选 Edge TTS 或系统 TTS
3. 调低语速到跟得上对话框切换的节奏
4. 用耳机试听，确认音量不过大

排坑指南：HOOK 不生效、OCR 不准、翻译慢

高频问题有 4 个，解法各 1-2 条。

• HOOK 不生效：以管理员身份运行，并确认 LunaTranslator 程序位数与游戏一致；仍不行时改用 OCR 捕获最直接。
• OCR 准确率低：确认已下载对应语言的语言包，识别区域与对话框对齐，窗口分辨率与字体越清晰越好。
• 翻译慢：换用响应更快的在线引擎或本地模型，检查网络，并开启翻译缓存。
• 读不出声音：确认已选择 TTS 引擎且系统音量未静音；Edge TTS 连不上时回退系统 TTS。

深度定制：配置文件清单与词典、过滤规则

默认配置位于 defaultconfig 目录，直接改文件即可生效，修改前先备份。

两个进阶设置值得优先做。

• 专有名词词典：把角色名、地名加入词典（词典配置文件），翻译会统一称呼，不再各引擎各译一套。
• 过滤与替换规则：通过后处理配置清理对话里的标点与重复内容，固定台词可替换成统一术语。

界面本身支持 20 余种语言与深色 / 浅色主题，在设置页切换即可。

想上手原版日语游戏，克隆仓库即可开始：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator

仓库 docs 目录 还有 OCR 参数、HOOK 设置与多语言界面的详细说明，配置卡住时按目录查阅。

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