企业官网建设流程全解析

LunaTranslator 视觉小说翻译上手手册：HOOK 与 OCR 两条路怎么选，克隆仓库后如何看懂第一句台词

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

LunaTranslator 是一款视觉小说翻译器（Visual Novel Translator），核心能力是把游戏里的外文文本实时捕获并翻译成中文，支持 HOOK 抓取内存文本、OCR 识别屏幕文本、游戏内嵌翻译等多种方式，是视觉小说汉化场景下玩家最常用的工具之一。这篇手册不按部就班讲功能清单，而是先帮你判断「自己卡在哪一步」，再对号入座走流程。

一、先对号入座：你的游戏卡在哪个环节

拿到一款外语视觉小说，常见有三类卡点，对应三条完全不同的操作路径：

经验提示：优先尝试 HOOK 路径。HOOK 是从游戏内存里直接取文本，不依赖屏幕渲染，识别率远高于 OCR，也不受字体、特效、动态背景干扰。只有当你确认 HOOK 候选文本里始终没有游戏台词时，再切到 OCR。

二、跑起来之前：一条命令把仓库拉到本地

所有操作的前提是先拿到软件本体。打开终端执行下面的命令，它会克隆 LunaTranslator 项目到本地：

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator

克隆完成后按 docs/zh/README.md 的说明完成后续构建与启动。仓库里src/LunaTranslator/translator/目录下每个文件就是一个翻译引擎的实现，后面配引擎时会用到。

三、HOOK 模式怎么绑对游戏文本

游戏已经启动的情况下，在软件里选择 HOOK 模式，弹出「选择游戏进程」窗口，点选目标游戏进程并确认。软件会注入该游戏，随后自动弹出「选择文本」窗口。

关键动作只有一个：让游戏跑一会儿，屏幕显示出真实台词后，候选文本列表里会出现若干条行。哪一行跟着游戏文字同步变化，哪一行才是正确的——选中它，翻译就开始生效。如果列表里没有跟游戏联动的行，多半是抓错了引擎或候选项，此时再考虑改用 OCR。

想要游戏内嵌翻译时，乱码先查字体和字符集

部分游戏支持把译文直接写回游戏画面（游戏内嵌翻译），选择文本窗口里会出现「内嵌」按钮列；没有这一列就说明该游戏不支持，别硬试。内嵌时有两个高频坑：

• 英文游戏内嵌后中文变方块：通常是游戏缺中文字体，激活「修改游戏字体」换一个合适的字体即可。
• 古早日文 galgame 内嵌后大量乱码：多为游戏内置 shift-jis 字符集处理不了简体字，尝试「将汉字转换成繁体/日式汉字」可显著减少乱码。

更多内嵌细节（翻译等待时间、限制每行字数等）可看 docs/zh/embedtranslate.md。

四、OCR 模式：HOOK 抓不到时的备胎

切到 OCR 模式后框选一个识别区域，软件会持续截图、识别并翻译该区域。三个容易踩的坑：

1. 别按错按钮：持续识别和「临时选取并识别一次」是两个图标几乎相同的按钮，按错后者只会识别一帧就停，很多人以为 OCR 坏了，其实是按错了。
2. 区域选偏了怎么办：重新框选即可；如果游戏台词位置会变（例如不同界面文本框不同位置），在 OCR 设置的「其他」里开启多重区域模式，为每个位置各框一个区域，用快捷键在区域间切换并立即重新 OCR，省去反复手动框选。
3. 识别频率不对劲（太频繁或太迟钝）：OCR 有周期执行、图像稳定性分析等四种自动化策略，参数调节方法在 docs/zh/ocrparam.md，看不懂其他参数时直接用默认的「周期执行」最稳。

五、懒人捷径：拖一下，启动和 HOOK 一起做

不想自己先启动游戏再找进程的话：把游戏可执行文件直接拖进 LunaTranslator 窗口，松手后游戏会被自动添加、自动启动并自动 HOOK，随后照第三节的「选择文本」流程操作即可。启动、注入、选文本三步压缩成一步，是最省事的日常路径。

六、用得顺手的最后三件事

快捷键：先在设置里激活「是否使用快捷键」，再逐项启用并绑键。最值得先配的三组——OCR 模式下「选取区域 / 切换区域」、HOOK 模式下「选择游戏 / 选择文本」、以及全局的「手动执行一次翻译」。完整键位说明见 docs/zh/fastkeys.md。

翻译引擎：软件支持几乎所有主流翻译引擎，包括大语言模型翻译和离线翻译，可在设置里随意切换。追求语境连贯选 LLM 类引擎（对应src/LunaTranslator/translator/下的 chatgptlike 等实现），追求速度和免费则选常规引擎。

学习向附加：如果你边玩边记词，可以配置 Anki 同步，把台词做成卡片，卡片过多时的本地同步服务器方案见 docs/zh/ankisync.md。

基础操作的完整图文版在 docs/zh/basicuse.md。下一步就挑一款游戏，按上面对号入座的路径走完「选进程 → 选文本行 → 出译文」，译出第一句台词，工具就算真正上手了。

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