企业官网建设流程全解析

LunaTranslator完整指南：Galgame实时翻译神器，HOOK、OCR、剪贴板3种模式快速上手教程

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

如果你玩的日文Galgame长期等不到官方汉化，LunaTranslator能帮你在游戏运行的那一刻就把对话实时翻译出来。这是一款免费开源的视觉小说翻译器，核心是HOOK内存提取、内嵌翻译与OCR图像识别三种文本捕获方式，再叠加从在线接口到大语言模型的翻译引擎，让你不必等汉化组就能直接读原版。下面按「先判断该用哪种方式 → 一步步连上游戏 → 按场景调配置 → 卡住时怎么排查 → 进阶玩法」的顺序带你真正跑起来。

一、先判断你的游戏属于哪一类，再决定用哪种文本捕获方式

别急着点按钮，先花一分钟判断你的游戏「文字怎么被读出来」，选错方式后面全是弯路。LunaTranslator把「读文字」这件事拆成四种路子，先用大白话说清楚它们各管什么：

• HOOK：像一个藏在游戏里的探针，直接从小游戏内存里把台词「捞」出来，延迟几乎为零，这是它的招牌能力。
• 内嵌翻译：在HOOK能捞到文字的基础上，再把译文写回游戏画面，读起来像原生就带翻译。
• OCR：把游戏窗口当成一张图来截图、识别文字，HOOK搞不定时它是兜底方案。
• 剪贴板：游戏本身支持复制文字时，直接监听剪贴板，最省事但受游戏限制。

判断顺序建议这样走：

1. 先默认用HOOK：绝大多数常见和冷门视觉小说都能直接读到文字。
2. HOOK能读到后，再问一句「能不能写回画面」——能就走内嵌翻译，追求沉浸感；不能就保持外挂窗口显示，照样能用。
3. HOOK完全读不到（有反调试或特殊引擎），切换OCR，框住对话区持续识别。
4. 游戏支持复制文本，直接用剪贴板模式最轻。

对照表收尾，对号入座即可：

二、从解压到挂钩游戏的连续操作链

选型定好后，按下面这条链走一遍就能连上，每一步都踩着上一步的尾巴。

1. 下载并放到「不会坏」的目录

LunaTranslator提供开箱即用的便携版，Windows 11 / 10（1803 及以上）用 64 位即可，旧系统（Win7、WinXP/Vista）有对应兼容版。下载后解压到任意目录就能用，但别放进C:\Program Files这类受保护路径——否则即便给了管理员权限也可能存不了配置、甚至跑不起来。建议放在非系统盘，比如D:\Games\LunaTranslator。

2. 三个启动入口，权限别选错

解压后你会看到几个可执行文件，按需挑：

• LunaTranslator.exe：普通模式启动，日常就用它。
• LunaTranslator_admin.exe：以管理员权限启动。只有当某个游戏必须以管理员运行、否则 HOOK 注入失败时，才切到它。
• LunaTranslator_debug.bat：会弹出命令行窗口，排查报错时用。

软件默认自动更新；想手动更新，直接下新版解压覆盖到原目录即可。如果你要卸载重装，一定别删userconfig文件夹，否则所有设置都会丢。

3. 把游戏接进来：拖拽、选进程、开OCR三种接入

最顺滑的方式是拖拽启动：启动软件后，把游戏程序图标直接拖进软件窗口松手，游戏会被自动添加、自动「转区」启动并立即 HOOK，随后弹出选择文本窗口。

如果游戏已经开着，就走 HOOK 模式：打开「选择游戏进程」窗口，从进程列表里选中你的游戏，点「确认」，软件会把探针注入游戏，再弹出选择文本窗口。让游戏跑一下、显示几段台词，窗口里会列出若干候选文本行，选中符合游戏实际台词的那一行，翻译就开始了。

OCR 接入则用于 HOOK 无效的游戏：切到 OCR 模式后框选识别区域即可自动持续识别。这里有个高频坑——界面上有两个图标很像的按钮，后一个只用于「临时识别一次」，持续自动识别要用前一个，选错就不会一直翻。

三、按游戏类型选配置组合的实战

选对捕获方式只是第一步，不同游戏还得配不同的参数组合。

现代视觉小说：开内嵌翻译，顺手修字体与字符集

如果你的游戏支持内嵌（选择文本窗口里会出现「内嵌」这一列按钮，没有就说明不支持），直接激活内嵌就能在画面里看到翻译。内嵌和显示可以同时开：都开就是「画面里嵌入翻译 + 软件窗口里再多展示译文」，只开内嵌则画面里只有翻译。内嵌不是万能的，小概率会让游戏崩溃，先拿重要存档试。

内嵌后最常遇到的是乱码，基本就两类原因：

• 缺字体（多见于英文游戏要显示中文）：激活「修改游戏字体」，选一个能显示中文的字体即可。
• 字符集（多见于古早日式游戏用 shift-jis 处理）：可尝试「将汉字转换成繁体/日式汉字」，减少乱码。较新的 KiriKiri、Ren'Py、TyranoScript、RPGMaker 等引擎一般用 UTF-8/UTF-16，乱码多半是字体而非字符集问题。

另外两个实用项：翻译等待时间用来兜底——内嵌的原理是「先停住游戏、把文字送出去翻、翻完再放行显示」，翻译引擎慢就会卡，给它设个上限可避免长时间卡死；限制每行字数则防止长句冲出文本框被裁掉。

模拟器游戏：NS / PSP / PSV / PS2 优先 HOOK 模拟器

对 NS、PSP、PSV、PS2 上的大量游戏，LunaTranslator 支持直接 HOOK 模拟器、读取其中的游戏文本（底层用 JIT HOOK 挂到 Unity、Yuzu、PPSSPP、Vita3K、RPCS3 等运行时的绘制函数上）。流程和普通 HOOK 一致：接进游戏 → 选择文本窗口选中正确文本行。读不到的模拟器再回退到 OCR。支持的平台与模拟器清单见 docs/zh/emugames.md。

大模型与离线翻译：从在线接口一路配到本地模型

翻译引擎这块选择很多。想要质量优先，可以在「大模型通用接口」里填好API 接口地址 + API Key（多个 Key 会自动轮询），点 model 旁的刷新就能拉模型列表；开「附带上下文个数」会带上若干条历史原文/译文喂给模型，连贯性更好，设 0 即关闭。想对比不同效果，可以点上方「+」复制一份接口、分别设置后一起跑。

不想依赖云端，就走离线翻译模型：部署好后同样用「大模型通用接口」调用；像 SakuraLLM、Hy-MT2 这类需要专用 prompt 的模型，还有专门接口帮你套好格式。本地推理可以用 llama.cpp 这类运行时，离线跑起来既省流量也保护隐私，相关源码在 src/LunaTranslator/translator/ 目录下，接口细节见 docs/zh/guochandamoxing.md。

四、翻译捕获失败的排查清单：按症状逐项定位

卡住了别盲目重装，对着下面的「症状 → 排查 → 解决」走，大多数坑都落在前两条。

• 症状：启动报「找不到重要组件 / Missing embedded Python3」，或一直卡在「正在等待 DLL 注入」

  • 排查：几乎必然是杀毒软件把 HOOK 用的注入组件（如 LunaSubprocess / LunaHost）当病毒删了或拦了。
  • 解决：把整个 Luna 文件夹加入杀软信任（Defender 走「病毒和威胁防护 → 排除项 → 添加排除项 → 文件夹」），然后重新下载解压。这是实现 HOOK 的必需组件，可放心信任。

• 症状：HOOK 后选择文本窗口里根本没有正确文本

  • 排查：先确认权限——游戏和软件是否都以管理员运行；再看是否游戏本身加载太晚。
  • 解决：改用LunaTranslator_admin.exe启动；仍不行就在 HOOK 设置里勾选「Win32 通用钩子」（默认不注入，注入多了会变慢，抓到即可关），或开启「延迟注入」等游戏加载完 DLL 再挂钩；特殊引擎可录入「特殊码」。详见 docs/zh/hooksettings.md。

• 症状：文本一两个字地蹦，或一行顶掉上一行，最后只留最后一行

  • 排查：这是「刷新延迟」太低，游戏显示文字慢、还没显示完就抢先刷出来了。
  • 解决：调高刷新延迟，或把游戏内文字显示速度调到最快，让整句一次到位。

• 症状：文本反复不停刷屏、查看历史时卡顿

  • 排查：缓冲区被无用文本填满。
  • 解决：适当调低「最大缓存文本长度」（默认 1000000，实际调到 1000 就够）；「最大允许输出文本长度」调小还能过滤 Skip / 翻历史时的一次性文本爆发。

• 症状：内嵌后游戏里全是乱码 / 方框

  • 排查：先判断是「字体缺失」还是「字符集不匹配」。
  • 解决：前者开「修改游戏字体」；后者（老日式游戏）开「将汉字转换成繁体/日式汉字」，或「清除游戏内显示的文字」把原文清掉、用软件窗口覆盖原文本位置来伪装成内嵌。

完整启动类错误对照见 docs/zh/README.md。

五、从新手到定制者的进阶路线

• 第 1 阶段 · 打牢基础（1–2 周）：把 HOOK / OCR / 剪贴板三种接入用熟，能自如切换常用翻译引擎，遇到上面第四节列的症状会自己定位。
• 第 2 阶段 · 个性化（1–2 个月）：配置专有名词词典统一角色名/术语，用正则写文本过滤与翻译结果修正（比如给内嵌译文前补个换行），再为常玩的游戏做专用 HOOK 设置（在游戏管理里取消「跟随默认」单独配）。
• 第 3 阶段 · 深度定制（3 个月+）：读源码、改行为或加插件，参与社区并分享你的游戏专属配置。想动手可以从克隆源码开始：

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

翻译引擎、OCR 引擎、TTS 等模块在 src/LunaTranslator/ 下按目录分好，改起来边界清晰。

六、官方文档与配置资源导航：遇到问题去哪找

• 基本用法（三种模式操作）：docs/zh/basicuse.md
• HOOK 设置详解（刷新延迟、缓冲区、特殊码）：docs/zh/hooksettings.md
• 内嵌翻译与字体/字符集修正：docs/zh/embedtranslate.md
• 模拟器游戏支持清单：docs/zh/emugames.md
• OCR 自动执行参数：docs/zh/ocrparam.md
• 翻译接口与大模型：docs/zh/guochandamoxing.md
• 默认配置参考：src/LunaTranslator/defaultconfig/
• 你的个性化设置：userconfig/（重装/更新时务必保留）

现在你可以打开游戏，先用 HOOK 试着选一条文本行跑通翻译；读不到就切 OCR 框住对话区。挑一款你最想玩的原版 Galgame，照着第二节的操作链走一遍——翻译窗口亮起来的那一刻，语言墙就翻过去了。

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