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

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

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

LunaTranslator 是一款视觉小说实时翻译工具，它能把没有官方中文的游戏文本边玩边翻成中文。读完全文，你能完成 LunaTranslator 下载选版、解压部署、三种取词场景（HOOK 注入、OCR 读屏、拖拽启动）的操作，以及自动更新与常见报错处理。

🧩 先建立概念：译文从哪来，又怎么出去

原文获取只有三条路，也是后面三个操作场景的主线：

译文则由内置的数十种翻译引擎（网页版、API、本地大模型等）即时生成。

🖥️ 场景一：游戏已在运行，用 HOOK 模式实时翻译

动作

保持游戏窗口在前台运行，打开 LunaTranslator，进入 HOOK 模式，点开"选择游戏进程"窗口。
在列表里选中你的游戏进程，点确认。软件完成注入后会自动弹出"选择文本"窗口（工具栏按钮也能随时打开）。
让游戏推进一点剧情，选择文本窗口里会出现若干候选文本行，选中与游戏画面一致的那行，翻译开始。
如果该游戏支持内嵌翻译（译文直接显示在游戏内），候选行旁会出现"内嵌"按钮；不支持时只有"显示"按钮，译文在软件窗口里看。

原理：HOOK 引擎读的是游戏内存中的真实文本，不依赖屏幕渲染，所以识别稳定且几乎无延迟——这也是它需要注入 DLL、从而容易被杀软盯上的原因（后文排障会讲）。

🎮 场景二：游戏还没开，拖拽启动并自动 HOOK

动作

先启动 LunaTranslator 主程序。
用鼠标把游戏的 exe 文件直接拖进软件窗口，松开。
游戏被自动启动并立即 HOOK，随后弹出"选择文本"窗口，后续操作与场景一完全相同。

原理：拖拽等于把"启动游戏 + 注入 + 选文本"三步合并成一步，适合每次开玩都要重新挂钩的场景。

📷 场景三：不想注入，用 OCR 模式读屏翻译

动作

在软件中切换到 OCR 模式。
在屏幕上框选识别区域（对话框、字幕条等固定位置效果最好）。
软件会持续识别该区域并自动翻译，无需逐次点击。

原理：OCR 走的是"截图 → 文字识别 → 翻译"链路，对画面要求比 HOOK 高，但换来零注入、零杀软风险，是排查 HOOK 问题时的替代手段。

📦 LunaTranslator 下载与部署：拿对包、放对目录

第一步：选版本。官方只维护三档构建，选错档是后面所有问题的起点：

源码里这套划分有对应：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 个入口按用途选

原理：src/LunaTranslator/main.py 的启动流程依次做——工作目录切换、命令行参数解析、组件完整性检查、Qt 环境准备、单实例检测，最后才加载主界面。其中单实例检测用userconfig目录的绝对路径做哈希生成一个互斥量（操作系统里"同一时刻只允许一个进程持有"的命名锁）：普通模式下重复启动会弹"检测到软件已在运行，是否再次启动？"；而带--userconfig <路径>参数指向不同目录启动的实例则互不干扰，想要多套配置档案可以各建一个目录。

🔄 更新与备份：覆盖升级，别碰 userconfig

软件默认自动更新，机制在 src/LunaTranslator/myutils/updater.py 中，分四个动作：

查询：后台线程带arch（x86/x64）和target（winxp/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 时才暴露。处理办法依然是提前加信任列表并重新下载解压，让组件全程保持完整。

📚 文档与源码入口

文档类

下载、启动更新与常见错误总表（文末附 ChangeLog）：docs/zh/README.md
HOOK / 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），仅供参考

企业官网建设流程全解析