
LunaTranslator 游戏实时翻译工具HOOK 模式 3 步跑起来【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款面向视觉小说Galgame与 Windows 游戏的实时翻译工具核心能力是通过 HOOK 直接从游戏进程内存中读取文本再调用可配置的翻译引擎输出译文HOOK 不可用时可退回 OCR 识别或剪贴板监控。读完本文你能独立完成拉起软件、对一款游戏启用 HOOK 翻译、处理最常见的三类错误。能做什么能力速览能力做什么适用情况HOOK 取文向游戏进程注入钩子直接读内存中的文本首选方案速度快、准确率高覆盖绝大多数常见 VN 引擎仅限 Windows内嵌翻译把译文写回游戏画面原文位置进阶玩法并非所有游戏支持有一定崩溃风险OCR 识别对固定区域持续截图识别HOOK 失效时的通用兜底剪贴板监控监听用户复制的文本最后补充手段多引擎翻译在线 API、本地 LLM、Sakura 等离线模型引擎与参数见翻译引擎源码语音朗读将译文合成为语音引擎列表见TTS 引擎目录默认行为是在软件自己的悬浮窗口里显示原文加译文内嵌是可选的进阶项下文分开讲。 3 步跑起来获取代码或使用官方发布的 Windows 构建包git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator从源码运行时入口就是 src/run.bat 里的一行在src/目录下执行python.exe -B LunaTranslator\main.py源码运行需要 Python 3 环境。HOOK 注入依赖原生组件官方文档建议使用已构建的 Windows 包从源码跑时优先用 OCR 或剪贴板模式验证流程。启动后先打开游戏再进入下一章的 HOOK 取文流程。HOOK 模式深入选进程到选文本行连接游戏有两条路游戏未启动把游戏 exe 直接拖到 Luna 主窗口上游戏会被自动启动并注入 HOOK。游戏已运行打开“选择游戏进程”窗口选中对应进程点击确认后注入。HOOK 生效后会弹出文本选择窗口。让游戏跑一下、显示出对话窗口里会出现若干候选文本行选中内容与游戏对白相符的那一行并激活即开始翻译。每行有两个按钮显示在任何游戏上都可用在软件窗口中展示译文。内嵌仅支持内嵌的游戏才出现不出现就说明该游戏不可内嵌。参数调优只需记一条规则文本每次只蹦出几个字、或上一行不断被新行顶掉就调高刷新延迟文本正确但刷新慢就适当调低。其余缓冲区、代码页等参数见HOOK 设置文档。进阶内嵌翻译与 OCR 兜底内嵌翻译内嵌的原理是在游戏显示文本前暂停游戏把文本送去翻译再把译文写回内存后恢复运行因此翻译引擎慢时游戏一定会卡可用“翻译等待时间”上限兜底。两类常见问题中文乱码多数是游戏缺中文字体在“修改游戏字体”中换一个含中文的字体即可。古早日系引擎shift-jis 字符集可尝试“将汉字转换成繁体/日式汉字”减少乱码。完整参数说明见内嵌翻译文档。OCR 兜底HOOK 挂不上冷门引擎、受保护进程时切到 OCR 模式框选对话区域即可持续识别。注意界面上相邻有一个外观相似的按钮它只执行一次性识别不是持续识别别按错。内置本地 OCR 模型也可接入在线引擎参数见OCR 参数文档。排障最常遇到的 3 种情况Missing embedded Python3 / 一直等待 DLL 注入通常是杀毒软件删除了 HOOK 组件。把 Luna 所在目录加入排除项后重新下载解压注入组件LunaSubprocess、LunaHost 等是 HOOK 功能本体被误报属正常现象。游戏以管理员权限运行导致注入失败以管理员权限启动软件。构建包附带专门的LunaTranslator_admin.exe平时用普通权限版本即可。放在 C:\Program Files 下报 PermissionError换到普通目录解压。删除重装时务必保留 userconfig 文件夹否则全部设置会丢失。另外NS / PSP / PSV / PS2 走的是独立的“模拟器 HOOK”体系先对照模拟器 HOOK 支持列表确认游戏在列。下一步动作清单下载 Windows 构建包并解压到普通目录加入杀毒排除项挑一款已支持的游戏先用“显示”模式验证取文与翻译效果验证通过后尝试开启内嵌翻译按需调整字体与刷新延迟需要自定义翻译引擎、后处理规则时参考默认配置目录与文档索引完整操作截图版见基本用法文档【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考