企业官网建设流程全解析

LunaTranslator零基础上手指南：三步跑通视觉小说翻译

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

LunaTranslator 是一款开源视觉小说翻译器：HOOK、OCR、剪贴板三路捕获游戏文本，实时翻成中文，还能朗读出来。适合想玩日语等外语 VN、又不想手动查词的玩家。本指南带你从一台干净机器，三步走到看到第一句翻译。

图：LunaTranslator 视觉小说翻译工具效果展示

它能帮你省掉什么：三种手工活都免了

三条路里最核心的是 HOOK：它相当于在游戏的"台词出口"前设了个关卡站，游戏把对话送往屏幕之前要先经过这里，顺手抄走一份存档，游戏自己毫无察觉。有用的地方在于——你不再需要盯着画面一个字一个字地认，文本直接到手，翻译和朗读都是顺水推舟的事。

动手前30秒自检：环境够不够

缺什么去对应官网下载安装，装完重跑表里的命令能打印版本号就算数。⚠️ 注意：Python 安装向导里"Add to PATH"不勾，后面所有pip、python命令都会失效。

三步跑起来：克隆 → 安装 → 启动

一条命令把源码拉到本地

# 克隆 LunaTranslator 源码仓库 git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator # 进入目录，确认 src、docs 两个文件夹都在 dir LunaTranslator

✅ 完成标志：dir输出里能看到src、docs、LICENSE，说明代码下载完整。

一条命令装好依赖

# 安装界面所依赖的 PyQt5 库 pip install PyQt5 # 验证安装结果，能打印版本号即可 pip list | findstr PyQt5

⚠️ 注意：如果提示"pip 不是内部或外部命令"，是 PATH 没配好，重装 Python 时勾上 Add to PATH 再试。

启动后你第一次看到的是什么

# 用仓库自带的启动脚本拉起主程序 src\run.bat

几秒后弹出一个 Qt 主窗口：顶部一排工具栏（翻译引擎下拉框、模式切换按钮、TTS 菜单），中间是翻译内容区，底部有一条输入框。在这里敲一句外文点翻译，几秒后就能看到译文——从零到跑通，就到这里。✅ 完成标志：主窗口正常打开、没有报错弹窗、底部输入能出翻译。

⚠️ 注意：源码方式启动时，HOOK 注入需要的原生组件（LunaHost32.dll 等）不随代码附带；先用剪贴板和 OCR 模式熟悉流程，想用 HOOK 可按仓库里的 原生构建脚本 自行编译。另外别把程序目录放进C:\Program Files这类系统目录，否则配置可能存不下来。

想边玩边查的详细操作（HOOK 选文本行、OCR 框选区域）见 官方文档·基本用法。

按需微调（选做）：引擎、识别框、朗读声

1. 换个免注册的翻译引擎改哪里：主窗口顶部工具栏的"翻译引擎"下拉框 → 改成什么：选一个免注册的（如 Bing、Google）→ 怎么确认生效：底部输入框敲一句话点翻译，几秒内出结果。
2. 框出游戏对话区域改哪里：工具栏切到 OCR 模式，然后直接在屏幕上拖框 → 改成什么：让框完整盖住游戏对话框 → 怎么确认生效：游戏出现新对白时，译文自动跟着刷新。
3. 给译文配上朗读改哪里：工具栏"TTS"菜单 → 改成什么：选一个开箱即用的引擎（如 Edge TTS）→ 怎么确认生效：点译文旁的朗读按钮，能听到发音。

卡住了先看这里：四个高频症状

进阶内容（HOOK 设置、OCR 参数、TTS 引擎清单）都在 官方文档 里，遇到具体报错也可以直接翻 docs/zh/qa1.md 的问答页。

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