E-Hentai Downloader 实用教程：从安装到高级配置全指南

E-Hentai Downloader 实用教程：从安装到高级配置全指南

快速了解项目核心功能

E-Hentai Downloader 是一款专为 E-Hentai 档案下载设计的用户脚本工具，能够将在线画廊内容打包为 ZIP 文件高效保存。项目采用 GPL-3.0 开源许可，核心功能通过单一用户脚本实现，无需复杂依赖，安装即可使用。

项目文件结构解析

核心文件定位

项目根目录包含三个关键文件：

• LICENSE：GPL-3.0 许可证文本
• README.md：项目说明文档
• e-hentai-downloader.user.js：主用户脚本（核心功能实现）
• e-hentai-downloader.meta.js：脚本元数据配置

源代码目录构成

src/文件夹存放所有功能模块：

• FileSaver.js：文件保存功能实现
• JSZip.js：ZIP 压缩核心库
• main.js：主程序逻辑入口
• first.js：初始化流程控制
• gh_2215_make_GM_xhr_more_parallel_again.js：并行网络请求优化模块

脚本安装与基础使用

安装前置条件

1. 浏览器需安装用户脚本管理器（推荐 ViolentMonkey 或 Tampermonkey）
2. 确保网络环境可访问 E-Hentai 网站

安装步骤

1. 访问项目仓库获取最新版e-hentai-downloader.user.js
2. 在脚本管理器中选择"安装新脚本"
3. 复制脚本内容并保存
4. 安装完成后浏览器会自动加载脚本

基础下载操作

1. 访问目标 E-Hentai 画廊页面
2. 页面底部会出现下载控制栏
3. 设置下载范围（默认全部页面）
4. 点击"打包下载"按钮开始处理
5. 完成后自动保存为 ZIP 文件

高级配置指南

性能优化设置

1. 并行下载调整： 修改src/gh_2215_make_GM_xhr_more_parallel_again.js中的并发请求数（默认 5 线程）

2. 存储优化： 在 Chrome 浏览器中启用 File System API 支持：

   // 在 main.js 中找到以下配置 const useFileSystem = true; // 设置为 true 启用

下载参数配置

1. 文件大小控制： 通过调整Pages Range参数限制单文件大小，建议设置为 500MB 以内（约 50-100 页）

2. 超时设置： ViolentMonkey 用户需调整：

   // 在 e-hentai-downloader.user.js 中 const timeout = 30000; // 超时时间（毫秒）

错误处理优化

1. 网络不稳定时启用自动重试：

   // 在 first.js 中设置 const maxRetryCount = 3; // 最大重试次数

常见问题解决方案

下载中断问题

• 原因：网络波动或服务器限制
• 解决：启用断点续传功能，在main.js中设置enableResume = true

大文件处理失败

• 解决方案：
  1. 减小单 ZIP 文件页数
  2. 清理浏览器缓存
  3. 升级 JSZip 库至最新版（替换src/JSZip.js）

浏览器兼容性问题

功能扩展建议

自定义界面样式

修改脚本中的 CSS 样式定义，可自定义下载按钮外观：

/* 在 e-hentai-downloader.user.js 中 */ .downloadBtn { background: #2c3e50; color: white; padding: 8px 16px; border-radius: 4px; }

批量下载管理

可通过修改main.js实现多画廊队列下载功能，添加任务管理面板。

使用注意事项

1. 遵守 E-Hentai 网站使用条款，合理控制下载频率
2. 大型画廊建议分多次下载，避免服务器拒绝服务
3. 定期更新脚本以获取最新功能和 bug 修复
4. 隐私保护：脚本不会收集任何用户数据，所有操作均在本地完成

通过合理配置和使用本工具，您可以高效备份喜爱的 E-Hentai 画廊内容。如需进一步定制功能，可参考src/目录下的模块实现进行二次开发。