视觉小说翻译器：HOOK、OCR与剪贴板的完整上手指南
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
游戏文本刚在屏幕上显示，中文翻译已经跟在后面——这就是 LunaTranslator（视觉小说翻译器）做的事。它通过 HOOK 读内存、OCR 截屏识别、剪贴板监听三条通道拿到游戏文本，再接上数十种翻译引擎，让你玩日语、英语等外语游戏时像看原生字幕一样流畅。
🎮 LunaTranslator 是什么：三条取文本的通道，一套翻译引擎
它和"复制再翻译"的思路不同：翻译软件常驻在后台，主动从游戏里把文本"接"出来，再送去翻译、显示或写回游戏窗口。
HOOK 模式：读内存是主力通道
软件会向游戏进程注入一个钩子模块，直接拦截游戏绘制文字时调用的函数，文本几乎零延迟到手。对绝大多数视觉小说引擎（RPG Maker、Ren'Py、吉里吉里等）都有效，docs/zh/basicuse.md 里有具体操作。
OCR 模式：HOOK 失效时的兜底
当游戏是反编译壳、特殊渲染或防注入导致 HOOK 失败时，改用 OCR：框定字幕区域后自动截图、识别、翻译。适合老游戏、模拟器画面这类"只能看不能读"的场景。
剪贴板模式：最省事的入口
只想偶尔翻一段文本？开启剪贴板监听后，你在任何地方按 Ctrl+C，LunaTranslator 会自动识别内容并给出翻译，适合查攻略、读小说时随手使用。
内嵌翻译：把中文字幕写回游戏
部分游戏不仅能在旁边显示译文，还能直接把中文嵌入游戏对话框里，实现沉浸式的"中文原版"体验，具体见 docs/zh/embedtranslate.md。
三条通道拿到文本后，都交给同一套引擎池，所以下一环节就是先把它跑起来。
🚀 从克隆到启动：三步完成首次运行
获取代码
把仓库拉到本地：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator选择启动方式
更省事的方式是直接下载官方发布的整包版本，解压即用，安装说明在 docs/zh/README.md。如果就想从源码跑，打开src/目录，双击run.bat即可启动主程序（需要本机装有 Python 环境）。
记住两个目录约定
你的所有设置都存在安装目录下的userconfig文件夹里，更新或重装时千万别删它，否则配置全部丢失。另外别把软件放进C:\Program Files这类受保护路径，否则可能无法写入配置。
🎯 第一次 HOOK 翻译：选进程、选文本行
最快路径：把游戏拖进软件
启动 LunaTranslator 后，直接把游戏的 exe 图标拖到软件窗口里松手，游戏会被自动启动并完成注入，比手动选进程省一步。
手动选择游戏进程
如果游戏已经在运行，点击界面上的"选择游戏进程"按钮，在弹出的进程列表里找到对应条目并确认。随后会弹出"选择文本"窗口。
让游戏显示几句台词，再选对文本行
让游戏往前推进几行对话，选择文本窗口里会列出若干候选文本行。挑出那条真正对应游戏字幕的行，点"显示"，翻译就开始了。选错行只是翻出了乱码或提示语，换一行即可。
打开内嵌翻译
如果该游戏支持内嵌，选择文本窗口中会出现"内嵌"按钮。开启后中文字幕直接出现在游戏对话框内，效果最接近原生汉化。
第一次翻译顺利后，剩下的多数问题都出在个别游戏上，这时就轮到 OCR 出场了。
🖼 OCR 模式：HOOK 不灵时的替代方案
框定识别区域
切到 OCR 模式，用区域选择工具在游戏窗口上框出字幕所在的矩形。区域越大识别越慢，贴紧文字边缘效果最好。
挑选合适的 OCR 引擎
引擎列表在src/LunaTranslator/ocrengines/对应设置页里，涵盖本地模型和多家在线服务：本地 Tesseract 离线免费，在线引擎通常更准但有流量成本。日语识别建议优先用内置本地模型，参数说明见 docs/zh/ocrparam.md。
分清"持续识别"和"识别一次"
界面上有两个图标相近的按钮：一个是设置持续识别区域，另一个只做一次性识别。想要自动跟翻就选前者，误用后者会导致识别只跑一次就停止。
OCR 解决的是"文本从哪来"，而"翻得好不好"取决于引擎选择，这也是拉开体验差距的关键。
⚙️ 翻译引擎与进阶玩法
引擎怎么挑
引擎配置集中在 docs/zh/guochandamoxing.md，覆盖百度、谷歌、DeepL、阿里、微软等主流接口。日常游玩建议配一个稳定主力加一个备用：主力接口被限流时自动切换，翻译不中断。
本地大模型离线翻译
不想把剧情发到云端？软件支持 llama.cpp 等本地推理方案，在机器性能允许的情况下实现完全离线、隐私安全的翻译。
顺带把日语学了
开启分词与假名注音后，原文会带上读音和词性高亮，方便直接记生词；词典词条还能通过 AnkiConnect 同步进 Anki 卡组，玩法详见 docs/zh/ankisync.md。语音合成引擎列表在 docs/zh/ttsengines.md，让翻译结果读给你听。
🛠 卡住了怎么办：三类高频故障的排查路径
杀毒软件误报，组件被隔离
HOOK 需要往游戏里注入 DLL，这一步天然容易被查杀。出现"找不到重要组件 / Missing embedded Python3"或注入卡住时，把整个软件目录加入杀毒白名单，再重新解压一份，详见 docs/zh/README.md 的常见错误章节。
游戏需要管理员权限
部分以管理员身份运行的游戏无法被普通权限进程注入。用管理员权限启动LunaTranslator_admin.exe再试，平时则用普通模式即可。
文本只出一两个字或刷新太慢
去"HOOK 设置"调"刷新延迟"：文本被截成碎片就调高延迟，识别太慢则适当调低，具体解释见 docs/zh/hooksettings.md。文本反复刷屏时可缩短"最大缓冲区长度"。
跑通一个游戏只是开始——模拟器 HOOK、API 服务化、Yomitan 联动这些方向都写在 docs/zh/ 下，遇到具体游戏没识别出文本时，先看 docs/zh/qa1.md 里的支持流程，再按上面三条路径逐层排查，绝大多数问题都能闭环。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
