LunaTranslator 新手教程：3 步跑起视觉小说翻译器，从安装到配置一次讲清
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款 Windows 平台的游戏文本翻译器，核心功能是通过 HOOK 注入、OCR 识别、剪贴板三种方式提取视觉小说（Galgame）中的文本并自动翻译。它几乎适配所有常见与冷门的游戏引擎，还支持将翻译结果直接内嵌到游戏画面中。本文带你完成安装启动、关键配置和日常使用。
项目速览：它能帮你做什么
- HOOK 提取文本：注入游戏进程直接读取内存文本，几乎不需要你动手选区域，是最省心的方式
- OCR 兜底：内置离线 OCR 模型，也支持多种在线引擎，能识别任意画面上的文字
- 翻译引擎丰富：内置大量在线与离线翻译接口，设置界面即可切换，无需改代码
完整功能说明可以参考 官方中文文档，里面有模拟器支持列表、语音合成、Anki 同步等进阶内容。
跑起来的最短路径：3 步完成首次启动
第 1 步：下载并解压。官方提供 Windows 10/11 64 位安装包，解压到任意目录即可，无需安装。如果你是开发者想从源码运行，可克隆仓库后执行 run.bat（内部调用python.exe -B LunaTranslator\main.py，位于 src/LunaTranslator/）：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator第 2 步：双击LunaTranslator.exe启动。程序有三个入口：LunaTranslator.exe普通启动、LunaTranslator_admin.exe管理员启动（部分游戏需要）、LunaTranslator_debug.bat带命令行窗口启动。
第 3 步：把游戏接入翻译。有两种方式：
- 对已启动的游戏：用工具栏的"选择游戏进程"，选中目标进程，确认注入
- 快捷方式：直接把游戏 exe 拖拽到 Luna 窗口里，它会自动启动游戏并 HOOK
注入成功后会弹出"选择文本"窗口。让游戏跑几句对话，列表中会出现候选文本行，点击你认为正确的那一行，翻译开始工作。
注意：不要把软件放在
C:\Program Files这类受保护路径下，否则配置和缓存可能无法保存，甚至无法运行。
关键配置详解：改哪几项最有效
所有用户设置存放在安装目录下的userconfig文件夹里，界面里改的每一项最终都会落到这里。默认配置模板在 src/LunaTranslator/defaultconfig/，了解结构有助于你理解各配置项的作用。
如何调整 HOOK 刷新延迟
先说结论：当"每次只提取出一两个字"或"文本提取得很慢"时，第一个要调的就是刷新延迟（详见 HOOK 设置文档）。
| 现象 | 处理方式 | | - | - | | 每次只提取一两个字 / 一行顶掉上一行 | 游戏文本显示太慢，调高刷新延迟，或把游戏文本速度调到最快 | | 文本正确但刷新慢 |适当调低刷新延迟，注意别又变成逐字提取 | | 文本反复不停刷新、刷屏 | 调低"最大缓冲区长度"或"最大允许输出文本长度"过滤突发文本 |
如何调整 OCR 识别参数
OCR 模式下自动识别的灵敏度和频率，由几个阈值控制（详见 OCR 参数文档）。
| 参数 | 作用 | 建议 | | - | - | - | | 执行方式 | 决定何时触发一次识别 | 看不懂其他参数时直接选"周期执行"，最简单 | | 图像稳定性阈值 | 判断画面是否稳定 | 游戏完全静态可设为 0；有动态背景则适当调高 | | 图像一致性阈值 | 判断文本是否变化、要不要重新识别 | 识别太快就调高，太迟钝就调低 | | 文本相似度阈值 | 过滤 OCR 结果的微小抖动 | 频繁重复翻译时适当调高 |
常用操作与定制：换语言、绑快捷键、切翻译引擎
如何修改界面语言
界面语言在设置界面中切换。程序内置了 20 多种语言资源文件，位于 src/files/lang/，包括中文、英文、日文、韩文、俄文等，切换后界面文案随之更新。
如何绑定常用快捷键
在"设置 → 快捷键"里，先打开"是否使用快捷键"总开关，再为单个功能分配按键。高频项值得绑定（完整列表见 快捷键文档）：
- 自动模式：暂停/继续读取文本，暂停游戏对话时很有用
- 显示/隐藏翻译：翻译总开关，关了就不再翻译
- 取词翻译：翻译鼠标当前选中的文字
如何接入其他翻译引擎
翻译引擎在设置界面直接选择即可，无需编辑文件。各引擎的参数（如 API 地址、端口）定义在 translatorsetting.json，例如 Chrome 系翻译会用到chromepath（浏览器路径）和debugport（默认 9222）。界面里选好引擎后按提示填写即可，配置会自动写入userconfig。
常见问题：3 个最容易踩的坑
"找不到重要组件 / Missing embedded Python3"这是杀毒软件误删了内嵌的 Python 和注入组件（HOOK 机制本身容易被误报为病毒）。把 Luna 所在文件夹加入杀毒软件排除项（Windows Defender：病毒和威胁防护 → 排除项 → 添加文件夹），然后重新下载解压。"正在等待 DLL 注入到游戏中"也是同一原因。
配置文件丢失或无法保存程序放在
C:\Program Files等受保护目录会导致PermissionError，换到普通目录即可。重新下载时误删设置删目录重装前，务必保留
userconfig文件夹，里面是你全部的自定义设置，删了设置就清零了。
按以上步骤操作，你应该已经可以让 LunaTranslator 稳定翻译一款游戏了。遇到特定游戏的适配问题，官方文档 中有更细的模拟器支持与 FAQ 章节可以继续参考。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
