构建你的个人数字图书馆：novel-downloader小说下载器完全指南

构建你的个人数字图书馆：novel-downloader小说下载器完全指南

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

在数字阅读时代，你是否曾遇到过这样的困境：收藏的小说突然从网站上消失，付费章节无法离线阅读，或是想在旅途中享受阅读却受限于网络连接？novel-downloader正是为解决这些痛点而生的开源工具，它是一款功能强大的通用型小说下载器，能够从超过100个小说网站自动抓取内容，并转换为TXT和EPUB格式，为你构建个人数字图书馆。

为什么需要个人数字图书馆？

随着互联网内容的快速更迭，许多优质小说作品可能会因为版权问题、网站关闭或内容下架而永久消失。笔趣阁等转载网站虽然能保存部分内容，但对于那些不够热门、未被转载的作品，一旦原网站删除，就再也无法找回。novel-downloader正是404小说文库项目的核心组成部分，致力于保存那些质量上乘但可能被遗忘的文字作品。

这个项目不仅是一个下载工具，更是数字时代的知识守护者。它允许你将喜爱的作品永久保存到本地，无论网络环境如何变化，都能随时随地享受阅读的乐趣。

快速开始：三分钟搭建你的下载环境

第一步：安装脚本管理器

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文件，直接拖拽到脚本管理器安装即可。

第三步：开始下载之旅

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

下载过程中，页面右下角会显示进度条，你也可以按下F12打开开发者工具，在控制台查看详细状态。下载完成后，脚本会自动下载一个包含TXT文档和EPUB文件的ZIP压缩包。

上图展示了novel-downloader在实际使用中的界面，包括章节列表和网络请求监控

核心技术：智能解析与三层解码方案

模块化规则引擎

novel-downloader的核心在于其强大的规则引擎。项目采用模块化设计，将不同网站的解析逻辑封装在独立的规则文件中。在src/rules/目录下，你可以看到清晰的分类结构：

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

每个规则文件都继承自BaseRuleClass基类，实现了bookParse和chapterParse两个核心方法。这种设计使得添加对新网站的支持变得非常简单，只需创建新的规则文件并在src/router/download.ts中注册即可。

图片文字智能识别

部分网站为了防爬虫，会将文字替换为图片。novel-downloader采用创新的三层解码方案来处理这种情况：

1. 文件名映射：首先尝试根据图片文件名直接匹配对应的文字，这是最快的方法
2. 哈希匹配：如果文件名匹配不到，就下载图片并计算哈希值来匹配，速度也比较快
3. OCR识别：前两种方法都失败时，才会使用PaddleOCR中文识别模型来识别图片中的文字

这种分层处理策略既保证了效率，又确保了识别的准确性。文件名和哈希映射的匹配表会自动从GitHub获取并保存在本地存储中，OCR模型也会在需要时自动下载。

上图展示了小说章节页面，部分网站会将文字替换为图片，novel-downloader的三层解码方案能有效处理这种情况

字体加密自动处理

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

支持的网站范围

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

主流原创平台

• 起点中文网、起点女生网：完整支持公共章节和付费章节
• 晋江文学城、长佩文学、书耽：支持付费章节下载（需登录已购买账户）
• 七猫中文网、番茄小说、息壤中文网：覆盖主流免费阅读平台
• 有毒小说网、独阅读、轻之文库轻小说：满足不同类型读者需求

国外平台

• カクヨム（日本）、小説家になろう（日本）：支持日语小说下载
• pixiv小说、Lofter：覆盖同人创作平台
• Novel Up Plus、ESJ：支持海外中文小说网站

转载网站

• 笔趣阁系列、UU看书网：经典的转载网站支持
• 和图书、书趣阁、星空中文：多样化的阅读选择
• 乐文小说网、腐书网：满足特定题材需求

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

上图展示了典型的小说目录页面结构，包括小说标题、封面、分卷信息和章节列表

高级功能：个性化定制与批量处理

自定义章节筛选

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

// 只下载前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>", ""); } };

自动注入配置脚本

如果你总是使用相同的自定义设置，可以创建一个独立的用户脚本自动注入配置：

// ==UserScript== // @name Noveldownloader 自定义配置 // @namespace http://tampermonkey.net/ // @version 1.0 // @description 自动注入 novel-downloader 配置 // @author 你的名字 // @match *://*/* // @grant none // ==/UserScript== (function() { "use strict"; // 章节筛选 function chapterFilter(chapter) { return chapter.chapterNumber <= 100; } // 保存选项 const saveOptions = { getchapterName: (chapter) => { return `第${chapter.chapterNumber}章 ${chapter.chapterName || ""}`; } }; window.chapterFilter = chapterFilter; window.saveOptions = saveOptions; })();

上图展示了小说的分卷结构，novel-downloader能够正确处理这种层级关系

