LunaTranslator 视觉小说实时翻译工具：从下载到三种翻译场景的完整使用指南

LunaTranslator 视觉小说实时翻译工具从下载到三种翻译场景的完整使用指南【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款视觉小说实时翻译工具它能把没有官方中文的游戏文本边玩边翻成中文。读完全文你能完成 LunaTranslator 下载选版、解压部署、三种取词场景HOOK 注入、OCR 读屏、拖拽启动的操作以及自动更新与常见报错处理。 先建立概念译文从哪来又怎么出去原文获取只有三条路也是后面三个操作场景的主线| 取词方式 | 原理一句话 | 适用情况 | | - | - | - | | HOOK 注入 | 把一段代码注入游戏进程直接读出游戏内存里的显示文字 | 游戏已启动追求低延迟、文本稳定 | | OCR 读屏 | 对屏幕指定区域做文字识别 | 游戏不方便注入、或想翻译截图/任意画面 | | 拖拽启动 | 把游戏 exe 拖进软件窗口自动启动并 HOOK | 游戏还没开想一步到位 |译文则由内置的数十种翻译引擎网页版、API、本地大模型等即时生成。️ 场景一游戏已在运行用 HOOK 模式实时翻译动作保持游戏窗口在前台运行打开 LunaTranslator进入 HOOK 模式点开选择游戏进程窗口。在列表里选中你的游戏进程点确认。软件完成注入后会自动弹出选择文本窗口工具栏按钮也能随时打开。让游戏推进一点剧情选择文本窗口里会出现若干候选文本行选中与游戏画面一致的那行翻译开始。如果该游戏支持内嵌翻译译文直接显示在游戏内候选行旁会出现内嵌按钮不支持时只有显示按钮译文在软件窗口里看。原理HOOK 引擎读的是游戏内存中的真实文本不依赖屏幕渲染所以识别稳定且几乎无延迟——这也是它需要注入 DLL、从而容易被杀软盯上的原因后文排障会讲。 场景二游戏还没开拖拽启动并自动 HOOK动作先启动 LunaTranslator 主程序。用鼠标把游戏的 exe 文件直接拖进软件窗口松开。游戏被自动启动并立即 HOOK随后弹出选择文本窗口后续操作与场景一完全相同。原理拖拽等于把启动游戏 注入 选文本三步合并成一步适合每次开玩都要重新挂钩的场景。 场景三不想注入用 OCR 模式读屏翻译动作在软件中切换到 OCR 模式。在屏幕上框选识别区域对话框、字幕条等固定位置效果最好。软件会持续识别该区域并自动翻译无需逐次点击。原理OCR 走的是截图 → 文字识别 → 翻译链路对画面要求比 HOOK 高但换来零注入、零杀软风险是排查 HOOK 问题时的替代手段。 LunaTranslator 下载与部署拿对包、放对目录第一步选版本。官方只维护三档构建选错档是后面所有问题的起点| 你的系统 | 拿哪个包 | 说明 | | - | - | - | | Windows 11 / Windows 10 1803 及以上 | 64 位主版本 | 功能最全、性能最好默认选它 | | Windows 7 等旧系统 | 旧系统兼容版32/64 位 | 性能更差、更不稳、杀软误报更多没有特殊需要不建议用 | | Windows XP / Vista | 仅 32 位 | 极限兼容同上警告 |源码里这套划分有对应src/LunaTranslator/gobject.py 按系统版本挑选 Python 运行时目录runtime3.13-64、runtime3.7-64、runtime3.4-32等并用sys_win10_release_supported对应 Win10 1803等标志决定加载哪套 DLL。第二步解压部署。下载的是免安装绿色包解压到你有完整读写权的普通目录即可数据盘自建文件夹、用户目录下都可以。⚠️唯一容易踩的雷不要把软件放进C:\Program Files这类受保护路径。程序运行时要持续往自身目录写配置和缓存而 Windows 的用户账户控制UAC系统对受保护目录的写权限管控默认不允许普通进程写入轻则报错重则直接起不来管理员权限也不保险。第三步认目录。解压后你会看到两个关键文件夹软件本体和程序自己生成的userconfig——它是全部用户配置的根目录在 src/LunaTranslator/gobject.py 中定义为thisuserconfig后面更新备份时还要用到。 解压后第一次启动3 个入口按用途选| 入口 | 什么时候用它 | | - | - | |LunaTranslator.exe| 默认入口日常启动都用它普通权限即可 | |LunaTranslator_admin.exe| 只有当游戏必须以管理员身份运行、HOOK 注入不了时才用它 | |LunaTranslator_debug.bat| 想看命令行窗口里的日志来排查问题时用 |原理src/LunaTranslator/main.py 的启动流程依次做——工作目录切换、命令行参数解析、组件完整性检查、Qt 环境准备、单实例检测最后才加载主界面。其中单实例检测用userconfig目录的绝对路径做哈希生成一个互斥量操作系统里同一时刻只允许一个进程持有的命名锁普通模式下重复启动会弹检测到软件已在运行是否再次启动而带--userconfig 路径参数指向不同目录启动的实例则互不干扰想要多套配置档案可以各建一个目录。 更新与备份覆盖升级别碰 userconfig软件默认自动更新机制在 src/LunaTranslator/myutils/updater.py 中分四个动作查询后台线程带archx86/x64和targetwinxp/win7/win10参数请求/version接口拿回最新版本号、下载地址和 sha256 值。比对读出本地 exe 的版本号只有远端更新且配置里autoupdate为开默认开才继续。下载校验流式下载更新包并显示进度完成后按 sha256文件的数字指纹用于确认文件没传坏核一遍。退出后替换更新包先解压到cache/update目录界面提示准备完毕将在退出后更新程序完全退出后由LunaSubProcess拉起更新器做文件替换不会和你抢正在运行的文件。网络不通、校验失败时界面会提示自动更新失败请手动更新。手动更新很简单下载新版本直接解压覆盖到原目录配置原样保留。⚠️如果你打算整个删掉重下千万别顺手删userconfig文件夹——删了等于所有设置清零。想多开几套配置用--userconfig各指一个目录即可。️ LunaTranslator 排障按报错出现的时机处理启动阶段的高频错误基本绕不开两个根源杀软删了组件、目录没写权限。软件启动时会逐项点名检查关键文件src/LunaTranslator/myutils/config.py 的checkintegrity()运行库NativeUtils.dll、CVUtils.dll、onnxruntime.dll、DirectML.dll、bass系列、libcurl.dll、HOOK 相关LunaHost32/64.dll、LunaHook32/64.dll、LunaTmpFontLoader.dll、子进程LunaSubProcess32/64.exe、Magpie.Core.exe任一缺失就报找不到重要组件。刚启动就报找不到重要组件或 Missing embedded Python3多半是杀软动了手HOOK 需要把LunaSubProcess32.exe、LunaHost32.dll这类注入型文件送进游戏进程天然容易被判成病毒连内嵌的 Python3 运行时目录都可能被整目录清掉。处理办法能关杀软就先关关不掉的如 Windows Defender走排除项——病毒和威胁防护→管理设置→排除项→添加排除范围→文件夹选中 Luna 所在目录——然后重新下载并解压让被清掉的组件回来。担心加白名单不安全发布包由 CI 流水线自动构建除非构建服务器被攻陷否则包内不可能混进病毒可以放心添加信任。如果报的是Error/PermissionError而不是缺组件那基本可以确定是踩了部署一节的目录雷软件待在C:\Program Files等受保护路径里写不进配置与缓存把它整体挪到普通可写目录再启动即可。选完进程后卡在正在等待 DLL 注入到游戏中……本质是同一条的延续被隔离的注入 DLL如LunaHost64.dll没恢复注入自然完不成。处理办法同上加信任 重新下载解压把 HOOK 组件补全。运行几小时后HOOK 选进程才报 Error/FileNotFoundError这是杀软延迟清理的典型剧本启动时组件还在几小时后的后台扫描才把某些必要文件删掉等到真要用到那个 DLL 时才暴露。处理办法依然是提前加信任列表并重新下载解压让组件全程保持完整。 文档与源码入口文档类下载、启动更新与常见错误总表文末附 ChangeLogdocs/zh/README.mdHOOK / OCR / 拖拽启动的基本用法docs/zh/basicuse.md源码类启动入口、命令行参数与单实例检测src/LunaTranslator/main.py组件完整性检查逻辑src/LunaTranslator/myutils/config.py自动更新机制src/LunaTranslator/myutils/updater.py配置目录与系统版本判定src/LunaTranslator/gobject.py【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考