zip2epub 脚本用法

python zip2epub.py <输入路径> --author <作者...> [选项]

位置参数

参数	说明
input_path	输入单文件或目录（批量、不递归子目录）。--format archive 支持 ZIP / CBZ / RAR / CBR；--format epub 额外支持 .epub；--format pdf 仅支持 .pdf。

必填

选项	说明
--author	作者；多个名字用空格分隔，会写入多条 dc:creator。

单文件额外要求

选项	说明
--title	单文件转换时必填。批量（目录）时可省略，默认用各压缩包主文件名作书名。

可选参数

选项	说明
--format	输入类型：archive（默认，仅处理 .zip/.cbz/.rar/.cbr）、epub（额外允许 .epub，按 ZIP 取图重打包）或 pdf（仅 .pdf，按文件中图片顺序导出后打包 EPUB）。
-o, --output	单文件：输出 .epub 路径，或所在目录。 批量：必须是输出目录（默认与各压缩包同目录）。
--series	系列名；省略则与 --title 相同。
--volume	卷号基础值。默认 1：自动解析开启时作为后备值；关闭自动解析时，批量模式按文件名排序后从该值依次递增。
--auto-parse-volume / --no-auto-parse-volume	是否自动从文件名解析卷号（如 Vol_01、Vol.03、卷33、第12卷）。默认开启；关闭后按文件名排序并按 --volume 递增。
--split-wide	对宽幅双页图按 split_page 逻辑自动竖切。
--split-order	竖切后页序：right-left（默认，右半在前）或 left-right（左半在前）。
--rotate-landscape	横幅页（宽>高）用 CSS 旋转 90° 显示。
-q, --quiet	静默：不打印进度框与步骤；错误仍到 stderr；成功时输出路径仍到 stdout。
-j, --jobs	仅批量：并行线程数。0 = 自动（约 min(8, CPU)）；1 = 顺序并打出逐步日志。默认 0。

示例

# 单文件
python zip2epub.py comic.cbz --title "书名" --author "作者甲 作者乙" -o out.epub

# 目录批量（书名默认取自各文件名）
python zip2epub.py ./archives --author "作者" -o ./output_epubs

# 从 epub 里抽图重打包
python zip2epub.py book.epub --format epub --title "书名" --author "作者"

# 从 pdf 抽取原图并打包
python zip2epub.py comic.pdf --format pdf --title "书名" --author "作者"