RSTGameTranslation 漫画模式教程:4步实现日文竖排漫画实时翻译
RSTGameTranslation 漫画模式教程:4步实现日文竖排漫画实时翻译
RSTGameTranslation 是一款面向 Windows 的开源游戏实时翻译工具,通过 OCR 屏幕识别 + AI 翻译,把游戏界面文字"擦除并重绘"为译文。它内置的**漫画模式(Manga Mode)**专门针对漫画与漫画书场景:自动识别对话气泡、按日语竖排从右向左的阅读顺序读取文字、跳过假名注音(furigana),整页一次翻译且每个气泡的译文互不串线。本教程将带你用 4 步快速上手,把日文竖排漫画实时翻译成中文。
📌 漫画模式能解决什么问题
普通 OCR 按"从上到下、从左到右"扫读文字,直接用在漫画上会踩中三个坑:
| 问题 | 漫画模式的处理方式 |
|---|---|
| 相邻气泡文字混在一起 | 先定位每个对话气泡,气泡内文字永不合并 |
| 日语竖排读错顺序 | 自动识别阅读方向,竖排从右向左逐列读取 |
| 假名注音混进正文 | 自动过滤紧贴汉字的小字号注音行 |
官方中文界面里,该功能的说明是:按对话气泡分组文字(日语为竖排列,其他为横排行),并在一次请求中分别翻译每个气泡,详见 app/Languages/zh_cn.json。
🚀 漫画模式 4 步快速上手
前提:Windows 10/11,漫画阅读器建议以窗口模式运行;识别引擎需使用 OneOCR。
第 1 步:选择 OneOCR 并开启 Manga Mode
打开 设置 → OCR/Screen Selection,把识别引擎切换为 OneOCR,然后勾选 Manga Mode 复选框(该控件位于 src/SettingsWindow.xaml,开关状态由 src/ConfigManager.cs 持久化保存)。
第 2 步:设置源语言与目标语言
进入 设置 → Language:
- 源语言:日文竖排漫画选 Japanese;英文漫画选 English(漫画模式同样支持横排语言)
- 目标语言:选你阅读的语言,如 Chinese
⚠️ 源语言必须选对——气泡分组与竖排识别都依赖这个设置。
第 3 步:框选漫画页面
两种方式任选其一:
- 固定区域:按
Alt+Q,用鼠标把整页漫画框选起来 - 跟随窗口:点击 Select Application,选择漫画阅读器窗口(阅读器移动时区域自动跟随)
第 4 步:显示覆盖层并开始翻译
| 热键 | 作用 |
|---|---|
Alt+F |
显示 / 隐藏翻译覆盖层(Overlay) |
Alt+G |
开始 / 停止翻译 |
Alt+C |
打开 ChatBox(列表形式查看译文,翻页长条页面时更清晰) |
启动后整页会被一次性送出翻译,每个气泡各自保留独立译文,翻页后自动重新识别。
⚙️ 漫画模式背后的原理(了解即可)
如果你想弄清"为什么它不会把气泡读串",可以看这几处核心实现:
- 气泡检测与阅读方向判断:src/BlockDetectionManager.cs 会统计文字块偏左还是偏右,据此判定整页是右起(RTL)还是左起(LTR)阅读方向,并自动把段落合并进所属气泡。
- 假名过滤:src/BlockDetectionManager.cs 的
RemoveFurigana会剔除纯假名、且字号约为旁边正文一半的注音行,避免"汉字+注音"被重复翻译。 - 整页批量请求:src/Logic.cs 中定义了漫画模式的批量策略——不超过 15 个气泡的页面一次请求发完;大页面则每 10 个气泡一批,最多 3 路并发,兼顾速度与上下文完整。
这种"检测 → 排序 → 整页请求"的设计,正是漫画模式区别于逐行 OCR 的关键。
❓ 常见问题排查(Troubleshooting)
不同气泡的文字混在一起了? 开启 Manga Mode(依赖 OneOCR)并确认源语言设置正确。气泡检测对白色或浅色底的对话框效果最好,深色气泡可尝试在 src/SettingsWindow.xaml 中调整 OCR 相关参数。
翻译没出现在漫画上?
确认覆盖层已开启(Alt+F)、区域已框选(Alt+Q);阅读器是全屏独占模式时覆盖层无法显示,请改用窗口模式。
译文慢? 只框选漫画正文区域而不是整个屏幕;在线服务(Gemini、Groq)通常比本地模型更快。更多排查思路见 README.md 的 Troubleshooting 章节。
📂 关键文件索引
| 文件 | 说明 |
|---|---|
| src/BlockDetectionManager.cs | 气泡检测、竖排阅读顺序与段落合并 |
| src/Logic.cs | 漫画模式翻译调度与批量请求 |
| src/OneOCRManager.cs | OneOCR 识别引擎封装(漫画模式必选引擎) |
| README.md | 官方"Reading manga and comics"指南 |
| LICENSE.md | 开源许可协议 |
想获取源码或贡献代码,可克隆仓库:
git clone https://gitcode.com/gh_mirrors/rs/RSTGameTranslation
按照以上 4 步配置完成后,日文竖排漫画即可实现整页实时翻译:气泡不串字、竖排不读乱、注音自动忽略——开读吧!📖
