LunaTranslator 配置指南视觉小说翻译工具怎么在本地跑起来【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一个视觉小说Galgame翻译工具核心解决外文游戏文本怎么快速读成中文的问题通过 HOOK 直接从游戏进程里提取文本配合翻译引擎和 TTS 语音输出。本文面向第一次接触它的新手按判断能否使用 → 最短启动路径 → 三种取词方式 → 常见报错排查的顺序讲清配置与验证方法读完即可在自己的 Windows 机器上完成首次翻译。先确认这台电脑能不能跑起来这一节帮你在动手前排除硬性障碍避免装完才发现环境不满足。系统推荐 Windows 101803 及以上/ 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.bat32 位系统用run32.bat。它做的事是用 Python 运行主程序main.py。看到翻译窗口正常弹出、没有闪退就算启动成功。如果窗口一闪而过或弹出报错直接跳到下一节对照排查。三种取词方式分别怎么用工具拿到游戏文本有两条主路HOOK往游戏进程里注入一段代码从内存中钓出对话适合绝大多数视觉小说和 OCR截图识别相当于用眼睛读屏幕上的字。HOOK 模式默认首选场景是游戏已启动。做法是在程序里打开选择游戏进程窗口选中对应进程等游戏显示出一段对话后候选文本列表里会刷出多行文本点一下与游戏对话一致的那一行即可开始翻译。验证游戏里切换下一句台词翻译窗口同步更新说明钩子稳定。如果游戏支持内嵌翻译列表中会出现内嵌按钮翻译可直接写回游戏画面。快捷启动不想先手动选进程时把游戏 exe 直接拖进 LunaTranslator 窗口程序会自动代为启动并挂上 HOOK省去选进程步骤。OCR 模式场景是 HOOK 找不到文本加密游戏、模拟器、非典型引擎。做法是切到 OCR 模式后框选屏幕上文字所在区域程序会持续识别并翻译。注意界面上有两个图标相似的按钮持续识别和只识别一次的用途不同选错就不会自动刷新。内置了离线 OCR 模型也支持接入在线 OCR 接口配置方式见 OCR 接口文档。翻译与语音取到文本后在翻译设置里选一个引擎在线 API 或大语言模型均可需要听的时候再启用 TTS 引擎把译文朗读出来。引擎列表与参数在 TTS 文档 和 国搭模型文档 里有说明新手先用默认配置跑通流程再按需替换引擎。报错对照表现象、原因、处理遇到报错不用慌启动类问题大多出在路径、权限和杀毒软件这三处。现象可能原因处理提示找不到重要组件 / Missing embedded Python3或卡在正在等待DLL注入杀毒软件删除了注入用组件HOOK 必然涉及 DLL 注入极易被误报把软件目录加入杀毒软件白名单Windows Defender 走病毒和威胁防护 → 排除项 → 添加文件夹然后重新下载解压运行一段时间后弹FileNotFoundError必要组件在运行中被杀毒软件后补删除同样先加白名单再重新解压整个目录报PermissionError或无法保存设置软件被放在Program Files等受保护路径把整个目录移到普通目录如 D 盘再启动HOOK 选进程后无任何候选文本游戏位数与注入组件不匹配或游戏有保护优先用 64 位版本对应 64 位游戏仍失败则改用 OCR 模式兜底个别游戏注入失败游戏要求管理员权限用带管理员权限的启动入口如LunaTranslator_admin.exe重试到这里你能做什么跑通流程后日常使用只需启动程序 → 拖入游戏或选进程 → 点中目标文本行。后续可对照 基本用法文档 熟悉内嵌翻译按 HOOK 设置文档 为冷门游戏配置取词参数模拟器用户则查看 模拟器 HOOK 文档。更多界面说明都在仓库的 docs 目录 内遇到文档没覆盖的问题再到社区提问。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考