LunaTranslator 使用指南3 步跑通视觉小说翻译器再调成你自己的样子【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款免费开源的视觉小说翻译工具能自动读取游戏里的文字并实时翻译成中文。它靠 HOOK 和 OCR 两种方式看到游戏文本再调用几十种翻译引擎完成翻译连 NS、PSP、PS2 等模拟器游戏也能处理。这篇 LunaTranslator 新手教程按你的实际操作路径来写先看看仓库里都有什么再 3 步把它跑起来最后告诉你这个翻译工具如何配置到最顺手。打开仓库先扫一眼几个关键目录各管一摊️ 不用每个文件夹都懂记住下面几个就够src/LunaTranslator/ —— Python 主程序。入口是 main.py各功能模块按职责分目录translator/ 管翻译接口、ocrengines/ 管 OCR 引擎、tts/ 管朗读、defaultconfig/ 存放出厂配置模板。src/NativeImpl/ —— C 原生代码负责真正钻进游戏内存提取文字以及本地 OCR 推理。src/files/ —— 界面样式、多语言文本等资源。docs/ —— 官方使用文档中文在 docs/zh/遇到搞不定的功能先去翻这里。其余如 CMake 构建脚本、LICENSEGPLv3 许可属于工程细节先忽略即可。看完了仓库接下来就是点火启动。3 步启动从 clone 到主界面✅ LunaTranslator 是 Windows 桌面程序依赖 Python 环境和 PyQt5 图形库。克隆仓库git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator确认已安装 Python 3并装好界面依赖pip install PyQt5进入 src/ 目录双击执行 run.bat——它会运行python.exe -B LunaTranslator\main.py点亮主界面如果不想折腾环境可以直接下载官方发布包解压即用。启动成功后你手里这台机器该调调参数了。遥控器在哪最常改的 5 个参数️ LunaTranslator 的配置相当于一个遥控器运行后程序会在 src/LunaTranslator/ 旁生成userconfig文件夹首次运行自动创建里面就是你实际生效的配置仓库里的 defaultconfig/config.json 只是出厂模板。大多数设置可以直接在软件设置界面里改并自动保存你也可以自行编辑对应文件——改之前先退出软件不然改动会被覆盖。最常动的是这几个参数 / 作用 / 建议值参数作用建议值languageuse2config.json界面语言中文写zh翻译引擎的usetranslatorsetting.json选择启用哪个翻译接口如google、bing、大模型接口新手先开googletgtlang4config.json翻译目标语言看日文游戏填zhrendertext.webviewconfig.json译文显示样式如描边、阴影影响游戏里可读性背景亮的游戏选miaobian1描边OCR 引擎ocrsetting.json选择文字识别来源本地或在线不联网时用local配置只保留最小认知先跑通再按上表一项项试改动后重开软件即可生效。最后交代几个新手最容易卡住的地方。新手常见的 3 个卡点⚠️ 先别慌这些问题都有现成解法找不到配置入口配置不在源码目录里而在程序运行目录旁的userconfig文件夹启动时也可以传--userconfig参数指定别的目录。启动报权限/依赖错误源码方式启动需要 Python 环境和 PyQt5 已装好编译 NativeImpl/ 涉及权限和工具链新手直接下官方发布版最省心。游戏里没出译文先在工具栏用读取剪贴板确认翻译引擎本身正常再检查 docs/zh/hooksettings.md 中 HOOK 是否适配你的游戏走 OCR 的话确认已框选 OCR 范围。更多玩法看 docs/zh/基本用法、HOOK 设置、OCR 参数想深挖源码从 src/LunaTranslator/ 的 main.py 入手最合适。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考