LunaTranslator零基础上手指南：Galgame多引擎翻译工具效率提升全攻略

LunaTranslator是一款专为Galgame和视觉小说设计的多引擎翻译工具，集成HOOK实时捕获、OCR图文识别和剪贴板监控三大核心功能，支持百度、谷歌、DeepL等10+翻译服务。通过灵活的引擎配置和优化的文本处理流程，帮助玩家突破语言障碍，实现游戏内容的即时翻译与流畅阅读体验。

系统环境检测指南

最低配置要求

• 操作系统：Windows 10/11（64位）
• 硬件资源：2GB RAM，2GB可用存储空间
• 运行环境：Python 3.8+（建议3.10版本）

环境预检查清单

1. 确认已安装Python并配置环境变量（python --version命令验证）
2. 检查系统是否启用UTF-8编码（控制面板→区域→管理→更改系统区域设置）
3. 临时关闭杀毒软件（避免误删关键组件）

项目获取与初始化

两种安装方式对比

方法	操作步骤	优势	适用场景
Git克隆	git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator	便于更新	熟悉命令行用户
手动下载	访问仓库页面下载ZIP压缩包	操作直观	新手用户

项目结构概览

核心目录说明：

• src/LunaTranslator/：主程序代码
• src/files/lang/：语言配置文件
• src/defaultconfig/：默认配置模板
• docs/：官方文档（多语言版本）

依赖安装与环境配置

基础依赖安装

cd LunaTranslator
pip install -r requirements.txt

网络优化方案

当官方源下载缓慢时，使用国内镜像：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

关键依赖说明

• PyQt5：图形界面框架
• pytesseract：OCR识别核心
• requests：网络请求处理
• win32api：Windows系统交互

核心功能模块配置

HOOK文本捕获设置 ⚡

1. 进入配置目录 src/LunaTranslator/defaultconfig/
2. 编辑 config.json 文件，设置：

   "hook": {
     "enable": true,
     "target_process": "game.exe",
     "capture_interval": 100
   }
   

3. 支持的游戏引擎：Unity、Ren'Py、吉里吉里等主流AVG引擎

OCR引擎配置方案

提供三种识别方案选择：

引擎	配置路径	特点
Tesseract	src/LunaTranslator/ocrengines/tesseract5.py	完全离线，需下载语言包
百度OCR	src/LunaTranslator/ocrengines/baiduocr_X.py	高精度，需API密钥
腾讯OCR	src/LunaTranslator/ocrengines/txocr.py	多语言支持，按调用计费

翻译服务集成

在 src/LunaTranslator/translator/ 目录下提供多种翻译引擎实现：

• 在线服务：百度翻译（baiduapi.py）、谷歌翻译（google.py）
• 本地服务：DeepL（deepl_1.py）、ChatGPT（chatgpt-3rd-party.py）
• 配置方法：复制对应引擎的配置模板，填写API密钥或服务器地址

快速启动与基础操作

启动程序

cd src
python main.py

界面功能布局

主界面分为四大区域：

1. 源文本显示区：游戏原始文本
2. 翻译结果区：实时翻译内容
3. 控制工具栏：引擎切换、参数调整
4. 状态监控区：显示当前捕获/翻译状态

性能优化与高级设置

效率提升技巧

1. 缓存优化：在 config.json 中设置 cache_size: 200 提升重复文本翻译速度
2. 引擎组合：简单文本用本地引擎，复杂内容切换在线服务
3. 热键配置：通过 src/LunaTranslator/gui/setting/hotkey.py 自定义操作快捷键

自定义词典配置

1. 编辑 src/LunaTranslator/cishu/ 目录下的词典文件
2. 支持MDict格式词典导入（需放置在 mdict_ 子目录）

新手常见误区与解决方案

安装问题

• 依赖冲突：使用虚拟环境 python -m venv venv 隔离项目环境
• 缺失DLL文件：安装 Microsoft Visual C++ 运行库

使用故障

• HOOK失败：检查游戏是否以管理员权限运行
• OCR识别乱码：在 ocrsetting.json 中调整识别区域和语言参数
• 翻译无响应：验证网络连接或API密钥有效性

功能扩展与资源获取

官方文档

多语言使用指南位于 docs/ 目录，包含：

• 基础操作：docs/zh/basicuse.md
• 高级配置：docs/zh/transoptimi.md
• 常见问题：docs/zh/qa1.md

社区支持

• 项目Issue跟踪：提交功能需求或bug反馈
• 配置模板分享：社区用户贡献的优化配置文件

通过本指南配置的LunaTranslator已具备基础翻译能力，建议根据具体游戏需求进一步调整参数。定期同步项目更新可获取最新功能和兼容性改进。