LunaTranslator 视觉小说实时翻译上手：从安装到第一句中文的 5 个里程碑
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款开源免费的视觉小说翻译器，专门把视觉小说（即文字冒险游戏，Galgame 也属此类）里的外文对话实时译成中文。读完这篇文章，你能独立完成全部流程：装好程序、把游戏接进去、选对取词方式和翻译引擎，让日文对话框里的句子当场变成简体中文。
开始前的自检：系统要求与三件事
动手前，对照下面这份清单，确认环境没问题。
最低环境要求
- 系统：Windows 10（1803 版本及以上）或 Windows 11，64 位
- 硬件：普通笔记本即可；若想本地跑大模型翻译，需要一块独立显卡
- 网络：联网翻译必须有网；离线模式下载模型时需要联网，下载完成后可断网使用
安装前检查三件事
- 别把软件放进
C:\Program Files这类受保护路径。官方文档明确警告：放在特殊目录下即使以管理员权限运行，也可能无法保存配置和缓存，甚至直接起不来。选 D 盘根目录之类的普通位置即可。 - 杀毒软件先留个心眼。软件的 HOOK（挂钩，指把一段代码注入游戏进程、从内存里拦截文本流）功能靠几个注入组件实现，容易被误报为病毒。装完后如果启动异常，第一件事就是给软件目录添加信任。
- 确认游戏语言与目标翻译方向。启动后按向导选择界面语言和翻译方向，比如"日语 → 简体中文"，后面所有步骤都基于这个方向。
M1：如何安装并让 LunaTranslator 第一次跑起来
在终端里执行下面这条命令，克隆项目仓库：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator仓库根目录的run.bat是运行入口，它实际执行的是python.exe -B LunaTranslator\main.py。也就是说，从源码仓库直接运行前，你的电脑需要先装好 Python 3 环境；仓库里src/LunaTranslator/下就是全部 Python 源码，出问题时可以对照着看。
双击入口运行后，主窗口会弹出来，向导让你选界面语言和翻译方向。看到主界面、工具栏按钮都能正常点击，M1 就算完成。此时软件会自动检查更新，失败也不影响使用。
M2：如何把游戏接进来，看到第一条翻译
拿到游戏可执行文件后，最快的路径只有一步：把游戏的 exe 直接拖进主窗口，松开鼠标。
软件随后自动完成三件事：转区启动游戏（老游戏需要转区才能正常运行的话，它帮你处理）、向游戏进程注入 HOOK、弹出"选择文本"窗口。
接下来让游戏正常跑上两句对话。选择文本窗口里会滚出一批候选文本行，逐行扫一眼，勾中正在被游戏显示的那一条，点"显示"，主界面里立刻出现中文译文。这就是你要的第一句。
两个细节先记住：
- 如果游戏已经在运行，别拖 exe 了，直接打开"选择游戏进程"窗口，从进程列表里挑它即可，效果相同（对应文档：基本用法）。
- 如果候选文本行里除了"显示"还多出一个**"内嵌"按钮**，说明这个游戏支持内嵌翻译——激活它，译文会直接替换游戏对话框里的原文，相当于现场汉化。没有这个按钮的游戏就只有"显示"一种，译文显示在软件自己的窗口里。
M3：如何为你的游戏挑取词模式
LunaTranslator 拿到游戏文本有三条路，选哪条取决于游戏本身。下面按场景说。
走 HOOK 内存读取，当你的游戏是现代视觉小说时。对话要即时出译文、不想每次手动截图，这是首选。它延迟最低，因为文本从进程内存里直接截出来，游戏还没翻完页译文就到了。代价是它只认支持的引擎：太老的引擎、或者注入不进去的游戏，这条路走不通，候选文本行会是空的，这时别硬试，往下看。
走 OCR 截图识别，当注入失败或引擎不认时。切换到 OCR 模式，框住对话框区域，让框恰好包住文字，软件会持续截图、识别、翻译，之后你不用动手。受分辨率和字体影响，识别率取决于字体清晰度，所以框要尽量紧。注意工具栏里有个图标几乎一样的按钮，它只用于临时选取并识别一次，不是持续识别，别按错（详见 OCR 与识别参数文档）。
走剪贴板捕获，当游戏自带"复制文本"功能时。开启剪贴板监听后，在游戏里用它的复制功能抄一句话，译文自动出现，不用切窗口。这条路最省事，但前提是你得手动触发复制，只能当备用通道，不适合全程挂着。
三条路可以混着来：HOOK 为主，某段剧情抽风了切 OCR 顶着，个别句子手动复制。
M4：如何选翻译引擎：联网、离线、混合三种情形
取到原文后交给谁来翻，按你的网络和使用环境分三种情形。
情形一：稳定联网，追求低延迟。直接用在线翻译接口。在翻译设置里启用百度、腾讯、谷歌等常见接口即可，响应在秒级内，不占本机显卡，代价是每条原文都过网络。在线接口多配一两个，一个出错时不至于全线停摆。
情形二：经常断网，或不愿原文出机器。用本地大模型。这类引擎把模型放在你自己电脑上推理（文档里提到 llama.cpp 一类推理框架在本机跑模型），配好后可离线使用。视觉小说场景有专门微调的离线模型可选，比如日译中方向的 SakuraLLM / GalTransl 一类（见 大模型翻译接口文档）。代价是比在线慢一些，且吃显卡，核显或轻薄本上体验会打折。
情形三：混合。有网时用在线接口顶着保延迟，同时把本地模型留在配置里，断网、限流或在线接口抽风时切过去，翻译不停。这是长时间挂机跑剧情时的稳妥搭配。
M5：四个实用点，让译文读起来像人话
翻译能跑了之后，剩下的问题是人名乱跳、用词别扭、对话框显示不下。四个针对性手段：
- 给游戏建专用词典。把角色名、地名加进"游戏设置 → 翻译优化"里的专有名词词条，翻译时自动固定成你定的译名。词典建议加在该游戏的专用设置里而不是全局，这样切游戏时自动切换，各游戏的术语互不干扰（详见 翻译优化文档）。
- 用正则做翻译结果修正。翻译完成后对译文跑替换规则，比如把某个称呼全文统一，修掉机翻腔。
- 显示层面防截断和乱码。内嵌模式下可限制每行字数，避免译文超出对话框被切掉；游戏里中文变乱码时，先激活"修改游戏字体"选一个中文字体，老游戏再试"将汉字转换成繁体/日式汉字"（详见 内嵌翻译文档）。
- 取词不顺时调 HOOK 刷新延迟。文本每次只出一两个字，或者一行顶掉上一行，说明延迟太低，把它调高；反之提取偏慢则适当调低（详见 HOOK 设置文档）。
故障自查：六个常见异常，按症状对号入座
候选文本列表是空的，HOOK 没取到东西。依次检查：先以管理员权限重新启动软件（部分游戏只允许被管理员进程挂钩）；再进该游戏的专用 HOOK 设置，激活"Win32 通用钩子"（会向游戏额外注入 GDI、字符串等函数钩子，可能让游戏略变慢，所以默认不开）；两条都不行就切 OCR 模式过渡。
卡在"正在等待 DLL 注入到游戏中……"，或提示"找不到重要组件 / Missing embedded Python3"。这是杀毒软件误报的典型症状：注入组件被拦截甚至删除了。依次检查：给软件目录添加信任（Windows Defender 走"病毒和威胁防护 → 排除项 → 添加文件夹"）；重新下载解压一遍再试。
内嵌翻译后游戏里一片乱码。依次检查两件事：一是字体问题，激活"修改游戏字体"换一个中文字体，英文游戏缺中文字体是主因；二是字符集问题，古早 Galgame 用内置 shift-jis 处理文字，激活"将汉字转换成繁体/日式汉字"能明显减少乱码。
取到的文本断断续续，一两个字蹦一下，或只显示最后一行。依次检查：游戏的文本显示速度是否调得太慢；HOOK 设置里的刷新延迟是否过低，逐步调高直到整句稳定出现。
OCR 识别结果总是错。依次检查：识别框是否缩到恰好包住文字；游戏内对比度、动态阴影是否影响识别；识别语言是否与游戏实际语言一致；是不是按成了"临时识别一次"的按钮。
运行一段时间后才报 FileNotFoundError 或 PermissionError。前者多半是组件运行中被杀毒软件删掉，处理同第一条；后者检查软件是否放在了C:\Program Files等受保护路径，移到普通目录再试。
收尾：走过的路和你接下来的资源
到这里，安装、接游戏、选模式、选引擎、调质量五步全部走完了：游戏对话框里的外文变成中文的那一刻，你读的就是原著进度。之后每接一部新游戏，基本只重复 M2 和 M5，前面配置过的部分都会保留。
官方文档入口（仓库内docs/zh/目录）：
- 软件下载与启动说明：版本下载、常见错误、更新方式
- 基本用法：HOOK、OCR 两种模式的操作细节
- HOOK 设置：刷新延迟、缓冲区、特殊码
- 内嵌翻译：字体、字符集、分行等显示问题
- 翻译优化：词典、正则修正
- 大模型翻译接口：在线与离线模型配置
- 模拟器游戏支持：NS / PSP / PSV / PS2 模拟器取词
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
