LunaTranslator：视觉小说实时翻译，5分钟跑通

2026/11/2 15:14:17

LunaTranslator：视觉小说实时翻译，5分钟跑通

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

LunaTranslator 是一款视觉小说实时翻译工具，直接从 Galgame 里读文字、自动译成中文。本文带你在 5 分钟内把它跑起来，并选到一套趁手的配置。

跑起来前：30秒自检

系统：Windows 10/11（64 位），旧版 Win7 有单独的兼容包
依赖：Python 3.x 环境，用于跑源码版
网络：克隆仓库和装依赖要联网；翻译引擎要不要联网，看你后面选哪一类
装之前先暂停杀毒软件，或把软件目录加进信任，否则注入用的组件会被误删

安装：三步搞定

克隆仓库到本地：

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

补装 Python 依赖，缺什么装什么，以项目实际版本为准。
进仓库根目录，跑一下主程序：
```
python src/LunaTranslator/main.py
```

官方也提供打包好的运行版本，解压后直接点 exe 就行，能省掉前两步。

它到底怎么抓文字：两件事

Galgame 的文字来源只有两条路。第一条是 HOOK：软件把一个 DLL 注入游戏进程，直接从游戏内存里读出原文，不靠截屏，稳定又跟手。第二条是 OCR：软件定时截屏，再把画面里的文字识别出来，专治 HOOK 读不到文本的游戏。判断标准一句话：你的游戏能 HOOK 就用 HOOK，抓不到再上 OCR。

翻译引擎：选一个就够

三类各挑一个代表，够了。

在线：谷歌翻译——免费、快、要联网，日常读剧情够用。
离线：本地 llama.cpp 模型——断网也能译、数据不出机器，但吃显卡。
AI：大语言模型（ChatGPT 或国产模型）——语义最准、能下指令改风格，按量计费。

拿不准就先跑在线的谷歌翻译。

三套配置直接抄

新手档：

文本获取：HOOK，自动检测游戏进程
OCR：不开
翻译引擎：谷歌翻译（在线）
额外：开「原地显示译文」，边看边学

平衡档：

文本获取：HOOK 为主，读不到时自动补 OCR
OCR：用内置的高精度模型
翻译引擎：国产大模型
额外：开文本相似度阈值，避免同一句反复重译

折腾党：

文本获取：HOOK 模拟器（NS/PSP/PS2）
OCR：自定义识别区域 + 图像稳定性阈值
翻译引擎：本地 llama.cpp 模型（离线）
额外：开内嵌翻译或 TTS 语音合成

踩坑与排查

启动报"找不到重要组件 / Missing embedded Python"，或卡在"正在等待DLL注入"→ 多半是杀毒误杀，把软件目录加进信任/排除项，重新解压。
报 PermissionError 或配置存不进去→ 软件别放C:\Program Files这类特殊目录，挪到普通文件夹。
HOOK 选不到游戏进程→ 用管理员权限的LunaTranslator_admin.exe启动。

依赖装不上、一直报红→ 换清华源：

pip install <包名> -i https://pypi.tuna.tsinghua.edu.cn/simple

下一步

想在游戏画面里直接看到中文字幕，开「内嵌翻译」，见 embedtranslate 文档。
OCR 翻译抖、同一句反复重译，去调相似度/稳定性阈值，参考 ocrparam。
想接自己的翻译服务或加词库，看翻译引擎。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

LunaTranslator：视觉小说实时翻译，5分钟跑通