3个跨平台方案：LunaTranslator多系统适配与高效使用指南

LunaTranslator是一款Galgame翻译器，支持HOOK、OCR（通过图像识别提取文字的技术）、剪贴板等文本提取方式，为视觉小说爱好者提供跨平台翻译解决方案，帮助不同系统用户突破语言障碍。

功能特性解析

HOOK模式：实时文本捕获方案

适用场景：运行中的Windows原生游戏，需要实时提取游戏内文本进行翻译。

场景：玩家在游玩未汉化的Galgame时，希望实时获取游戏对话并翻译。 解决方案：使用HOOK模式选择游戏进程并注入，然后选择符合游戏文本的候选行。 效果：翻译结果实时显示，不影响游戏运行流程。

功能评分卡

• 功能完整性：★★★★★
• 配置复杂度：★★☆☆☆
• 性能消耗：★★☆☆☆

知识拓展：HOOK功能相关实现代码可参考 src/LunaTranslator/LunaHook/ 目录

OCR识别：图像文本提取方案

适用场景：Linux、Mac系统或无法使用HOOK模式的游戏，通过截取屏幕区域提取文字。

场景：在Mac系统上运行Galgame，无法使用HOOK功能获取文本。 解决方案：切换到OCR模式，选择游戏文本显示区域，启动自动识别。 效果：准确识别屏幕区域内的文字并进行翻译，识别准确率可达90%以上。

功能评分卡

• 功能完整性：★★★★☆
• 配置复杂度：★★★☆☆
• 性能消耗：★★★☆☆

知识拓展：OCR引擎实现源码位于 src/LunaTranslator/ocrengines/local.py

剪贴板翻译：通用文本翻译方案

适用场景：所有系统，适用于任何可复制文本的场景。

场景：在任何系统中，需要翻译从游戏或其他应用复制的文本。 解决方案：复制文本到剪贴板，LunaTranslator自动检测并翻译。 效果：快速获取翻译结果，支持多种翻译引擎。

功能评分卡

• 功能完整性：★★★★★
• 配置复杂度：★☆☆☆☆
• 性能消耗：★☆☆☆☆

知识拓展：剪贴板处理相关代码在 src/LunaTranslator/textio/textsource/copyboard.py

系统适配方案

Windows系统配置

准备工作：确保系统已安装Python 3.6及以上版本和Git。

执行步骤：

1. 克隆项目仓库：

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

2. 进入项目目录：

   cd LunaTranslator/src
   

3. 运行启动脚本：

   ./run.bat
   

验证方法：启动后观察是否出现LunaTranslator主界面，尝试使用HOOK模式选择一个运行中的游戏进程。

注意事项：Windows系统推荐使用管理员权限运行，以确保HOOK功能正常工作。

Linux系统配置

准备工作：安装必要依赖包。

执行步骤：

1. 安装系统依赖：

   sudo apt-get install python3-pyqt5 python3-pip tesseract-ocr
   

2. 克隆项目仓库：

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

3. 安装Python依赖：

   cd LunaTranslator
   pip3 install -r requirements.txt
   

4. 启动应用：

   cd src
   python3 main.py
   

验证方法：启动后切换到OCR模式，选择一个文本区域进行识别测试。

注意事项：Linux系统下HOOK功能支持有限，建议主要使用OCR和剪贴板翻译功能。

Mac系统配置

准备工作：安装Homebrew包管理器。

执行步骤：

1. 安装系统依赖：

   brew install python3 pyqt5 tesseract
   

2. 克隆项目仓库：

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

3. 创建并激活虚拟环境：

   cd LunaTranslator
   python3 -m venv venv
   source venv/bin/activate
   

4. 安装Python依赖：

   pip install -r requirements.txt
   

5. 启动应用：

   cd src
   python3 main.py
   

验证方法：检查应用是否正常启动，测试OCR和剪贴板翻译功能。

注意事项：Mac系统可能需要在系统偏好设置中授予应用屏幕录制权限以使用OCR功能。

进阶技巧

配置本地OCR引擎

准备工作：下载并安装Tesseract OCR引擎。

执行步骤：

1. 打开LunaTranslator设置界面
2. 导航至OCR引擎配置选项
3. 选择"本地OCR引擎"
4. 调整识别语言和置信度阈值
5. 保存配置并重启应用

验证方法：使用OCR模式识别一段文本，检查识别准确率是否符合预期。

知识拓展：OCR参数配置文档可参考 docs/zh/ocrparam.md

配置云端翻译服务

准备工作：获取对应翻译服务的API密钥。

执行步骤：

1. 打开设置界面，选择"翻译服务"选项卡
2. 选择需要配置的云端翻译服务
3. 输入API密钥等必要信息
4. 测试连接并保存配置

验证方法：使用该翻译服务翻译一段文本，检查是否成功返回结果。

知识拓展：API配置详细说明见 docs/zh/useapis/tsapi.md

自定义快捷键

准备工作：确保应用已关闭。

执行步骤：

1. 打开配置文件 src/LunaTranslator/defaultconfig/config.json
2. 找到"hotkey"部分
3. 修改或添加快捷键配置
4. 保存文件并启动应用

验证方法：在应用中测试设置的快捷键是否生效。

注意事项：避免与系统或游戏快捷键冲突。

问题解决

Linux系统权限错误

错误现象：启动应用时提示权限不足。 根本原因：应用没有足够的系统权限访问必要资源。 解决方案：

chmod +x src/run.bat
sudo apt-get install libx11-dev libxtst-dev

预防措施：运行应用前确保已安装所有必要依赖包。

Mac系统Python环境冲突

错误现象：启动时出现模块导入错误。 根本原因：系统Python环境与应用依赖不兼容。 解决方案：

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

预防措施：始终使用虚拟环境隔离应用依赖。

字体显示乱码问题

错误现象：翻译结果显示为乱码或方块。 根本原因：系统缺少必要的中文字体。 解决方案：

• Windows：安装微软雅黑或宋体
• Linux：

  sudo apt-get install fonts-wqy-zenhei
  

• Mac：通过Font Book安装中文字体 预防措施：安装应用前确保系统已安装常用中文字体。

上图展示了LunaTranslator的使用场景，用户可以通过该工具轻松获取游戏中的文本翻译结果，提升游戏体验。