企业官网建设流程全解析

LunaTranslator完整指南：本地实时翻译日文视觉小说，从下载到出译文三步跑通

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

LunaTranslator 是一款完全开源免费的视觉小说翻译工具：自动取出游戏画面中的日文文本，译成中文后内嵌回原对话框或悬浮窗展示。不会读假名的玩家，也能直接读原版日系 Galgame。

先花30秒自检：你在哪条赛道

• 如果你不认识假名、想马上开玩日文 Galgame→ 从第 2 部分"首次跑通清单"开始。
• 如果你软件已跑通，但翻译慢、乱码、取不到词→ 直接跳到第 5 部分"避坑指南"。
• 如果你想搭建长期工作流（人名统一、本地模型离线推理）→ 看第 6 部分"进阶提效"。

首次跑通清单：五步翻出第一句对话

照做即可完成首次翻译，全程无需打开任何其他设置：

• 下载并解压：获取发布版解压到任意目录。别放进C:\Program Files这类受保护路径，否则配置和缓存都存不了，甚至无法运行。
• （可选）克隆源码：想在终端里看代码就执行git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator。
• 首启向导：运行主程序，按向导选界面语言（内置简体中文等 20 余种）和默认翻译方向，例如"日语→简体中文"。
• 拖拽游戏启动：把游戏 exe 直接拖进主窗口 → 自动转区启动、注入并弹出文本选择窗口。拖拽启动是官方推荐开场方式，连"以管理员身份运行"这类坑都一并绕开。
• 勾选文本开始翻译：让游戏显示几句对话，在候选列表勾选与画面一致的那条 → 翻译立即开始。条目上有"显示"按钮就点一下确认悬浮窗生效；若出现"内嵌"列，说明该游戏支持内嵌替换原文。

完整流程可对照 docs/zh/basicuse.md，哪步卡住翻哪段。

原理一图流：取词、翻译、显示三环节流水线

你正在玩一部游戏，主角即将推开大门，对话框突然蹦出一长串平假名——此刻 LunaTranslator 在做三件事：先从游戏里取出日文原文（HOOK 内存读取、OCR 截图或剪贴板），再交给你配置的翻译引擎处理，最后把中文写回悬浮窗，或直接嵌回游戏对话框。三个环节互相独立、随时可换，这是它几乎覆盖所有游戏类型的根本原因。

路线决策：三个 If 帮你选对路

• 如果游戏能正常注入（大多数情况）→ 选 HOOK + 内嵌翻译。原文出现的同时译文就位，延迟最低，原文被直接替换，相当于把游戏当场汉化。
• 如果 HOOK 失败、候选文本出不来→ 切 OCR 并框选对话区域；动态背景多的话打开图像稳定性检测防止误识别，参数说明见 docs/zh/ocrparam.md。
• 如果断网游或不愿原文出机器→ 主引擎选本地大模型（Sakura 等），推理全在本机完成；在线时则用百度、腾讯这类免费额度友好的引擎打头阵，本地模型当备胎，单引擎故障不卡剧情。

避坑指南：三个高频症状三步解决

1. 候选文本列表空空如也，注入界面卡住

• 症状：选中游戏进程后始终不出候选行。
• 原因：没有管理员权限，DLL 无法注入游戏进程。
• 解法：改用管理员权限启动主程序，再到游戏设置里开启"额外的 Win32 通用钩子"；仍不行就先切 OCR 过渡。

2. OCR 结果缺字，同一句话反复重译

• 症状：识别结果时好时坏，翻译延迟被放大。
• 原因：识别区域框得太大，动态背景、阴影持续干扰识别。
• 解法：把区域缩到恰好包住文字，关闭游戏内动态阴影，开启图像稳定性检测并适当调低识别频率。

3. 译文全是方块乱码

• 症状：中文位置显示为 □□□。
• 原因：游戏字体缺中文字形，或字符集不匹配。
• 解法：激活"修改游戏字体"选一个中文字体；老游戏再叠加"汉字转繁体/日式汉字"转换，细节见 docs/zh/embedtranslate.md。

进阶提效：三个小动作去掉机翻腔

• 把角色名、地名加进专有名词词典→ 翻译时自动替换为固定译名，同一个人名从此不再两种写法。
• 写几条正则修正规则→ 批量修正常见误译，比如把"仆"统一成"我"，语法见 docs/zh/transoptimi.md。
• 每个游戏存一套独立配置→ 切换游戏自动加载，重开档回档，术语与引擎设置互不串台。

行动收尾：今天就能做完的 3 件事

1. 挑一部喜欢的游戏拖进软件，用 HOOK 翻出第一句对话。
2. 用 OCR 框一个对话区，验证注入失败的游戏也能出词。
3. 把剧情里的 3~5 个人名加进专有名词词典。

当那句日语在屏幕里变成中文，故事就完全属于你了——去把它读完吧。

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