LunaTranslator：Galgame 实时翻译，从安装到出字的操作笔记-平芜编程栈

LunaTranslator：Galgame 实时翻译，从安装到出字的操作笔记

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

你双击启动了一款全日 Galgame，满屏日文，想不查词直接读下去——LunaTranslator 就是为此做的开源视觉小说翻译器。它挂在运行中的游戏上，把文本实时翻译成中文显示在屏幕上，也可以把译文直接写回游戏对话框里。下面按实际操作顺序讲一遍。

📌 它实际能做什么

LunaTranslator 负责两件事：拿到游戏文本，再把它送进翻译引擎。拿文本有三条路——HOOK（直接读取游戏内存里的文本）、OCR（对游戏画面截图认字）、剪贴板监控（游戏文本可以被复制时使用）。拿到文本后，可以交给百度、Google、DeepL 等在线接口或本地大模型来翻译；部分游戏支持内嵌翻译，即译文直接替换游戏内的原文。此外还有翻译历史、日语分词与假名注音、语音合成等附加功能。

捕获方式	适合什么游戏	特点
HOOK	绝大多数常见和冷门视觉小说	直接读内存，适配面广，支持内嵌翻译
OCR	特殊渲染、无法 HOOK 的游戏	对画面截图认字，内置高精度 OCR 模型，也可接在线/离线引擎
HOOK 模拟器	NS / PSP / PSV / PS2 等平台的模拟器	对模拟器进程取文本，支持列表见模拟器支持列表
剪贴板监控	文本可选中复制的游戏	最简单，无需注入，只盯复制内容

🚀 装好并跑起来

获取软件：从文档首页的软件下载入口下载 Windows 版本；也可以从仓库（git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator）获取源码自行构建。
解压：放到非系统盘的普通目录，注意不要放在"程序文件"这类受保护路径，注入游戏时容易出权限问题。
首次启动：运行主程序，按提示完成基础设置。
界面语言：在设置中选择中文界面。
默认翻译引擎：在翻译设置里选一个你已有账号或密钥的接口（在线接口或本地大模型均可）并填好密钥。
热键：在快捷按键设置里先激活"是否使用快捷键"，再为"自动模式"、"显示/隐藏翻译"等绑定按键；也可按默认热键操作。
显示位置：翻译结果显示在独立窗口上，可拖动到屏幕任意位置，字体、颜色、透明度在显示设置中调整。

提示：如果游戏要求管理员权限运行，请用同权限启动 LunaTranslator（或直接用LunaTranslator_admin.exe），否则 HOOK 注入会失败。

还有一个省事的操作：启动软件后，把游戏 exe 直接拖进 LunaTranslator 窗口，游戏会被自动启动并完成 HOOK，省去手动选进程。

🎯 你的游戏属于哪一类

游戏类型	推荐捕获模式	选择依据
标准视觉小说	HOOK	官方文档明确 HOOK"几乎适配所有常见和冷门的视觉小说"，默认首选
RPG Maker 等引擎类、无法 HOOK 的游戏	OCR	画面能截到字就认得到，选"识别区域"即可持续工作
模拟器游戏	HOOK 模拟器	先查支持列表，支持就走 HOOK，不支持再用 OCR 兜底
文本可选中复制的游戏	剪贴板监控	无需注入，配置最少

拿不准时的顺序是：先试 HOOK；选进程后弹出"选择文本"窗口，能看到与游戏对话框一致的候选文本行，就选对了；看不到再切 OCR。

🔧 三种典型局面的调法

标准 Galgame：HOOK 流程

现象：HOOK 上以后"选择文本"窗口里全是乱行。→动作：让游戏显示几句对话，从候选文本行中点选与对话框一致的那一行。
现象：文本每次只出一两个字，或一行行顶掉只显示最后一行。→动作：提高 HOOK 设置里的"刷新延迟"，或调快游戏内文字显示速度（HOOK 设置详解）。
现象：文本正确但提取慢。→动作：适当降低刷新延迟，别降到重新出现逐字问题。
现象：完全抓不到正确文本。→动作：在游戏设置里尝试激活"Win32 通用钩子"；仍不行就去项目 issue 区提报游戏名。

RPG Maker 等引擎类游戏：OCR 流程

现象：刚切到 OCR 模式。→动作：选"持续识别"按钮框选对话区域（注意别点成"只识别一次"的临时按钮）。
现象：看不懂 OCR 参数。→动作：截图方式选"周期执行"，这是最简单的方式（OCR 参数说明）。
现象：识别太频繁或太迟钝。→动作：调"图像一致性阈值"，过高迟钝、过低频繁，反向微调。
现象：识别结果因画面微小抖动而反复重译。→动作：调高"文本相似度阈值"，结果变化不够大就不输出。

模拟器游戏

现象：想玩 NS / PSP / PSV / PS2 的日文游戏。→动作：确认模拟器在支持列表内，把模拟器进程按 HOOK 模式选中，流程与标准 Galgame 相同。
现象：模拟器不支持 HOOK。→动作：退回 OCR，并适当拉大截图周期，降低 CPU 占用。
现象：模拟时卡顿。→动作：关闭翻译历史显示、调低识别频率，再按模拟器支持文档反馈具体模拟器与游戏名。

🩺 不工作时先查这几条

症状	常见原因	处理动作
HOOK 抓不到文本	游戏与 LunaTranslator 权限不一致	两者同权限（管理员/普通）运行
HOOK 抓不到文本	该游戏暂无适配	项目 issue 区提报，附游戏名与运行方式
HOOK 只出半句/整行顶替	刷新延迟低于游戏出字速度	提高"刷新延迟"
OCR 识别差	选区偏了或背景太花	精确框选纯文字区域，排除动态背景
OCR 反复重译	相似度阈值过低	调高"文本相似度阈值"
查看文本时卡顿	历史缓存文本过多	把"最大缓存文本长度"调小（默认 1000000，1000 也够用）
游戏整体变卡	钩子或识别频率偏高	降低 OCR 频率，关闭内嵌以外的附加功能
重装后配置丢失	未备份	复制运行目录下的 userconfig 文件夹，重装后放回原位

✏️ 让翻译更贴的进阶项

专有名词翻译：在翻译优化里维护一个词条表，角色名、地名在每次翻译前按表替换，保证专名前后一致。
正则过滤：文本处理支持正则表达式替换，可以把系统提示、UI 文字、特殊符号从待译内容里剔除，再配合后处理规则统一标点格式。
上下文优化：大模型翻译接口支持"附带上下文个数"，把最近 N 条原文与译文一起喂给模型；还可以自定义 system prompt 引用{contextOriginal[N]}等字段，控制风格。