视觉小说看不懂原文，实时提取文本再翻译（LunaTranslator）

视觉小说里有不少作品只有日文原版，汉化组的覆盖范围有限。想读这类作品，玩家得自己把文本弄出来。麻烦在于游戏文本一般不在剪贴板里，位置也不固定：一部分躺在进程内存中，另一部分只以图像形式画在画面上。

LunaTranslator 是视觉小说翻译器，用 C++ 和 Python 写成。它从运行中的游戏进程提取文本，或对屏幕做 OCR，把译文显示在悬浮翻译框里，供看不懂原版语言的玩家使用。

提取文本有两条路。HOOK 直接读游戏进程里的内容，拿到的文字干净，README 把它列为主要方式；OCR 对画面做文字识别，适合没有 HOOK 条件、或者跑在模拟器里的游戏。翻译环节接的是各家翻译引擎，涵盖大语言模型翻译与离线翻译。项目以 GPL-3.0 许可开源，仓库地址是 https://github.com/HIllya51/LunaTranslator，当前 13650 Star、1170 Fork，最近一次提交在 2026 年 10 月。

装它需要什么

• Windows 系统。仓库里报告的运行环境基本是 Windows 10、Windows 11 的 64 位版本。
• 游戏本体。项目做的是运行时翻译，被翻译的游戏得先跑起来。
• 翻译服务凭据。用在线引擎或大语言模型翻译时要填对应服务商的信息，README 只列出支持的引擎，没有写申请流程。
• 从源码构建需要 C++ 与 Python 环境，仓库里有 CMake 构建文件（占代码量 0.6%）。README 没有给出编译命令。

跑起来

README 没有逐步操作说明，细节都指向官方文档站。按它列出的功能结构，最短一条路径大致是：

1. 从文档站取发布包，README 在标题旁挂了「软件下载 & 常见问题」入口，指向 docs.lunatranslator.org。
2. 启动程序，进入设置。
3. 启动游戏，在设置里把它选为提取目标。
4. 选文本来源，用 HOOK 还是 OCR。
5. 选一个翻译引擎，填入对应凭据。
6. 让游戏推进到有对话的位置，看翻译框是否出译文。

输出是什么

译文落在悬浮的翻译框里，随游戏对话刷新。Issue 里提到过用 Magpie 缩放时点击翻译框会让缩放退出，说明这个框是独立窗口，可以用鼠标点到，也能挪位置。部分游戏支持把译文直接嵌进游戏画面，README 把这列为「内嵌翻译」。

语言学习方向还有另一类输出：日语分词与假名注音，以及对接 AnkiConnect 和 Yomitan 插件。判断这次是否跑通，看翻译框有没有随新对话出现中文即可。至于模拟器场景，README 说 NS、PSP、PSV、PS2 上的大部分游戏支持用 HOOK 模拟器直接读文本。

先说它做不到什么

面向使用者的发布方式是预编译版本，README 没有从源码构建的步骤，自己编译要自己摸 CMake 和 Python 那套依赖。

HOOK 的效果取决于具体游戏，内嵌翻译也只支持部分作品。Issue 里记录过几类问题：HOOK 模式无法提取文字、第二次开启 HOOK 后闪退、点开设置没有反应、查词窗口白屏闪退。这些条目目前都标记为已解决，说明它们集中在特定版本与系统组合上。语音识别只在 Windows 10 和 Windows 11 上可用，走的是系统自带的语音识别。

提取游戏进程文本属于逆向手段，用途应限于自有资产或已获授权的游戏。把提取结果用于规避版权保护、打包分发受版权保护的文本，会触碰法律与平台规则。

适合玩日文原版视觉小说、想边玩边看译文的玩家，也适合借它做日语阅读练习、配合分词与 Anki 使用的人。想批量把游戏文本导出、再拿去做汉化补丁的用途，仓库没有说明这条路径。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.1 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。