E-Hentai Downloader 用户脚本：批量下载与 ZIP 打包实操指南

1. 从零理解 E-Hentai Downloader 的定位与核心价值E-Hentai Downloader 是一个运行在浏览器里的用户脚本UserScript专门用来把 E-Hentai 画廊里的图片批量抓取下来打包成 ZIP 压缩包保存到本地。它的核心价值在于把原本需要一张张右键另存为的重复劳动压缩成一次点击就能完成的操作。对于经常需要离线收藏画廊内容的用户来说这个脚本几乎是必备工具。我第一次接触这个脚本是在整理一批老画廊的时候手动存了三十多张图就受不了了后来在社区里看到有人推荐这个用户脚本装上之后效率提升非常明显。它解决的核心问题有三个批量下载、自动打包、断点续传。批量下载让你不用一张张点自动打包让你不用面对一堆散落的图片文件断点续传让你在网络不稳定的时候不至于前功尽弃。这个脚本适合谁用如果你只是偶尔存一两张图那浏览器自带的另存为就够了没必要折腾。但如果你需要成批地保存画廊内容或者需要把画廊整理成压缩包归档那这个脚本能帮你省下大量时间。它不需要你懂编程但需要你会装浏览器扩展、会基本的文件管理操作。下面我会从原理到实操把整个流程拆开讲清楚。2. 用户脚本的运行机制与安装前的准备工作2.1 用户脚本到底是什么为什么需要 Tampermonkey用户脚本本质上是一段 JavaScript 代码它会在你访问特定网站时自动注入到页面里修改页面的行为或者增加新功能。E-Hentai Downloader 就是这样一个脚本它会在你打开画廊页面时往页面里添加下载按钮和相关的逻辑。但浏览器本身不会自动运行这些脚本你需要一个“脚本管理器”来托管它们。Tampermonkey 是目前最主流的脚本管理器支持 Chrome、Edge、Firefox、Safari 等主流浏览器。它的作用就像一个容器你往里面装脚本它负责在合适的时机把脚本注入到对应的页面。没有它你下载的 .user.js 文件只会被浏览器当成普通文本显示不会执行。安装 Tampermonkey 的步骤很简单打开浏览器的扩展商店搜索 Tampermonkey点击安装。安装完成后浏览器工具栏会出现一个图标点击能看到管理面板。这里有个细节要注意不同浏览器对用户脚本的支持程度不一样。Chrome 从某个版本开始对用户脚本的权限做了限制需要在 Tampermonkey 的设置里开启“允许用户脚本”选项否则脚本可能无法正常工作。这个选项在 Tampermonkey 设置页面的“通用”或者“安全”分类下具体位置随版本变化找不到的话可以在设置里搜索“用户脚本”关键词。2.2 获取脚本的几种途径与选择建议获取 E-Hentai Downloader 脚本主要有两种途径。第一种是从脚本托管平台直接安装比如 Greasy Fork 这类社区搜索脚本名称后点击安装按钮Tampermonkey 会自动弹出安装确认页面。第二种是从代码仓库克隆源码也就是热词里提到的 git clone 方式。这种方式适合想自己改代码或者想用最新开发版的人。对于大多数用户我建议直接用第一种方式省事而且脚本会自动更新。第二种方式需要你本地有 Git 环境还要会基本的命令行操作。如果你只是想用没必要折腾源码。但如果你遇到脚本某个功能不好用想自己改一改那克隆源码就是必要的。克隆命令大概是这样的git clone https://github.com/作者名/E-Hentai-Downloader.git克隆下来之后你会得到一个包含 .user.js 文件的目录然后在 Tampermonkey 里选择“添加新脚本”把文件内容粘贴进去或者用“从文件导入”的方式加载。这里有个坑git clone 有时候会因为网络问题中断报错信息里会出现 “failed to clone git repository” 之类的提示。遇到这种情况可以试试加--depth 1参数只拉取最新一次提交减少数据量git clone --depth 1 https://github.com/作者名/E-Hentai-Downloader.git如果还是断可以配置 Git 的断点续传相关参数或者换个时间段再试。热词里还出现了 “active post-checkout hook found during git clone” 这种报错这通常是仓库里带了 Git 钩子脚本在克隆完成后自动执行时出了问题。一般不影响源码的获取可以忽略或者用--no-checkout参数先克隆再手动检出。2.3 安装前的环境检查清单在正式安装脚本之前有几项环境检查建议先做一遍能避免后面很多莫名其妙的报错。确认浏览器版本不要太旧太旧的版本可能不支持 Tampermonkey 的最新特性。确认 Tampermonkey 已经启用有些浏览器在安装扩展后默认是禁用状态需要手动开启。确认浏览器的“允许用户脚本”选项已经打开这个前面提过是 Chrome 系浏览器的常见坑。确认你访问 E-Hentai 的页面能正常加载如果页面本身打不开脚本也无从运行。如果之前装过其他版本的下载脚本建议先禁用或删除避免多个脚本冲突。注意安装脚本时 Tampermonkey 会弹出权限确认页面一定要仔细看它请求了哪些权限。E-Hentai Downloader 通常需要访问目标网站和下载文件的权限这是正常的。如果某个脚本请求了明显不相关的权限比如读取你所有浏览记录那就要警惕了。3. 脚本核心功能拆解与关键参数解析3.1 下载流程的完整链路E-Hentai Downloader 的工作流程可以拆成四个阶段解析画廊页面、获取图片列表、逐张请求图片、打包成 ZIP 下载。每个阶段都有对应的技术细节理解这些细节能帮你在出问题的时候快速定位。解析画廊页面阶段脚本会读取页面的 DOM 结构找到画廊的元信息比如标题、页数、每页的缩略图链接。E-Hentai 的页面结构比较特殊缩略图和原图是分开的脚本需要根据缩略图链接推导出原图链接。这个推导逻辑是脚本的核心之一如果 E-Hentai 改了页面结构脚本就需要更新。获取图片列表阶段脚本会把所有原图链接整理成一个数组然后按顺序请求。这里有个关键参数是并发数也就是同时请求多少张图片。并发数太高容易被服务器限流太低又下载慢。脚本一般会设置一个默认值比如 3 到 5 个并发你可以在脚本设置里调整。逐张请求图片阶段脚本会模拟浏览器的请求行为带上必要的请求头比如 Referer 和 User-Agent。有些网站会检查 Referer如果缺失就返回 403 错误。脚本通常会处理好这些细节但如果你用了某些隐私扩展可能会把 Referer 抹掉导致下载失败。打包成 ZIP 阶段脚本会把下载到的图片数据在浏览器内存里组装成 ZIP 格式然后触发下载。这里用到的技术是 JavaScript 的 ZIP 库比如 JSZip。ZIP 格式的好处是通用Windows、macOS、Linux 都能直接解压不需要额外工具。3.2 关键参数与设置项说明脚本提供了一些可配置的参数理解它们的作用能让你根据实际情况调优。参数名作用建议值注意事项并发数同时下载的图片数量3-5太高容易被限流太低速度慢重试次数单张图片下载失败后的重试次数2-3太多会拖慢整体进度超时时间单张图片请求的超时阈值30秒网络差可以适当调大打包格式输出文件的格式ZIP目前主要支持 ZIP文件名模板输出文件的命名规则画廊标题避免特殊字符导致保存失败并发数的设置需要根据你的网络环境和目标网站的承受能力来定。我实测下来3 个并发在大多数情况下够用速度也不慢。如果你网络特别好可以试试 5 个但再高就容易触发限流了。限流的表现是图片请求返回 429 状态码或者直接连接被拒绝。重试次数建议设成 2 到 3 次。有些图片因为网络抖动会失败重试一次通常就能成功。但如果某张图片本身已经失效重试再多次也没用只会浪费时间。脚本一般会跳过连续失败的图片继续下载后面的。超时时间默认 30 秒对大多数情况够用。如果你用的是移动网络或者网络特别不稳定可以调到 60 秒。但调太大也有问题如果某张图片真的卡住了你会等很久才跳过。3.3 ZIP 打包的技术细节与常见问题ZIP 打包看起来简单其实有不少细节。首先是文件名编码问题ZIP 格式早期用的是本地编码后来有了 UTF-8 扩展。如果脚本打包时用的编码和你解压时用的编码不一致文件名就会变成乱码。E-Hentai Downloader 一般会用 UTF-8 编码现代解压工具都能正确识别。其次是 ZIP 文件大小限制。浏览器内存有限如果画廊图片特别多、特别大打包出来的 ZIP 可能超过浏览器能处理的上限导致打包失败或者浏览器崩溃。遇到这种情况可以分批下载比如先下载前 100 张再下载后面的。还有一个热词里提到的 “zip 伪加密” 问题。有些 ZIP 文件看起来有密码其实密码是假的只是文件头里某个标志位被设置了。这种文件用普通解压工具会提示输入密码但实际上不需要密码就能解压。E-Hentai Downloader 生成的 ZIP 一般不会有这个问题但如果你从其他渠道拿到 ZIP 文件遇到这种情况可以用 7-Zip 这类工具强制解压。“zip 密码移除” 是另一个相关话题。如果你下载的 ZIP 确实有密码而且你知道密码可以用解压工具的“移除密码”功能重新打包一个无密码版本。7-Zip 和 WinRAR 都支持这个操作。但 E-Hentai Downloader 本身不涉及密码功能所以这个点更多是通用 ZIP 处理知识。4. 完整实操流程从安装到成功下载4.1 第一步安装 Tampermonkey 并开启用户脚本支持打开你的浏览器扩展商店搜索 Tampermonkey。以 Chrome 为例进入 Chrome 网上应用店搜索后点击“添加到 Chrome”。安装完成后浏览器工具栏会出现 Tampermonkey 的图标默认是一个黑色方块带两个圆点。点击图标选择“管理面板”进入设置页面。在设置页面里找到“通用”或“安全”分类确认“允许用户脚本”选项是开启状态。不同版本的 Tampermonkey 这个选项的位置可能不一样如果找不到可以在设置页面的搜索框里输入“用户脚本”快速定位。这一步很关键因为 Chrome 从 Manifest V3 开始对用户脚本的执行做了更严格的限制。如果这个选项没开脚本即使安装了也不会运行你会看到页面没有任何变化也没有下载按钮出现。4.2 第二步安装 E-Hentai Downloader 脚本打开脚本托管平台搜索 “E-Hentai Downloader”。找到脚本页面后点击“安装此脚本”按钮。Tampermonkey 会弹出一个新标签页显示脚本的代码和安装确认按钮。仔细看一下脚本的权限请求确认没有问题后点击“安装”。安装完成后回到 Tampermonkey 管理面板在“已安装脚本”列表里应该能看到 E-Hentai Downloader。如果没看到可能是安装过程中出了问题可以重新安装一次。如果你选择用 git clone 方式获取源码流程是这样的先克隆仓库到本地找到 .user.js 文件然后在 Tampermonkey 管理面板里点击“添加新脚本”把文件内容全部粘贴进去按 CtrlS 保存。保存后脚本会出现在已安装列表里。提示从源码安装的脚本不会自动更新每次作者发布新版本你都需要手动重新克隆和粘贴。如果你不想折腾还是建议从托管平台安装。4.3 第三步在画廊页面触发下载打开 E-Hentai 的任意一个画廊页面等待页面完全加载。如果脚本正常工作你会在页面上看到新增的下载按钮通常位于画廊标题附近或者页面顶部。按钮的文字可能是 “Download” 或者 “下载 ZIP”。点击下载按钮脚本会开始解析页面并获取图片列表。这个过程可能需要几秒钟取决于画廊的页数。页数越多解析时间越长。解析完成后脚本会开始逐张下载图片你可以在页面上看到进度提示比如 “正在下载 15/120”。下载过程中不要关闭页面也不要刷新。如果中途关闭页面下载会中断已经下载的部分也会丢失。脚本是在浏览器内存里操作的没有持久化存储所以必须保持页面打开直到下载完成。4.4 第四步处理下载完成的 ZIP 文件下载完成后浏览器会提示你保存 ZIP 文件。选择保存位置等待文件写入磁盘。文件大小取决于画廊图片的总大小可能从几 MB 到几百 MB 不等。保存完成后用解压工具打开 ZIP 文件。Windows 自带的解压功能就能处理但如果文件比较大或者文件名有特殊字符建议用 7-Zip 或 Bandizip 这类专业工具。解压后你会得到一个文件夹里面是画廊的所有图片文件名通常是按页码顺序排列的。如果你在 Windows 上遇到右键菜单里出现“压缩为 ZIP”选项想去掉的情况那是系统自带的功能可以在注册表里禁用但和 E-Hentai Downloader 本身没关系。热词里提到的 “win10 如何去掉右键菜单的压缩为 zip” 是另一个独立问题这里不展开。4.5 第五步验证下载完整性下载完成后建议做一次完整性检查。打开解压后的文件夹看看图片数量是否和画廊页数一致。如果少了可能是某些图片下载失败被跳过了。脚本通常会在下载日志里记录失败的图片你可以根据日志重新下载缺失的部分。图片能不能正常打开也要检查一下。偶尔会有图片下载不完整的情况文件大小明显偏小打开后显示不全。这种通常是网络问题导致的重新下载那一张就行。5. 常见问题排查与避坑经验实录5.1 脚本不生效的排查思路脚本装了但页面上没有出现下载按钮这是最常见的问题。排查顺序如下确认 Tampermonkey 图标上有没有数字标记有标记说明脚本已经注入到当前页面。点击 Tampermonkey 图标看看 E-Hentai Downloader 是否在“已启用”状态。检查浏览器的“允许用户脚本”选项是否开启。打开浏览器开发者工具的控制台看看有没有报错信息。常见报错包括脚本语法错误、权限不足、页面结构变化导致的选择器失效。如果控制台显示 “failed to install plugin” 或者类似的克隆失败信息说明脚本安装过程中出了问题重新安装一次。还有一个容易被忽略的点有些浏览器扩展会干扰用户脚本的运行比如广告拦截器、隐私保护工具。可以试试在无痕模式下打开页面无痕模式默认不加载扩展如果无痕模式下脚本能正常工作说明是某个扩展在捣乱逐个禁用排查即可。5.2 下载速度慢或频繁失败的优化方法下载速度慢通常和并发数、网络环境、目标网站限流有关。可以先试试降低并发数从 5 降到 3 甚至 2。并发数低了单张图片的请求间隔变长不容易触发限流整体速度反而可能更稳定。如果频繁失败看看失败的模式。如果是集中在某一段页码可能是那几页的图片本身有问题。如果是随机失败那多半是网络问题。可以试试换个网络环境或者用有线网络代替无线。重试次数也可以适当调大但不要超过 5 次。超过 5 次还失败的图片基本可以判定为失效图片重试也没用。5.3 ZIP 文件相关的典型问题ZIP 文件打不开或者解压报错可能的原因有几个。一是文件下载不完整浏览器在写入磁盘时中断了。这种情况重新下载一次通常能解决。二是 ZIP 文件本身损坏可能是脚本打包过程中出了错。可以试试用 7-Zip 的“修复压缩包”功能有时候能救回来。文件名乱码是另一个常见问题。如果解压后文件名是乱码说明 ZIP 文件用的编码和你系统默认的编码不一致。可以在解压工具的设置里手动指定编码为 UTF-8或者用 Bandizip 这类自动检测编码的工具。热词里提到的 “zip 解压” 和 “linux 解压缩命令 zip” 也是相关话题。在 Linux 下解压 ZIP 用unzip命令unzip filename.zip -d output_directory如果文件名有中文可能需要加-O CP936或-O UTF-8参数指定编码。具体用哪个取决于 ZIP 文件本身的编码。5.4 常见问题速查表问题现象可能原因解决方法页面没有下载按钮脚本未启用或权限不足检查 Tampermonkey 状态和浏览器用户脚本选项下载中途中断网络波动或页面被关闭保持页面打开检查网络重新下载部分图片缺失图片请求失败被跳过查看下载日志重新下载缺失部分ZIP 解压报错文件损坏或下载不完整重新下载或用 7-Zip 修复文件名乱码ZIP 编码与系统编码不一致解压时指定 UTF-8 编码下载速度极慢并发数过高被限流降低并发数到 2-3脚本报错 “failed to clone”源码克隆失败用 --depth 1 参数重试或改用托管平台安装5.5 几个我踩过的坑第一个坑是并发数设太高。我一开始把并发数调到 10想着能快一点结果下载了十几张之后全部请求都返回 429整个下载卡死。后来降到 3虽然单张速度没变但整体稳定多了反而更快完成。第二个坑是没注意浏览器内存。有一次下载一个 500 多页的画廊打包到一半浏览器直接崩溃之前下载的全没了。后来我学乖了超过 200 页的画廊就分批下载每次下载 100 页左右打包保存后再下载下一批。第三个坑是 Referer 被隐私扩展抹掉。我装了一个隐私保护扩展默认会把所有请求的 Referer 头去掉。结果脚本下载图片时全部返回 403排查了半天才发现是扩展的问题。把目标网站加入扩展的白名单就好了。第四个坑是 ZIP 文件名里的特殊字符。有些画廊标题里带冒号、问号这些字符Windows 不允许文件名包含这些字符导致保存失败。后来我在脚本设置里把文件名模板改成只保留字母、数字和连字符问题就解决了。6. 进阶技巧与效率提升建议6.1 批量下载多个画廊的思路E-Hentai Downloader 本身是针对单个画廊的但如果你需要下载多个画廊可以配合浏览器的多标签功能。每个标签打开一个画廊分别触发下载。但要注意同时下载多个画廊会占用大量内存和网络带宽建议一次不要超过 3 个。另一个思路是用脚本的队列功能。有些版本的 E-Hentai Downloader 支持把多个画廊加入下载队列脚本会按顺序逐个下载。这个功能在脚本设置里可以开启适合需要批量归档的场景。6.2 下载后的文件整理与命名规范下载下来的 ZIP 文件默认用画廊标题命名但画廊标题有时候不够直观。建议在保存时手动改成更有意义的名称比如加上日期前缀或者分类标签。这样以后找起来方便。解压后的文件夹结构也值得整理一下。我习惯按 “分类/画廊标题/图片” 这样的三层结构存放分类可以是作者名、作品系列或者主题。整理虽然花时间但以后检索效率会高很多。6.3 脚本更新与版本管理从托管平台安装的脚本会自动检查更新Tampermonkey 会定期拉取最新版本。如果你发现脚本某个功能不好用了可以先检查一下有没有更新。在 Tampermonkey 管理面板里点击脚本选择“检查更新”即可。从源码安装的脚本需要手动更新。每次作者发布新版本你需要重新克隆仓库把新的 .user.js 文件内容替换掉旧版本。如果改动不大也可以直接在 Tampermonkey 编辑器里修改对应的代码段。提示更新脚本之前建议先备份当前版本。万一新版本有 bug可以快速回滚到旧版本。Tampermonkey 的编辑器里有导出功能可以把当前脚本导出成文件保存。6.4 与其他工具配合使用的场景E-Hentai Downloader 负责下载下载之后的处理可以交给其他工具。比如用图片管理软件批量重命名、去重、转换格式。如果下载的图片格式不统一可以用格式转换工具批量转成 JPG 或 PNG。如果需要把下载的图片做成 PDF 或者电子书可以用 Calibre 这类工具。Calibre 支持从文件夹导入图片并生成电子书适合把画廊做成离线阅读的格式。热词里提到的 “crystaldiskinfo 便携版 zip” 和 “7 zip” 是磁盘和压缩工具和 E-Hentai Downloader 没有直接关系但如果你下载量大磁盘空间管理就很重要。CrystalDiskInfo 可以监控硬盘健康状态7-Zip 可以高效压缩和解压都是值得常备的工具。6.5 安全与合规使用的提醒使用任何下载工具都要注意遵守目标网站的使用条款。E-Hentai 对请求频率有限制过于频繁的请求可能导致账号被限制。脚本里设置的并发数和重试次数就是为了在效率和合规之间找平衡不要为了追求速度把参数调得太激进。另外下载的内容请仅用于个人离线收藏不要用于商业用途或者二次分发。尊重内容创作者的权益是每个使用者应该遵守的基本准则。7. 关于脚本生态与后续扩展的一些个人体会E-Hentai Downloader 这类用户脚本的生态其实挺有意思的。它们依赖目标网站的页面结构一旦网站改版脚本就可能失效。所以脚本作者需要持续维护用户也需要关注更新。这种依赖关系决定了用户脚本的寿命往往不如独立的桌面软件但胜在轻量、即装即用。我在实际使用中的体会是不要把用户脚本当成唯一方案。对于特别重要的下载任务最好准备一个备选方案比如手动下载或者用其他工具。用户脚本适合日常的、量不大的下载需求遇到极端情况还是得靠更底层的工具。最后分享一个小技巧如果你经常下载同一类画廊可以在脚本设置里把文件名模板和保存路径固定下来这样每次下载都不用重新选择效率会高很多。Tampermonkey 本身不管理保存路径但浏览器的下载设置里可以指定默认下载目录配合脚本的文件名模板基本能做到一键下载、自动归档。