视觉小说翻译完整指南：LunaTranslator 从安装到译出第一条文本
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款面向 Windows 的开源视觉小说翻译器（Galgame 翻译工具），专门给玩日文视觉小说但没有中文化版本的人用。它的工作链路很直接：先通过 HOOK、OCR 截图或剪贴板把游戏里显示的文本取出来，再交给翻译引擎，把译文显示在原句旁边；部分游戏甚至能把翻译直接嵌进游戏对话框，让你玩原版、看中文。
三步装好环境，看到第一条翻译
准备工作只有三件事：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslatorpip install -r requirements.txt装完依赖后，双击仓库里的src/run.bat就能把软件跑起来。之后走一遍最短路径：
- 先把游戏正常启动，保持窗口模式（全屏独占容易干扰取词）。
- 把游戏的可执行文件直接拖进 LunaTranslator 的窗口，松开鼠标后游戏会被自动添加、自动注入并重新以转区模式启动；也可以先启动游戏，再在软件里打开"选择游戏进程"窗口手动选。
- 这时会弹出"选择文本"窗口。让游戏剧情走到有文字的位置，窗口里会出现若干候选文本行——哪一行和游戏对话框里的内容一致，就点对应的"显示"按钮；支持内嵌翻译的游戏这一行还会有"内嵌"按钮，点了翻译就直接出现在游戏画面里。
- 从这一刻起，游戏里每蹦出新的文本行，软件的翻译窗口就会自动跟进，基本不用你再动手。
如果第 3 步候选行里找不到和游戏对话匹配的那一行，先别怀疑软件坏了，多半是取词方式没选对，往下看。
取词方式怎么选：HOOK、OCR 还是剪贴板
取词有三种路子，按游戏新旧和类型来挑，别硬凑：
| 方式 | 原理 | 适用场景 | 代价 |
|---|---|---|---|
| HOOK | 向游戏进程注入，直接从内存里读出游戏准备显示的文本（HOOK 是"挂钩"的意思，即在不改游戏文件的前提下拦截并读取它的内部调用） | 绝大多数主流和冷门视觉小说；NS/PSP/PSV/PS2 上多数游戏也能靠 HOOK 模拟器读取 | 需要进程注入，个别带保护机制的游戏可能拒绝注入或直接崩溃 |
| OCR | 按设定区域定时截图，用内置高精度识别模型（OCR 即"文字识别"，把截图里的字认出来）把字符读出来 | HOOK 找不到文本行的游戏、对话框位置不规则的老游戏 | 结果依赖截图区域和字体，偶发错字漏字，比 HOOK 更吃资源 |
| 剪贴板 | 你自己复制文本，软件监听到复制内容后自动翻译 | 只想翻几句、或前两种方式都不灵的兜底 | 没有实时感，得手动复制，不适合通读剧情 |
新游戏默认先试 HOOK，翻不出来再退回 OCR；OCR 记得选对按钮——自动持续识别和"临时截一次"是两个不同入口，选错会表现为"识别一次就没动静了"。
翻译引擎怎么选，效果差怎么办
引擎分两类。在线引擎（Bing、Google、百度、DeepL 以及各家大语言模型）效果最好，但走网络、有频控，个别有免费额度限制；离线/本地引擎不依赖网络、不限量，代价是译文质量略逊。具体实现都放在 src/LunaTranslator/translator/ 目录里，设置界面按名字勾选即可，不用碰代码。
效果差的时候按顺序排查，别上来就换引擎：先看原文有没有被取对——如果是 OCR 模式，大概率是识别阶段就错了，此时换什么引擎都是错的；原文没问题再看译文，这时先在同一个游戏里对比两三个引擎，通常能直接分辨出明显差距；还是不满意，就上文本后处理和纠错功能（仓库里src/LunaTranslator/transoptimi/下的transerrorfix会针对已知典型误翻做修正）。对没有官方中文的日文游戏来说，"HOOK + 一个靠谱的在线引擎"这套视觉小说翻译组合通常已经够用，剩下的优化空间在后处理。
新手最容易踩的 3 个坑
症状：HOOK 上了但候选文本行里就是没有游戏对话。原因一般有两个：游戏还没走到显示文本的位置，或者选错了文本行（有些游戏内存里会同时存在多段字符串，只有真正画进对话框的那段才是你要的）。解法：让剧情推进一下，挑和当前对话框逐字对应的那行点"显示"；反复找不到就切 OCR，框住对话框区域手动识别一次验证。
症状：识别出来的原文一堆错字漏字，翻译自然也跟着歪。原因在 OCR 阶段而不是翻译阶段，字体特殊、背景太花、识别框没对准都会导致。解法：缩小识别区域只框文字部分，调整 OCR 参数（区域、阈值），必要时换更宽松的在线识别引擎；这步不解决，后面全白搭。
症状：玩着玩着软件卡顿、翻译断流。原因是同时开的任务太多——OCR 持续截图、多条文本并行请求翻译、再加上游戏本身的开销会互相挤占。解法：关掉游戏里无关紧要的特效，降低 OCR 识别频率，别同时挂多个翻译任务；长期方案是换延迟更低的离线引擎，减少网络往返等待。
把取词方式选对、引擎匹配好，绝大多数视觉小说库都能以中文读完，剩下的差别只在于流畅度和细节。想继续深挖，仓库里的 docs/zh/ 目录按功能拆了 HOOK 设置、OCR 参数、内嵌翻译等专题文档；想让游戏"开口说话"的，去看src/LunaTranslator/tts/目录下的语音合成模块，在线离线引擎都接了不少。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
