LunaTranslator GalGame翻译工具实用指南:三种提取路径与常用参数调优
LunaTranslator GalGame翻译工具实用指南三种提取路径与常用参数调优【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款 Windows 平台的 GalGame 翻译工具通过 HOOK、OCR、剪贴板三种方式从游戏里取出文本再交给内置翻译引擎实时翻译显示。本文按使用流程走一遍从启动到参数调优的完整路径。跑起来之前这一节回答三个基础问题装什么版本、放在哪、怎么启动。官方包支持 Windows 101803/ 11 的 64 位系统Win7/XP 另有旧系统兼容版但性能更差、误报率更高没有特殊需求不建议用。下载后解压到普通目录即可不要放进 C:\Program Files 这类特殊路径否则软件可能无法写入配置文件。启动入口是 LunaTranslator.exe只有游戏受 UAC 保护时才需要改用 LunaTranslator_admin.exe 以管理员权限启动。如果要删除重下别删掉 userconfig 文件夹你的全部设置都存在里面。把文本拿出来这一节解决第一次翻译前最关键的选择用哪种方式取文本。决策顺序是先试 HOOK引擎不支持或取不到再试 OCR实在不行用剪贴板兜底。HOOK把 DLL 注入游戏进程从内存直接读文本缓冲区文本选择窗口会实时列出候选行选中与游戏对话对应的那一行即可游戏支持内嵌翻译时译文还能写回游戏对话框OCR对指定区域持续截图识别引擎在设置页里随时可换截图策略有周期执行、分析图像更新、鼠标键盘触发加等待稳定、文本相似度阈值四种剪贴板在游戏里复制文本时自动取走并翻译对比项HOOKOCR剪贴板文本来源游戏内存屏幕像素手动复制可靠性无识别误差受字体、背景影响取决于游戏能否复制适用范围有内置引擎的引擎绝大多数游戏可复制对话的游戏省掉手动选进程的话把游戏 exe 拖到主窗口游戏会直接启动、注入并弹出文本选择窗口一步到位。引擎怎么选这一节解决引擎多到不知道选哪个的问题。翻译器实现有百度、Google、DeepL、Bing、Papago、彩云、Azure 等四十多个常见三组搭配免费省事百度或 Bing 翻译 本地 OCR默认模型 PP-OCRv5_mobileCPU 即可跑追求译文质量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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考