LunaTranslator 完整教程：HOOK 与 OCR 双路取词，把日文视觉小说实时翻成中文

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

一打开日版视觉小说，满屏的假名和敬体句式瞬间劝退——LunaTranslator 就是为这个痛点而生的实时翻译工具：它跑在 Windows 上，一边从游戏进程里抽文本，一边调用翻译引擎，把原文几乎实时地换成了中文。这篇教程不绕弯子，按「先跑起来 → 选对取词方式 → 配好翻译引擎 → 对号入座 → 调参排障」的顺序，带你把整条流程走通。

第一次运行：解压版还是源码版

拿法有两种。图省事，直接去官网取 Windows 安装包，解压到任意目录就能跑（别放进C:\Program Files这类特殊路径，否则保存配置和缓存会出问题）。想改代码或看实现，再走源码路线：

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

依赖装齐：

pip install -r requirements.txt

然后从仓库根目录启动主程序：

python src/LunaTranslator/main.py

解压版里带LunaTranslator_admin.exe，只有当某些游戏必须管理员权限才能被 HOOK 时才用它，平时普通模式启动就够；想要命令行输出就开 debug 版。

取词两条路：HOOK 优先，OCR 兜底

软件能读到游戏文字，靠的不是「截屏再认字」，而是两条正路。

HOOK：直接把进程里的原文抽出来

游戏已经在跑的话，进 HOOK 模式，打开「选择游戏进程」窗口，点中目标进程。确认后 LunaTranslator 会往游戏里注入并弹出选文本窗口；先让游戏跑出几句台词，候选文本行会陆续出现，挑对的那一行，翻译随即开始。

嫌麻烦的话，把游戏可执行文件直接拖进软件窗口松开，它会帮你转区启动并自动 HOOK，省掉手动选进程这一步。

部分游戏还支持「内嵌」：把中文直接写回游戏画面里的原文框，沉浸感拉满✨；不支持内嵌的，就只有旁边那个「显示」窗口。玩主机模拟器也一样——NS、PSP、PSV、PS2、PS3 上的大量作品都能通过 HOOK 模拟器直接读文本（PPSSPP、PCSX2、RPCS3 等）。

OCR：HOOK 拿不到时的兜底

遇到 HOOK 抽不出来的画面，切到 OCR 模式，框定识别区域即可自动识别再翻译。LunaTranslator 自带精度较高的本地 OCR 模型，也接了在线与离线多种 OCR 引擎，断网场景也能识别。

翻译引擎分三类，按需挑

取到文本后交给谁翻，大致分三档：

• 在线接口：谷歌、百度、DeepL 等主流服务，配好即用，日常够用。
• 本地离线模型：断网、或不想把剧情传出去时用。LunaTranslator 基于 llama.cpp 运行时加载 GGUF 本地模型，隐私敏感的内容可全程不联网。
• 大语言模型：接 ChatGPT 之类的 LLM，适合需要语境理解、术语更准的长文本。

按游戏类型对号入座

刷不出文本？先动这两个参数

多数「取词」问题出在刷新节奏，不必急着换引擎：

• 刷新延迟：文本每次只出一两个字、或一行顶掉上一行，说明游戏出字慢而延迟太低——把刷新延迟调大（或调快游戏出字）；翻译跟得上但偏慢，再适当调小。
• 最大缓冲区长度 / 最大缓存文本长度：文本反复刷屏时，把缓冲区长度调小一点（别小到低于真实文本长度）；历史文本缓存默认值偏高，调低也能缓解查看时的卡顿。

常见现象排查

顺手把学习和语音也接上

翻译之外，它还能做不少事：接 TTS 把译文读出来（Windows 自然语音、VOICEVOX 等）；用 AnkiConnect 把生词丢进 Anki；对日语文本做分词和假名注音，也能对接 Yomitan 插件。取词方式、翻译引擎、文本后处理这几块都能在设置里自由组合，多试几种搭配，总能找到最贴合自己玩法的那一套。

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