企业官网建设流程全解析

LunaTranslator 上手指南：一条 Galgame 翻译工具三条通道怎么跑通

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

LunaTranslator 是一款面向视觉小说玩家的 Galgame 翻译工具，能通过 HOOK、OCR、剪贴板三种方式拿到游戏文本并翻出中文，实时弹在屏幕上。适合想日翻中玩视觉小说、又不想逐句查词典的玩家。

为什么值得装这套 Galgame 翻译工具

痛点很简单：日文视觉小说没有中文版时，要么等汉化组，要么一句一句拿在线词典翻，速度慢且机翻质量忽高忽低。LunaTranslator 的解法是把"拿文本"和"翻译"拆成两步：先靠 HOOK 文本捕获、OCR 屏幕识别或剪贴板复制拿到原文，再丢给翻译引擎输出中文。HOOK 可以理解为程序"截胡"游戏写入的文字，相当于在水管上开了个口子；OCR 就是截图加文字识别。三条通道只要有一条通了，后面的实时翻译就有得看。

从 clone 到第一次看到中文

环境要求：Windows 10 及以上。装之前先把杀毒软件关掉或加白名单——HOOK 组件容易被当成病毒，这是后面九成翻车的原因。

先拿源码，克隆命令如下：

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

进目录装依赖；如果网络不通，给同一条命令加个-i https://pypi.tuna.tsinghua.edu.cn/simple换镜像源即可，不用单独搞一节：

cd LunaTranslator pip install -r requirements.txt

装好后启动软件，试最快的路子：把游戏可执行文件拖进 LunaTranslator 窗口，软件会自动转区启动并 HOOK，随后弹出文本选择窗口。让游戏跑几秒，在候选行里挑一条和游戏台词对得上的，点"显示"，中文就弹出来了。文本输入输出的实现都在 src/LunaTranslator/textio/，逐步图文可以看 docs/zh/basicuse.md。

三条文本通道怎么选：HOOK、OCR 还是剪贴板

| 通道 | 适用场景 | 优点 | 限制 | | - | - | - | - | | HOOK | 绝大多数 PC 视觉小说，以及 NS/PSP/PSV/PS2 模拟器 | 文本完整稳定、不用框屏幕，部分游戏还能内嵌翻译 | 个别游戏需要管理员权限，得在候选行里挑对文本 | | OCR | HOOK 失效、或文本是图片的时候 | 任何屏幕内容都能读 | 识别有延迟，要框选识别区域，且选"持续识别"而不是"识别一次" | | 剪贴板 | 临时翻一句看到的东西 | 零配置 | 纯手动，撑不起实时字幕 |

一句话建议：优先 HOOK，HOOK 抓不到文本行就退 OCR，剪贴板留作备用。

OCR 与翻译引擎速查：三种需求三个答案

• 离线优先：选内置的 PP-OCRv5 离线 OCR 翻译路线，中日英开箱就能识别，不联网、不注册。OCR 引擎的完整清单在 src/LunaTranslator/ocrengines/。
• 在线优先：百度或腾讯 OCR 配对应翻译 API，识别快、稳定，日常党选它。
• 追求精度：在设置里下载 PP-OCRv5_server 这类高精度模型，准确率明显上去但变慢，有 GPU 就顺手开 GPU 推理。

最小可用配置示例如下，改你本地配置目录下的配置文件即可（仓库里的文件只读，别动）：

{ "ocr_engine": "local_ppocrv5", "translation_service": "baidu", "cache_size": 100 }

调优三板斧

💡 第一条，清缓存："最大缓存文本长度"默认 100 万，里面大半是垃圾文本，还会拖慢文本选择窗口，在 HOOK 设置里改成 1000 就行。

第二条，HOOK 不进去就换启动方式：部分游戏要管理员权限才能注入，用管理员版的 LunaTranslator_admin.exe 启动，而不是普通版。

第三条，识别差先查模型：在设置里确认 OCR 模型是否下载完整、语言包是否支持你要识别的文字，再怀疑引擎。

踩坑急救包：三个高频问题

🚑症状：启动报"找不到重要组件 / Missing embedded Python3"。原因：杀毒软件把注入组件删了（HOOK 靠 DLL 注入游戏，天然容易被误报）。修复：Windows Defender 的"排除项"里把 Luna 整个文件夹加进去，重新下载解压。

症状：卡在"正在等待 DLL 注入到游戏中……"。原因：同上，注入文件被拦。修复：加完排除项后重启软件再注入。

症状：PermissionError、设置存不下来。原因：软件放在了 C:\Program Files 这类受保护路径。修复：整个目录挪到普通路径（比如 D 盘）再运行。

装完之后还能玩什么

• 自定义词典：在"翻译优化"里加角色名、地名，译者就不会再自由发挥。
• 文本后处理：HOOK 出来重复字符、乱码时，"文本处理"里的过滤器能清掉，其中"去重复字符"用得最多。
• 语音合成：翻译接上 TTS，让角色台词直接读出来。

下次日文视觉小说出资源时，你只需要把游戏 exe 拖进窗口、挑好文本行——第一句中文跳出来的那一刻，就算真正上手了。

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