企业官网建设流程全解析

LunaTranslator 完整入门指南：免费开源游戏实时翻译器如何跑通第一次翻译

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

你是否因为读不懂日文游戏的剧情，而在一堆字幕前逐字硬猜，最后干脆弃了游戏？或者试过把游戏截图丢给在线翻译，却发现一句对话要来回复制四五次，沉浸感全无？LunaTranslator 是一款完全免费开源的 Windows 游戏实时翻译器，它能直接盯住游戏画面，把台词自动识别出来并实时翻译成中文。读完本文，你不需要任何开发背景，就能在自己的电脑上跑通第一次游戏翻译，并学会为不同类型的游戏选对配置。

两种核心机制白话拆解：HOOK 与 OCR 各干什么

LunaTranslator 能"听懂"游戏，靠的是两套取文本的本事。理解了这两套机制，后面所有设置你都不会懵。

HOOK：给游戏内存装一个"听诊器"

先说大白话：HOOK 就是把一小段程序贴进游戏进程里，让它在游戏"说话"（往屏幕上写文本）的同时，顺手把原话抄一份给翻译器。

它怎么工作？游戏要在屏幕上显示任何文字，都必须先把文本写进内存、再交给画面系统渲染。LunaTranslator 把几个小文件（如 LunaHost32.dll）注入游戏后，就守在"文本经过"的关键路口上，游戏每吐一句对话，它立刻截获，再转交翻译引擎。

这种方式的优点是几乎零延迟、拿到的是原始干净文本，不受字体和画面特效影响；代价是不同游戏、不同引擎的"文本路口"位置不一样，所以它挑游戏，也容易被杀毒软件盯上（后文讲怎么解除误会）。

OCR：替你的眼睛认字

如果 HOOK 接不住某个游戏（老引擎、模拟器、自研引擎都可能发生），就上 OCR。大白话：软件周期性截图，把你圈定的区域送去"认字"，认出文字再翻译。

它怎么工作？你在屏幕上框出对话框区域，LunaTranslator 按设定频率截图、比对画面是否变化、只对变化的区域调用 OCR 引擎（本地或在线），识别出的文字进入翻译流程。还可以开启"原地显示翻译"，让译文直接覆盖在原文位置上，像游戏原生就带翻译一样。

OCR 的好处是几乎不挑游戏，代价是比 HOOK 慢一拍，且识别准确率受字体、画面清晰度影响。

一句话记住选择逻辑：先用 HOOK，不行再 OCR，都嫌麻烦就用剪贴板。

5 分钟跑通首次翻译：从下载到看到译文

第一步：拿到软件并启动

从官方仓库获取最新版本，只需一条命令：

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

拿到后解压到任意普通目录，只有一条铁律：别放在 C:\Program Files 这类受保护路径下，否则连管理员权限都可能无法保存配置、甚至无法运行。

启动时认准两个文件：

• LunaTranslator.exe：普通模式启动，绝大多数游戏用它就够
• LunaTranslator_admin.exe：管理员权限启动，仅当游戏要求管理员运行时才用

软件默认会在线自动更新；手动更新只需下载新版本解压覆盖，但千万不要删掉 userconfig 文件夹，那是你所有配置和术语表的家。

第二步：三种文本获取模式怎么选

这是新手最容易卡住的一步。三种模式按"优先尝试"排序：

1. HOOK 模式（首选）：游戏先运行起来，在软件里打开"选择游戏进程"窗口，点选你的游戏进程，确认后软件会注入并弹出"选择文本窗口"。让游戏随便跑几句对话，候选文本行就会出现——挑出和屏幕上台词对得上的那一行，翻译立刻开始。如果游戏支持内嵌翻译，还会多一个"内嵌"按钮，可以把译文直接写进游戏画面里。
   • 偷懒技巧：启动游戏前，直接把游戏的 exe 拖进 LunaTranslator 窗口，它会替你自动转区启动并 HOOK，省去手动选进程。
2. OCR 模式（通用兜底）：切到 OCR 模式，用框选按钮圈住游戏里的对话框区域，软件就开始自动识别并翻译。注意别点错按钮——图标相近的另一个按钮是"只识别一次"，不是持续识别。
3. 剪贴板模式（最省事）：如果你的游戏支持复制文字，开启剪贴板模式后，复制即翻译，适合文字类应用和少数可复制文本的游戏。

第三步：接好一个翻译引擎

在翻译设置里挑一个你信任的服务即可。两个方向供你选：

• 在线服务：百度、谷歌、微软、DeepL 等主流引擎即开即用，响应快、质量好，但要联网。
• 本地大模型：软件内置大模型翻译接口，也可以加载本地推理的开源模型（如基于 LLaMA.cpp 的模型），适合在意隐私或想要"离线也能玩"的场景，填好模型路径即可切换。

新手建议：先用免费的在线引擎跑通全流程，之后再按需换本地模型。

第四步：调顺显示，把窗口藏进游戏体验里

翻译默认浮在屏幕上，几个显示设置值得花一分钟调一下：

• 字体大小与颜色：在显示设置里按你的屏幕分辨率调整，避免遮挡画面
• 位置与透明度：把窗口挪到不挡关键画面的角落，必要时降低不透明度
• 快捷键：在快捷按键设置里激活后，给"显示/隐藏翻译""自动模式暂停/继续"各绑一个键，随时一键静音译文
• 工具栏默认在鼠标移出时自动隐藏；想让它常驻，激活"锁定工具栏"即可

进阶与调优：不同游戏给不同的配方

现代视觉小说（Unity、Ren'Py、RPG Maker 等）

