视觉小说实时翻译器 LunaTranslator：HOOK 注入 3 步跑通日语台词翻译
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
开着日文视觉小说，一句台词要切出去复制、翻译、再切回来，剧情早就断片了。LunaTranslator 自动抓取游戏文本并实时翻译成中文，译文悬浮在屏幕边或直接嵌进游戏画面，全程不用离开游戏。
LunaTranslator 是干什么的，适合你吗
这是一款免费的 Windows 桌面翻译器，核心是把游戏里不断刷新的文字变成中文，同时兼顾剪贴板翻译、查词和朗读这类学习需求。日常打视觉小说、玩日系单机就适合用；如果你要批量翻译文档或做网页翻译，它不是合适的工具。
从下载到看到第一条译文的最短路径
- 拿到程序：大多数人下载官方 Windows 预编译包，解压到一个普通目录即可，别放
C:\Program Files这类系统路径；想用源码版就克隆仓库：
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator- 双击LunaTranslator.exe启动；若你的游戏要求管理员权限，改用LunaTranslator_admin.exe
- 源码版直接双击
src\run.bat，跳过打包步骤
此时屏幕上应出现主界面：顶部有HOOK、OCR、剪贴板等模式按钮，右侧是等待译文出现的文本区。界面就绪后，下一步就是把游戏接进来。
场景实操
把译文直接嵌进游戏画面
游戏支持内嵌时（选择文本窗口里该条目带“内嵌”一列），效果最沉浸：游戏里的日文对白被中文原地替换，不用再扫两个窗口。
- 先启动游戏，再切到HOOK模式
- 把游戏快捷方式直接拖进软件窗口，或在进程列表里选中游戏
- 注入成功后弹出「选择文本窗口」，让游戏显示几句台词，从候选行里挑与对白吻合的那条
- 对该条目点内嵌；若中文变方块字，勾选修改游戏字体并选一个中文字体
预期效果：对话框里的原文变成中文，软件窗口可不再关注。不是所有游戏都能内嵌，不支持的条目没有“内嵌”按钮。
HOOK 选不到文本行时改用 OCR 截图识别
老游戏或非标准引擎可能挂不进去，此时按截图识别走：软件按固定频率截图、认字、送翻译，不需要读内存。
- 切到OCR模式，框选台词所在区域（注意用持续识别的按钮，别点成只识别一次的）
- 拿不准参数就用「周期执行」策略，最省事
- 译文可以勾「原地显示」，直接盖在选框内，字号自动适配
预期效果：台词每次刷新，选框或悬浮窗里就出现对应中文。识别引擎默认用内置模型，也可在 src/LunaTranslator/ocrengines/ 列出的 Tesseract、Windows OCR、百度等里切换。
断网也能出译文的本地大模型方案
不想让文本经过在线接口时，内置的 LLaMA.cpp 引擎可以整机离线翻译。
- 在翻译设置里选本地引擎，指向一个 GGUF 模型文件
- 没有模型就用现成脚本拉取：
src/scripts/gethfmodels.py，按需执行 - 回到 HOOK 或 OCR 模式正常操作，选中的文本行照常被翻译
预期效果：关掉网络，译文照常出现，文字不出电脑 📴。
进阶与可选配置
- 抓到乱码或重复文本：开文本处理，过滤杂文本并修正错译，见 docs/zh/textprocess.md
- OCR 识别太频繁或太迟钝：调「图像一致性阈值」，详见 docs/zh/ocrparam.md
- 内嵌出现方块字：优先换字体，古早日文游戏可试「将汉字转换成繁体/日式汉字」
- 复制外文进剪贴板自动翻译，选中文案可查 JPDB、有道等词典释义
- 译文一键朗读，生词同步 Anki，日语支持分词并给汉字标注假名，词典引擎在 src/LunaTranslator/cishu/
遇到问题先查这几条
- 「选择文本窗口」一直空着 → 让游戏先显示几秒台词再刷新候选；仍不行就换一条候选行，或整条路径切到 OCR
- 游戏 HOOK 失败 → 游戏本身要管理员权限，改用LunaTranslator_admin.exe启动再注入
- 提示找不到重要组件 → 多半被杀软删了，把目录加入信任名单后重新下载解压
- OCR 频率忽快忽慢 → 按 docs/zh/ocrparam.md 说明微调「图像一致性阈值」，别一次动太大
- 内嵌后游戏直接闪退 → 内嵌有一定崩溃风险，先退回「显示」模式玩着，等有空再排查字体和字符集设置
打开你的第一部视觉小说，先跑通 HOOK 注入并选中那行台词，中文剧情马上就能接上。想继续深入：内嵌翻译看 docs/zh/embedtranslate.md，HOOK 细节看 src/NativeImpl/LunaHook/，基本用法图解见 docs/zh/basicuse.md。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
/sample_frac() 的加权抽样、分组行为与错误信息链)
