企业官网建设流程全解析

LunaTranslator上手指南：日文视觉小说实时翻译，从下载会用到三步

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

你正打到关键剧情，屏幕上弹出一整屏日文对话框，旁边没有任何中文。这时候你需要的不是等汉化，而是一款能在游戏运行时把文本抓出来、立刻翻成中文的工具——LunaTranslator。它是一款免费开源的视觉小说（Galgame）实时翻译器，核心做三件事：从游戏里提取文本（HOOK 内存提取、OCR 图像识别、剪贴板监控三种方式），调用你选的翻译引擎，把结果显示在屏幕侧边或直接嵌入游戏对话框里。

三步跑起来：下载、启动、选进程

1. 下载并解压。从官方渠道获取 Windows 64 位版本，解压到任意目录。不要放到C:\Program Files这类受保护路径，否则配置和缓存可能无法写入，甚至无法运行。
2. 启动主程序。运行LunaTranslator.exe（普通模式）。只有当某些游戏拒绝普通方式 HOOK 时，才改用LunaTranslator_admin.exe以管理员权限启动，平时不必。
3. 连接游戏。两种方式任选：
   • 在游戏已经运行的情况下，打开软件里的"选择游戏进程"窗口，选中游戏进程，确认后会弹出文本选择窗口；
   • 更省事的做法：把游戏启动 exe 直接拖进 LunaTranslator 窗口松开，游戏会自动转区启动并完成 HOOK。

游戏跑起来显示几句对话后，文本选择窗口里会出现若干候选文本行，挑出那条就是游戏对话的行，翻译即刻开始。整个流程基本 3 分钟内能完成，具体操作见 docs/zh/basicuse.md。

解决什么问题：按你的难题选对应方案

LunaTranslator 不按"功能列表"设计，而是针对不同游戏能读不读得出文本来分流。对照你手上的游戏，选一条路走：

补充两点：剪贴板监控适合能复制文本的老游戏；软件还带日语分词与假名注音、Anki 同步、语音合成、Windows 语音识别，学日语的人可以顺手用起来，对应文档是 docs/zh/jiebapinyin.md、docs/zh/ttsengines.md、docs/zh/sr.md。

翻译引擎怎么选：三档配置对号入座

翻译质量主要由引擎决定，LunaTranslator 内置了在线引擎、大模型通用接口和离线方案，按你的需求挑：

• 只想要"够用"：选免费在线引擎（如百度、Bing、DeepL 等），零配置，打开游戏即翻。
• 重度玩家 / 在意上下文：配一个大模型接口。填 API 地址和 Key 后即可拉取模型列表；把"附带上下文个数"调成 5~10 条，模型能参考历史原文与译文，角色口吻和指代会稳很多；多个 Key 用|分隔可自动轮询。参数细节见 docs/zh/guochandamoxing.md。
• 断网 / 隐私优先：走离线路线，用本地或自建接口翻译，无需任何外部服务。

引擎配置存于运行目录的userconfig文件夹，重装前记得备份这个文件夹，设置才不会丢。

按人群定制：三组方案

轻度玩家（偶尔玩一两款，不想折腾） HOOK 模式 + 免费在线引擎 + 默认显示设置。遇到抓不到文本的游戏就切 OCR 模式框选一下，到此为止。

模拟器玩家（NS/PSP/PSV/PS2 日版游戏） HOOK 模拟器为主；模拟器本身 HOOK 不了时退回 OCR。模拟器画面更新频繁，OCR 建议用"鼠标键盘触发"而非固定周期截图，触发事件（按左键、回车等）后再等画面稳定再识别，既省 CPU 又不会翻半句，四种自动化方式的差别见 docs/zh/ocrparam.md。

低配设备 / 嫌卡

• 用本地 OCR 引擎代替在线 OCR，减少网络往返；
• 把 HOOK 设置里的"最大缓存文本长度"从默认 1000000 降到 1000 左右，查历史文本不再卡顿；
• OCR 模式下适当调高"图像一致性阈值"，识别频率降下来，翻译请求也随之减少。

避坑指南：四个高频问题

现象 1：启动时报"Missing embedded Python3"或一直"正在等待DLL注入到游戏中……"→ 可能原因：杀毒软件把LunaSubprocess32.exe、LunaHost32.dll等注入用组件当病毒删了（这是它最常见的误报）。 → 处理：关闭杀毒或添加信任（Windows Defender 走"病毒和威胁防护 → 排除项"加入整个 Luna 文件夹），重新下载解压。软件由 CI 自动构建，这些文件本身不带毒。

现象 2：报 PermissionError，或配置保存失败→ 可能原因：软件被放在C:\Program Files等受保护目录。 → 处理：把整个目录挪到普通路径（如 D 盘），再运行。

现象 3：HOOK 只提取出一两个字，或只显示最后一行→ 可能原因：游戏逐字显示文本，而刷新延迟太低，没显示完就被刷出来了。 → 处理：调高刷新延迟，或把游戏内文本显示速度调到最快。反过来如果提取正确但很慢，则适当调低。参数说明见 docs/zh/hooksettings.md。

现象 4：OCR 翻着翻着突然变迟钝，或同一句话反复重翻→ 可能原因：识别频率与画面变化不匹配。 → 处理：OCR 频率过高就调高"图像一致性阈值"；同一句反复重翻则调高"文本相似度阈值"，让微小扰动不触发重新识别。

延伸资源

• 文档（中文，按语言目录区分）：基础用法 docs/zh/basicuse.md、HOOK 参数 docs/zh/hooksettings.md、OCR 自动化 docs/zh/ocrparam.md、大模型接口 docs/zh/guochandamoxing.md、模拟器支持列表 docs/emu supportlist/ 各平台 md
• 默认配置样例：src/LunaTranslator/defaultconfig/，可直接对照理解各配置项
• 源码：Python 主程序在 src/LunaTranslator/，HOOK 注入相关的 C++ 实现在 src/NativeImpl/LunaHook/
• 遇到问题优先查项目 issue 区；官方文档站和作者视频（B站）覆盖了大量具体游戏案例

先拿一个你已经会玩的日文游戏试 HOOK，跑通后再碰参数——大多数问题默认设置就能覆盖，剩下的按避坑指南一条条对即可。

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