实用技巧与最佳实践

提高下载成功率

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

性能调优建议

• 并行下载线程数：默认3个线程，可根据网站反爬策略调整
• 下载间隔设置：仅当并行下载线程数为1时生效，控制章节间下载间隔
• 内存使用监控：对于图片特别多的博客（如Lofter），注意内存用量（800MB限制）

常见问题解决方案

问题1：下载按钮不显示

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

问题2：下载过程中卡住

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

问题3：付费章节无法下载

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

问题4：下载的文件乱码

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

上图展示了包含图片的小说章节，novel-downloader能够正确处理图文混排内容

开发者扩展指南

创建新规则文件

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

在src/rules/目录下创建新的规则文件：

import { BaseRuleClass } from "../lib/rule"; export default class NewSite extends BaseRuleClass { public siteName = "new-site"; public urlPattern = /https:\/\/www\.newsite\.com\/novel\/.+/; public async bookParse() { // 实现书籍信息提取逻辑 } public async chapterParse() { // 实现章节内容提取逻辑 } }

注册新规则

在src/router/download.ts中添加新规则的选择逻辑：

import NewSite from "../rules/NewSite"; // 在规则选择逻辑中添加 if (url.match(NewSite.urlPattern)) { return new NewSite(); }

并在header.json文件的match字段中添加相应的URL模式。

测试与构建

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

项目架构与设计理念

核心模块设计

novel-downloader采用清晰的分层架构：

• 规则层（src/rules/）：负责不同网站的解析逻辑
• 核心层（src/main/）：处理书籍、章节和附件的基本数据结构
• 工具层（src/lib/）：提供HTTP请求、DOM清理、图片处理等通用功能
• UI层（src/ui/）：管理用户界面和交互逻辑
• 保存层（src/save/）：处理文件生成和格式转换

可扩展性设计

项目采用插件式架构，每个网站的解析规则都是独立的模块。这种设计使得：

1. 易于维护：每个网站的规则变化不会影响其他网站
2. 便于扩展：添加新网站只需实现新的规则类
3. 灵活配置：不同网站可以有不同的反爬策略和解析逻辑

错误处理与日志系统

项目内置完善的错误处理机制和日志系统：

• 分级日志：支持不同级别的日志输出
• 调试模式：提供详细的调试信息帮助定位问题
• 错误恢复：支持断点续传和失败重试

上图展示了下载后的TXT文件格式，保持了良好的章节结构和排版

安全与隐私考虑

数据保护

novel-downloader在设计时充分考虑了用户隐私：

• 本地处理：所有数据处理都在浏览器本地完成
• 无数据上传：不会将任何用户数据上传到服务器
• 透明操作：所有网络请求都可以在开发者工具中查看

版权尊重

项目强调对版权的尊重：

• 仅下载已授权内容：鼓励用户仅下载已购买或有权阅读的内容
• 合理使用：建议将下载内容用于个人阅读和备份
• 尊重创作者：支持正版，尊重原创作者的劳动成果

社区贡献指南

项目欢迎社区贡献，但需要遵循以下原则：

1. 遵守法律法规：不添加违反法律法规的网站支持
2. 尊重版权：不鼓励下载盗版内容
3. 技术导向：专注于技术实现，不讨论版权争议

未来发展与社区生态

持续改进方向

novel-downloader项目仍在持续发展，未来的改进方向包括：

• 更多网站支持：不断扩展支持的小说网站列表
• 性能优化：提高下载速度和稳定性
• 用户体验：改进界面和交互设计
• 格式支持：增加更多输出格式（如MOBI、PDF）

社区参与

项目拥有活跃的社区，用户可以通过以下方式参与：

1. 提交问题：在项目issue页面报告bug或提出功能建议
2. 贡献代码：为项目添加新功能或修复问题
3. 分享经验：在社区中分享使用技巧和最佳实践
4. 翻译文档：帮助将文档翻译成更多语言

相关项目

novel-downloader是404小说文库项目的一部分，该项目还包括：

• 图片文字映射库：存储图片到文字的映射关系
• 字体匹配数据库：收集和整理字体加密信息
• 规则共享平台：社区贡献的网站解析规则

结语：构建你的数字阅读未来

在信息快速变化的数字时代，novel-downloader不仅是一个工具，更是一种态度——对知识的珍视，对文化的保护，对个人阅读权利的维护。它让我们能够在瞬息万变的互联网中，为自己保留一份稳定的阅读空间。

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

现在就开始使用novel-downloader，构建属于你自己的数字图书馆吧。在信息洪流中，为自己保留一份宁静的阅读角落。

温馨提示：请遵守相关法律法规和网站使用条款，仅下载你已获得授权的内容。支持正版，尊重原创，让创作者获得应有的回报。

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