企业官网建设流程全解析

LunaTranslator 视觉小说翻译：从克隆仓库到跑通第一次 HOOK 翻译

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

打开一款日语文字冒险游戏，对话框里全是看不懂的假名，逐句截图再丢给网页翻译既打断剧情又跟不上节奏。LunaTranslator 就是为这个场景做的开源视觉小说翻译工具：它捕获游戏运行时显示或渲染中的文本，实时翻译成中文，在悬浮窗口里和原作对照显示，也能把译文直接画回游戏画面。

最短体验路径

这个软件面向 Windows（官方打包版支持 Win10/Win11 64 位，老系统有兼容版），所以"跑起来"分两种情况。

直接用打包版（推荐）：进入 docs/zh/ 找到下载入口，把压缩包解压到一个普通目录——不要放C:\Program Files这类受保护路径，否则配置文件可能写不进去。双击LunaTranslator.exe启动，界面起来即算跑通；需要 HOOK 受保护的游戏时，改用同目录的LunaTranslator_admin.exe（管理员权限启动）即可。

从源码运行：如果你手上是这份源码仓库，先确认本机装了 Python 3.9 以上。进入仓库的src目录，安装 PyQt5 等基础依赖后，双击 src/run.bat——它执行的是一条python -B LunaTranslator\main.py，会拉起主界面并自动生成默认配置。HOOK 注入依赖 Windows 下的原生组件，Linux/macOS 上源码版只能看到界面，完整功能需要 Windows。

git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator

src> run.bat

跟着一遍：从打开游戏到看到第一句译文

以 HOOK 模式翻译一款已启动的日文游戏为例，完整走一遍。

启动游戏并让角色开始说话，然后回到 LunaTranslator：把游戏的可执行文件图标直接拖进软件主窗口，松开后游戏会被自动启动（或选中已在运行的进程），软件把 DLL 注入游戏，随后弹出"选择文本"窗口。这一步的意义是建立与游戏的通道——不选中文本源，后面就没有可翻译的内容。

让游戏对话框多播几句话。选择文本窗口里会逐行列出候选文本，其中和游戏对话框里重复出现的那些行，就是游戏正在渲染的文本；在对应行的"显示"列点一下确认。若游戏支持内嵌翻译，该行还会出现"内嵌"按钮，点它译文会直接画进游戏画面而不是悬浮窗。

确认后，主界面旁的悬浮窗开始滚动输出译文，点游戏继续对话，译文跟着刷新。某条翻得不理想时，可以右键该条译文，从已启用的多个引擎里换一个结果。走到这里，翻译链路就算完全通了。

如果游戏不支持 HOOK（部分 Unity 作品常见），切到 OCR 模式：用框选工具圈住游戏内的文本区域，软件会定时截图、识别该区域文字再翻译。识别由 OCR 引擎完成，翻译仍走上面选好的引擎，两者互不干扰。

弄明白两个核心机制

文本捕获：HOOK 优先，OCR 兜底。HOOK 的原理是把 DLL 注入游戏进程，从内存里读取渲染前的字符串，稳定且不受字体、特效影响，代价是游戏位数（32/64 位）要和软件支持匹配；OCR 则不侵入游戏，靠定时截图加图像识别，通用但会受画面清晰度影响。两条捕获链路分别落在 src/LunaTranslator/translator/ 上游的文本源与 src/LunaTranslator/ocrengines/（OCR 引擎集合）。

拿到文本之后怎么翻。你选定的引擎先出初译，再经过翻译优化层：名词词典（src/LunaTranslator/transoptimi/noundict.py）让关键名词保持固定译名，错误修正表把常见错译自动替换掉。所以同一角色名不会在不同章节出现两种写法。引擎开关和翻译选项都在主界面"翻译"设置页调整，默认值放在 src/LunaTranslator/defaultconfig/。

不工作时怎么自检

如果卡在"正在等待 DLL 注入到游戏中……"，多半是杀毒软件拦了注入用的 LunaSubprocess/LunaHost 组件。验证办法：在系统的病毒与威胁防护里把软件整个目录加入排除项，重新解压一份再试——官方文档把这一项列为最常见故障。

运行一段时间后弹"找不到重要组件"或 FileNotFoundError，通常是杀毒软件在软件启动后才静默删掉了必要文件，同样加排除项并重新解压，注意别动userconfig文件夹，里面存着你的全部配置。

弹出 PermissionError，基本是软件被放到了C:\Program Files这类受保护路径，把整个目录搬到磁盘根目录或用户目录下的普通文件夹即可。

HOOK 与 OCR 的逐步操作细节、内嵌翻译开关，都在 docs/zh/ 的"基本用法"一章；官方也提供了演示视频和 QQ 群作为提问入口。

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