LunaTranslator 视觉小说翻译工具：3 种游戏文本提取方式，从启动到出译文的最短路径
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
如果你玩日文视觉小说（Galgame）并希望看到中文译文，LunaTranslator 是一个在 Windows 上免费开源的方案：它通过 HOOK 注入、截图 OCR 或剪贴板三种方式持续获取游戏文本，再交给在线或本地翻译引擎处理。读完本文，你可以完成软件的启动、为游戏选对取文方式，并看到第一条译文输出。
适用判断：哪些游戏适合用 LunaTranslator 翻译
先确认你的场景在覆盖范围内，可以少走弯路：
- 适合：Windows 10（1803 及以上）/ Windows 11 的 64 位环境；大多数常见与冷门视觉小说引擎——HOOK 方式对它们的适配面很广；NS / PSP / PSV / PS2 模拟器上运行的大部分游戏，也支持 HOOK 模拟器直接读文。
- 需要留意：部分游戏必须以管理员权限运行才能被 HOOK；完全无法注入的游戏要退回 OCR 方式；如果你只想翻译自己手头的零散文字，用剪贴板模式即可，不必折腾 HOOK。
- 不适合：非 Windows 平台；对系统权限管控严格、禁止 DLL 注入的环境。
从解压到看到第一条译文：最小启动路径
- 获取程序。普通用户建议下载发布版，解压到任意目录即可，但不要放在
C:\Program Files这类特殊路径，否则可能无法保存配置和缓存。也可以从源码运行：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator然后在src/下运行run.bat（32 位环境用run32.bat）。
选对启动方式。默认用
LunaTranslator.exe普通模式启动；仅当游戏要求管理员权限时才改用LunaTranslator_admin.exe。接入游戏。软件与游戏同时运行时，在 HOOK 模式下打开选择进程窗口，选中游戏进程，注入后会弹出文本选择窗口。让游戏先显示几句对话，候选文本行出现后，挑出与画面台词一致的一行，翻译随即开始。
还有一个更快的入口：把游戏程序直接拖拽到 LunaTranslator 窗口中，软件会自动启动游戏并完成 HOOK，之后按上述流程继续即可。
按任务选取文方式：HOOK、OCR 还是剪贴板
| 你的目标 | 推荐方式 | 关键操作 | | - | - | - | | 边玩边实时翻译 | HOOK | 选中游戏进程，在文本选择窗口挑对文本行；支持内嵌翻译的游戏会出现"内嵌"按钮，可将译文直接写回游戏画面 | | 游戏无法注入，或文字是贴图 | OCR | 切到 OCR 模式后框定识别区域，即可持续识别。注意工具栏上图标相近的另一个按钮只做一次性识别，别按错 | | 只翻译自己复制的段落 | 剪贴板 | 复制文本后软件自动识别翻译，无需接入游戏 | | 想边玩边学日语 | 翻译 + 分词 | 在辞书设置中下载 mecab 的 unidic 词典，可开启假名注音与语法加亮 |
选法上有一个简单原则：先试 HOOK，出文最稳定；HOOK 拿不到文本再切 OCR；两者都不需要时才用剪贴板。
文本出不来时的常见错误与排查顺序
大多数卡点集中在以下四处，建议按顺序检查：
- 杀毒软件误报。HOOK 需要向游戏注入 DLL，
LunaSubprocess32.exe、LunaHost32.dll等组件容易被拦截，典型报错是"Missing embedded Python3""正在等待DLL注入""FileNotFoundError"。把 Luna 所在文件夹加入系统排除项（Windows Defender 路径：病毒和威胁防护 → 排除项 → 添加排除项 → 文件夹）后重新运行。 - 安装位置不对。软件放在
C:\Program Files下可能出现PermissionError且无法保存配置，换到普通目录解压即可。 - 文本一次只出两三个字、或新行顶掉旧行。说明游戏出字速度比刷新快，调高HOOK 设置中的"刷新延迟"；反之，若文本正确但提取很慢，则适当调低。
- 完全提取不到正确文本。可尝试在 HOOK 设置中激活"Win32 通用钩子"（默认关闭，因为注入过多钩子会拖慢游戏）；仍无改善时，说明该游戏可能需要定制配置，可参考文档中的特殊码说明或反馈给作者。
跑通之后：文档与功能入口
- 基本用法详解：
docs/zh/basicuse.md（HOOK、OCR 逐步操作截图） - HOOK 参数含义（刷新延迟、缓冲区长度、代码页等）：
docs/zh/hooksettings.md - 翻译引擎与默认配置：引擎实现集中在
src/LunaTranslator/translator/，默认参数见src/LunaTranslator/defaultconfig/translatorsetting.json - 语言学习：
docs/zh/qa1.md介绍日语分词与假名注音，同时支持 AnkiConnect 与 Yomitan 插件；src/LunaTranslator/cishu/下还集成了多个在线词典 - 语音合成：
src/LunaTranslator/tts/提供大量在线与离线引擎，可在 TTS 设置中选择
先把 HOOK 模式在一款已知受支持的视觉小说上跑通，再逐步尝试 OCR 与内嵌翻译，遇到问题对照docs/zh/下对应文档逐项核对设置，是目前最省时的上手顺序。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
