LunaTranslator 快速上手HOOK 与 OCR 让视觉小说翻译跑起来【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator玩日文视觉小说卡在文本读不出、翻译对不上、引擎挑不清三件事上的人不少。LunaTranslator 是一个开源的视觉小说Galgame实时翻译工具主打从游戏进程里直接抓取文本HOOK同时提供 OCR 图像识别作为兜底翻译接口覆盖在线引擎、离线模型和大语言模型。它的目标人群很明确想读日文原版游戏、又不想手动截图翻词典的玩家以及有日语学习需求、希望顺便查词注音的用户。一、先判断它适不适合你的场景LunaTranslator 提供三条获取文本的路径选择顺序基本决定了后续体验HOOK 模式游戏已启动或可启动时首选。它从游戏进程里提取文本覆盖大多数常见和冷门视觉小说引擎文本干净、无识别误差。OCR 模式HOOK 抓不到文本时的兜底。框选屏幕上的文本区域由 OCR 引擎识别后翻译适合无法注入的窗口或纯图片文本。剪贴板等辅助输入手动复制文本进来翻译最朴素但最通用。如果你的游戏是 Windows 平台的常见视觉小说引擎直接走 HOOK 路线如果游戏跑在模拟器里NS/PSP/PSV/PS2它有专门的模拟器 HOOK 支持可参考 docs/zh/emugames.md 里列出的机型范围。二、最短上手路径三步出第一条译文拿到软件后有两条入口使用官方发行版到项目文档首页 docs/zh/README.md 下载对应的 Windows 安装包Windows 10/11 用 64 位版本安装后直接启动不需要任何环境配置。从源码获取git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator然后在仓库根目录运行src/run.bat其内容就是调用python.exe -B LunaTranslator\main.py启动前确保本地 Python 环境已装好项目所需依赖。启动后完成第一条译文通常只需三个动作把游戏窗口拖入 LunaTranslator 主窗口软件会自动启动或附加游戏并注入 HOOK在弹出的选择文本窗口里让游戏显示一段对话从候选文本行里选中与游戏画面对应的那一行点击该行对应的显示按钮译文即出现在悬浮窗中。如果该游戏支持内嵌翻译会出现内嵌按钮点击后译文直接叠在游戏画面里。整个流程的具体演示见官方文档 docs/zh/basicuse.md。三、核心能力哪些功能最影响日常体验文本获取层是它和普通翻译器的分界线。HOOK 引擎适配了大量视觉小说引擎源码位于src/NativeImpl/LunaHook/并且支持为单个游戏单独设置 HOOK 参数——同一个软件配多款游戏互不干扰这是长期使用的关键。翻译层接入了覆盖面很广的接口常见选择在线引擎百度、谷歌、微软、DeepL 等配置简单、速度快适合日常离线/本地方案支持 llama.cpp 等本地模型路线适合在意隐私或网络环境差的场景大语言模型接口可调用 ChatGPT 类模型做语境更好的翻译还能把自定义词典塞进 prompt 里。各类引擎的接入方式和取舍可查 docs/zh/guochandamoxing.md大模型配置和src/LunaTranslator/translator/目录下的实现文件。学习向功能对日语文学习者是隐藏价值日语分词、假名注音振假名、Anki 同步、Yomitan 插件兼容读游戏的同时完成查词和背词闭环。四、配置策略新手先动这三处不建议一开始就翻遍设置界面按下述优先级调整即可新手默认HOOK 自动检测 任意一个稳定的在线翻译引擎 悬浮窗显示。这一组合能解决大多数游戏的翻译需求。进阶可选项为常用游戏建立游戏管理条目单独固化 HOOK 参数与翻译设置启动即生效开启内嵌翻译获得字幕直接长在游戏里的体验配置 TTS 语音合成引擎让悬浮窗朗读译文。特定场景文本反复只出一两个字、或整行顶掉上一行属于刷新延迟与游戏打字速度不匹配去 HOOK 设置里调整刷新延迟文本大量乱码则多半是代码页设置问题。这些参数的作用说明在 docs/zh/hooksettings.md 里写得比较细。五、遇到卡点时的排查方向HOOK 后选不到正确文本先确认选中的游戏进程是否为目标游戏多开或模拟器时容易选错再试试让游戏实际显示一段对话后刷新候选列表仍不行则在游戏设置中开启 Win32 通用钩子。OCR 识别效果差换引擎离线模型与在线服务精度不同、重新框选区域、确认区域里只有文本没有背景干扰OCR 各引擎的参数说明见 docs/zh/ocrparam.md。翻译质量不稳优先换引擎对比而不是反复调参对固定译错的专名、角色名用翻译优化里的专有名词翻译加词条比全局替换更稳思路见 docs/zh/transoptimi.md。快捷键失灵确认总开关是否使用快捷键已启用具体按键映射在 docs/zh/fastkeys.md 中有完整列表。下一步建议跑通第一条译文后建议按这个顺序深入先把 2~3 款常玩游戏录入游戏管理并固化设置再按需接入本地模型或 TTS最后探索分词注音与 Anki 同步这类学习功能。文档站入口在 docs/zh/index.md遇到无法提取文本的新引擎时项目文档里也提供了反馈支持的渠道。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考