如何 3 步装好 LunaTranslator：Galgame 翻译器新手完整指南
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款面向视觉小说（即文字冒险游戏）的免费翻译工具，主打 HOOK、OCR 和剪贴板三种取文本方式，把游戏里的外文实时翻成中文。适合想无字幕畅玩外语 Galgame 的玩家，也适合想借游戏学外语的初学者。全文约 5 分钟读完。
它能帮你做什么
一句话：游戏里出现外文，它就自动抓出来、翻译好、甚至塞回游戏画面里。
| 你的需求 | LunaTranslator 的对策 | | - | - | | 直接读懂游戏文本 | HOOK 进游戏内存，实时抓字翻译，覆盖主流及小众引擎 | | 想要"沉浸式"阅读 | 内嵌翻译，译文直接替换游戏内原文 | | 游戏读不到字时兜底 | OCR 识别截图文字，在线、离线引擎任选 | | 顺便学外语 | 日语分词、假名注音、Anki 生词导出 |
翻译引擎也足够多：常见在线翻译接口和大语言模型（用 AI 大模型生成译文，语气更自然）都能接，配置都在 src/LunaTranslator/translator/ 里。
三步装好它
第 1 步：拿到软件。推荐去官网下载现成的打包版（解压即用，无需装 Python）。如果你是开发者想从源码跑，执行：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator源码入口在 src/LunaTranslator/，启动脚本就是仓库里的 run.bat，内部等价于用 Python 运行 main.py。
第 2 步：安装/解压。打包版解压到任意目录即可。有一个硬要求：别放进C:\Program Files这类系统保护目录，否则它连配置都写不进去，直接罢工。普通用户跳过源码依赖这一步；跑源码才需要自行配好 Python 环境。
第 3 步：首次启动。双击LunaTranslator.exe即可（部分独占游戏需要管理员权限时，用同目录的LunaTranslator_admin.exe）。它默认会自动检查更新，失败就手动下载新版解压覆盖旧目录。
进阶提示：首次运行前先把软件目录加入杀毒软件的排除项。它要往游戏里注入 DLL 才能抓字，这个行为非常容易被误报成病毒，后文的问题 80% 都源于此。
核心功能速览
HOOK 模式：最省事的取字方式
它是干嘛的：直接挂钩游戏进程，从内存里读出文本，比截图识别更准更快。什么时候用：几乎任何时候，这是首选。怎么开：游戏先跑起来，打开"选择游戏进程"窗口选中它，等候选文本列表出现后，点选那条看起来像台词的行即可。懒得手动挂钩？直接把游戏 exe 拖进 Luna 主窗口，它会自动启动并挂钩游戏。操作细节可看基本用法。
OCR 模式：HOOK 失效时的备胎
它是干嘛的：对屏幕区域做文字识别（OCR，即"读图识字"）再翻译。什么时候用：HOOK 找不到文本、或你要翻译游戏外的图片文字。怎么开：切到 OCR 模式，框选识别区域，它就持续识别并翻译。引擎有本地离线模型（内置，识别精度不错）和多家在线服务，都放在 src/LunaTranslator/ocrengines/，可按网络情况切换。
内嵌翻译：最沉浸的体验
它是干嘛的：把译文直接写回游戏画面，替代原文显示。什么时候用：游戏引擎支持内嵌、且你受够了"游戏在上、译文在旁"的副屏式排版。怎么开：HOOK 成功后，候选文本行里出现"内嵌"按钮，点它就生效；没有该按钮说明这款游戏不支持，老老实实用"显示"模式。更多引擎兼容说明在内嵌翻译文档。
卡住了怎么办
| 现象 | 原因 | 解法 | | - | - | - | | 提示"Missing embedded Python3" / 找不到重要组件 | 杀毒软件把内嵌的 Python 运行库删了 | 把 Luna 目录加入杀软排除项，重新下载解压 | | 卡在"正在等待 DLL 注入到游戏中……" | 同上，注入用的 DLL 被拦截 | 同上；Windows Defender 在"病毒和威胁防护 → 排除项"里加文件夹 | | 运行一段时间后报 FileNotFoundError | 组件被杀软"事后补刀"删掉了 | 提前加排除项，别等报错了才加 | | 报 PermissionError、配置保存失败 | 软件装在 Program Files 等受保护目录 | 整个目录挪到别处，如 D 盘根目录 | | 选不出游戏进程、HOOK 无候选文本 | 游戏是 64 位独占/加壳程序，或权限不够 | 换管理员启动器；仍不行就切 OCR 模式兜底 |
更多错误截图与排查流程见官方常见问题文档。
下一步建议
装好并跑通一个游戏后，建议按这个顺序折腾：先给 OCR 换一台不依赖网络的离线引擎，保证断网也能玩；再配一个你顺手的翻译接口，嫌机翻生硬就上大语言模型翻译；最后打开假名注音和 Anki 同步，把"玩游戏"顺便变成"背单词"。各模块的完整参数文档都放在 docs/zh/ 下，遇到具体功能名搜一下就有。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
