LunaTranslator 视觉小说翻译器使用指南HOOK 提取、OCR 识别与多引擎翻译【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款开源的视觉小说Visual Novel即文字冒险类游戏翻译工具。它通过 HOOK 技术直接读取游戏内存中的文本配合 OCR 图像识别和剪贴板方式把日、英等外语对白实时翻译成中文并支持内嵌显示、语音朗读和日语学习功能适合想玩外语原版游戏的玩家和语言学习者。第一次上手下载与启动普通用户不需要编译源码。官方提供绿色压缩包解压即可使用文档见 docs/zh/README.md。如果你希望从源码获取完整仓库可以执行git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator解压后有几个启动入口按场景选择LunaTranslator.exe普通模式日常使用即可LunaTranslator_admin.exe管理员模式个别游戏需要该权限才能完成 HOOK 注入LunaTranslator_debug.bat带命令行窗口便于查看报错两个注意事项一是不要把软件放在C:\Program Files这类受保护目录否则可能无法写入配置二是如果删除重装记得保留userconfig文件夹否则所有设置会丢失。软件默认自动更新手动更新只需下载新版解压覆盖旧目录。它实际能帮你做什么如何用 HOOK 模式提取游戏文本这是主用方式适配绝大多数常见与冷门的视觉小说说明见 docs/zh/hooksettings.md。操作步骤先正常启动游戏在 LunaTranslator 中打开 HOOK 模式选择游戏进程确认后游戏会被注入并弹出“选择文本”窗口让游戏显示几句对白在候选行中挑出真正对应游戏文本的一行确认即可开始翻译更省事的方式是直接把游戏启动程序拖拽到 LunaTranslator 窗口上它会自动转区启动并完成 HOOK。游戏不通用 HOOK 时用 OCR 模式接管切换到 OCR 模式后框选画面中的对话框区域软件会持续截图、识别并翻译操作说明见 docs/zh/basicuse.md。内置较高精度的离线 OCR 模型也接入了多家在线 OCR 服务参数入口在设置界面的 OCR 选项。注意工具栏上有一个图标相同的“单次识别”按钮它只截取一次而不持续跟踪别点错。模拟器游戏如何读取文本对 NS、PSP、PSV、PS2 平台的大部分游戏可以直接 HOOK 模拟器进程读取文本支持列表见 docs/zh/emugames.md 及其附带的分平台清单docs/emusupportlist/。入口和 HOOK 模式一致只是选择的是模拟器进程。翻译引擎与输出方式怎么配翻译引擎实现集中在 src/LunaTranslator/translator/涵盖在线接口谷歌、DeepL、百度等、大语言模型接口和离线模型可在设置界面切换并组合。翻译结果有三种输出方式悬浮窗显示默认方式跟随游戏窗口内嵌翻译部分游戏支持把译文直接写回游戏画面入口在文本选择窗口的“内嵌”按钮语音合成TTS 引擎实现见 src/LunaTranslator/tts/支持 Edge TTS、系统 TTS 等在线与离线引擎可以边看边听学习向功能包括日语分词、假名注音、Anki 生词本同步AnkiConnect和 Yomitan 浏览器插件联动文档见 docs/zh/qa1.md。关键配置与扩展影响实际效果最明显的几处设置刷新延迟HOOK 通用设置文本“一两个字蹦出来”或“整行被顶掉”时调高它文本正确但出得慢时适当调低最大缓冲区长度文本反复刷新刷不停时适当调小可缓解刷屏最大允许输出文本长度跳过剧情Skip时会瞬间涌出大量历史对白用它过滤突发文本翻译优化包括翻译前替换支持正则、专有名词词典、翻译结果修正和自定义 Python 处理脚本原理见 docs/zh/transoptimi.md。建议游戏专属词条加在“游戏设置 → 翻译优化”里而不是全局规则中游戏专用设置在“游戏管理 → 游戏设置”中可取消“跟随默认”为单个游戏单独配置 HOOK 参数和翻译优化不影响其他游戏仓库中的默认配置参考在 src/LunaTranslator/defaultconfig/运行时你的个人配置保存在userconfig目录改配置优先通过设置界面完成。常见坑与排查提示“找不到重要组件 / Missing embedded Python3”原因杀毒软件把注入相关的组件文件如 LunaSubprocess32.exe、LunaHost32.dll当作威胁删除了。处理给整个软件目录添加信任或排除项然后重新下载解压。HOOK 本身就需要 DLL 注入误报属于正常现象。卡在“正在等待 DLL 注入到游戏中……”同样是杀毒拦截或权限不足。先加信任若仍不行改用_admin版本启动。HOOK 后文本乱码或只有一个字符可能是编码不匹配或刷新延迟不当。老引擎的中文版本可尝试调整代码页设置多数情况下优先调刷新延迟更有效。若确实无法提取建议按官方文档提交游戏适配请求自行修改钩子参数通常收效有限。配置改过之后找不到正确文本了检查是否误改了“代码页”或“最大缓冲区长度”。代码页只对引擎未指定编码的多字节字符串生效无特殊需求保持默认即可。适合谁下一步做什么LunaTranslator 最适合两类人想玩日/英原版视觉小说但不想等汉化组的玩家以及借游戏练日语、积累生词的学习者。它的边界也要心里有数提取效果依赖具体游戏的适配情况个别引擎较新的游戏可能需要 OCR 兜底或等待后续支持HOOK 对模拟器同样有效但前提是模拟器本身在支持列表内。上手路径建议先用默认配置 HOOK 模式跑通一款游戏确认文本提取和翻译正常后再去动刷新延迟、翻译引擎和翻译优化这些细项。完整文档索引在 docs/zh/index.md各功能页面都有对应说明。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考