3分钟跑通LunaTranslator：视觉小说实时翻译实操指南
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
打开一款全日语文游，满屏片假名和敬语，剧情走到哪儿都卡在对话框上。这就是 LunaTranslator 想解决的事：把它挂到游戏进程上，视觉小说翻译就自动跟着台词刷出来，全程不用你动手。
五步看到第一句译文
装完依赖库先别急着关窗口，把这条命令跑一遍验证环境：
python --version然后照这五步走：
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator - 装好 Python 3.9+，安装时勾选"Add Python to PATH"（run.bat 里的
python.exe直接依赖系统环境）。 - 进入仓库根目录，双击
run.bat（32 位系统用run32.bat），主界面弹出即算跑起来。 - 主界面选一个在线翻译引擎，源语言设成日语、目标语言设成中文。
- 点"附加进程"选中游戏进程，开始 HOOK。
游戏里每蹦出一句新台词，下方悬浮窗就会刷出译文——第一句译文到手，跑通收工。
💡 提示：不挂游戏也能自测，用剪贴板或文本输入方式粘一段日文，主界面会直接给你翻译结果。
三种取词方式，一张表看懂
先花十秒搞清楚"字是怎么被抓出来的"，后面配置不迷路：
| 方式 | 原理 | 点评 |
|---|---|---|
| HOOK | 注入游戏进程，直接从内存里读文本 | 又快又准，但游戏得有支持的引擎，翻车了再换路 |
| OCR | 截图识别游戏画面上的字 | 谁都能抓，就是费眼睛也费显卡，字糊了它就抓瞎 |
| 剪贴板 | 监听复制动作，捕获你复制的文本 | 最朴素，最稳定，手动党专用 |
按你玩的游戏挑引擎和参数
翻译引擎都在 src/LunaTranslator/translator/ 目录下，默认配置放在 src/LunaTranslator/defaultconfig/。按下面的场景对号入座：
| 你玩的是 | 推荐配置 |
|---|---|
| 日文视觉小说（主流选择） | 主引擎用 DeepL，网络抖了就切谷歌兜底；源日语、目标中文，开自动翻译 |
| 英文游戏或英文文本 | 首选谷歌，语种覆盖最宽；术语多的作品顺手开一下名词词典 |
| HOOK 抓不到词的游戏（引擎不支持、文本加密渲染） | 切 OCR 模式：先框选文本区，再调置信度阈值（0.7~0.8 比较稳），字小的游戏把窗口分辨率拉到 1080p 以上 |
| 断网 / 不想走在线接口 | 用 Sakura 本地模型，或接一个本地 LLM 跑离线翻译 |
⚠️ 注意：OCR 抓得准不准，七成取决于游戏字体清不清晰。文本区被特效、立绘遮挡时，先调游戏设置，再怪识别率。
翻不动的时候查这张表
| 现象 | 可能原因 | 解法 |
|---|---|---|
| 附加进程失败 / HOOK 无效 | 游戏引擎没适配，或进程受保护 | 用管理员身份重开程序；查文档里支持的引擎列表，不行就换 OCR 模式 |
| 译文刷得慢 | 在线接口慢或网络差 | 换备用引擎，或切本地模型；代理设置里补一条出口 |
| OCR 识别错误多 | 字小、字糊、背景花 | 调大游戏字体和分辨率，收窄识别区，微调置信度阈值 |
| 悬浮窗显示乱码 | 游戏文本编码不是常见 UTF | 在附加进程后设置正确编码；仍乱码就用文本输入方式自测，先确认翻译链路本身没问题 |
这些玩法知道就行
名词表可以让"セーブ、ロード"这类词永远翻成你想要的词，入口在设置里的翻译优化项，思路是登记原文加译文；TTS 能把译文实时念出来，引擎、声音、语速都在 TTS 设置页里挑；界面支持二十多种语言，改个下拉框就能把菜单换成你顺眼的语言。另外仓库内置了 llama.cpp 运行时，本地大模型翻译开箱即用：
卡住了去哪找答案
更细的功能说明都放在 docs/zh/ 里，一篇一主题，对着报错找就好。复现不了、定位不了的问题，直接去项目的 issue 区开一单，把游戏名、版本、现象贴全，基本都有人接。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
