Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Z-Library 批量下载器 (Modern)

Version License Tampermonkey

为 Z-Library 打造的现代化批量下载工具

功能特性 • 安装说明 • 使用指南 • 常见问题 • 贡献指南


📖 简介

Z-Library 批量下载器是一个功能强大的 Tampermonkey 用户脚本,为 Z-Library 用户提供优雅、高效的批量下载体验。通过现代化的界面设计和智能的下载管理,让您的电子书收藏变得更加轻松。

✨ 功能特性

核心功能

  • 🎯 批量选择 - 在搜索结果页面快速选择多本书籍
  • 📥 智能下载 - 支持并发下载,可自定义最大并发数(1-10)
  • 📊 实时进度 - 实时显示下载进度和状态
  • 💾 本地存储 - 使用 IndexedDB 持久化保存选择和下载历史
  • 🎨 现代界面 - 精美的暗色/亮色主题,支持一键切换

高级特性

  • ⚡ 任务管理 - 取消、删除、重试下载任务
  • 📝 下载历史 - 自动记录已下载书籍,避免重复下载
  • 🔄 断点续传 - 失败任务支持重试
  • 📱 响应式设计 - 适配各种屏幕尺寸
  • 🎭 主题切换 - 支持深色/浅色主题

界面特色

  • 🌈 渐变色彩 - 现代化的配色方案
  • ✨ 流畅动画 - 丝滑的交互体验
  • 🎪 毛玻璃效果 - 精致的视觉设计
  • 📌 浮动按钮 - 便捷的快速访问入口

🚀 安装说明

前置要求

  1. 安装浏览器扩展:

安装步骤

方法一:直接安装

  1. 点击 安装脚本
  2. Tampermonkey 会自动打开安装页面
  3. 点击"安装"按钮

方法二:手动安装

  1. 复制 index.js 文件的全部内容
  2. 打开 Tampermonkey 管理面板
  3. 点击"添加新脚本"
  4. 粘贴代码并保存

验证安装

访问 Z-Library 网站,如果看到右下角的浮动按钮,说明安装成功!

📚 使用指南

基础使用

1. 选择书籍

  • 在 Z-Library 搜索结果页面,每本书的卡片右上角会出现一个勾选按钮
  • 点击按钮选择/取消选择书籍
  • 已选择的书籍会有蓝色边框高亮显示

2. 查看列表

  • 点击右下角的浮动按钮打开侧边栏
  • 浮动按钮上的数字显示已选书籍数量
  • 侧边栏有三个标签页:
    • 已选书籍 - 查看和管理待下载的书籍
    • 下载历史 - 查看已下载的书籍记录
    • 下载任务 - 实时查看下载进度

3. 批量下载

  • 在"已选书籍"标签页,点击"开始下载"按钮
  • 切换到"下载任务"标签页查看实时进度
  • 下载完成后会自动保存到浏览器默认下载位置

高级功能

任务控制

  • 取消下载 - 点击任务右侧的"取消"按钮停止正在下载的任务
  • 删除任务 - 点击"删除"按钮从列表中移除任务
  • 重试失败 - 失败的任务可以点击"重试"按钮重新下载

设置选项

  1. 点击侧边栏右上角的齿轮图标打开设置
  2. 调整"最大并行下载数"(建议 3-5)
  3. 点击"保存"应用设置

主题切换

  • 点击侧边栏右上角的太阳/月亮图标切换主题
  • 支持深色和浅色两种主题

快捷操作

  • 清空列表 - 在"已选书籍"标签页点击"清空列表"
  • 导出列表 - 点击"导出 Excel"将书籍列表导出为表格
  • 删除单项 - 点击每个书籍卡片右侧的垃圾桶图标

⚙️ 配置说明

可调整参数

脚本顶部的常量可以根据需要调整:

const DOWNLOAD_DELAY = 3000;        // 下载间隔(毫秒)
const MAX_CONCURRENT_DOWNLOADS = 5; // 默认最大并发数

存储说明

  • 使用 IndexedDB 本地存储数据
  • 数据库名称: zlib-batch-download
  • 包含两个存储:
    • selected - 已选书籍
    • downloaded - 下载历史

🎨 界面预览

主界面

  • 现代化的侧边栏设计
  • 流畅的动画效果
  • 清晰的信息展示

下载进度

  • 实时状态更新
  • 进度条显示
  • 任务控制按钮

主题切换

  • 深色主题:适合夜间使用
  • 浅色主题:适合白天使用

❓ 常见问题

Q: 为什么有些书籍无法下载?

A: 可能的原因:

  • 书籍链接已失效
  • Z-Library 服务器限制
  • 网络连接问题 建议:检查网络连接,稍后重试失败的任务

Q: 下载速度慢怎么办?

A:

  • 适当降低"最大并行下载数"设置
  • 检查网络连接状态
  • 避免在高峰时段下载

Q: 数据会丢失吗?

A:

  • 所有数据存储在本地 IndexedDB 中
  • 除非手动清除浏览器数据,否则不会丢失
  • 建议定期导出书籍列表作为备份

Q: 支持哪些浏览器?

A:

  • ✅ Chrome/Edge (推荐)
  • ✅ Firefox
  • ✅ Safari (需要 Userscripts 扩展)
  • ✅ Opera

Q: 如何更新脚本?

A:

  • Tampermonkey 会自动检查更新
  • 也可以手动重新安装最新版本

🤝 贡献指南

欢迎贡献代码、报告问题或提出建议!

如何贡献

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

详细信息请查看 CONTRIBUTING.md

报告问题

如果您发现 bug 或有功能建议,请:

  1. 在 Issues 页面创建新问题
  2. 详细描述问题或建议
  3. 如果是 bug,请提供复现步骤

📝 更新日志

查看 CHANGELOG.md 了解详细的版本更新历史。

最新版本 (2025-11-20)

  • ✨ 添加并发下载控制
  • ✨ 添加任务管理功能(取消/删除/重试)
  • ✨ 优化下载进度显示
  • 🐛 修复封面图片提取问题
  • 🐛 修复下载链接重定向问题
  • 💄 优化界面设计和动画效果

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

  • 感谢 Z-Library 提供优质的电子书资源
  • 感谢所有贡献者和用户的支持

⚠️ 免责声明

本工具仅供学习交流使用,请遵守相关法律法规和 Z-Library 的使用条款。下载的内容仅供个人学习研究,请勿用于商业用途。请支持正版图书。


如果这个项目对您有帮助,请给一个 ⭐️ Star!

Made with ❤️ by tccpc

About

No description, website, or topics provided.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages