当前位置：首页 > news >正文

novel-downloader：全网小说下载终极方案，一站式解决离线阅读难题

news 2026/5/27 23:59:15

novel-downloader：全网小说下载终极方案，一站式解决离线阅读难题

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

在这个数字阅读时代，你是否曾因为网络不稳定而无法追更心爱的小说？或者想要收藏经典作品却苦于无法离线阅读？novel-downloader正是为你量身打造的多平台小说下载工具。这款可扩展的通用型小说下载器能够从众多小说网站自动抓取内容，转换为TXT和EPUB格式，让你随时随地享受离线阅读的乐趣。在404时代，当小说突然从原网站消失时，这款工具还能帮助你保存珍贵的小说资源，确保优质作品不会彻底从互联网上消失。

📚 痛点分析：为什么你需要novel-downloader？

小说消失的困扰

在这个网络内容瞬息万变的时代，许多优秀的小说作品会因为各种原因从原网站消失。可能是版权问题、网站关闭，或是作者主动下架。一旦小说消失，如果你没有提前保存，就再也无法阅读这些作品。特别是那些质量上乘但不够热门、没有被其他网站转载的作品，一旦消失就可能永远失传。

平台碎片化问题

不同小说网站有不同的阅读界面、登录机制和付费规则。读者需要在多个平台间切换，记住不同的账号密码，面对五花八门的阅读体验。更糟糕的是，很多网站限制下载功能，即使你已经付费购买了章节，也无法将其保存到本地。

阅读体验不一致

每个小说网站都有自己的排版风格、字体大小和阅读界面，这让读者很难获得统一的阅读体验。有些网站广告繁多，有些则加载缓慢，这些都影响了阅读的流畅性和舒适度。

技术门槛过高

虽然市面上有一些小说下载工具，但大多数要么操作复杂，要么只支持少数几个网站。对于普通用户来说，配置抓取规则、处理反爬机制等技术门槛太高，难以实现自动化下载。

🚀 解决方案：novel-downloader的创新设计

模块化架构设计

novel-downloader采用高度模块化的架构设计，将网页解析逻辑与核心下载功能分离。这种设计使得添加对新网站的支持变得异常简单。项目中的src/rules/目录包含了超过100个网站的解析规则，每个规则文件都是一个独立的模块，负责处理特定网站的结构解析。

三层OCR图像文字识别系统

针对那些将文字替换为图片来防止抓取的网站，novel-downloader采用了创新的三步解码方案：

文件名映射：最快的方法，根据图片文件名直接匹配文字
哈希映射：下载图片并计算哈希值来匹配，速度较快
OCR识别：前两种方法失败时使用OCR识别图片中的文字，最准确但最慢

这套系统在保证识别准确率的同时，最大程度地提升了处理速度。对于像西瓜书屋这样的网站，它能自动下载PaddleOCR模型进行文字识别，确保图片中的文字也能被正确提取。

智能字体解密机制

晋江文学城、番茄小说等网站使用自定义字体显示文字，novel-downloader能够自动下载字体文件并建立映射关系。通过字体匹配表技术，即使网站使用特殊的字体加密，也能正确还原文字内容。

🛠️ 实战演示：三分钟快速上手

准备工作：安装脚本管理器

novel-downloader是一个油猴脚本（UserScript），需要先安装脚本管理器才能使用。主流浏览器都支持以下任意一款脚本管理器：

Tampermonkey：最流行的脚本管理器，支持Chrome、Firefox、Edge等浏览器
Violentmonkey：开源免费的替代选择
Greasemonkey：Firefox专用版本

获取项目代码与安装

首先克隆项目到本地：

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

构建完成后，在dist目录中找到bundle.user.js文件，这就是可以直接安装的脚本。

基础使用方法

安装脚本后，访问支持的小说网站，当你打开小说目录页时，网页右上角会出现一个下载图标。点击该图标，脚本就会开始自动抓取小说内容。

下载过程说明：

脚本会分析页面结构，识别章节列表
自动下载所有章节内容（包括付费章节，需要你已登录并购买）
下载完成后自动打包为TXT和EPUB文件
浏览器会自动下载生成的文件

