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），仅供参考
