LunaTranslator 新手教程：3 种捕获模式搞定日系游戏实时翻译
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
屏幕上是一部日语视觉小说，对话框里全是假名和汉字，你只能靠猜。LunaTranslator 就是为这种场景准备的：它把游戏文本实时抓出来，翻译成中文浮在画面上，全程免费开源。HOOK 注入、OCR 识别、剪贴板三条路，总有一条能走通。
5 分钟装好并跑起来
打开终端，克隆仓库并解压到本地：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator解压位置有讲究：别放在C:\Program Files这类系统保护目录，配置文件会写不进去。放到用户目录或 D 盘的普通文件夹最稳妥。
首次启动跟着引导走三件事，每件 1 分钟：
- 界面语言：选你熟悉的语言，之后改界面不迷路
- 默认翻译引擎：随便挑一个在线引擎，后面随时换
- 快捷键：打开「使用快捷键」，给「手动执行」「自动模式」各绑一个顺手的组合
全部完成后点启动游戏，翻译窗口出现即算跑通。
捕获模式怎么选：HOOK、OCR、剪贴板
文本从哪来，决定翻译能不能开始。按下面的顺序试：先 HOOK，失败切 OCR，都不行用剪贴板兜底。
- HOOK 注入：从游戏内存直接读文本，作用是无延迟、跟手。启动游戏后打开「选择游戏进程」窗口选中它即可，把游戏 exe 拖进 LunaTranslator 窗口也能一步到位。
- OCR 屏幕识别：按固定间隔截图做文字识别，作用是绕开一切内存障碍。切到 OCR 模式后框住对话框区域即可。注意：持续识别和「识别一次」是两个按钮，别点错。
- 剪贴板：监听你复制的内容，适合支持文字复制的工具、网页、文档。手动复制一下，翻译窗口自动刷新。
| 模式 | 适用场景 | 操作要点 | 局限 |
|---|---|---|---|
| HOOK 注入 | 主流引擎的视觉小说；模拟器游戏直接 HOOK 模拟器进程 | 选对进程，候选列表里选对文本行 | 受游戏保护机制影响，偶尔读不到 |
| OCR 识别 | HOOK 失败、文字是图片或特殊渲染 | 框选对话框，间隔设 300–500ms | 受背景、字体、特效干扰 |
| 剪贴板 | 游戏外文本，或支持复制的场景 | 复制即翻译 | 依赖手动或自动复制 |
模拟器里的老游戏优先 HOOK 模拟器本身；读不到再切 OCR 识别游戏窗口，把识别间隔放宽到 500–800ms 缓解卡顿。老平台游戏则多试几种编码（Shift-JIS、EUC-JP、GBK）。
选一个合适的翻译引擎：在线快、离线稳
引擎按来源分两类。
在线引擎（速度快，需要联网）：
- 百度翻译：响应快，日常对白够用，新手默认选它
- DeepL：复杂句式更稳，适合文本量大的作品
- Lingva：开源免费接口，不用配密钥
离线引擎（本地运行）：
- 本地大模型（llama.cpp）：翻译在本地完成，隐私敏感、断网环境用；模型相关文档有部署说明
- Sakura 引擎：对 ACG 术语有专门处理，大模型翻译接口文档里可以对比各家特点
在设置页的翻译引擎列表中切换，改动立即生效，不用重启。
显示与快捷键：两处顺手调整
覆盖层的参数在 显示设置 里调，目标是不挡游戏画面：
| 参数 | 建议值 | 说明 |
|---|---|---|
| 不透明度 | 60%–70% | 半透明不挡画面，0% 则窗口完全隐形 |
| 字体 | 微软雅黑 / Meiryo | 日中英混排清晰易读 |
| 位置 | 屏幕底部或侧边 | 避开对话框和核心 UI |
| 阴影 / 描边 | 开 | 深色背景上文字更清楚 |
快捷键在 快捷键设置 里配置，先打开「使用快捷键」总开关再逐个绑定。游戏里最常用的几个，功能定义见 快捷按键文档：
| 快捷键功能 | 游戏中的用途 |
|---|---|
| 手动执行 | 不放心自动抓取时，手动补读一次并翻译 |
| 自动模式 | 暂停 / 恢复自动读取，切场景防误翻 |
| 选择游戏 | 快速重新指定要 HOOK 的进程 |
| 选取 OCR 范围 | 换场景后重新框选识别区域 |
| 鼠标穿透窗口 | 操作游戏时窗口不抢鼠标 |
| 立即保存配置 | 调好参数立刻落盘，不用等退出 |
排查速查表：翻译不工作时查这里
HOOK 失效
- 现象：选完进程没文本，或有文本对不上对白。检查：是否管理员权限运行、游戏是否窗口模式。动作：双管理员重启，切窗口模式再试。
- 现象：候选列表全是乱码。检查：文本编码。动作：在文本设置里换编码，Shift-JIS 和 UTF-8 逐个试。
- 现象：注入直接失败。检查：游戏保护机制。动作：换 HOOK 模式重试，或转 OCR。
OCR 不准
- 现象：识别结果夹杂背景图案。检查：选区大小。动作：缩到只含文字，去掉 UI 元素。
- 现象：小字漏识别。检查：游戏分辨率与文字对比度。动作：提高分辨率到 1080p，调亮文字颜色。
- 现象：识别内容旧。检查：识别间隔。动作：调到 300–500ms，OCR 参数文档有完整项。
卡帧
- 现象：翻译期间掉帧。检查：OCR 间隔是否过密。动作：放宽到 500–800ms。
- 现象：CPU 占用高。检查：进程优先级。动作：在任务管理器把 LunaTranslator 调为「低于正常」。
- 现象：窗口特效拖慢渲染。检查：Aero/Acrylic 是否开启。动作：关闭窗口特效，或改用纯文本渲染。
进阶调优：词典、过滤、后处理
- 自定义词典：给专有名词和人名锁定译法，避免同一角色被翻成两个名字。替换规则写在 字符串替换配置 的
stringreplace段，按「原文 → 译文」添加即可。 - 正则过滤：文本进翻译之前先清洗，去掉换行、控制字符、多余符号。处理方法及顺序在 transoptimi 目录 对应实现，用法见 文本处理文档。
- 翻译后处理：对返回结果再加工，统一标点、全半角转换（NFKC 默认开启）。全部规则与执行顺序见 postprocessconfig.json。
文档与社区
出问题时按顺序来：先查文档，再翻历史 issue，最后才新建 issue，附上现象、游戏名和截图。
- 基本用法：三种模式的操作入口
- HOOK 设置：注入失败时的重点文档
- OCR 参数：识别质量逐项调优
- 翻译引擎对比：各家引擎的特性差异
- 常见问题 与 问答补充
配置都写在软件旁的userconfig/目录，换机器时整包拷走；默认配置 可作为排查异常值时的参照。
把模式选对、引擎挑顺，翻译窗口就会安静地跟住每一句对白。剩下的细节，等你玩起来之后再慢慢抠。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
