manga-translator-ui 是什么?

manga-translator-ui 是基于 manga-image-translator 的 GPL-3.0 桌面与 Web 工具,完成文字检测、OCR、翻译、消字修复、排版和人工编辑。它既能使用本地 OCR/修复模型,也能把图片或文本发送到 OpenAI 兼容、Gemini、Vertex 等在线接口;隐私边界取决于所选工作流。

⭐ 2,141 Stars 🍴 98 Forks Python GPL-3.0 作者: hgmzhn
来源:github.com/hgmzhn/manga-translator-ui;https://github.com/hgmzhn/manga… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v3.0.4 于 2026-09-06 发布,发布说明标注实际发布日期为 2026-08-29,增加贴片图层并修复 AVIF、EPUB、蒙版与 API 错误分类。3.0 系列还加入系统代理、更多 API 管理和编辑流程。仓库约 2.1k stars;

来源:github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4;https://git…

核心功能

完整漫画翻译流水线

按检测、OCR、翻译、inpainting 和文字渲染处理单页或整个目录,也可只运行 OCR、翻译 JSON、修复、上色或放大。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/WORKFLOWS.md;h…
Qt 可视化编辑器

支持文本区域移动、旋转、形状与蒙版编辑、富文本、撤销重做、多选和贴片图层,自动结果可以继续人工修正。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/FEATURES.md;ht…
本地与在线后端混合

OCR 和修复有本地模型,也支持 OpenAI/Gemini 等多模态 OCR、翻译、上色和渲染;在线通道需要用户自己的 API 配置。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/FEATURES.md;ht…
桌面、CLI 与 Web/Docker

PyQt6 负责桌面编辑,manga_translator 模块提供 CLI 与 FastAPI server;官方文档给出 Windows 便携包、源码环境和 CPU/GPU Docker 镜像。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/INSTALLATION.m…

技术架构

输入图片先进入检测与 OCR,区域和文字写入中间 JSON;translator adapter 调用本地或在线翻译,inpainting 清除原文,renderer 按方向、气泡与字体规则回填。desktop_qt_ui 管理任务、配置和富文本编辑,manga_translator/server 暴露 FastAPI/WebSocket。模型、字体、prompt、API 通道和工程 JSON 分别存储,因此备份和泄露风险也不同。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/DEVELOPMENT.md…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) CPU、NVIDIA CUDA 与部分 Windows AMD ROCm 路线,具体组合由安装器选择CPU、NVIDIA CU… 本地模型首次下载占用磁盘;paddleocr_vl、FLUX.2 Klein 和高质量 upscaler 需要更多资源本地模型首次下载… 在线翻译/OCR/渲染需要相应 API key,并可能按图片或 token 计费在线翻译/OCR/渲… 完整漫画翻译流水线 Qt 可视化编辑器 本地与在线后端混合 桌面、CLI 与 Web/Docker桌面、CLI 与 Web/Doc… manga-translator-ui 项目本体 核心功能 关键依赖

技术栈

语言Python,PyQt6 桌面 UI,FastAPI/Starlette Web server框架manga-image-translator pipeline、PyTorch OCR/检测/修复模型、多 translator adapters
CPU、NVIDIA CUDA 与部分 Windows AMD ROCm…本地模型首次下载占用磁盘;paddleocr_vl、FLUX.2 Kle…在线翻译/OCR/渲染需要相应 API key,并可能按图片或 toke…
桌面本地运行或 Docker 端口 8000;Web UI 保存 API key 时需持久化 /app/.env;GPL-3.0
来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/INSTALLATION.m…

快速上手

固定 v3.0.4,优先下载官方 Windows release 或在隔离目录审阅安装脚本后建立源码环境。第一次使用公开测试页,选择本地 48px+mocr 或其他本地 OCR、Original/None translator,先验证检测、消字和排版,不填 API key。需要在线翻译时再添加单独、限额的 key,确认 base URL 与模型支持图片,设置明确输出目录并关闭详细日志中的敏感素材。
来源:github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4;https://git…

使用场景

适合有合法素材、需要批量 OCR/翻译后继续精修气泡、文字和蒙版的人,也适合把 JSON/PSD 交给校对与排版流程。它不替用户解决漫画版权、翻译授权和在线模型的数据政策;只要选择在线 OCR、翻译、上色或渲染,页面内容就可能发送到相应服务。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/FEATURES.md;ht…

优势与局限