以 HOOK 为主力：选对文本行后，翻译基本零配置就能跑。若出现"每次只蹦出一两个字"或"一行把上一行顶掉"，说明游戏的字打得太慢而 HOOK 刷新太快——提高 HOOK 设置里的刷新延迟，或直接把游戏内文字速度调到最快。反过来若文本提取又慢又全，可适当降低刷新延迟。支持内嵌翻译的游戏建议开启"内嵌"，并维护一份专有名词表，让角色名、技能名前后统一。

老 RPG、模拟器或接不住 HOOK 的游戏

转 OCR 模式，三个动作：

1. 框准文本区域，确保整个对话框都在框内
2. 自动化方式从四种里选最稳的：看不懂其他参数就用周期执行；游戏有动态背景或 Live2D 时，用分析图像更新并适当调高图像稳定性阈值；按键推进的剧情则用鼠标键盘触发+等待稳定
3. 保留文本相似度阈值，它能过滤 OCR 结果里那一两个字位的抖动，避免同一句话反复重译

语言学习与内容校对场景

这类用法不吃 HOOK，吃的是软件的"工具属性"：

• 查词与注音：内置词典支持即点即查，日语还能做分词和假名注音（需在辞书设置里下载 unidic 词典，一键完成）
• Anki 同步：查到生词后可直接送入 Anki 记忆卡片，把"读游戏"变成"背单词"
• TTS 朗读：接入 TTS 引擎后可听译文或原文发音，辅助语感

性能、质量、体验三类优化手法

• 性能：HOOK 模式下若文本反复刷新刷屏，调低"最大缓冲区长度"；历史文本太多导致查看卡顿，把"最大缓存文本长度"降到 1000 即可（默认 1000000 纯属浪费）
• 质量：为大模型翻译开启"附带上下文"（带上几句历史原文与译文），长对话连贯性明显提升；OCR 识别抖动大时优先用带相似度阈值的模式
• 体验：多配置文件功能可为不同游戏存独立方案（术语表、HOOK 参数、OCR 区域各存一份），切换游戏不用来回改；游戏管理里还能为单个游戏建立专用 HOOK 设置，覆盖默认值

避坑与延伸：先救活，再玩出花样

杀毒软件误报：最常见也最容易解决

因为 HOOK 需要往游戏里注入文件，LunaTranslator 的几个组件（LunaSubprocess32.exe、LunaHost32.dll 等）天然长得像"可疑注入器"，常被杀毒软件顺手干掉。典型症状：

• 启动提示"Missing embedded Python3"或找不到重要组件
• 卡在"正在等待 DLL 注入到游戏中……"
• 用了一段时间后报 FileNotFoundError

解法统一：把整个 Luna 目录加入信任。Windows Defender 走"病毒和威胁防护 → 排除项 → 添加文件夹"；其他杀软添加白名单。加完信任后重新下载解压一遍（被删的文件要补回来）。软件由 GitHub Actions 自动构建，构建管道里混进恶意代码的概率极低，可以放心信任。

HOOK 没反应：按顺序排查

1. 游戏若以管理员运行，Luna 也要用 LunaTranslator_admin.exe 启动，权限不匹配就注不进去
2. 在"选择文本窗口"里多等几秒，让游戏多说几句，候选行会越来越多
3. 尝试 HOOK 设置里的"额外钩子（Win32 通用钩子）"，代价是可能略降游戏速度
4. 老游戏可能需要"延迟注入"，等游戏把自身 dll 加载完再注入
5. 实在不行，直接切 OCR，不丢人

OCR 识别不准：对症下药

• 框选区域没包住完整文本 → 重新框，留点边距
• 字体小、画面糊 → 把游戏分辨率调高一档，或开 OCR 的图像预处理参数（对比度等）
• 换了个 OCR 引擎试试：本地引擎免费不联网，在线引擎对复杂字体更稳
• 译文在原地抖 → 确认文本相似度阈值别设成 0

翻译延迟大：先分清瓶颈在哪

延迟通常三段：取文本（HOOK 几乎无感，OCR 看引擎和频率）、翻译服务响应（换更快的引擎，或切本地模型）、本地资源（缓存过大、杀软反复扫描都会拖慢）。定位方法：HOOK 模式延迟大基本是翻译端的问题；OCR 模式则优先降截图频率或换在线 OCR。

延伸用法：它还能干什么

• 日语阅读训练器：开着游戏当阅读材料，查词 + 注音 + Anki 三连，比生硬的教材例句有上下文得多
• 多语言内容校对：把待校对的译文截图后走 OCR 流程快速比对，或在翻译窗口里反复对照原文译文，做术语一致性检查
• 历史文本回放：翻译过的句子都留在历史文本窗口里，复盘剧情或查"他刚才说了什么"很方便

从"逐字硬猜字幕"到"台词出口即译文"，你要做的不过是先让 HOOK 装上听诊器，不行再让 OCR 替眼睛认字——语言这道坎，LunaTranslator 已经替你铺平了路。

卡住了去哪找帮助

• 官方文档：仓库内 docs/zh/ 目录，按 docs/zh/README.md（下载与常见错误）、docs/zh/basicuse.md（基本用法）、docs/zh/qa1.md、docs/zh/qa2.md 的顺序读，覆盖绝大多数故障
• 游戏兼容问题：HOOK 接不住具体某款游戏时，直接在项目仓库的 issue 区提交游戏名和引擎信息，作者维护着游戏支持列表
• 作者视频与用户群：docs/zh/README.md 的"联系作者"一节附有作者的 B 站视频和 QQ 群入口，遇到文档没覆盖的怪问题，社区里大概率有人踩过同款坑

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