LunaTranslator 完整上手指南快速搞定视觉小说 Hook 游戏实时翻译【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款面向视觉小说Galgame的实时翻译工具它用 HOOK 技术直接从游戏进程里抽出正在显示的对话文本再调用翻译引擎实时给出译文。对于想零成本读日文原版、却不想装各种脚本和汉化补丁的玩家它把取文本 → 翻译 → 显示这条链路整合到了一个窗口里。本文按真实使用路径走一遍先让你第一次就把游戏跑通再按场景讲该用哪种模式最后给出一组常见坑位与调优参数。它能帮你做什么适合谁在决定下载之前先确认它是否覆盖你的场景HOOK 提取主要工作模式。LunaTranslator 适配了绝大多数主流与冷门视觉小说引擎直接从游戏内存读取对话文本稳定且低延迟。详见 HOOK 设置。内嵌翻译在部分引擎上可以把译文直接写回游戏画面替换掉原来的对白效果接近官方汉化。详见 内嵌翻译。HOOK 模拟器对 NS / PSP / PSV / PS2 / PS3 上的大部分游戏直接 HOOK 模拟器进程读文本无需给模拟器打补丁。支持列表见 模拟器游戏支持。OCR 兜底内置高精度离线 OCR 模型同时支持百度、腾讯等在线 OCR 接口用于读不出文本或需要识别图片文字的情况。接口配置见 OCR 接口设置。丰富的翻译后端在线接口Bing、Google、DeepL、阿里等、离线模型、以及 ChatGPT 类大语言模型接口支持 OpenAI / Gemini / DeepSeek / 阿里云百炼 / 火山引擎 / 智谱 等。大模型接口见 大模型翻译接口。日语学习辅助日语分词、假名注音Furigana、语法加亮支持 AnkiConnect 一键做卡、Yomitan 插件联动。分词注音见 日语分词及假名注音。语音合成与识别集成 Windows TTS、Edge TTS、VOICEVOX、VoiceRoid 等大量引擎让游戏读出对白Win10/11 下还支持语音识别把玩家说的话转成文本。TTS 引擎见 语音合成引擎。如果你只是想打开游戏 → 看到中文重点看下面两节即可其余能力按需查阅。最短上手路径三步第一次成功第一步下载并解压到非系统目录到官方下载页拿到 64 位 Win10/11 版本旧系统有专门的兼容版性能更差、易被杀软误报非必要不选。下载后解压到一个你自己的目录比如D:\Games\LunaTranslator。别放到C:\Program Files这类受保护路径。即使以管理员运行也可能写不了配置和缓存直接报 PermissionError。顺手确认杀软状态LunaTranslator 需要向游戏注入 DLL 来 HOOK 文本LunaSubprocess32.exe/LunaHost32.dll等文件经常被误报。建议把整个 Luna 目录加入杀软信任列表Windows Defender 走病毒和威胁防护 → 排除项 → 添加排除项 → 文件夹。这一步不做后面几乎所有报错都指向它。第二步启动程序目录里有三个入口文件作用LunaTranslator.exe普通模式启动绝大多数情况用这个LunaTranslator_admin.exe管理员权限启动仅当游戏本身需要管理员权限才能被 HOOK 时才用LunaTranslator_debug.bat显示命令行窗口出问题时看日志用首次启动会自检/自动更新如果失败重新下载新版本解压覆盖到原目录即可。你的所有设置都保存在userconfig文件夹里重装时不要删它否则所有配置清零。项目是闭源分发如果你只是想看代码可以克隆源码git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator核心源码 是主要入口。第三步把游戏连上选中文本行有两种方式接入游戏推荐第一种方式 A拖拽启动推荐。在 LunaTranslator 主窗口里用鼠标把游戏的 exe 快捷方式拖到软件窗口上松开——软件会先按你的游戏设置拉起游戏然后自动完成 HOOK。方式 B对已启动的游戏 HOOK。如果游戏已经在跑打开工具栏的选择游戏进程在弹出的进程列表里选中游戏主程序即可。接入后会弹出选择文本窗口里面会出现若干候选文本行游戏运行起来、显示对白之后才会刷新。让游戏先说一句台词然后在候选里挑那条真正对应游戏对话的文本行点它旁边的显示按钮——翻译就开始了。若这一行还有个内嵌按钮说明该游戏支持把译文写回画面见下节。到这里你就跑通了核心链路HOOK 拿到文本 → 引擎翻 → 窗口显示。分场景使用什么游戏走哪条路场景一Windows 视觉小说HOOK 模式这是 LunaTranslator 的主场。绝大多数 RenPy、KiriKiri、TyranoScript、RPG Maker 等引擎出品的游戏都直接支持。操作即上面第三步拖入或选进程 → 选文本行 → 翻译。判断候选行哪条是对的让游戏多打几段不同的台词看哪一行的内容跟着剧情同步变化那一条就是对白通常还伴随一个稳定不变的 ID 列。选完后如果文本反复闪烁多半要调刷新延迟见调优一节。场景二NS / PSP / PSV / PS2 / PS3 模拟器游戏打开对应平台的模拟器加载游戏后走 HOOK 流程只不过游戏进程换成了模拟器本身。常见模拟器支持列表见 模拟器支持或 docs/emusupportlist/all.md。32 位模拟器PPSSPP 旧版、Vita3K 老分支等走LunaSubprocess32.exe64 位模拟器走LunaSubprocess64.exe软件会自动选择你不用管。部分 JIT 类模拟器Unity / Yuzu / PPSSPP / Vita3K / RPCS3依赖JIT HOOK如果选不出文本可以在 HOOK 设置 里为这款游戏单独加专用 HOOK 设置不必改全局默认。模拟器本身如果是 64 位游戏里跑的还是 32 位代码这是正常的不影响 HOOK。场景三HOOK 拿不到、或者要读的不是对话OCR 模式以下情况切到 OCR 更合适游戏是位图文字比如把整段对话画到一张背景图上HOOK 只能读到空指针你想翻译游戏界面里的说明文字、图鉴、菜单而不是对白你在看静态图片截图、漫画页、攻略图。用法切到 OCR 模式 → 在屏幕上框选要识别的区域 → 松开后自动识别并翻译之后再改框也会跟着刷。离线 OCR 默认内置模型即可用精度不够时可以在 OCR 接口设置 里挂一个百度 / 腾讯 / 阿里等在线接口。OCR 和 HOOK 是两条独立的取文本通道理论上可以并存但同一时刻只有一条在真正驱动翻译。切模式前先想清楚我这次到底要读什么。场景四让译文住进游戏画面内嵌翻译如果选中文本那一行有内嵌按钮不是每个游戏都支持没有就不支持点它译文会直接替换掉游戏里的原文观感接近官方汉化。显示和内嵌可以同时打开前者在 Luna 窗口里给完整的原文 译文后者只改游戏画面。乱码是内嵌模式的头号敌人两类原因对应两套解法详见 内嵌翻译字体问题多见于英文游戏显示中文激活修改游戏字体选一个带中文字形的字体字符集问题多见于古早日文 Galgame 使用 Shift-JIS激活将汉字转换成繁体/日式汉字让写回画面的字符落在游戏能识别的字符集里。内嵌本质是往游戏字符串里写数据理论上有一定崩溃风险重要进度先存档再试。进阶与调优把体验拧到最顺HOOK 能跑不代表跑得舒服。真正影响日常体验的只有下面这几项其余默认即可。完整说明见 HOOK 设置 和 文本处理。调文本刷新节奏刷新延迟出现每次只蹦出一两个字或一行一行顶掉上一行、最后只剩最后一行是延迟太低把文本刷新得比游戏打得还快——调高反之文本正确但更新慢适当调低。最大缓冲区长度文本反复不停刷新、缓冲区被撑爆时适当调小别低于实际文本长度。最大缓存文本长度默认 100 万看着大但绝大部分是无用文本调到1000通常就够还能显著减少看历史文本时的卡顿。最大允许输出文本长度跳过剧情 / 回看历史时游戏会一口气喷大量文本把这个值调成合理上限能过滤掉突发洪流。用文本处理方法清理脏数据HOOK 偶尔会读到重复字符、控制符、标点噪声。文本处理方法 里有一整套过滤器过滤非 Shift-JIS 字符、过滤控制符、过滤英文标点、只保留「」内文本等可以按顺序叠多个。注意内嵌模式下大多数过滤器会被关闭怕破坏游戏字符串只保留过滤换行符、字符串替换、自定义 Python 处理、过滤尖括号、去除花括号这几个安全的。换翻译引擎而不是换软件追求速度和稳定Bing / Google 这类主流接口默认就够用追求语气和上下文贴合尤其长段落、双关走 大模型通用接口把 API 地址、Key、model 填好可以开启流式输出让译文逐段显示再配上附带上下文个数给模型喂前文有多个 Key 想轮询用|分隔写在同一栏即可想同时用多个不同平台对比效果就点复制一份接口配置起个名字单独打开完全不想联网接本地离线翻译模型llama.cpp 部署后走大模型通用接口或专门的离线翻译模型接口。让译文读出来打开 语音合成引擎 里你已有的那一个Windows 自带 TTSWin10/11 下自然语音质量最好、Edge TTS免费、语感自然、VOICEVOX / VoiceRoid日语角色音、GPT-SoVITS本地克隆音。选好后开启自动朗读对白显示的同时就播出来。避坑指南高频问题与直接解法以下四件占了绝大多数求助量按问题—原因—方案给你。问题 1报错 Missing embedded Python3 或找不到重要组件原因内置 Python 运行时被杀软隔离了。方案把 Luna 目录加入杀软信任/排除项然后重新下载解压不是简单恢复文件避免其他组件也缺。问题 2一直停在正在等待 DLL 注入到游戏中……原因还是杀软只是它拦在了注入 DLL 这一步。方案同上加入排除项。确认游戏进程本身也允许被注入少数游戏带反注入切 64 位/32 位版本试试。问题 3PermissionError原因软件装在C:\Program Files等受保护目录写不了配置/缓存。方案把整个 Luna 目录迁到D:\之类的普通用户目录重装前记得搬走userconfig。问题 4HOOK 后选不到正确文本行按顺序排查是否用了LunaTranslator_admin.exe如果游戏本身以管理员运行普通进程是注入不进去的候选行里是不是根本没出现目标对白那多半引擎没适配去官方提 issue别在代码页设置上反复改对绝大多数游戏没用出现了但内容乱看 HOOK 设置 里的游戏专用设置为这款游戏单独加一份 HOOK 配置激活Win32 通用钩子GDI / D3DX / 字符串函数或让作者补一条特殊码文本对但节奏错一个字一个字蹦调刷新延迟见上节。问题 5更新失败 / 想手动更新默认会自动更新。失败时直接下载新版本解压覆盖到原目录即可userconfig不要动。想要干净重装也只删 exe 和库别删userconfig否则设置全丢。一句话总结与延伸方向一句话LunaTranslator HOOK 抽文本 你选的翻译引擎 可选内嵌回画面第一次跑通的关键就三件事——解压到非系统目录、加杀软信任、选对那条文本行。跑通之后按你的目标延伸想让观感更像官方汉化 → 读 内嵌翻译想学日语、边玩边背词 → 配 假名注音 Anki 集成想让游戏说话 → 语音合成引擎想接入自己调过的模型 → 大模型翻译接口 和 OCR 接口想让翻译更干净 → 文本处理想深入了解实现 → 核心源码、Native 注入实现更多细节都集中在 官方文档遇到不适配的游戏直接去提 issue比在本地参数里死磕更快。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考