优势

  • 从检测到排版的完整流水线与可视化精修在同一个应用中
  • 本地和在线 OCR/翻译后端可以按质量、隐私与费用切换
  • 支持目录批处理、JSON/TXT、PSD、CLI、Web 和 Docker
  • v3.0.4 对贴片、EPUB、AVIF、蒙版和错误提示做了具体修复

局限

  • 自动 OCR、翻译、消字和断行都会出错,批量输出仍需逐页抽检并保留原图
  • 高质量在线模式会上传图片上下文,API 费用和保留政策由相应 provider 决定
  • API key 与 preset 属于敏感配置;Docker Web UI 若要持久化 key 会绑定 /app/.env,不能把该文件提交到仓库
  • Web server 映射 8000 端口后会扩大访问面,应只绑定可信接口并在反向代理层加认证
  • 安装/更新脚本和便携包会下载大量依赖与模型,生产环境应先审阅脚本、固定 release 并保留哈希
  • README 有自愿打赏入口和友情链接,但没有订阅、credits、付费功能解锁或转售漏斗
来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/INSTALLATION.m…

最新版本

最新稳定版是 v3.0.4。GitHub 于 2026-09-06 发布该 release,正文标记版本日期 2026-08-29;主要增加编辑器贴片图层,并修复 AVIF/EPUB、字体刷新、蒙版、翻译 dispatch 与在线组件错误分类。

来源:github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4

实测与证据

status: docs_and_source_checked_not_executed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、v3.0.4 release、英文安装/功能/使用/设置/CLI/工作流/开发文档、gitignore、GPL-3.0 许可证和上游 manga-image-translator;未下载便携包、模型或容器。  |  limitations: 没有验证 release 哈希、安装脚本、GPU/ROCm、模型下载、API key 存储、翻译质量、PSD/EPUB、Web 认证、代理行为、资源占用或费用。  |  observed_output: 官方把 v3.0.4 标为 latest,GitHub 发布于 2026-09-06,说明正文写实际发布日期 2026-08-29。文档列出 9 种工作流、Qt 编辑器、本地/在线 OCR 与 Docker 端口 8000。

来源:github.com/hgmzhn/manga-translator-ui/releases/tag/v3.0.4;https://git…

同类项目对比

相比上游 manga-image-translator,manga-translator-ui 继续使用相同类型的检测、OCR、翻译、修复与渲染流水线,但增加 PyQt6 富文本编辑、API 管理、工程文件、贴片、多种导入导出和桌面安装体验;上游项目更偏 CLI/Web 推理核心与服务器接口。需要人工逐页修稿时选 UI;要嵌入自己的服务、减少桌面依赖时先评估上游。

来源:github.com/hgmzhn/manga-translator-ui;https://github.com/zyddnys/mang…

总结评价

manga-translator-ui 可保留,项目没有严重商业漏斗;API 花费来自用户选择的外部模型。推荐先用公开页面和全本地路径验证 v3.0.4,再按功能逐个启用在线 OCR/翻译。任何批处理都应保留原图、中间 JSON、配置和少量人工抽检记录。

来源:github.com/hgmzhn/manga-translator-ui/blob/main/doc/en/USAGE.md;https…

常见问题

manga-translator-ui 可以完全离线使用吗?

检测、部分 OCR、消字和排版可用本地模型,但首次安装或下载模型仍可能联网。选择 OpenAI、Gemini、Vertex、在线 OCR、AI 上色或渲染后,文字或图片会发送到对应服务。

第一次应该选哪种 OCR 和翻译器?

先用公开测试页和本地 OCR,例如官方建议的 48px+mocr 日漫组合;translator 选 Original 或 None 验证检测、消字与排版。路径正常后,再为在线翻译配置限额 key。

Docker 里的 API key 怎么保存?

官方文档说明,若要让 Web UI 保存的 server API key 持久化,需要把主机上的空文件绑定到 /app/.env。该文件含敏感信息,应限制权限、备份加密并加入版本控制忽略。

翻译结果可以直接发布吗?

不建议跳过校对。应检查漏框、OCR 错字、术语、气泡内断行、消字边缘和未编辑区域,并确认你对原漫画、字体和译文拥有相应使用或发布权限。

v3.0.4 的发布日期为什么有两个?

GitHub 页面显示 release 于 2026-09-06 发布,release 正文写版本发布日期为 2026-08-29。两项都应保留,避免把说明中的版本日期误写成 GitHub 发布时间。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件