重要提示：下载付费章节前，请确保已登录相应网站账户并已购买相关章节。未登录或未购买的付费章节会被自动跳过。

支持网站一览

novel-downloader支持超过100个小说网站，包括国内外主流平台：

国内主流平台：

起点中文网、起点女生网、晋江文学城
长佩文学、书耽、海棠文化线上文学城
七猫中文网、番茄小说、息壤中文网
有毒小说网、独阅读、轻之文库轻小说

国外平台：

カクヨム（日本）、小説家になろう（日本）
pixiv小说、Lofter
Novel Up Plus、ESJ

转载网站：

笔趣阁系列、UU看书网、和图书
书趣阁、星空中文、乐文小说网

完整支持列表可在项目文档中查看，脚本持续更新中，更多网站正在不断添加。

🔧 深度应用：高级功能详解

章节筛选功能

如果你只想下载小说的特定部分，可以使用章节筛选功能。在开始下载前，按下F12打开开发者工具，在控制台中定义chapterFilter函数：

// 只下载前100章 function chapterFilter(chapter) { return chapter.chapterNumber <= 100; } // 只下载第一卷 function chapterFilter(chapter) { return chapter.sectionNumber === 1; } // 只下载包含特定关键词的章节 function chapterFilter(chapter) { return chapter.chapterName.includes("武器"); }

自定义输出格式

你可以完全控制生成文件的样式和格式：

const saveOptions = { // 修改章节标题格式 getchapterName: (chapter) => { if (chapter.chapterName) { return `第${chapter.chapterNumber}章 ${chapter.chapterName}`; } else { return `第${chapter.chapterNumber}章`; } }, // 自定义CSS样式 mainStyleText: `p { text-indent: 2em; line-height: 1.6; margin: 0.5em 0; }`, // 删除EPUB中的空行 genChapterEpub: (contentXHTML) => { return contentXHTML.replaceAll("<p><br /></p>", "") .replaceAll("<p><br/></p>", ""); } };

智能下载设置优化

在脚本设置中，你可以调整下载参数以获得最佳体验：

参数	说明	推荐值
并行下载线程数	控制同时下载的章节数量	3-5（根据网站反爬策略调整）
下载间隔	每章节下载后的等待时间（毫秒）	500-2000
最大下载间隔	防止因网络问题导致的无限等待	10000

处理特殊网站的策略

长佩文学：反爬较严，限制下载速度，每分钟约可下载6章，请耐心等待Lofter：脚本会下载博文中的图片，对于图片特别多的博客，请注意内存用量（800MB限制）晋江文学城：需要配置API Token以获得更好体验

📊 性能优化与最佳实践

提高下载成功率

网络环境：确保网络连接稳定，避免在下载过程中断开
登录状态：下载付费章节前确认已登录相应网站
反爬处理：如果遇到频繁失败，尝试降低并行下载线程数
耐心等待：大量章节下载可能需要较长时间，请耐心等待完成

内存管理策略

对于图片特别多的博客（如Lofter），建议使用筛选函数分批下载：

// 分批下载Lofter博文 function chapterFilter(chapter, index) { // 只下载前50章，避免内存溢出 return index < 50; }

批量处理技巧

如果你需要下载多本小说，建议：

一次只下载一本小说，避免浏览器资源竞争
使用书签功能保存下载进度
对于超长篇小说，使用章节筛选功能分批下载

🛠️ 开发者扩展指南

创建新规则文件

novel-downloader采用模块化设计，可以轻松扩展支持新的小说网站。如果你发现某个网站不受支持，可以按照以下步骤添加支持：

在src/rules/目录下创建新的规则文件，例如src/rules/custom-site.ts：

import { BaseRuleClass } from "../lib/rule"; export default class CustomSite extends BaseRuleClass { // 网站名称 public siteName = "custom-site"; // URL匹配规则 public urlPattern = /https:\/\/www\.custom-site\.com\/novel\/.+/; // 书籍解析方法 public async bookParse() { // 实现书籍信息提取逻辑 } // 章节解析方法 public async chapterParse() { // 实现章节内容提取逻辑 } }