拯救消失的文学：novel-downloader 开源小说下载器深度解析

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

在数字阅读日益普及的今天，你是否曾遇到过心爱的小说突然从网站上消失的困境？那些付费订阅的章节、精心收藏的作品，可能因为网站关闭、内容下架或版权变动而永远无法访问。novel-downloader正是为解决这一痛点而生的开源工具，它能够从超过100个小说网站智能抓取内容，让你真正拥有自己的数字图书馆。

为什么我们需要小说下载器？

在瞬息万变的网络环境中，优质内容面临着随时消失的风险。许多优秀的小说作品因为不够热门，没有被其他网站转载，一旦原网站关闭或删除，这些作品就会彻底从互联网上消失。novel-downloader诞生的初衷就是保存这些珍贵的文字资源，让读者不再受网络限制，真正拥有自己的阅读时光。

这款工具不仅仅是简单的网页抓取器，它是一个完整的解决方案，支持从主流原创平台到转载网站的各种小说站点，涵盖了中文、日文等多个语种的文学作品。

五分钟快速上手指南

第一步：安装脚本管理器

novel-downloader是一个油猴脚本（UserScript），需要先在浏览器安装脚本管理器。推荐使用以下任一款：

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

第二步：获取并安装脚本

你可以通过两种方式获取脚本：

1. 从GitCode仓库克隆源码并自行构建：

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

构建完成后，在dist目录中找到bundle.user.js文件，直接拖拽到脚本管理器安装即可。

2. 直接安装预构建版本，访问项目页面获取最新版本的脚本文件。

第三步：开始下载小说

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

下载过程中，页面右下角会显示进度条，你也可以按下F12打开开发者工具，在控制台查看详细状态。下载完成后，工具会自动生成TXT和EPUB两种格式的文件，方便你在不同设备上阅读。

novel-downloader后台抓包与解析界面，展示工具如何智能提取小说章节链接

核心功能深度剖析

智能网站识别系统

novel-downloader采用模块化规则引擎设计，针对不同网站采用不同的解析策略。工具内置了三层架构的规则系统：

• 单页模式：适用于章节列表在同一页面的网站，如起点、晋江等
• 多页模式：适用于章节分页显示的网站
• 特殊处理：针对特殊加密或反爬机制的网站

每个网站的解析规则都独立存放在src/rules/目录下，这种设计使得添加新网站支持变得非常简单，开发者只需按照模板创建新的规则文件即可。

三级图片文字识别技术

部分网站为了防爬虫，会将文字替换为图片。novel-downloader采用三级解码方案来应对这一挑战：

1. 文件名映射：根据图片文件名直接匹配文字，速度最快
2. 哈希匹配：下载图片计算哈希值进行匹配，准确率较高
3. OCR识别：使用PaddleOCR中文识别模型，准确但较慢

这种分层处理策略既保证了效率，又确保了识别的准确性。首次使用OCR功能时，工具会自动从GitHub下载PaddleOCR模型文件并保存在本地。

novel-downloader解析的小说封面与目录页，展示完整的作品结构和章节导航

字体加密自动处理

晋江文学城等网站使用自定义字体加密文字显示。脚本会自动下载字体文件并建立映射关系，确保下载的内容文字正确显示。如果遇到乱码问题，可以在设置中启用调试模式，按照提示信息提交字体匹配请求。

支持网站全面覆盖

novel-downloader支持超过100个小说网站，涵盖了主流原创平台、国外平台和转载网站：

主流原创平台支持

• 起点中文网：支持公共章节和付费章节
• 晋江文学城：支持公共章节和付费章节（需配置Token）
• 七猫中文网：支持公共章节
• 番茄小说：支持公共章节和付费章节
• 长佩文学：支持公共章节和付费章节
• 息壤中文网：支持公共章节和付费章节

国外平台支持

• カクヨム（日本）：支持公共章节
• 小説家になろう：支持公共章节
• pixiv小说：支持公共章节
• Lofter：支持公共章节

转载网站支持

• 笔趣阁系列：支持公共章节
• UU看书网：支持公共章节
• 和图书：支持公共章节

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

novel-downloader解析的小说正文页，展示工具提取的完整文本内容和排版格式

高级定制功能详解

自定义章节筛选

如果你只想下载小说的特定部分，可以在下载前定义筛选函数。例如：

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

个性化输出格式控制

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

const saveOptions = { // 自定义章节标题格式 getchapterName: (chapter) => { return `第${chapter.chapterNumber}章 ${chapter.chapterName || ""}`; }, // 自定义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>", ""); } };

自动注入配置脚本

如果你总是使用相同的自定义设置，可以创建一个独立的用户脚本自动注入配置。这样每次访问小说网站时，配置都会自动生效，无需手动设置。

技术架构与设计理念

模块化设计

novel-downloader采用高度模块化的设计，主要分为以下几个核心模块：

1. 规则引擎：负责解析不同网站的结构
2. 下载管理器：处理并发下载和错误重试
3. 内容处理器：清理HTML、提取文本、处理图片
4. 输出生成器：生成TXT、EPUB等格式文件
5. 用户界面：提供直观的操作界面和进度显示

错误处理与重试机制

工具内置了完善的错误处理机制，包括：

• 网络错误重试：自动重试失败的下载请求
• 内容验证：检查下载内容的完整性和正确性
• 进度保存：支持断点续传，避免重复下载

性能优化策略

为了提供更好的用户体验，工具采用了多种性能优化策略：

• 并发控制：可调节的并行下载线程数
• 内存管理：智能缓存和垃圾回收机制
• 网络优化：请求合并和延迟加载

novel-downloader解析的小说正文+插图页，展示工具对带图片小说内容的处理能力

常见问题解决方案

下载按钮为什么不显示？

1. 确认当前网站是否在支持列表中
2. 刷新页面重新加载脚本
3. 检查脚本管理器是否正确安装并启用

下载过程中卡住怎么办？

1. 降低并行下载线程数（在设置中调整）
2. 检查网络连接是否稳定
3. 查看控制台错误信息，可能需要等待网站反爬机制解除

付费章节无法下载？

1. 确保已登录相应网站账户
2. 确认已购买相关付费章节
3. 部分网站需要配置特殊token（如晋江文学城）

下载的文件出现乱码？

1. 启用调试模式生成日志
2. 检查字体匹配是否正常
3. 提交issue并提供详细日志

开发者扩展指南

添加新网站支持

如果你想为novel-downloader添加对新网站的支持，可以按照以下步骤操作：

1. 创建新规则文件：在src/rules/目录下创建新的规则文件
2. 实现解析逻辑：继承BaseRuleClass类，实现bookParse、chapterParse方法
3. 注册新规则：在src/router/download.ts中添加新规则的选择逻辑
4. 添加URL匹配：在header.json文件的match字段中添加相应的URL模式

贡献代码流程

项目采用标准的开源贡献流程：

1. Fork项目仓库
2. 创建功能分支
3. 实现功能并添加测试
4. 提交Pull Request
5. 等待代码审查和合并

测试与构建

yarn lint # 代码检查 yarn build # 构建脚本 yarn test # 运行测试

novel-downloader生成的纯文本输出文件，展示工具对小说内容的格式化存储能力

实用技巧与最佳实践

提高下载成功率

1. 网络环境：使用稳定的网络连接，避免在下载过程中断开
2. 登录状态：下载付费章节前确保已登录并购买
3. 反爬处理：如遇到频繁失败，尝试降低并行下载线程数
4. 分批下载：对于超长篇小说，建议分卷或分批次下载

性能优化建议

• 调整并行下载线程数（默认3个），找到适合当前网站的最佳值
• 使用章节筛选功能只下载需要的部分
• 定期清理浏览器缓存，保持脚本运行流畅
• 关注项目更新，及时获取最新的网站支持和bug修复

安全注意事项

• 仅下载你已购买或有权阅读的内容
• 尊重作者版权，合理使用下载功能
• 不要在公共场合分享下载的付费内容
• 定期备份重要的下载文件

项目生态与未来发展

404小说文库项目

novel-downloader是404小说文库项目的组成部分之一。该项目的目标是保存那些质量上乘但不够热门，没有被其他网站转载，可能彻底从互联网上消失的作品。对于无登录墙的小说网站，如果你同意，脚本会尝试将当前书籍详情页及目录页存档至互联网档案馆（archive.org），以备日后查看。

社区贡献与支持

项目拥有活跃的社区，开发者们持续维护和更新网站支持列表。如果你在使用过程中遇到问题或有新功能建议，可以到项目页面提交issue。项目还提供了Matrix和Telegram交流群组，方便用户交流使用经验。

技术路线图

未来版本计划增加以下功能：

• 更多网站支持
• 更好的错误恢复机制
• 更智能的内容识别算法
• 多格式输出支持（如PDF、MOBI等）

结语：开启你的离线阅读之旅

novel-downloader不仅仅是一个下载工具，更是数字阅读时代的知识守护者。在信息易逝的今天，它帮助我们保存那些珍贵的文字，让优质内容不会因为网站关闭或内容下架而彻底消失。

无论你是想要离线阅读方便通勤，还是想要收藏心爱的小说，或是作为技术爱好者想要研究网页解析技术，novel-downloader都能满足你的需求。它的开源特性意味着你可以自由定制、贡献代码，与全球开发者一起完善这个工具。

现在就安装novel-downloader，开始你的离线阅读之旅吧！如果你在使用过程中遇到问题或有新功能建议，欢迎到项目页面提交反馈，让我们一起为保存互联网上的优秀小说作品贡献力量。

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