LunaTranslator 游戏实时翻译工具：HOOK 模式 3 步跑起来-平芜编程栈

LunaTranslator 游戏实时翻译工具：HOOK 模式 3 步跑起来

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

LunaTranslator 是一款面向视觉小说（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 支持列表确认游戏在列。