10分钟跑通LunaTranslator视觉小说翻译器从零开始的环境准备、首次启动与常用配置指南【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款 Windows 视觉小说Galgame翻译器用 HOOK 或 OCR 从游戏里提取文本交给各家翻译引擎出译文还能把译文写回游戏里直接读。这篇文章带你从零把克隆下来的代码跑起来并调好最常用的几项设置。 环境准备安装 LunaTranslator 前检查这几点操作系统这是 Windows 专用工具。正式发布的打包版支持 Win101803/ Win11 64 位另有兼容 Win7 甚至 XP 的旧版见官方文档 docs/zh/README.md。运行依赖打包版已内嵌 Python 运行时解压即用不需要你装 Python。如果你要在本仓库源码上直接跑需要本机有可用的 PythonPyQt5 等依赖入口是 src/LunaTranslator/main.py。原生组件HOOK 注入、本地 OCR 等由 src/NativeImpl/ 的 C 代码编译而来打包版已包含成品 dll/exe若要改原生层需要准备 CMake MSVC 编译环境构建脚本在 src/scripts/。网络在线翻译和 OCR 引擎都要走网络网络受限时建议在软件的代理设置里配代理详见 docs/zh/qa1.md 相关章节。 首次启动从源码到看到第一句游戏译文走哪条路线取决于你的身份普通用户直接下载打包版开发者可以直接跑源码。把软件放到可写目录打包版解压、源码 clone 后都同理避开C:\Program Files这类受保护路径。判断成功能正常打开该目录并读写里面能看到LunaTranslator.exe打包版或src/目录源码。启动程序。打包版双击LunaTranslator.exe个别游戏需要管理员权限 HOOK 时才用_admin版本源码路线则双击 src/run.bat它实际执行的就是python.exe -B LunaTranslator\main.py判断成功弹出 LunaTranslator 主窗口没有报错弹窗首次启动会自动检测语言并写入配置。接入一个已启动的游戏点工具栏的选取进程按钮选中游戏进程。判断成功游戏被注入随后弹出“选择文本窗口”。挑出文本行让游戏跑一段剧情选择文本窗口里会出现若干候选行选中与游戏文本吻合的那一行开始翻译。判断成功该行显示译文支持内嵌翻译的游戏还会多出“内嵌”按钮完整流程图解见 docs/zh/basicuse.md 同目录的 basicuse 页 docs/zh/basicuse.md。️ 常用配置参数调优最常改的 5 项设置你的配置存在软件目录下的userconfig文件夹里主配置是config.json仓库里的出厂默认值在 src/LunaTranslator/defaultconfig/config.json软件目录\userconfig\config.json ← 主配置 软件目录\userconfig\ocrsetting.json ← OCR 相关界面里改和在 JSON 里改是同一个东西改完重启软件生效。最常动的几项参数名默认值修改后效果谁需要改languageuse2跟随系统语言中文系统即zh切换软件界面语言需要日文/英文界面的人tgtlang4与界面语言相同设定翻译的目标语言想把游戏译成非中文的人fanyi.youdaodict.use/fanyi.google.use中文系统默认启 youdaodict其余启 google决定默认使用哪个翻译引擎想换翻译源、或同时挂多个引擎的人history.autosavefalse设为true后翻译结果自动进历史记录方便回看需要复盘翻译记录的人disappear_delay5调整文本消失前的等待秒数文本停留更久或更快觉得译文一闪而过 / 显示太拖沓的人翻译引擎的具体启用与排序在界面“翻译设置”里勾选更方便引擎清单可参考文档 docs/zh/guochandamoxing.md。️ 核心目录速览改代码前先认准这几个目录目录作用什么时候要看它src/LunaTranslator/Python 主程序main.py入口、translator/各翻译引擎、ocrengines/各 OCR 引擎、tts/语音合成、gui/界面排查某个功能行为、加一个新翻译引擎src/NativeImpl/C 原生层LunaHook/游戏与模拟器 HOOK、NativeUtils/本地 OCR 等HOOK 注入失败、模拟器适配问题软件目录\userconfig\运行时生成你改过的配置、缓存改设置前、换机迁移时迁移只带这个文件夹即可src/LunaTranslator/defaultconfig/出厂默认配置模板对照“我到底改了什么”docs/zh/中文用户手册HOOK 设置、OCR、TTS、模拟器等想深入某个功能的使用细节❓ 常见问题新手起步期 3 个高频坑Q1启动报“Missing embedded Python3”或 HOOK 时一直“正在等待DLL注入到游戏中……”多半是杀毒软件把用于注入的组件如LunaSubprocess32.exe、LunaHost32.dll当作威胁删掉了。把整个软件文件夹加入 Windows Defender 的排除项“病毒和威胁防护 → 排除项”或临时关杀软后重新解压一次。详见 docs/zh/README.md 的“常见错误”一节。Q2保存设置失败或启动报PermissionError软件被放进了C:\Program Files这类受保护路径配置和缓存写不进去。把整个软件目录移到有写权限的位置如D:\Luna再启动即可。Q3想升级或重装旧文件夹能直接删吗手动升级只需下载新版本、解压覆盖到原目录。千万不要删userconfig文件夹否则之前所有的设置会全部丢失。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 10分钟跑通LunaTranslator视觉小说翻译器：从零开始的环境准备、首次启动与常用配置指南
10分钟跑通LunaTranslator视觉小说翻译器从零开始的环境准备、首次启动与常用配置指南【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款 Windows 视觉小说Galgame翻译器用 HOOK 或 OCR 从游戏里提取文本交给各家翻译引擎出译文还能把译文写回游戏里直接读。这篇文章带你从零把克隆下来的代码跑起来并调好最常用的几项设置。 环境准备安装 LunaTranslator 前检查这几点操作系统这是 Windows 专用工具。正式发布的打包版支持 Win101803/ Win11 64 位另有兼容 Win7 甚至 XP 的旧版见官方文档 docs/zh/README.md。运行依赖打包版已内嵌 Python 运行时解压即用不需要你装 Python。如果你要在本仓库源码上直接跑需要本机有可用的 PythonPyQt5 等依赖入口是 src/LunaTranslator/main.py。原生组件HOOK 注入、本地 OCR 等由 src/NativeImpl/ 的 C 代码编译而来打包版已包含成品 dll/exe若要改原生层需要准备 CMake MSVC 编译环境构建脚本在 src/scripts/。网络在线翻译和 OCR 引擎都要走网络网络受限时建议在软件的代理设置里配代理详见 docs/zh/qa1.md 相关章节。 首次启动从源码到看到第一句游戏译文走哪条路线取决于你的身份普通用户直接下载打包版开发者可以直接跑源码。把软件放到可写目录打包版解压、源码 clone 后都同理避开C:\Program Files这类受保护路径。判断成功能正常打开该目录并读写里面能看到LunaTranslator.exe打包版或src/目录源码。启动程序。打包版双击LunaTranslator.exe个别游戏需要管理员权限 HOOK 时才用_admin版本源码路线则双击 src/run.bat它实际执行的就是python.exe -B LunaTranslator\main.py判断成功弹出 LunaTranslator 主窗口没有报错弹窗首次启动会自动检测语言并写入配置。接入一个已启动的游戏点工具栏的选取进程按钮选中游戏进程。判断成功游戏被注入随后弹出“选择文本窗口”。挑出文本行让游戏跑一段剧情选择文本窗口里会出现若干候选行选中与游戏文本吻合的那一行开始翻译。判断成功该行显示译文支持内嵌翻译的游戏还会多出“内嵌”按钮完整流程图解见 docs/zh/basicuse.md 同目录的 basicuse 页 docs/zh/basicuse.md。️ 常用配置参数调优最常改的 5 项设置你的配置存在软件目录下的userconfig文件夹里主配置是config.json仓库里的出厂默认值在 src/LunaTranslator/defaultconfig/config.json软件目录\userconfig\config.json ← 主配置 软件目录\userconfig\ocrsetting.json ← OCR 相关界面里改和在 JSON 里改是同一个东西改完重启软件生效。最常动的几项参数名默认值修改后效果谁需要改languageuse2跟随系统语言中文系统即zh切换软件界面语言需要日文/英文界面的人tgtlang4与界面语言相同设定翻译的目标语言想把游戏译成非中文的人fanyi.youdaodict.use/fanyi.google.use中文系统默认启 youdaodict其余启 google决定默认使用哪个翻译引擎想换翻译源、或同时挂多个引擎的人history.autosavefalse设为true后翻译结果自动进历史记录方便回看需要复盘翻译记录的人disappear_delay5调整文本消失前的等待秒数文本停留更久或更快觉得译文一闪而过 / 显示太拖沓的人翻译引擎的具体启用与排序在界面“翻译设置”里勾选更方便引擎清单可参考文档 docs/zh/guochandamoxing.md。️ 核心目录速览改代码前先认准这几个目录目录作用什么时候要看它src/LunaTranslator/Python 主程序main.py入口、translator/各翻译引擎、ocrengines/各 OCR 引擎、tts/语音合成、gui/界面排查某个功能行为、加一个新翻译引擎src/NativeImpl/C 原生层LunaHook/游戏与模拟器 HOOK、NativeUtils/本地 OCR 等HOOK 注入失败、模拟器适配问题软件目录\userconfig\运行时生成你改过的配置、缓存改设置前、换机迁移时迁移只带这个文件夹即可src/LunaTranslator/defaultconfig/出厂默认配置模板对照“我到底改了什么”docs/zh/中文用户手册HOOK 设置、OCR、TTS、模拟器等想深入某个功能的使用细节❓ 常见问题新手起步期 3 个高频坑Q1启动报“Missing embedded Python3”或 HOOK 时一直“正在等待DLL注入到游戏中……”多半是杀毒软件把用于注入的组件如LunaSubprocess32.exe、LunaHost32.dll当作威胁删掉了。把整个软件文件夹加入 Windows Defender 的排除项“病毒和威胁防护 → 排除项”或临时关杀软后重新解压一次。详见 docs/zh/README.md 的“常见错误”一节。Q2保存设置失败或启动报PermissionError软件被放进了C:\Program Files这类受保护路径配置和缓存写不进去。把整个软件目录移到有写权限的位置如D:\Luna再启动即可。Q3想升级或重装旧文件夹能直接删吗手动升级只需下载新版本、解压覆盖到原目录。千万不要删userconfig文件夹否则之前所有的设置会全部丢失。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考