企业官网建设流程全解析

LunaTranslator 视觉小说游戏翻译器完整使用指南：HOOK、内嵌翻译与 OCR 全流程

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

玩日系视觉小说最大的门槛，往往不是剧情看不懂，而是原文一行行往外蹦、翻译窗口却慢半拍——等你看完翻译，游戏里的文本框早翻到下一句了。LunaTranslator 就是为解决这个问题做的工具：它通过HOOK 技术直接读取游戏内存里的文本，几乎零延迟地把译文推送到屏幕上，让你在文字冒险游戏里像读母语一样顺畅地推进剧情。

这是一款免费开源的视觉小说翻译器（GPLv3 许可），主打 HOOK 提取文本、内嵌翻译、OCR 识别三条链路，配套大语言模型翻译、日语分词注音、Anki 同步等学习功能。适合三类人：想畅玩无汉化视觉小说的玩家、需要把 NS/PSP/PSV/PS2 模拟器游戏读下来的怀旧党，以及边玩游戏边学日语的语言学习者。

功能支持一览

• HOOK 提取游戏文本：把 DLL 注入游戏进程后直接读内存文本，延迟极低，适配大多数常见和冷门引擎
• 内嵌翻译：支持的游戏可把译文直接写回游戏画面，免去来回看浮动窗口，沉浸感最强
• HOOK 模拟器：NS/PSP/PSV/PS2 上的大部分游戏，可直接 HOOK 模拟器进程取文本
• OCR 识别：内置高精度本地 OCR 模型，也支持多种在线/离线 OCR 引擎，覆盖 HOOK 不到位的画面
• 丰富翻译接口：主流在线翻译引擎之外，还支持大语言模型翻译和离线翻译模型
• 语言学习：日语分词与假名注音、AnkiConnect 同步生词、配合 Yomitan 插件查词
• 语音合成与识别：接多种在线/离线 TTS 引擎朗读译文；Win10/11 上还能用 Windows 语音识别

下载、解压与首次启动

官方按操作系统提供预编译包，解压即用，不需要装 Python 环境。如果要从源码构建，仓库地址为：

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

首次使用按这个顺序走：

1. 解压到普通目录：放到任意可写路径，但别放C:\Program Files这类受保护目录，否则即使开管理员权限也可能保存不了配置、甚至无法运行
2. 选对启动器：LunaTranslator.exe普通启动即可；只有当游戏以管理员权限运行、普通模式 HOOK 失败时，才改用LunaTranslator_admin.exe提权启动
3. 确认自动更新：程序默认自动检查更新，失败时可下载新版本直接覆盖旧目录升级；重新安装时千万不要删 userconfig 文件夹，否则全部设置丢失
4. 给目录加信任：HOOK 需要往游戏里注入 DLL，这是杀毒软件误报的重灾区，建议第一时间把整个目录加入白名单，避免用到一半组件被杀掉

三种取文本方式怎么用

HOOK 模式：选进程、选文本行

HOOK 是主链路，适合绝大多数已启动的游戏：

1. 先启动游戏并推进到出现对话的位置
2. 在 LunaTranslator 切到 HOOK 模式，打开"选择游戏进程"窗口，点选游戏进程并确认
3. 程序注入后自动弹出"选择文本"窗口，里面会列出若干候选文本行
4. 让游戏多运行几句，观察哪一行的文本与游戏画面同步变化，选它即可开始翻译
5. 想省掉手动选进程这一步，也可以把游戏启动器图标直接拖进 LunaTranslator 窗口，松开后游戏会以指定区域启动并被自动 HOOK

小技巧：快捷键里"选择游戏""选择文本"都有对应按键（见 快捷按键说明），玩到后期基本可以盲操作切换文本行。

内嵌翻译：把译文写回游戏画面

不是所有游戏都支持内嵌，判断标准很简单：选择文本窗口里，支持内嵌的条目才会出现"内嵌"按钮。

1. 在候选文本中选中带"内嵌"按钮的那一行，激活内嵌
2. "内嵌"和"显示"可同时开：游戏里嵌译文，软件窗口里保留更多翻译结果；只开内嵌则软件窗口不显示内容
3. 英文游戏出现中文乱码时，通常是缺字体，激活修改游戏字体并选一个含中文字形的字体
4. 古早日本 galgame 用 Shift-JIS 字符集，简体字会显示成方框或错字，可尝试将汉字转换成繁体/日式汉字规避

