终极小说下载神器：一键保存200+网站小说，打造个人数字图书馆

终极小说下载神器：一键保存200+网站小说，打造个人数字图书馆

【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader

在数字阅读时代，你是否曾遇到过心爱的小说突然从网站上消失？或者想在没有网络的环境下继续阅读？novel-downloader 正是为解决这些痛点而生的开源工具。这款功能强大的小说下载器能够智能解析200多个小说网站，将在线内容转换为本地文件，让你随时随地享受阅读乐趣，无需担心内容消失或网络限制。

📚 为什么你需要这款工具？

全面支持主流小说平台

novel-downloader 拥有广泛的兼容性，覆盖了国内外几乎所有主流小说阅读平台：

• 国内主流平台：起点中文网、晋江文学城、番茄小说、七猫中文网等
• 轻小说平台：SF轻小说、轻之文库、轻小说文库等
• 日本小说平台：カクヨム、小説家になろう、ハーメルン等
• 图片加密网站：西瓜书屋、海棠文化等（支持OCR图片识别）
• 付费墙网站：刺猬猫、米国度等（需登录账号）

智能三层解码技术

面对网站的各种反爬虫措施，novel-downloader 采用了创新的三层解码技术：

小说下载工具的操作界面和解析过程

智能解码流程：

1. 文件名映射：快速匹配图片文件名对应的文字
2. 哈希映射：通过图像哈希值识别文字内容
3. OCR识别：使用PaddleOCR进行光学字符识别

这种分层处理机制既保证了识别效率，又确保了识别准确性，特别适用于那些将文字替换为图片的网站。

🚀 快速上手指南

安装步骤

1. 克隆项目到本地

   git clone https://gitcode.com/gh_mirrors/no/novel-downloader cd novel-downloader yarn install yarn build

2. 安装浏览器脚本将生成的dist/bundle.user.js文件安装到你的浏览器脚本管理器（Tampermonkey、Violentmonkey等）。

三步完成下载

1. 打开目标小说目录页- 工具会自动识别页面结构
2. 点击下载按钮- 开始解析章节列表
3. 等待下载完成- 工具会自动处理所有技术细节

下载完成后，你会同时获得TXT和EPUB两种格式的文件，方便在不同设备上阅读。

小说下载后的阅读效果展示

🔧 核心功能详解

模块化架构设计

novel-downloader 采用清晰的分层架构，每个网站的支持都通过独立的规则文件实现：

src/rules/ ├── onePage/ # 单页式网站规则 ├── twoPage/ # 两页式网站规则 ├── special/ # 特殊网站规则 └── lib/ # 共享解码库

这种设计让开发者可以轻松添加对新网站的支持，也使得维护变得更加简单。

高级定制功能

通过简单的配置，你可以定制化下载体验：

自定义章节命名：

const saveOptions = { getchapterName: (chapter) => { return `第${chapter.chapterNumber}章 ${chapter.chapterName || ''}`; } }; window.saveOptions = saveOptions;

自定义EPUB样式：

const saveOptions = { mainStyleText: `p { text-indent: 2em; line-height: 1.6; margin: 0.5em 0; }` }; window.saveOptions = saveOptions;

🎯 实用功能特性

智能章节筛选

novel-downloader 提供了强大的筛选功能，让你可以精确控制下载内容：

// 只下载前100章 function chapterFilter(chapter) { return chapter.chapterNumber <= 100; } // 只下载特定卷的内容 function chapterFilter(chapter) { return chapter.sectionNumber === 1; } // 按关键词筛选章节 function chapterFilter(chapter) { return chapter.chapterName.includes("战斗"); }

批量处理与自动化

对于需要批量下载的场景，可以通过脚本实现自动化：

// 批量下载多本小说 const novelUrls = [ 'https://www.example.com/novel/1', 'https://www.example.com/novel/2', // 更多URL... ]; novelUrls.forEach(url => { window.open(url); setTimeout(() => { const downloadBtn = document.querySelector('.novel-downloader-btn'); if (downloadBtn) downloadBtn.click(); }, 3000); });

📊 技术架构解析

核心模块设计

novel-downloader 的技术架构非常清晰：

