LunaTranslator 使用指南：GalGame 翻译工具三种取词模式的完整流程
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
如果你在玩日文或英文游戏，想按自己的语言阅读对白，最先要解决的就是“把屏幕上的文字拿下来”。LunaTranslator 是一款面向 Windows 的 GalGame 翻译工具，通过 HOOK、OCR、剪贴板三种方式取词，接上各类翻译引擎后，把译文显示在游戏旁。
先判断你的游戏属于哪一类
动手配参数之前，先搞清楚游戏的文字走哪条路：
- 文字存放在进程内存里（多数视觉小说）：走 HOOK
- 文字以图像形式呈现，或 HOOK 失败：走 OCR
- 游戏内可以手动复制文字：剪贴板就够
| 游戏现状 | 建议模式 | 做法 |
|---|---|---|
| 常见视觉小说、可正常注入 | HOOK | 选进程，或拖入 exe 自动注入 |
| HOOK 取不到，或文字是图片 | OCR | 框住识别区域，持续识别 |
| 游戏内 Ctrl+C 能复制 | 剪贴板 | 复制后自动触发翻译 |
在模拟器里跑的游戏
官方文档维护了各平台的模拟器兼容列表（docs/emusupportlist/），NS、PSP、PSV、PS2 等平台的模拟器同样支持 HOOK 取词，不用先导出存档。
三步跑起 LunaTranslator GalGame 翻译工具
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator克隆后如果只想体验源码版，Windows 上直接运行src\run.bat即可，仓库内附带了运行环境。文档在 docs/，有中英日韩等多语言版本，含快速上手章节。
拖拽快速启动
最快的路径：打开软件后，把游戏 exe 拖到主窗口上松手。游戏会自动启动并完成注入，随后弹出文本选择窗口。
对已经在运行的游戏
进入 HOOK 模式，在进程选择窗口里选中游戏进程并注入，效果与拖拽方式一致。
三种取词模式的正确打开方式
HOOK：多数游戏的主路径
让游戏运行并显示一些文字，文本选择窗口会列出若干候选行。点选与游戏对白吻合的那一行，翻译随即开始。若该游戏支持内嵌翻译，界面上会出现“嵌入”按钮，译文可直接替换进游戏内文本框，效果见 docs/en/embedtranslate.md。
OCR：兜底方案
HOOK 取不到文字时，切到 OCR 模式，框选屏幕中文字出现的区域，软件会持续识别并翻译。注意工具栏上有两个图标相同的按钮：一个是持续自动识别，另一个只对当前画面做一次识别，别点混。内置识别方案包括 Windows 系统 OCR、Tesseract、百度等云端服务，以及自带的高精度本地模型。
剪贴板：最稳也最费手
复制即触发翻译，几乎兼容所有游戏，代价是每次都要手动复制。
按游戏保存配置并微调参数
不同游戏刷新文字的快慢不一样，一套参数在这款游戏里顺畅，换一款可能就会卡顿。游戏管理器（src/LunaTranslator/gui/gamemanager/）支持为每个游戏保存独立参数集，切游戏时一键切换。
HOOK 参数按症状调
| 看到的现象 | 要动的参数 |
|---|---|
| 文字一次蹦出一两个字符，或旧行被新行顶掉 | 调大刷新延迟 |
| 文字反复刷新、一直停不下来 | 调小最大缓冲区长度，但仍要长于实际文字 |
| 翻看历史文字很卡 | 调小最大缓存文字长度 |
两个容易碰壁的设置
编码（代码页）设置主要服务于老国产引擎，一般不用动。如果始终选不对文本，到项目 issue 里反馈游戏名，比反复调这个项更有效。
让翻译结果更好用
翻译引擎怎么选
内置引擎覆盖 Google、DeepL、百度、腾讯等云端服务；本地方案有 Sakura 离线翻译和基于 LLM 的翻译（含本地模型）；还有一个自定义 API 入口，可以接入你自己的翻译服务。想离线就用本地引擎，追求质量就选云端或 LLM。
后处理与名词词典
src/LunaTranslator/transoptimi/ 模块负责翻译结果的二次加工：常见误译修正、专名替换。对反复译错的角色名、地名，写进词典比每次手改更省心。
词典、语音与对外服务
- 词典：支持 MDict 读取 .mdx 与 .mdd 文件，也可接 Jisho、Weblio 等在线词典
- 语音：Windows 系统 TTS、Edge TTS 等多个引擎
- 语言学习：日语分词、振假名标注、Anki 同步、Yomitan 插件
- 对外接口：内置网络服务（src/LunaTranslator/network/）把翻译、词典、OCR、TTS 做成 HTTP 接口，原文与译文还能通过 WebSocket 实时推给其他程序
出问题时快速排查
取不到文字
- 确认选中的是游戏进程本身，而不是启动器
- 重启游戏后重新注入，或尝试延迟注入
- 仍不行就切 OCR，并把游戏名报给项目维护者，兼容列表会持续更新
翻译不准或偏慢
- 换引擎对比，同一段原文在不同引擎下差别可能很大
- 把高频错词加入名词词典，并开启后处理
- 慢的话检查网络与代理设置；刷新过密时适当调大刷新延迟
启动与环境
主程序依赖 C++ 编译的 HOOK 引擎，首次使用建议把安装目录加入杀毒软件的信任列表，避免注入被拦截。源码版遇到问题时，换官方发布的正式版本再复现一次。
上手提醒：第一次使用别急着调参数，用默认配置把“选词—出译文”流程跑通，再按实际游戏的症状对照 docs/ 中的对应章节逐项查。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
