manhuagui-cli

快速开始

注意：默认下载速度较为保守，调高并发数或降低延迟可能导致 IP 被服务器封禁几个小时，请谨慎调整。

npm install -g manhuagui-cli

manhuagui-cli

不带参数运行，工具会逐步引导你完成操作。流程：输入漫画 URL -> 解析漫画信息 -> 选择章节组（多选） -> 开始下载。

安装

npm（推荐）

npm install -g manhuagui-cli

安装后即可直接使用 manhuagui-cli 命令。

从源码

git clone https://github.com/wooloo26/manhuagui-cli.git
cd manhuagui-cli
pnpm install
pnpm build
pnpm start

使用方法

命令行

# 查看帮助
manhuagui-cli --help

# 下载指定章节组
manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "单行本"

# 下载指定章节
manhuagui-cli https://www.manhuagui.com/comic/12345/ -s "单话" -c "第01话"

# 指定输出目录
manhuagui-cli https://www.manhuagui.com/comic/12345/ -o ./my-comics

# 断点续传
manhuagui-cli https://www.manhuagui.com/comic/12345/ --resume

# 断点续传 + 覆盖未完成章节
manhuagui-cli https://www.manhuagui.com/comic/12345/ --resume --overwrite

# 预览模式（不实际下载）
manhuagui-cli https://www.manhuagui.com/comic/12345/ --dry-run

选项

| 选项 | 默认值 | 说明 | | ----------------------- | ---------- | --------------------------------------------- | | -s, --section <name> | 全部 | 指定章节组名称 | | -c, --chapter <name> | — | 指定章节名称 | | -o, --output <dir> | ./output | 下载输出目录 | | -C, --concurrency <n> | 2 | 章节内图片并发数 | | --retry <n> | 3 | 图片下载重试次数 | | --log-level <level> | info | 日志级别：debug / info / warn / error | | -r, --resume | — | 断点续传模式 | | -O, --overwrite | — | 续传时覆盖未完成的章节 | | -d, --dry-run | — | 预览模式（不实际下载） | | -h, --help | — | 显示帮助信息 | | -v, --version | — | 显示版本号 |

配置

除 CLI 参数外，还可通过环境变量调整行为。

优先级：CLI 参数 > 环境变量 > 默认值

将 .env.example 复制为 .env，按需修改。也可直接设置系统环境变量。

| 变量 | 默认值 | 说明 | | -------------------- | ---------- | ---------------------------------------------- | | OUTPUT_BASE | ./output | 下载输出目录 | | IMAGE_CONCURRENCY | 2 | 章节内图片并发数 | | DOWNLOAD_DELAY | 3000 | 图片批次间延迟（毫秒，0 为禁用） | | CHAPTER_DELAY_MIN | 3000 | 章节间最小延迟（毫秒） | | CHAPTER_DELAY_MAX | 6000 | 章节间最大延迟（毫秒） | | RETRY_COUNT | 3 | 图片下载重试次数 | | RETRY_BACKOFF_BASE | 500 | 重试退避基值（毫秒），第 N 次重试等待 N * base | | LOG_LEVEL | info | 日志级别：debug / info / warn / error | | USER_AGENTS | — | 自定义 User-Agent 列表（每行一个） |

输出目录结构

output/
└── <漫画名>/
    ├── progress.json         # 下载进度（断点续传用）
    └── <章节组>/
        └── <章节>/
            ├── 001.webp
            ├── 002.webp
            └── ...

变更日志

详见 CHANGELOG.md。

许可协议

MIT

免责声明

本工具仅供学习和个人使用。请遵守目标网站的服务条款，尊重内容创作者的知识产权。请勿将本工具用于商业用途或在未经许可的情况下分发受版权保护的内容。