src/ ├── main/ # 核心数据模型 │ ├── Book.ts # 书籍类 │ ├── Chapter.ts # 章节类 │ └── main.ts # 主逻辑 ├── rules/ # 网站规则 │ ├── onePage/ # 单页式规则 │ ├── twoPage/ # 两页式规则 │ └── special/ # 特殊网站规则 ├── lib/ # 工具库 │ ├── decoders/ # 解码器 │ ├── http.ts # HTTP请求 │ └── zip.ts # 压缩处理 └── save/ # 输出模块 ├── epub.ts # EPUB生成 ├── txt.ts # TXT生成 └── web.css # 网页样式

支持图文混排的小说内容展示

性能优化策略

1. 并发下载控制：智能调整并发数避免被封禁
2. 缓存机制：本地缓存已解析内容减少重复请求
3. 增量更新：只下载新增或更新的章节
4. 错误重试：自动重试失败请求提高成功率

💡 高级使用技巧

应对反爬虫策略

对于有反爬虫机制的网站，你可以调整下载设置：

• 调整下载间隔：对于敏感网站，增加下载间隔时间
• 并行下载控制：智能调整并发数避免被封禁
• 缓存机制：本地缓存已解析内容减少重复请求

自定义规则开发

如果你需要支持新的小说网站，可以轻松创建新的规则文件：

// 创建自定义网站规则 export default { siteName: 'custom-site', urlPattern: /https:\/\/www\.custom-site\.com\/novel\/.+/, bookParse: async () => { // 解析书籍信息逻辑 return { bookUrl: window.location.href, bookname: document.title, author: document.querySelector('.author')?.textContent, }; }, chapterParse: async (chapterUrl, chapterName, isVIP, isPaid) => { // 解析章节内容逻辑 return { chapterName, contentRaw: document.querySelector('.content'), contentText: document.querySelector('.content')?.textContent, }; } };

🛠️ 安装与配置

环境要求

• Node.js 14+
• Yarn 或 npm
• 支持用户脚本的浏览器（Chrome、Firefox、Edge等）
• Tampermonkey 或 Violentmonkey 扩展

构建步骤

1. 安装依赖

   yarn install

2. 构建脚本

   yarn build

3. 安装脚本将生成的dist/bundle.user.js拖拽到浏览器脚本管理器

小说章节的起始内容展示

🔍 常见问题解答

Q: 下载速度太慢怎么办？

A: 可以调整并行下载线程数，但要注意不要设置过高，以免被网站封禁IP。

Q: 下载的章节有乱码？

A: 检查网页编码设置，或尝试在设置中调整字符编码选项。

Q: 如何下载付费章节？

A: 需要先登录相应网站的账号，并确保已购买相应章节。未登录或未购买的付费章节无法下载。

Q: 支持哪些文件格式？

A: 支持TXT和EPUB两种格式，EPUB格式更适合在电子书阅读器上阅读。

📈 最佳实践建议

1. 资源管理优化

• 内存控制：大文件分块处理避免内存溢出
• 磁盘空间：定期清理临时文件
• 网络流量：压缩传输数据减少带宽消耗

2. 质量保证措施

• 完整性校验：验证下载内容的完整性
• 格式检查：确保输出文件符合标准
• 编码处理：正确处理各种字符编码

3. 安全使用指南

• 遵守版权：仅下载个人已购买或免费章节
• 合理使用：不要用于商业用途或大规模爬取
• 尊重网站：控制下载频率，避免对网站服务器造成过大压力

🎉 开始你的离线阅读之旅

novel-downloader 不仅仅是一个小说下载工具，更是一个完整的数字阅读解决方案。无论你是普通读者想要备份心爱的小说，还是技术爱好者希望学习网页解析技术，这个项目都能为你提供强大的支持。

通过模块化的设计、智能的解析算法和丰富的定制选项，novel-downloader 在保持易用性的同时，提供了专业级的扩展能力。现在就开始使用这款工具，打造属于你自己的数字图书馆吧！

提示：使用过程中遇到任何问题，欢迎在项目的支持页面提交Issue，社区开发者会及时为你提供帮助。记住，对于付费章节，请确保已登录相应网站账号并已购买相应章节，否则无法下载。

【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader