企业官网建设流程全解析

LunaTranslator GalGame翻译工具实用指南：三种提取路径与常用参数调优

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

LunaTranslator 是一款 Windows 平台的 GalGame 翻译工具，通过 HOOK、OCR、剪贴板三种方式从游戏里取出文本，再交给内置翻译引擎实时翻译显示。本文按使用流程走一遍从启动到参数调优的完整路径。

跑起来之前

这一节回答三个基础问题：装什么版本、放在哪、怎么启动。官方包支持 Windows 10（1803+）/ 11 的 64 位系统，Win7/XP 另有旧系统兼容版，但性能更差、误报率更高，没有特殊需求不建议用。下载后解压到普通目录即可，不要放进 C:\Program Files 这类特殊路径，否则软件可能无法写入配置文件。启动入口是 LunaTranslator.exe，只有游戏受 UAC 保护时才需要改用 LunaTranslator_admin.exe 以管理员权限启动。如果要删除重下，别删掉 userconfig 文件夹，你的全部设置都存在里面。

把文本拿出来

这一节解决第一次翻译前最关键的选择：用哪种方式取文本。决策顺序是：先试 HOOK，引擎不支持或取不到再试 OCR，实在不行用剪贴板兜底。

• HOOK：把 DLL 注入游戏进程，从内存直接读文本缓冲区，文本选择窗口会实时列出候选行，选中与游戏对话对应的那一行即可；游戏支持内嵌翻译时，译文还能写回游戏对话框
• OCR：对指定区域持续截图识别，引擎在设置页里随时可换，截图策略有周期执行、分析图像更新、鼠标键盘触发加等待稳定、文本相似度阈值四种
• 剪贴板：在游戏里复制文本时自动取走并翻译

省掉手动选进程的话，把游戏 exe 拖到主窗口，游戏会直接启动、注入并弹出文本选择窗口，一步到位。

引擎怎么选

这一节解决"引擎多到不知道选哪个"的问题。翻译器实现有百度、Google、DeepL、Bing、Papago、彩云、Azure 等四十多个，常见三组搭配：

• 免费省事：百度或 Bing 翻译 + 本地 OCR（默认模型 PP-OCRv5_mobile，CPU 即可跑）
• 追求译文质量：DeepL API + 本地 OCR
• 在线高精度识别：百度智能云 OCR（设置里填 API Key、Secret Key）+ Google 或腾讯翻译

译文出来之后，还可以再开日语分词注音、翻译错误修正等后处理，说明见 docs/zh/textprocess.md。

参数调优

这一节只讲最常动的参数，原则是看到现象再调，一次只动一个。

• 刷新延迟：提取的文本一次出一两个字、或一行行把上一行顶掉，说明延迟太低，提高它，或调快游戏文本速度；文本正确但提取慢，则适当降低
• 最大缓冲区长度：文本反复刷新把缓冲区填满时调低它，但别低于实际文本长度
• 最大缓存文本长度：默认 1000000 字符，文本一多查看会卡，可以直接调到 1000
• 代码页：仅对未指定编码的多字节字符串有效，基本不用动；找不到正确文本时先反馈 issue，调代码页通常徒劳
• 延迟注入：游戏启动后才加载 DLL 的场景，等 DLL 加载完成再执行注入
• Win32 通用钩子与特殊码：记录在游戏管理器的游戏专用设置里，下次启动该游戏自动生效

给开发者的接口

这一节面向想把 LunaTranslator 功能接进自己程序的少数人。内置 HTTP 服务提供 /api/translate?text=...（加 id 参数指定翻译器，否则走最快的）、/api/dictionary?word=...、POST /api/ocr（请求体带 base64 图像）；/page/ 下的 mainui、translate、ocr、tts 等浏览器页面可以直接当第二屏界面用。WebSocket 端点 /api/ws/text/origin 与 /api/ws/text/trans 会持续推送原文与译文。细节见 docs/zh/apiservice.md。

踩坑记录

三个出现频率最高的故障，都按现象、原因、处理写。

HOOK 提取不到文本——原因：游戏用了内置引擎未覆盖的渲染方式，或启动后才加载 DLL。处理：在游戏专用设置里开启"Win32 通用钩子"；不行再试延迟注入；再不行放弃 HOOK，切 OCR 模式。

OCR 反复翻译同一句——原因：相似度阈值过低，画面微小变化就触发重识别。处理：调高"图像一致性阈值"；游戏有动态背景或 Live2D 时，同时调高"图像稳定性阈值"，等画面稳定再识别。

启动报错 Missing embedded Python3——原因：杀毒软件删掉了组件文件。处理：把软件目录加入杀毒软件信任列表，重新下载解压，并注意别放在 Program Files 下。

收尾

全文的主干就是"提取、翻译、显示"这条已经内置打通的路：默认 HOOK 加免费引擎加本地 OCR，开箱就能译。接下来你可以直接解压软件，把正在玩的日文游戏的 exe 拖进主窗口，在文本选择窗口里挑对文本行；如果那个游戏 HOOK 不了，切到 OCR 模式框住对话区域，照样能玩。

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