企业官网建设流程全解析

LunaTranslator 配置指南：视觉小说翻译工具怎么在本地跑起来

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

LunaTranslator 是一个视觉小说（Galgame）翻译工具，核心解决"外文游戏文本怎么快速读成中文"的问题：通过 HOOK 直接从游戏进程里提取文本，配合翻译引擎和 TTS 语音输出。本文面向第一次接触它的新手，按"判断能否使用 → 最短启动路径 → 三种取词方式 → 常见报错排查"的顺序讲清配置与验证方法，读完即可在自己的 Windows 机器上完成首次翻译。

先确认这台电脑能不能跑起来

这一节帮你在动手前排除硬性障碍，避免装完才发现环境不满足。

• 系统：推荐 Windows 10（1803 及以上）/ Windows 11 的 64 位系统。老系统（Win7/XP）有兼容版，但功能少、更易被杀毒软件拦截，没特殊需求不建议用。
• 使用场景：目标软件是 Windows 平台的游戏，或 NS/PSP/PSV/PS2 等平台的模拟器。手游、网页游戏不适用。
• 权限：个别游戏需要管理员权限，此时要用带管理员权限的启动方式（见下文排错），日常使用普通模式即可。
• 路径：不要把软件放在C:\Program Files这类受保护目录，否则可能无法写入配置和缓存，甚至直接启动失败。
• 网络：HOOK 提词本身不需要联网，但多数翻译和 TTS 引擎调用的是在线接口，无网络时只能换离线引擎。

最短启动路径

目标是让程序先跑起来，再谈配置。普通用户建议直接获取官方发布的压缩包，解压到任意非受保护目录（例如D:\Tools\LunaTranslator）；如果你从源码入手，则执行：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator

这一步把项目完整拉到本地，克隆完成后目录里应能看到src和docs两个文件夹，即说明下载完整。

然后进入src目录，双击run.bat（32 位系统用run32.bat）。它做的事是用 Python 运行主程序main.py。看到翻译窗口正常弹出、没有闪退，就算启动成功。如果窗口一闪而过或弹出报错，直接跳到下一节对照排查。

三种取词方式分别怎么用

工具拿到游戏文本有两条主路：HOOK（往游戏进程里注入一段代码，从内存中"钓"出对话，适合绝大多数视觉小说）和 OCR（截图识别，相当于用眼睛读屏幕上的字）。

• HOOK 模式（默认首选）：场景是游戏已启动。做法是在程序里打开选择游戏进程窗口，选中对应进程，等游戏显示出一段对话后，候选文本列表里会刷出多行文本，点一下与游戏对话一致的那一行即可开始翻译。验证：游戏里切换下一句台词，翻译窗口同步更新，说明钩子稳定。如果游戏支持内嵌翻译，列表中会出现"内嵌"按钮，翻译可直接写回游戏画面。
• 快捷启动：不想先手动选进程时，把游戏 exe 直接拖进 LunaTranslator 窗口，程序会自动代为启动并挂上 HOOK，省去选进程步骤。
• OCR 模式：场景是 HOOK 找不到文本（加密游戏、模拟器、非典型引擎）。做法是切到 OCR 模式后框选屏幕上文字所在区域，程序会持续识别并翻译。注意界面上有两个图标相似的按钮，持续识别和"只识别一次"的用途不同，选错就不会自动刷新。内置了离线 OCR 模型，也支持接入在线 OCR 接口，配置方式见 OCR 接口文档。
• 翻译与语音：取到文本后，在翻译设置里选一个引擎（在线 API 或大语言模型均可），需要"听"的时候再启用 TTS 引擎把译文朗读出来。引擎列表与参数在 TTS 文档 和 国搭模型文档 里有说明，新手先用默认配置跑通流程，再按需替换引擎。

报错对照表：现象、原因、处理

遇到报错不用慌，启动类问题大多出在路径、权限和杀毒软件这三处。

到这里你能做什么

跑通流程后，日常使用只需：启动程序 → 拖入游戏或选进程 → 点中目标文本行。后续可对照 基本用法文档 熟悉内嵌翻译，按 HOOK 设置文档 为冷门游戏配置取词参数，模拟器用户则查看 模拟器 HOOK 文档。更多界面说明都在仓库的 docs 目录 内，遇到文档没覆盖的问题再到社区提问。

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator