LunaTranslator 实战手册：4 步配置让日系视觉小说变成实时中文
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
剧情关键抉择处，对话框突然冒出日文，限时倒计时还在走——读不完？错过？这种"卡关"时刻正是 LunaTranslator 要解决的问题：一款开源免费的游戏翻译器，实时抓取游戏里的日文文本，翻成中文浮在画面上，原版 VN 现在就能玩到通关。
一分钟搞懂它能干什么 🎮
三种"抓文字"方式：HOOK / OCR / 剪贴板
它是日文翻译器，但翻译的前提是先把字弄出来。LunaTranslator 内置三种取词路径：
| 方式 | 原理 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|---|
| HOOK 模式 | 直接从游戏内存读文本 | 大多数现代引擎（Unity、Ren'Py、自研） | 延迟几乎为零、文本精准 | 需要进程注入，个别引擎未适配 |
| OCR 模式 | 截图 + 图像识别 | HOOK 失效、特殊渲染场景 | 几乎任何游戏都能用 | 有识别延迟，受背景干扰 |
| 剪贴板模式 | 监听剪贴板变化 | 支持选中复制文字的游戏 | 配置最简单 | 被动等待你复制，不能自动触发 |
经验之谈：先试HOOK，不行再降级OCR，剪贴板模式当作最后兜底。
翻译引擎怎么选：在线 vs 离线
引擎分两组，各挑代表说两句。
在线引擎（需联网，质量优先）：
- 百度翻译：响应快、日常对白稳，新手默认推荐
- DeepL：复杂句式和敬语处理更自然，长段落优势明显
- 彩云小译：对 ACG 语境理解到位，视觉小说翻译味道更对
离线引擎（本地模型，不联网）：
- 游戏文本不出本机，隐私友好
- 不受网络波动影响，延迟稳定
- 可配合自定义词典微调，折腾空间大
新手先用在线引擎跑通流程，之后想折腾再上本地模型不迟。
从克隆到跑通：最简上手路径 ⚡
- 获取代码：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator- 解压到用户目录下的自定义文件夹，别放
C:\Program Files这类系统保护目录，否则配置写不进去。 - 首次启动完成基础配置：选界面语言、确认文本输入源。
- 在翻译设置里选好引擎，发一句话试译，确认链路通。
- 设好热键（默认 F12 切换翻译窗口），按习惯改组合，参考 docs/zh/fastkeys.md。
- 启动游戏，回到 LunaTranslator 选中游戏进程注入（也可以把 exe 直接拖进主窗口，自动启动并注入）；在文本选择窗口点中符合游戏对白的那一行。
翻译窗口里出现中文，就成了。支持内嵌翻译的游戏还能直接把译文写回游戏画面。
按游戏类型抄作业
现代引擎作品（Unity / Ren'Py）：首选 HOOK
推荐组合：HOOK 模式+ 代码页Shift-JIS+ 在线引擎（百度/DeepL）。出现"一次只出一两个字"或"只显示最后一行"时，调高刷新延迟；提取太慢则适当调低。老引擎官方中文版把代码页换成 GBK/BIG5 试试。参数细节见 docs/zh/hooksettings.md。
模拟器上的日区作品：翻译怎么配
先 HOOK 模拟器进程本身，项目已适配一批主流模拟器，清单见 docs/emusupportlist/。内存读不到就切OCR 区域选择：圈住对话框、执行方式选"周期执行"、间隔 500ms 左右起步。掉帧就把识别频率降到 800ms 以上、关实时预览。
老平台 / 低分辨率作品：代码页轮换法
老游戏多是多字节编码加奇怪文本排布。推荐组合：HOOK + 代码页轮换（Shift-JIS → EUC-JP → GBK）+ 激活"Win32 通用钩子"扩大捕获面；HOOK 彻底不行就上 OCR，先把窗口最大化、调大游戏内字号再识别。
翻译质量调优三招
自定义词典：把人名地名锁死
做什么：把反复翻错的角色名、物品名固定成指定译法。在哪里改：游戏设置 → 翻译优化 → 专有名词翻译，游戏专用词条建议写到该游戏自己的设置里，别塞进全局。改完效果：原文先被替换成占位符再送翻译，回来换回固定译名，全篇角色名不再"千人千面"。
正则预处理 / 后处理：清掉垃圾文本
做什么：去掉控制字符、重复字符、无意义括号，并修正译后小错。在哪里改：翻译优化里的"翻译前替换"支持正则；后处理模板参考 src/LunaTranslator/defaultconfig/postprocessconfig.json，比如开启"去除重复字符 AAAABBBB→ABC"。改完效果：引擎收到干净句子，输出也规整，翻译质量肉眼可见提升。
显示层微调：透明度、字体、位置、气泡
做什么：让译文窗口贴住游戏界面而不抢戏。在哪里改：设置 → 显示，对应实现在src/LunaTranslator/gui/setting/display.py。改完效果：不透明度 60%-70%、位置放屏幕底边或侧边、开气泡样式模仿游戏对话框，观感直接贴近官方汉化。
翻车了怎么办：高频故障速查 🔍
HOOK 注入失败：5 步排查
- 游戏和 LunaTranslator 都以管理员权限运行
- 游戏切到窗口模式
- 换代码页（Shift-JIS / UTF-8 / GBK）
- 激活"Win32 通用钩子"扩大钩子范围
- 试延迟注入，仍不行就提 issue 求适配
OCR 识别乱码：5 步排查
- 重新框选区域：只含对话框，排除背景特效
- 关游戏内抗锯齿、动态模糊，调高文字对比度
- 执行方式改"分析图像更新"，调稳定性/一致性阈值（docs/zh/ocrparam.md）
- 换 OCR 引擎，或切本地 Tesseract 复认
- 分辨率拉到 1080p 以上重试
翻译延迟高、游戏卡顿：5 步排查
- 调低最大缓存文本长度（默认百万级，几千就够）
- 提高刷新延迟，减少触发次数
- 任务管理器里把进程优先级设为低
- 调低最大输出文本长度，过滤 Skip 时的文本爆发
- 换轻量离线引擎，关实时预览
想再深一点：进阶与贡献 ⚙️
源码在 src/LunaTranslator/，先看三个目录：translator/（各引擎实现）、ocrengines/（各识别引擎）、gui/setting/（设置界面）。配置分两层：defaultconfig/是出厂默认，运行时生成的userconfig/才是你自由改的地方。
成长路径很直接：先把配置调到顺手 → 读一读好奇模块的源码 → 遇到 bug 或缺引擎支持时带上复现步骤提 issue，维护者通常会跟进适配。
最合适的配置，永远是配出来的。现在就去打开你的第一款日系 VN，照上面的步骤走一遍。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
