企业官网建设流程全解析

LunaTranslator 完整教程：3 步跑通视觉小说实时翻译（免费、可离线）

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

LunaTranslator 是一款免费的视觉小说翻译工具，面向 Galgame 的实时翻译器：它自动抓取游戏台词、交给翻译引擎、把译文悬浮显示在屏幕边，不懂日语也能玩懂故事。

它替你解决哪件具体的事

想象这个场景：你下了一款评分很高的日本视觉小说，开场十分钟的对话全是片假名和敬语，你既不想等民间汉化组的更新，也不打算每句话都复制去搜索引擎翻译。LunaTranslator 做的事很直接——它坐在游戏旁边，游戏一吐出台词它就立刻接住、翻译、贴到屏幕边缘给你看。

于是三件烦心事消失了：

• 不用等汉化：剧情走到哪，翻译跟到哪，日、英、韩、俄文游戏都能出中文
• 不用切窗口复制粘贴：游戏进程里的文本被实时读出来，或者框住字幕区域让截图识别顶上
• 不怕断网：内置本地大模型引擎，翻译全程不出你的电脑

翻译之外它还是个顺手的学习工具：复制外文自动出译文、选中文字能查词典释义、译文能一键朗读、生词能同步进 Anki 卡片。

最短路径：最快怎么跑起来

📦 预编译包路线（推荐新手）：

1. 下载官方 Windows 预编译包，解压到一个普通目录。千万别放进C:\Program Files这类系统路径，否则配置和缓存可能写不进去
2. 双击LunaTranslator.exe启动。如果你的游戏需要管理员权限运行，改点LunaTranslator_admin.exe，其余情况普通启动就够
3. 首次启动会自动检查更新，之后左侧是设置区、右侧是翻译显示区，可以直接进下一步了

💻 源码路线（给想捣鼓的人）：

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

克隆下来后双击src/run.bat即可运行（32 位系统用src/run32.bat）。

路线选择：几条技术方案怎么挑

拿到文本有两条主路，挑法很简单：先试 HOOK，不成再落 OCR。

HOOK 模式：延迟最低的正规军。打个比方，它就像在游戏进程门口装了个传声筒，台词从内存里一出来就原样递给你，不经过眼睛、不走截图。步骤：先开游戏，切到 HOOK 模式，在进程列表里选中它（也可以把游戏快捷方式直接拖进软件窗口，自动启动并挂钩）。注入成功后会弹出「选择文本窗口」，从候选行里挑出真正对应台词的那一条，翻译就开始滚动了。支持内嵌的游戏还能把译文直接嵌进游戏画面里。

OCR 模式：读不到内存时的备用眼镜。老游戏常常把文本锁在奇怪的地方，HOOK 够不着，那就让软件当个"看图说话"的：框选字幕区域后，它按固定频率截图、识别、送翻译。识别引擎有开源的 Tesseract、在线的百度、系统自带的 Windows OCR 等，参数拿不准就先按默认值跑。

剪贴板：常驻的随身翻译。文本不一定非来自游戏——复制外文到剪贴板就会自动翻译，配合词典查词、朗读，随时可查。

两条主路的实现分别在 src/NativeImpl/LunaHook/（挂钩端）和 src/LunaTranslator/textio/textsource/texthook.py、src/LunaTranslator/ocrengines/（引擎端）。

离线翻译怎么开

不想让每个词都出家门，就用本地大模型。项目内置了 LLaMA.cpp 本地推理引擎，断网状态下译文照常生成。

操作只有两步：在翻译引擎里选本地大模型，然后指向模型文件即可。默认模型配置在 src/LunaTranslator/defaultconfig/Magpie/，缺模型时可以用仓库备好的拉取脚本 src/scripts/gethfmodels.py 按需执行。

辅助功能怎么顺手用

• 剪贴板翻译：复制即译，实现见 src/LunaTranslator/textio/textsource/copyboard.py
• 查词：选中文案弹词典释义，多个词典引擎在 src/LunaTranslator/cishu/
• 朗读：译文一键 TTS，引擎选项在 src/LunaTranslator/tts/
• 记忆：生词可同步到 Anki，学完游戏顺便背了词

体验调优：把默认配置调到顺手

OCR 的节奏感。默认用「周期执行」截图策略最省心。如果发现软件"眨眼太勤"（识别频繁、吃 CPU）或"反应太慢"（台词变了迟迟不翻），调「图像一致性阈值」：调大更冷静，调小更敏感。参数逐项解释在 docs/zh/ocrparam.md。

内嵌翻译的两个坑。支持内嵌的游戏可以把译文写回游戏画面，注意不是所有游戏都支持，且内嵌有小概率引发崩溃。出现乱码先怀疑两件事：缺中文字体（激活"修改游戏字体"换一个即可）、老日游的字符集问题（试试"将汉字转换成繁体/日式汉字"）。翻译引擎慢时内嵌会造成卡顿，可以用「翻译等待时间」设上限保命。详见 docs/zh/embedtranslate.md。

译文不顺口。三个开关值得打开：错译修正（翻译后自动修一遍）、纯标点句跳过（别把"……"也送进翻译）、专有名词替换（把角色名固定成你习惯的译法，避免"这个人名一会儿叫雪一会儿叫雪子"）。对应实现都在 src/LunaTranslator/transoptimi/。

卡点速查：常见问题怎么破

• HOOK 模式选不到文本行→ 回到「选择文本窗口」换一条候选行再试；整列都不对就切 OCR 模式
• 翻译延迟太高→ 换延迟更低的在线引擎；或者干脆上离线大模型方案，本地推理不排队
• OCR 识别太频繁或太迟钝→ 动「图像一致性阈值」，见上一节
• 提示"找不到重要组件"→ 多半是杀软在运行途中删掉了注入用的组件（HOOK 本身就要往游戏里注 DLL，很容易被误报）。把软件目录加入杀软信任名单，重新下载解压
• 游戏 HOOK 失败、卡在等待注入→ 游戏可能需要管理员权限，改用LunaTranslator_admin.exe启动再挂钩
• 内嵌后游戏卡顿→ 调低「翻译等待时间」，或改用普通显示模式

延伸资源：想继续深入去哪看

• 入门图解（HOOK / OCR / 快捷启动三种方式）：docs/zh/basicuse.md
• OCR 参数逐项详解：docs/zh/ocrparam.md
• 内嵌翻译专题：docs/zh/embedtranslate.md
• 把本地大模型部署到免费在线 GPU：docs/zh/sakurallmcolab.md
• 下载说明、更新方式与作者联系方式：docs/zh/README.md

LunaTranslator 的思路很朴素：先保证拿得到文本，再保证翻得又快又好。现在就启动它，HOOK 住你的第一部视觉小说，选中那行台词——故事，立刻就通了。

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