LunaTranslator 零基础上手指南：3步完成游戏翻译环境搭建
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator（月译）是一款面向视觉小说与主机游戏的文本翻译工具，核心做法是从游戏内存中直接提取文字（HOOK），或在 HOOK 不可用时用 OCR 截图识别，再把结果送进多种翻译引擎实时显示。它适合想无障碍游玩外语视觉小说、主机模拟器的玩家，以及需要批量积累外语素材的学习者。
安装与启动
环境要求：
- 官方发行包：Windows 10/11（64 位），解压即用，无需 Python；
- 源码运行：Python 3.10 及以上，并自行安装 PyQt5 等运行依赖（仓库未附依赖清单）；
- 解压目录避开 C:\Program Files 等受保护路径，否则配置与缓存文件无法写入。
源码方式获取与运行（64 位）：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator/src run.bat源码运行失败时，建议改用官方发行包；日常使用无需关心构建流程。
核心功能速览
| 功能 | 解决什么 | 所在模块 |
|---|---|---|
| HOOK 文本提取 | 从游戏内存直接读出文本，比截图识别更稳、更快 | LunaHook/ |
| OCR 文本识别 | 覆盖 HOOK 不适配的游戏，按区域自动截图取词 | ocrengines/ |
| 多引擎翻译 | 在线接口（DeepL、谷歌、百度等）与本地 LLM（Sakura、llama.cpp）可自由切换 | translator/ |
| 内嵌翻译 | 把译文写回游戏画面，免去悬浮窗来回看 | docs/zh/embedtranslate.md |
| 多平台模拟器支持 | NS、PS2、PS3、PSP、PSV 等模拟器内的文本提取 | docs/zh/emugames.md |
| 日语辅助 | 分词、假名注音、Anki 同步 | docs/zh/jiebapinyin.md |
| 语音合成 | 翻译结果转语音播报，支持在线与离线引擎 | tts/ |
一次完整使用走查
下面以"HOOK 模式翻译一款日语视觉小说"为例，走一遍从启动到出结果的完整流程。
- 拖拽启动：把游戏主程序直接拖到 LunaTranslator 主窗口上。软件会自动按游戏所需的系统区域启动它，并完成 HOOK 注入。
- 选定文本行：注入完成后会弹出"选择文本"窗口。让游戏先推进对话，窗口里会出现若干候选行，把与实际对白内容一致的那一行勾上。
- 查看译文：选中后，游戏里每次出现新对白，悬浮面板即同步刷出原文与译文。
- 可选内嵌：若该游戏支持内嵌翻译，候选行旁会出现"内嵌"按钮，点开后译文直接绘制在画面文本位置上。
- HOOK 不适配时：切到 OCR 模式，框选对白区域，之后游戏文字变化时自动截图、识别并翻译；注意"选取区域"与"临时识别一次"是两个不同按钮，别点混。
关键配置说明
配置文件保存在用户目录 userconfig 内，默认值位于 defaultconfig/，改动会同步写回。以下四项对体验影响最大：
| 配置项 | 默认值 | 建议值 | 作用 |
|---|---|---|---|
| 翻译引擎 | 内置在线接口（如 DeepLX 免费接口） | 在线 DeepL 为主；需离线时改用本地 LLM | 决定译文质量与速度 |
| OCR 执行方式 | 周期执行 | 周期执行（最简单）；慢速字幕或动态背景再换"分析图像更新" | 控制 OCR 何时触发截图 |
| 图像一致性阈值 | 按引擎不同 | 识别过频调高、反应迟钝调低 | 判定"文本是否已变化"，变化才重新识别 |
| 文本相似度阈值 | 关闭 | 开启，阈值约 95% | 抑制 OCR 对微小扰动的误判，避免重复翻译 |
高频问题速查
现象：HOOK 后卡在"正在等待 DLL 注入"，或提示找不到 Python 组件。 原因：杀毒软件把注入用的 LunaSubprocess、LunaHost 组件误删。 处理：先给 LunaTranslator 目录加信任（如 Defender 排除项），再重新下载解压。
现象：OCR 模式下同一句台词被反复翻译。 原因：截图存在微小扰动，识别出的文本随之抖动，每次都触发新翻译。 处理：开启"文本相似度阈值"，相似度未达标就不重复翻译。
现象：HOOK 模式无法注入游戏进程。 原因：游戏以管理员权限运行时，普通权限的 LunaTranslator 无法向其注入。 处理：改用发行包中的 LunaTranslator_admin.exe 以管理员身份启动。
延伸阅读
- 官方文档：docs/zh/（basicuse 基本用法、hooksettings HOOK 设置、emugames 模拟器、ttsengines 语音合成）；
- 翻译引擎 API 整理：docs/zh/useapis/tsapi.md；
- 作者社区入口：docs/zh/README.md。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
