LunaTranslator 完整指南：从 HOOK 到 OCR，掌握视觉小说游戏翻译

LunaTranslator 完整指南从 HOOK 到 OCR掌握视觉小说游戏翻译【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款免费开源、面向 Windows 的视觉小说翻译器。它通过 HOOK 注入游戏进程直接读取内存文本或通过 OCR 识别画面文字再交给多种翻译引擎输出译文让日文、英文的视觉小说VN无需等待汉化即可实时阅读。如果你符合以下任一情况这个项目值得试用你经常玩日文或英文视觉小说不想等待官方或民间汉化你希望译文随游戏文本同步刷新而不是手动截图翻译你想边玩游戏边积累日语词汇并推送到 Anki 记忆你的游戏不受 HOOK 支持需要用 OCR 识别画面文本兜底能力总览场景与对应能力下表把典型使用场景映射到具体能力便于你判断它能否覆盖你的需求| 使用场景 | 对应能力 | 实际效果 | | - | - | - | | 玩日文 VN想要实时中文字幕 | HOOK 文本提取 多翻译引擎 | 直接读取游戏内存中的文本无截图环节延迟低 | | 游戏不受 HOOK 支持 | 离线/在线 OCR | 框选识别区域即可自动识别画面里任何文字都能读 | | 希望译文直接出现在游戏对话框 | 内嵌翻译 | 译文替换游戏内原文显示无需切换窗口部分游戏支持 | | 在 NS / PSP / PSV / PS2 模拟器上玩游戏 | 模拟器 HOOK | 注入模拟器进程提取原文 | | 边玩边学日语 | MeCab 分词 假名注音 Anki | 译文展示分词与注音生词可经 AnkiConnect 推送 | | 希望听到剧情 | 多引擎语音合成 | 将译文转成语音播放 |快速上手三步完成安装与启动第一步确认环境要求| 项目 | 要求 | | - | - | | 系统 | Windows 101803 及以上或 Windows 1164 位 | | 旧系统 | 提供 Windows 7 / XP 兼容版但功能与稳定性更差非必要不建议 |第二步获取并解压从项目发布页下载最新版本压缩包解压到任意目录。注意两点不要放在C:\Program Files等受保护路径否则可能无法保存配置甚至无法运行杀毒软件可能误报注入相关组件如LunaSubprocess32.exe、LunaHost32.dll请将整个文件夹加入信任或排除项第三步选择启动方式| 启动项 | 说明 | | - | - | |LunaTranslator.exe| 普通模式日常使用这个即可 | |LunaTranslator_admin.exe| 管理员权限启动仅当部分游戏必须以管理员权限运行时使用 | |LunaTranslator_debug.bat| 附带命令行窗口用于排查问题 |首次启动会自动更新必要组件手动更新时只需将新版本解压覆盖原目录且不要删除userconfig文件夹否则已有设置会丢失。核心工作流按任务链路操作以下五条链路覆盖了绝大多数使用场景。每条链路先给判断条件再给步骤与成功标志。链路一HOOK 模式提取文本适用判断游戏已在 Windows 上运行且为常见视觉小说引擎。启动游戏后在 LunaTranslator 中切换到 HOOK 模式打开进程选择窗口选中游戏进程并确认软件会向游戏注入让游戏运行并显示若干句文本文本选择窗口中会出现若干候选文本行选中与游戏画面相符的文本行点击显示若该条目带有内嵌按钮可另行选择内嵌翻译成功标志游戏文本每变化一次软件窗口同步显示译文且刷新无感延迟。链路二拖拽启动游戏并自动 HOOK适用判断游戏尚未启动且你希望省去手动选进程的步骤。启动 LunaTranslator将游戏可执行文件拖拽到软件窗口中松开游戏以兼容方式启动并自动 HOOK随后弹出文本选择窗口按链路一的第 3、4 步操作成功标志无需手动选择进程游戏启动后直接出现候选文本行。链路三内嵌翻译游戏内显示译文适用判断文本选择列表中该条目存在内嵌按钮即游戏支持内嵌没有该按钮则不支持。选中对应文本条目激活内嵌若游戏内出现乱码英文游戏通常缺中文字体激活修改游戏字体并选择一个中文字体若乱码来自字符集常见于使用 Shift-JIS 的旧游戏尝试将汉字转换成繁体/日式汉字成功标志译文直接显示在游戏对话框中仅激活内嵌时软件窗口不显示内容。注意内嵌有一定概率导致游戏崩溃且并非所有游戏都支持。链路四OCR 模式识别画面文字适用判断HOOK 选不出候选文本行或游戏引擎不受支持。切换到 OCR 模式在游戏画面中拖拽框选识别区域选择自动化执行方式不确定参数时选周期执行按固定间隔截图识别结果自动送入翻译成功标志框选区域内的文字随游戏文本更新而被识别并翻译全程无需操作鼠标。可选开启原地显示翻译让译文直接覆盖在选框内的原文位置。链路五模拟器游戏NS / PSP / PSV / PS2 等适用判断你在模拟器上玩游戏且游戏在对应平台的支持列表中。正常启动模拟器并进入游戏在 HOOK 模式中选择模拟器进程其余操作与链路一相同成功标志与链路一相同。支持的平台与引擎清单见 模拟器支持文档。参数速查表HOOK 与 OCR 关键参数大多数参数保持默认即可仅在出现对应症状时调整| 参数 | 作用 | 建议值 | | - | - | - | | 刷新延迟 | 两次文本提取的间隔 | 默认文本一次只出一两个字或一行时调高提取偏慢时适当调低 | | 最大缓冲区长度 | 单条文本的缓冲上限 | 文本反复不停刷新时适当降低但不要低于实际文本长度 | | 最大缓存文本长度 | 历史文本缓存大小 | 默认 1000000一般可降至 1000 左右以减轻卡顿 | | 最大允许输出文本长度 | 过滤突发的大量文本 | 游戏常有 Skip 或历史文本回滚时设为合理上限 | | Win32 通用钩子 | 额外注入 GDI / D3DX / 字符串函数钩子 | 仅在提取不到正确文本时开启默认关闭以避免拖慢游戏 | | 执行周期OCR | 周期执行下的截图间隔 | 选与游戏文本节奏匹配的值最省心的方式 | | 文本相似度阈值OCR | 抑制 OCR 微小抖动导致的重复翻译 | 默认同一句被反复重新翻译时调高 | | 图像一致性阈值OCR | 判断游戏文本是否真正变化 | OCR 频率过快时调高响应迟钝时调低 | | GPU / OpenVINO 推理OCR | 加速离线识别 | Win10 版或 Win11 可启用 GPUIntel 平台可换 OpenVINO |离线 OCR 默认内置 PP-OCRv5_mobile中日英轻量模型追求更高准确率可下载 PP-OCRv6_medium、PP-OCRv5_server 等模型在线 OCR 则支持百度、腾讯、有道、Google Cloud Vision 等接口详见 OCR 接口文档。进阶能力语音、词汇与翻译优化语音合成TTS支持 Windows 自带 SAPI 与自然语音、VOICEVOX、VoiceRoid / A.I.VOICE、GPT-SoVITS 等引擎可将译文转成语音播放引擎清单见 TTS 文档。日语学习基于 MeCab 的分词、假名注音与语法加亮配合内置辞书查词通过 AnkiConnect 可将生词推送到 Anki 卡片也支持 Yomitan 插件见 分词注音文档。语音识别在 Windows 10 / 11 上可用 Windows 语音识别输入见 语音识别文档。翻译优化翻译前替换、专有名词词典、翻译结果修正与自定义脚本用于解决人名译名不一致、术语错误等典型问题见 翻译优化文档。大模型翻译大模型通用接口可对接 OpenAI、Gemini、DeepSeek、Claude 等平台的接口支持流式输出、上下文附带与自定义 prompt另提供 Hy-MT2、Index-Translate、SakuraLLM 等离线翻译模型的专用接口见 大模型接口文档。架构与目录代码如何组织LunaTranslator 采用 Python C 混合架构界面、引擎编排与扩展部分用 PythonHOOK、注入与识别等性能敏感部分用 C 实现。| 目录 | 职责 | | - | - | | src/LunaTranslator/translator/ | 翻译引擎实现Bing、DeepL、百度、Google、大模型通用接口等 | | src/LunaTranslator/ocrengines/ | OCR 引擎内置离线模型、manga-ocr、百度、腾讯、Google Cloud Vision 等 | | src/LunaTranslator/textio/ | 文本输入输出管道HOOK / OCR / 剪贴板等文本源与输出目标 | | src/LunaTranslator/tts/ | 语音合成引擎封装 | | src/LunaTranslator/cishu/ | 辞书mdict、有道、Jisho、Weblio 等 | | src/LunaTranslator/transoptimi/ | 翻译优化前替换、专有名词、结果修正 | | src/NativeImpl/LunaHook/ | C HOOK 引擎32/64 位注入与各游戏引擎适配 | | src/NativeImpl/LunaSubprocess/ | 子进程DLL 注入、辅助识别与 TTS 接口 | | src/files/lang/ | 多语言 UI 资源20 余种语言 | | docs/zh/ | 中文官方文档 |排障手册症状对照表遇到报错时按症状 → 排查顺序 → 操作三步定位| 症状 | 排查顺序 | 对应操作 | | - | - | - | | 提示 Missing embedded Python3 / 找不到重要组件 | 杀毒软件是否拦截了组件 | 将整个文件夹加入信任或排除项重新下载解压 | | 一直停在正在等待 DLL 注入到游戏中…… | 同上注入文件被拦截 | 同上 | | 运行一段时间 HOOK 时出现 Error / FileNotFoundError | 组件在运行中被杀毒软件删除 | 添加信任后重新下载 | | 启动报 PermissionError | 安装位置是否在C:\Program Files等受保护路径 | 迁移到普通用户目录 | | HOOK 后选不出候选文本行 | 权限 → 引擎支持 → 钩子缺失 | 先用管理员版启动仍无候选则开启 Win32 通用钩子再不行提交 issue 请求引擎支持 | | 文本一次只提取一两个字 / 一行 | 刷新延迟过低 | 调高刷新延迟或提高游戏内文本显示速度 | | 内嵌翻译出现乱码 | 字体 → 字符集 | 英文游戏激活修改游戏字体旧日文游戏尝试转换为繁体/日式汉字 | | OCR 识别率低 | 选区 → 模型 → 画面字体 | 框准文本区域换更精确的模型或在线接口调大游戏内字体 | | 同一句文本被反复翻译 | OCR 结果抖动 | 调高文本相似度阈值 | | 译文人名、术语不准确 | 引擎 → 词典 | 切换翻译引擎在专有名词词典中添加词条 |更完整的错误说明见 下载与常见问题。能力边界能做什么不能做什么可以做到的对受支持的 Windows 视觉小说做 HOOK 级实时翻译覆盖多数常见与冷门引擎对 NS / PSP / PSV / PS2 等主流模拟器游戏做进程级文本提取离线 OCR 识别内置模型无需联网以及调用多家在线 OCR 接口在线翻译、离线大模型翻译、TTS、Anki 同步等配套功能做不到或需要留意的没有 macOS / Linux 版本仅在 Windows 上运行HOOK 与内嵌翻译取决于具体游戏引擎不是任何游戏都支持内嵌还可能导致游戏崩溃它是实时阅读工具不做整包文本提取不能直接替代汉化组的专业提取工具内置 OCR 模型面向中日英场景小字号、复杂背景、艺术字需要更精确的模型或在线接口在线引擎的效果受对应服务的可用性与条款约束离线场景请以本地模型为主社区与文档基本用法HOOK / OCR / 拖拽启动的操作细节HOOK 设置通用设置与特殊码格式OCR 功能设置四种自动化执行方法与阈值内嵌翻译字体与字符集问题处理模拟器支持各平台支持列表核心翻译源码、HOOK 引擎源码下载最新版本把第一款游戏接进 HOOK 模式看看你的文本能多快变成中文。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考