内嵌的原理是在游戏显示文本前把线程停住、替换内存里的文字再放行，所以翻译引擎越慢游戏卡得越久——在 内嵌翻译文档 里可以把翻译等待时间调小，避免长时间卡死。

OCR 模式：HOOK 不到位时的通用方案

1. 切到 OCR 模式，用"选取 OCR 范围"框住游戏画面里的文本区域
2. 程序会持续监控该区域，文本变化时自动识别并翻译
3. 注意别点错按钮：图标相似的那个按钮是临时识别一次用的，不是持续识别
4. 多区域布局的游戏可开启多重区域模式，一次框多个文本框

HOOK 模拟器：掌机与主机游戏

玩 NS/PSP/PSV/PS2 模拟器里的游戏时，不需要对游戏本身做任何处理，直接 HOOK 模拟器进程即可读到文本。各平台的支持情况整理在 模拟器游戏文档，其中 支持列表 按主机平台分门别类，先查自己的游戏在不在表里能省不少试错时间。

进阶配置：按你的场景调

• 离线与大模型翻译：不想依赖在线接口时，可配置本地 llama.cpp 服务加载大模型做翻译，模型与 GPU 层数等参数都有独立设置项；配合 Sakura 等模型可获得更地道的轻小说语感
• 多套配置：不同游戏引擎（Ren'Py、KiriKira、TyranoScript 等）常需要不同的 HOOK 参数与显示设置，利用 多配置功能 给每款游戏存一份，切游戏时一键切换
• 快捷键：先在设置里激活"是否使用快捷键"，再逐项绑定按键。"显示/隐藏原文""显示/隐藏翻译""放弃窗口焦点"（让程序不跟游戏抢焦点、增强沉浸感）是高频三件套
• 翻译窗口位置与外观：字体大小、透明度、鼠标穿透、Aero/Acrylic 特效都在 显示设置 相关文档中，建议按游戏分辨率微调字号
• 词典与生词本：日语游戏可开启分词与假名注音，生词通过 AnkiConnect 一键进 Anki 卡组；浏览器端可配 Yomitan 插件 联动查词

常见问题

• 提示"Missing embedded Python3"或找不到重要组件→ 大概率是杀毒软件把内置组件删了。把 LunaTranslator 目录整体加入信任（Windows Defender 走"病毒和威胁防护 → 排除项 → 添加文件夹"），然后重新下载解压
• 软件放到 Program Files 后报 PermissionError、无法保存配置→ 换到普通用户目录重新解压；升级只需覆盖，但保留 userconfig 文件夹
• 等待 DLL 注入一直转圈→ 仍是注入行为被安全软件拦截，同上处理加信任
• 内嵌翻译后游戏画面出现乱码/方框→ 英文游戏先换中文字体；日系老游戏先试"汉字转繁体/日式汉字"。具体案例见 内嵌翻译文档

文档与源码目录

• 基本用法：HOOK、OCR、拖拽启动的图文流程
• HOOK 设置：进程选取与参数细节
• 软件下载与常见问题：下载渠道和报错对照
• 核心模块：翻译引擎 src/LunaTranslator/translator/、OCR 引擎 src/LunaTranslator/ocrengines/、文本输入输出 src/LunaTranslator/textio/、界面 src/LunaTranslator/gui/、HOOK 注入实现 src/NativeImpl/LunaHook/
• 文档有简繁中、英、日、韩、俄、越等多语言版本，位于 docs/；项目采用 GPLv3 许可证，欢迎提交 Issue 反馈兼容性问题，或从新增游戏适配、翻译引擎适配入手参与贡献

适合谁、下一步做什么

• 零安装成本：预编译包解压即玩，更新覆盖即可，无需 Python 环境
• 低延迟体验：HOOK 直读内存文本 + 内嵌写回画面，是浮动翻译窗口给不了的沉浸感
• 覆盖面广：HOOK、模拟器 HOOK、OCR、剪贴板多条链路互为备份，冷门引擎也能想办法
• 能边玩边学：分词注音、Anki 同步、词典联动把游戏变成语言练习场

先下载预编译包，挑一款你手头的视觉小说，按 HOOK 模式选进程、选文本行跑通第一句翻译——剩下的内嵌、字体、引擎切换都是在这条主线上的微调。

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