企业官网建设流程全解析

LunaTranslator实时翻译实操：从首次启动到稳定捕获文本

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

你刚入手一款日版视觉小说，开头第一屏假名就把你劝退了，又不想等不确定的官方汉化。LunaTranslator 就是为这种情况做的视觉小说实时翻译工具：它以 HOOK、OCR、剪贴板三种方式捕获游戏文本，再调用翻译引擎把结果显示在你指定的窗口里。整个流程不长——选中游戏进程、让它认出文本、挑一个翻译引擎，就能边玩边看译文。

🧭 项目定位：三句话说清它是什么

• 工具类型：Windows 平台免费开源的视觉小说实时翻译工具，常驻在屏幕一侧，不打断游戏进程本身。
• 核心能力维度：文本捕获（游戏内存 HOOK、模拟器 HOOK、图像 OCR、剪贴板监控）、翻译（内置 LLM 接口、各类在线引擎、离线模型）、显示与学习（游戏内嵌翻译、历史文本、假名注音、Anki 同步）。
• 运行环境：Windows 10（1803+）/ 11 64 位为主力；Win7 及更老系统有兼容版本，但功能更少、稳定性更差。

⚡ 最短路径：从零到跑通

下载软件：到 docs/zh/README.md 的下载区取对应系统版本，解压后运行主程序；若要从源码入手，可用git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator克隆仓库。

接入游戏：启动游戏后，切到 HOOK 模式，打开选择游戏进程窗口，在进程列表里选中游戏的 exe 并确认。软件注入游戏后会弹出选择文本窗口。

选择文本：让游戏跑出一段对话，选择文本窗口里会列出若干候选文本行。选中与屏幕文字对应的那一行，翻译立即开始。

提示：如果选不到正确文本，多半是文本刷新太快或太慢，去调"刷新延迟"（见后文参数章节）；若游戏需要管理员权限，请让游戏和软件在同一权限级别下运行。

配置翻译引擎：打开翻译设置，任选一个可用引擎。内置大模型接口开箱即用；使用百度、DeepL、Google 等在线引擎时按各自说明填写即可。

摆好窗口：把翻译窗口拖到屏幕底部，可再绑定"显示/隐藏翻译"快捷按键（需先在快捷设置中启用"是否使用快捷键"）。

🎯 按需选路：根据游戏情况选捕获方式

判断依据就三条：游戏是不是标准视觉小说引擎？HOOK 能不能拿到文本？你是在线还是离线环境？

标准引擎场景（HOOK 模式）

适用条件：绝大多数市售视觉小说，引擎文本走标准字符串接口。关键配置项：

• 刷新延迟：控制多快输出一条文本，按症状方向调，不要盲目调；
• 最大缓冲区长度：文本反复刷新的游戏可适当调低；
• 示例值：若发现文本一行行地顶替，把刷新延迟调大到每次能完整收下一句话为止。

自绘渲染场景（OCR 模式）

适用条件：HOOK 选不出文本，或游戏用位图字体、特殊渲染。关键配置项：

• OCR 引擎：默认用本地PP-OCRv5_mobile模型，无需联网；
• 图像一致性阈值：控制识别频率，是最重要的 OCR 参数；
• 执行方式：不懂其他参数就选"周期执行"，最简单。
• 示例值：若识别触发过于频繁，把图像一致性阈值调大 10 左右。

模拟器与离线场景

模拟器游戏优先走 HOOK：yuzu、ppsspp 等主流模拟器已被支持，支持列表见 docs/zh/emugames.md，无法 HOOK 时退回 OCR。完全离线环境则选内置 LLM 接口加载本地模型（基于 llama.cpp），翻译全程不出本机，接口配置方式见 docs/zh/guochandamoxing.md。

🔧 配置深度：五个必须知道的参数

刷新延迟（docs/zh/hooksettings.md，HOOK 设置） 没有固定推荐值，按症状定方向：文本每次只出一两个字、或上一行被新行顶掉 → 调大；文本正确但出得慢 → 调小。副作用是双向的：调太大翻译滞后明显，调太小文本被切碎反复重译。

最大缓存文本长度（同上） 默认 1000000 → 推荐 1000。缓存里绝大多数是无用文本，数值过大会让查看文本时卡顿；调小只影响选择窗口里的历史回看，有用内容在历史文本窗口里都有。

最大允许输出文本长度（同上） 游戏 Skip 或翻历史文本时会瞬间灌入大批文本，设一个与正常句长相当的上限即可过滤。副作用：设得过小会截断游戏里的长台词。

图像一致性阈值（docs/zh/ocrparam.md，OCR 设置） 识别频率过快就调大、反应迟钝就调小。若游戏背景完全静态，"图像稳定性阈值"可直接设为 0；有动态背景或 Live2D 则保持默认并配合一致性阈值微调。

OCR 模型与线程（src/LunaTranslator/defaultconfig/ocrsetting.json） 默认PP-OCRv5_mobile、4 线程、CPU 运行，精度与性能的平衡点；有独立显卡时可开启 GPU 项换取更低识别延迟，代价是占用显卡资源。

🩺 排障速查：遇到 X 就做 Y

症状：三种捕获方式都拿不到文本依次检查：① 游戏与软件的运行权限是否一致 ② 是否已更新到最新版本 ③ 切窗口模式再试 ④ 确认引擎类型，自绘引擎直接转 OCR 模式。

症状：原文能出，但翻译窗口卡顿依次检查：① 把最大缓存文本长度降到 1000 ② 缩短历史文本的保存量 ③ 关闭窗口特效和动画。

症状：翻译结果错乱或术语不统一依次检查：① 确认源语言识别正确 ② 换一个翻译引擎对比 ③ 用专有名词翻译功能固定关键术语。

📚 延伸阅读与社区入口

• docs/zh/basicuse.md：三种捕获方式的逐步演示，装完软件第一份该读的文档。
• docs/zh/hooksettings.md：HOOK 参数详解与特殊码格式，想给特定游戏定制捕获方案时再看。
• docs/zh/ocrparam.md：OCR 三种自动执行方法与阈值原理，觉得识别频率不对劲时对照着调。
• docs/zh/guochandamoxing.md：大模型翻译接口配置，想换模型、调 prompt 或加上下文时查这里。
• src/LunaTranslator/defaultconfig/：全部默认配置的 JSON 样例，找某个参数对应的字段名时翻这里最方便。

社区渠道：

• 视频教程与用户群入口，见 docs/zh/README.md 的"联系作者"一节。
• 遇到不支持的游戏，按文档指引向作者提交 issue，可获得针对该游戏的适配支持。

🏁 收束

现在你可以用 HOOK 模式接上自己的游戏跑通第一次翻译。打开选择游戏进程窗口，挑一款你想玩的视觉小说，选中文本行。

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