Manga Translator UI跨平台部署Linux与macOS一键安装脚本详解【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-uiManga Translator UI 是一款开源漫画 AI 翻译桌面工具基于 manga-image-translator 实现覆盖 OCR 文字检测、原文擦除、AI 翻译、图像修复与译文排版的完整链路并自带可视化编辑器支持日、韩、英文漫画处理与 OpenAI、Gemini 等翻译引擎。在 Linux 与 macOS 上它提供了一套共享的一键安装脚本只需运行Unix-Install-or-Update.sh脚本会自动准备 Git、uv、Python 3.12 和虚拟环境随后进入双语维护菜单完成依赖安装日常启动则交给Unix-Start.sh。下面以新手视角完整讲解这两个脚本的工作流程与使用细节。部署前须知系统与硬件要求在开始安装前先确认你的机器满足基本条件可以少走弯路项目最低要求推荐配置操作系统Linux x86_64 / macOS 12.0macOS 12Apple Silicon内存8 GB RAM16 GB 或更多存储空间5 GB 可用空间10 GB SSDGPU无CPU 模式NVIDIA / AMD ROCm / Apple Metal几个要点Apple SiliconM 系列芯片自动使用 Metal/MPS 加速开箱即快Intel Mac脚本会以 CPU 模式运行功能完整但速度较慢NVIDIA 显卡维护菜单会按显卡型号与驱动自动选择 CUDA 版本一般无需手动干预首次安装约需下载 2 GB 依赖包耗时 10~20 分钟取决于网络速度。详细说明可参考官方安装指南 doc/INSTALLATION.md。一键安装步骤从下载到完成只需 3 条命令Linux 与 macOS 共用同一套脚本安装过程非常简单# 1. 创建干净的目录脚本拒绝在非空目录中克隆项目 mkdir manga-translator-ui cd manga-translator-ui # 2. 获得两个入口脚本从项目仓库获取后放入该目录 # 仓库地址https://gitcode.com/gh_mirrors/man/manga-translator-ui # 3. 赋予执行权限并运行 chmod x Unix-Install-or-Update.sh ./Unix-Install-or-Update.sh脚本启动后只会询问一次Start installation now? [Y/n]确认后即全自动执行。若想先了解代码再安装也可以手动克隆完整仓库后在仓库根目录运行同一脚本git clone https://gitcode.com/gh_mirrors/man/manga-translator-ui.git cd manga-translator-ui chmod x Unix-*.sh ./Unix-Install-or-Update.sh脚本会自动完成 5 件事安装脚本 Unix-Install-or-Update.sh 的源码中main函数按顺序执行以下步骤每一步失败都会打印清晰的错误位置并停止检查平台确认是 Linux x86_64 或 macOSIntel/ARM 均可不支持的系统会直接报错退出确保 Git 可用Linux 下自动调用 apt/dnf/pacman/apk 安装macOS 下通过 Homebrew 或 Xcode Command Line Tools 安装克隆项目代码若目录中已有完整项目则跳过若目录非空且不是本项目脚本会拒绝操作避免误覆盖你的文件准备 Python 环境自动安装 uv 包管理器通过 uv 下载受管的 Python 3.12并在项目下创建.venv虚拟环境已有但版本不符时会自动重建;进入双语维护菜单最后exec切换执行 packaging/launch.py 的--maintenance模式由菜单负责选择cpu、cuda13.0、cuda12.6、rocm7.2.1或metal依赖组并完成依赖安装。 整个过程不需要你手动安装 Python也不会污染系统环境——所有依赖都隔离在项目本地的.venv中。启动程序Unix-Start.sh 的作用安装完成后日常启动只需要一条命令./Unix-Start.sh启动脚本 Unix-Start.sh 的逻辑很直观先检查项目文件是否完整缺失时会提示先运行安装脚本优先使用.venv中的 Python 启动图形界面入口desktop_qt_ui/main.py兼容旧版本若你曾使用 conda 环境manga-env安装过且.venv不存在脚本会自动回退到旧环境启动无需重装。程序启动后如果安装时选择了CPU 版本请记得进入参数设置 → 通用取消勾选使用 GPU否则可能导致程序崩溃。高级选项环境变量与自动化部署两个脚本都支持若干环境变量方便在服务器、CI 或批量部署场景中无人值守运行环境变量作用示例MANGAT_AUTO_CONFIRM设为1跳过所有确认提示MANGAT_AUTO_CONFIRM1 ./Unix-Install-or-Update.shMANGAT_REPO_URL自定义代码源地址配合克隆流程MANGAT_REPO_URLhttps://gitcode.com/gh_mirrors/man/manga-translator-ui.gitMANGAT_UV指定 uv 可执行文件路径MANGAT_UV/usr/local/bin/uvPYTHON_VERSION覆盖默认的 Python 3.12PYTHON_VERSION3.12MANGAT_DRY_RUN设为1时启动脚本只打印命令不实际运行MANGAT_DRY_RUN1 ./Unix-Start.sh典型的一键静默部署命令MANGAT_AUTO_CONFIRM1 MANGAT_REPO_URLhttps://gitcode.com/gh_mirrors/man/manga-translator-ui.git ./Unix-Install-or-Update.sh更新程序与常见问题速查更新到最新版本重新运行安装脚本在双语维护菜单中选择[2] 更新即可。更新只会补齐缺失的依赖不会重复下载已安装的包./Unix-Install-or-Update.sh # 进入菜单后选择 [2] 更新常见问题FAQQ: 脚本提示 Refusing to clone into a non-empty unrelated directory脚本拒绝在包含无关文件的目录中克隆项目。请新建一个空目录把两个脚本放进去再运行。Q: 安装到一半失败怎么办脚本采用set -Eeuo pipefail严格模式任何一步出错都会显示具体出错行号与退出码并提示修复上方问题后重新运行本脚本。由于已完成的步骤都有幂等检查直接重跑即可续装不需要清理。Q: 非 x86_64 的 Linux 架构如 ARM 服务器能装吗脚本会提示内置 Linux wheel 未覆盖该架构并询问是否继续可以试试但兼容性不保证建议优先在 x86_64 机器上部署。Q: 如何卸载删除项目目录即可.venv虚拟环境也随之消失卸载指引另见 doc/UNINSTALL.md。写在最后Manga Translator UI 的 Linux/macOS 部署把繁琐的环境准备全部封装进了两个脚本一条命令装好 Git、uv、Python 与虚拟环境一条命令启动图形界面。无论你是 Mac 用户还是 Linux 桌面/服务器用户都可以按本文步骤快速搭建起完整的漫画 AI 翻译工作流。更多安装方式便携包、Docker与故障排除细节建议继续阅读 doc/INSTALLATION.md 与 doc/USAGE.md。【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
