企业官网建设流程全解析

Manga Translator UI 命令行使用指南：批量翻译与自动化脚本完整参数清单

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui

Manga Translator UI 是一款基于 manga-image-translator 的开源漫画 AI 翻译工具，除图形界面外，它还提供功能完整的命令行模式：一条命令即可完成 OCR 文字检测、原文擦除、AI 翻译、图像修复与译文排版的完整链路。本文面向新手与脚本使用者，系统整理 Manga Translator UI 命令行的批量翻译用法、四种运行模式与全部关键参数，帮你快速搭起自动化漫画翻译流程 📚

一、命令行快速开始：第一条批量翻译命令

在项目根目录激活运行环境后，只需一条命令就能翻译单张图片或整个文件夹：

# 激活环境（Windows 为 conda activate manga-env） source .venv/bin/activate # 翻译单张图片（自动读取 config/config.json 配置） python -m manga_translator local -i manga.jpg # 批量翻译整个文件夹（递归处理子文件夹） python -m manga_translator local -i ./manga_folder/ # 简写：省略模式名，默认走 Local 模式 python -m manga_translator -i page1.jpg page2.jpg page3.jpg -o ./output/

命令会自动完成：加载配置文件 → 文本检测 → OCR 识别 → 机器翻译 → 原文擦除修复 → 译文渲染，最后输出到同目录（文件名自动加-translated后缀），开箱即用 ✅

二、命令结构：四种运行模式一览

Manga Translator UI 的正式入口只有一个：python -m manga_translator <mode> [options]，顶层共注册 4 个模式（参数定义见 manga_translator/args.py）：

# 查看顶层帮助 / 某个模式的完整参数 python -m manga_translator --help python -m manga_translator local --help

💡 新手只需掌握local与web两个模式，ws/shared属于内部部署组件。

三、批量翻译：输入与输出规则

支持的输入格式：.png、.jpg、.jpeg、.jfif、.webp、.avif、.bmp、.tiff、.tif、.heic、.heif

批量细节：

• 文件夹输入会递归扫描所有子文件夹，并自动跳过manga_translator_work工作目录；
• 多张-i可以同时给出，混合文件与文件夹时按自然排序处理（file2排在file10前）；
• 未开启覆盖时，输出文件已存在的图片会自动跳过——这正是断点续传的实现方式：任务中断后重跑同一条命令即可，无需任何额外参数。

# 批量 + 指定输出目录 + 覆盖旧结果 python -m manga_translator local -i ./raw/ -o ./translated/ --overwrite

四、核心参数完整清单 ⚙️

local模式的全部命令行参数如下（未显式传入的参数一律沿用配置文件中的值）：

这些参数与图形界面「参数设置」页的一一对应关系（如重试次数、批量大小、并发批处理等）可在 doc/SETTINGS.md 中查到逐项说明：

参数覆盖优先级（从高到低）：

1. 显式传入的命令行参数（只覆盖当次运行，不回写配置文件）
2. --config指定的配置文件 > 用户config/config.json> 发行模板 config/config-example.json
3. 代码内置默认值

# 一次翻译临时切换整套配置（GPU + 输出 PNG + 无限重试） python -m manga_translator local -i ./raw/ --config my_config.json \ --use-gpu --format png --attempts -1

五、大批量翻译内存管理：子进程模式

一次性翻译上百张长图时，模型与中间结果会让内存持续增长。local的子进程模式让每批翻译在独立子进程中运行，达到阈值后自动重启、无缝续接，已完成的图片不会重复翻译（机制详见 doc/wiki/zh/cli/subprocess-memory-and-recovery.md）：

# 子进程内存超过 6GB 时自动重启 python -m manga_translator local -i ./manga_folder/ --subprocess --memory-limit 6000 # 系统内存使用率超过 80% 时自动重启 python -m manga_translator local -i ./manga_folder/ --subprocess --memory-percent 80 # 每处理 20 张强制重启一次，组合使用更稳妥 python -m manga_translator local -i ./manga_folder/ --subprocess \ --memory-limit 6000 --batch-per-restart 20 -v

⚠️ 子进程模式依赖psutil监控内存，需先pip install psutil。

六、自动化脚本实战：三个常用模板

1. Shell 脚本批量处理多卷漫画

#!/bin/bash # 遍历所有章节文件夹，逐卷批量翻译 for chapter in ./chapters/*/; do python -m manga_translator local -i "$chapter" \ --use-gpu --format jpg --overwrite done echo "全部章节处理完成 ✅"

2. 定时任务 / 断点续传

子任务中断后重跑同一条命令即可续传（默认跳过已存在的输出）；需要全部重译时再加--overwrite：

# 每天凌晨 2 点扫描 raw 目录批量翻译（crontab 示例） 0 2 * * * /path/to/venv/bin/python -m manga_translator local -i ./raw/ -o ./out/

3. Web 服务模式 + REST API 自动化

把 Manga Translator UI 作为常驻翻译服务启动，脚本通过 HTTP 接口调用，适合需要进度上报、批量 ZIP 下载的自动化流程：

python -m manga_translator web --host 0.0.0.0 --port 8000 --models-ttl 300 --retry-attempts 3

启动后常用端点（完整清单见 doc/CLI_USAGE.md 的「Web 模式 API 端点」一节）：

批量端点接收 JSON 请求（图片 base64 编码），配合config.translator.attempts与服务器级--retry-attempts可实现稳定的无人值守批量翻译。

七、进阶工作流：导出原文、可编辑与重渲染

除完整翻译外，配置文件中cli组还可切换多种工作流模式（CLI 无对应开关，需修改 config/config-example.json 的cli段）：

典型「人机协作」流水线：导出原文 → 人工校对 → 导入翻译 → 重渲染。翻译完成后还可打开自带的可视化编辑器逐框精修文字样式、蒙版与排版：

八、调试与常见问题 🛠️

• 查看详细日志：加-v，会在result/目录保存调试图bboxes.png（文本框）、mask_final.png（修复蒙版）、inpainted.png（修复底图），并生成log_<时间戳>.txt；
• 退出码：成功返回0，配置加载失败或未捕获异常返回1，方便脚本判断成败；
• 速度慢：开启--use-gpu、调小detector.detection_size（如 1536）、适当增大--batch-size；
• 只想提取文本不翻译：用web模式的/translate/json端点，跳过修复与渲染，速度最快。

九、延伸阅读

• 完整参数与工作流文档：doc/CLI_USAGE.md
• 命令行 Wiki 专题（命令结构 / 输入输出 / 配置覆盖 / 退出码）：doc/wiki/zh/cli/command-structure.md、doc/wiki/zh/cli/local-input-output.md、doc/wiki/zh/cli/configuration-overrides.md
• 桌面图形界面教程：doc/USAGE.md
• 安装与部署：doc/INSTALLATION.md、doc/wiki/en/install/docker.md
• 参数实现源码：manga_translator/args.py、manga_translator/mode/local.py

掌握以上内容后，无论是十几页的单卷翻译，还是数百张的整季批量自动化，Manga Translator UI 的命令行都能一条命令搞定。

【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理，集成OpenAl、Gemini等多翻译引擎；实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路，自带可视化编辑器，支持自定义文本样式，一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui