
LunaTranslator 新手教程3 步跑起视觉小说翻译器从安装到配置一次讲清【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款 Windows 平台的游戏文本翻译器核心功能是通过 HOOK 注入、OCR 识别、剪贴板三种方式提取视觉小说Galgame中的文本并自动翻译。它几乎适配所有常见与冷门的游戏引擎还支持将翻译结果直接内嵌到游戏画面中。本文带你完成安装启动、关键配置和日常使用。项目速览它能帮你做什么HOOK 提取文本注入游戏进程直接读取内存文本几乎不需要你动手选区域是最省心的方式OCR 兜底内置离线 OCR 模型也支持多种在线引擎能识别任意画面上的文字翻译引擎丰富内置大量在线与离线翻译接口设置界面即可切换无需改代码完整功能说明可以参考 官方中文文档里面有模拟器支持列表、语音合成、Anki 同步等进阶内容。跑起来的最短路径3 步完成首次启动第 1 步下载并解压。官方提供 Windows 10/11 64 位安装包解压到任意目录即可无需安装。如果你是开发者想从源码运行可克隆仓库后执行 run.bat内部调用python.exe -B LunaTranslator\main.py位于 src/LunaTranslator/git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator第 2 步双击LunaTranslator.exe启动。程序有三个入口LunaTranslator.exe普通启动、LunaTranslator_admin.exe管理员启动部分游戏需要、LunaTranslator_debug.bat带命令行窗口启动。第 3 步把游戏接入翻译。有两种方式对已启动的游戏用工具栏的选择游戏进程选中目标进程确认注入快捷方式直接把游戏 exe 拖拽到 Luna 窗口里它会自动启动游戏并 HOOK注入成功后会弹出选择文本窗口。让游戏跑几句对话列表中会出现候选文本行点击你认为正确的那一行翻译开始工作。注意不要把软件放在C:\Program Files这类受保护路径下否则配置和缓存可能无法保存甚至无法运行。关键配置详解改哪几项最有效所有用户设置存放在安装目录下的userconfig文件夹里界面里改的每一项最终都会落到这里。默认配置模板在 src/LunaTranslator/defaultconfig/了解结构有助于你理解各配置项的作用。如何调整 HOOK 刷新延迟先说结论当每次只提取出一两个字或文本提取得很慢时第一个要调的就是刷新延迟详见 HOOK 设置文档。| 现象 | 处理方式 | | - | - | | 每次只提取一两个字 / 一行顶掉上一行 | 游戏文本显示太慢调高刷新延迟或把游戏文本速度调到最快 | | 文本正确但刷新慢 |适当调低刷新延迟注意别又变成逐字提取 | | 文本反复不停刷新、刷屏 | 调低最大缓冲区长度或最大允许输出文本长度过滤突发文本 |如何调整 OCR 识别参数OCR 模式下自动识别的灵敏度和频率由几个阈值控制详见 OCR 参数文档。| 参数 | 作用 | 建议 | | - | - | - | | 执行方式 | 决定何时触发一次识别 | 看不懂其他参数时直接选周期执行最简单 | | 图像稳定性阈值 | 判断画面是否稳定 | 游戏完全静态可设为 0有动态背景则适当调高 | | 图像一致性阈值 | 判断文本是否变化、要不要重新识别 | 识别太快就调高太迟钝就调低 | | 文本相似度阈值 | 过滤 OCR 结果的微小抖动 | 频繁重复翻译时适当调高 |常用操作与定制换语言、绑快捷键、切翻译引擎如何修改界面语言界面语言在设置界面中切换。程序内置了 20 多种语言资源文件位于 src/files/lang/包括中文、英文、日文、韩文、俄文等切换后界面文案随之更新。如何绑定常用快捷键在设置 → 快捷键里先打开是否使用快捷键总开关再为单个功能分配按键。高频项值得绑定完整列表见 快捷键文档自动模式暂停/继续读取文本暂停游戏对话时很有用显示/隐藏翻译翻译总开关关了就不再翻译取词翻译翻译鼠标当前选中的文字如何接入其他翻译引擎翻译引擎在设置界面直接选择即可无需编辑文件。各引擎的参数如 API 地址、端口定义在 translatorsetting.json例如 Chrome 系翻译会用到chromepath浏览器路径和debugport默认 9222。界面里选好引擎后按提示填写即可配置会自动写入userconfig。常见问题3 个最容易踩的坑找不到重要组件 / Missing embedded Python3这是杀毒软件误删了内嵌的 Python 和注入组件HOOK 机制本身容易被误报为病毒。把 Luna 所在文件夹加入杀毒软件排除项Windows Defender病毒和威胁防护 → 排除项 → 添加文件夹然后重新下载解压。正在等待 DLL 注入到游戏中也是同一原因。配置文件丢失或无法保存程序放在C:\Program Files等受保护目录会导致PermissionError换到普通目录即可。重新下载时误删设置删目录重装前务必保留userconfig文件夹里面是你全部的自定义设置删了设置就清零了。按以上步骤操作你应该已经可以让 LunaTranslator 稳定翻译一款游戏了。遇到特定游戏的适配问题官方文档 中有更细的模拟器支持与 FAQ 章节可以继续参考。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考