企业官网建设流程全解析

LunaTranslator 完整教程：三条路径把游戏台词抓出来实时翻译

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

LunaTranslator 是一款视觉小说（Galgame）实时翻译工具，核心工作是把日语文本从游戏内存或屏幕画面里抠出来，翻成中文后以字幕显示，或者直接内嵌写回游戏的对话框。这篇教程从克隆源码跑起来讲起，重点拆文本获取、翻译流水线两块，最后把高频坑的成因和解法列清楚。

🧩 环境核对

软件只跑在 Windows 上（Win10 1803 以上 / Win11 体验最好），源码运行需要 Python 3.x 和 PyQt 环境。HOOK 机制要往游戏里注入 DLL，这类组件极易被杀软误报，所以先把安装目录加入排除项，比事后排查"组件丢失"省事得多。

⚡ 两条命令跑通

仓库里run.bat的本体就是一条启动命令，依赖没装齐时按报错提示 pip 安装对应包（主要是 PyQt 和网络库）即可。

克隆代码到本地：

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

在仓库根目录执行：

python -B src/LunaTranslator/main.py

窗口能弹出来就算跑通了。-B跳过字节码写入，保持目录干净。

🔧 抓文本的三条路：HOOK 优先，OCR 兜底

HOOK 是首选路径：把钩子注入游戏进程，监听字符串显示函数，文本从内存里直接流出。操作顺序是——游戏先启动，点"选择游戏进程"选中它，等屏幕打出几段台词后，在文本选择窗口里点中那条和画面一致的文本行，翻译就开始了。如果引擎支持内嵌，界面上会出现"内嵌"按钮，点它译文会直接写进游戏对话框，体验接近官方汉化。

HOOK 抓不到就切 OCR：对固定屏幕区域截图识别，引擎实现都放在 src/LunaTranslator/ocrengines/ 目录里，Windows 自带 OCR、Tesseract 这类离线引擎不耗流量，百度、腾讯等云识别精度更高。区域框好一次，后续逐帧自动识别。

第三条路最朴素——剪贴板模式：复制文本到剪贴板即触发翻译，适合临时查句。

🧪 翻译流水线：引擎 + 后处理

文本到手后挑翻译接口：Bing、Google、百度、DeepL 等云 API，本地模型，以及大语言模型接口都可选。LLM 接口能附带上下文并自定义 prompt，对长句和专有名词的效果明显好于普通机器翻译。

后处理是 HOOK 的配套环节：游戏常把同一句文本反复绘制（阴影、描边、逐字重绘），抓出来的就是AABBCC式重复串。打开 docs/zh/textprocess.md 里列的"去除重复字符""过滤非日语字符集"等过滤器即可清洗，脏得没救的形态可以写自定义 Python 脚本接管。

📦 按场景对号入座

PC 视觉小说

• HOOK 模式起步，文本缺字断行就先调大"刷新延迟"
• 引擎支持的话开内嵌翻译，沉浸感最好
• 专有名词多时切 LLM 接口并开启上下文附带

模拟器游戏（NS / PSV / PS2）

• HOOK 模拟器进程直接读文本，不碰原版游戏
• 文字乱码时先确认模拟器区域语言设为日语
• 支持的模拟器清单参考docs/zh/emugames.md

想顺便学日语

• 开日语分词与假名注音
• AnkiConnect 同步单词卡
• 接 Yomitan 插件共享词库

⚠️ 四个高频坑的成因和解法

打不开，报"找不到重要组件 / Missing embedded Python3"成因：杀软把注入组件或运行时文件删了，这类 DLL 是最容易被标病毒的特征。解法：关杀软或加排除项，重新解压整个包，别只补单个文件。

HOOK 一次只出一两个字，或者整行不断顶掉成因：刷新延迟太低，游戏文本还没打完字就被刷出去了。解法：调大刷新延迟，或在游戏设置里加快文字显示速度。

译文里出现成倍重复的字符或整句成因：同一文本被多次绘制（描边、阴影、逐字符重绘）。解法：激活"HOOK 去除重复字符/重复行"过滤器；实在去不干净就写自定义 Python 后处理。

保存配置时报 PermissionError成因：软件放在C:\Program Files这类受保护路径，连管理员权限都写不进去。解法：挪到普通目录再启动。

写在最后

把 LLM 接口接进翻译流水线、用自定义词典把专有名词钉死，或者研究内嵌翻译的注入原理，都可以作为下一步的延伸方向。

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