Manga Translator UI 命令行使用指南批量翻译与自动化脚本完整参数清单【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-uiManga 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模式用途典型场景local本地图片/文件夹批量翻译日常批量处理、自动化脚本webHTTP API Web 界面服务器浏览器远程使用、REST API 集成ws内部 WebSocket 后端作为 Web 服务器的翻译实例shared内部 Shared/API 实例多实例部署# 查看顶层帮助 / 某个模式的完整参数 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输入方式输出规则-i manga.jpgmanga-translated.jpg同目录-i ./manga_folder/./manga_folder-translated/新文件夹保持目录结构-i ./raw/ -o ./translated/结果全部写入./translated/批量细节文件夹输入会递归扫描所有子文件夹并自动跳过manga_translator_work工作目录多张-i可以同时给出混合文件与文件夹时按自然排序处理file2排在file10前未开启覆盖时输出文件已存在的图片会自动跳过——这正是断点续传的实现方式任务中断后重跑同一条命令即可无需任何额外参数。# 批量 指定输出目录 覆盖旧结果 python -m manga_translator local -i ./raw/ -o ./translated/ --overwrite四、核心参数完整清单 ⚙️local模式的全部命令行参数如下未显式传入的参数一律沿用配置文件中的值参数说明默认值-i,--input输入图片或文件夹可多个必填—-o,--output输出目录自动推导--config指定本次运行的配置文件路径config/config.json-v,--verbose输出详细 DEBUG 日志关闭--overwrite覆盖已存在的输出文件关闭--use-gpu启用 GPU 加速配置文件--disable-onnx-gpu禁用 ONNX Runtime GPU 加速配置文件--format输出格式png/jpg/jpeg/jfif/webp/avif/bmp/tiff/tif/heic/heif配置文件--batch-size批量处理大小一次送入流水线的图片数配置文件--attempts翻译失败重试次数-1 无限重试配置文件--subprocess启用子进程模式内存管理关闭--memory-limit子进程内存上限MB超限自动重启子进程0不限制--memory-percent系统内存使用率上限%超限自动重启0不限制--batch-per-restart每处理 N 张后重启子进程释放内存0不限制这些参数与图形界面「参数设置」页的一一对应关系如重试次数、批量大小、并发批处理等可在 doc/SETTINGS.md 中查到逐项说明参数覆盖优先级从高到低显式传入的命令行参数只覆盖当次运行不回写配置文件--config指定的配置文件 用户config/config.json 发行模板 config/config-example.json代码内置默认值# 一次翻译临时切换整套配置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 端点」一节端点说明POST /translate/with-form/image/stream单图翻译表单上传流式返回进度适合脚本POST /translate/batch/images批量翻译直接返回 ZIP 压缩包POST /translate/export/original仅检测 OCR导出原文供人工校对POST /translate/import/txt导入人工译文并渲染/docsSwagger API 文档批量端点接收 JSON 请求图片 base64 编码配合config.translator.attempts与服务器级--retry-attempts可实现稳定的无人值守批量翻译。七、进阶工作流导出原文、可编辑与重渲染除完整翻译外配置文件中cli组还可切换多种工作流模式CLI 无对应开关需修改 config/config-example.json 的cli段配置键工作流用途save_text图片可编辑额外保存工程 JSON之后可在桌面编辑器中继续修改templatesave_text导出原文只跑检测 OCR按模板导出原文generate_and_export导出翻译翻译后导出译文模板文件load_text导入翻译并渲染从 JSON/TXT 加载译文直接重渲染upscale_only/colorize_only/inpaint_only仅超分 / 仅上色 / 仅修复单步骤图像处理replace_translation替换翻译模式将译文直接粘贴到原文位置典型「人机协作」流水线导出原文 → 人工校对 → 导入翻译 → 重渲染。翻译完成后还可打开自带的可视化编辑器逐框精修文字样式、蒙版与排版八、调试与常见问题 ️查看详细日志加-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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考