全网小说离线阅读终极方案：novel-downloader 一键下载指南

全网小说离线阅读终极方案：novel-downloader 一键下载指南

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

你是否曾因网络不稳定而无法追更心爱的小说？或者想收藏经典作品却苦于无法离线阅读？在数字内容快速变化的今天，许多优质小说可能会突然从原网站消失，让你再也无法找到。novel-downloader正是为解决这些问题而生的多平台小说下载工具，它能够从超过100个小说网站自动抓取内容，转换为TXT和EPUB格式，让你随时随地享受离线阅读的乐趣。

🔍 为什么需要小说下载器？

在这个"404时代"，许多优秀的小说作品可能因为各种原因从原网站消失。即使你已经订阅了付费章节，一旦网站关闭或内容下架，你的投资就可能付诸东流。novel-downloader的出现，正是为了帮助读者保存这些珍贵的数字资产。

传统下载方式的痛点

• 手动复制粘贴：费时费力，容易出错
• 网页保存不完整：无法保留章节结构和格式
• 付费内容无法保存：登录状态失效后无法再次访问
• 多平台不兼容：不同网站需要不同的下载方法

novel-downloader的解决方案

这款开源工具通过智能识别网页结构，自动提取小说内容，并生成结构完整的离线文件。它支持TXT和EPUB两种主流格式，满足不同设备的阅读需求。

上图展示了novel-downloader在浏览器中批量下载小说章节的过程。你可以看到开发者工具中显示的网络请求，这正是工具在自动抓取小说内容。

🚀 三分钟快速上手

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

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

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

获取与安装脚本

1. 克隆项目到本地：

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

2. 安装脚本： 构建完成后，在dist目录中找到bundle.user.js文件，将其拖拽到已安装脚本管理器的浏览器中即可完成安装。

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

📚 支持网站全览：覆盖主流平台

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

国内主流平台

• 起点中文网、晋江文学城、长佩文学
• 七猫中文网、番茄小说、息壤中文网
• 有毒小说网、独阅读、轻之文库轻小说

国外平台

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

转载网站

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

完整支持列表可在项目的规则目录中查看：src/rules/目录下包含了所有网站的解析规则。项目持续更新中，更多网站正在不断添加。

🔧 核心技术：智能解析与下载

智能网页解析

novel-downloader采用模块化设计，针对不同网站使用专门的解析规则。这些规则位于src/rules/目录下，按网站类型分类：

• onePage/：单页加载的小说网站
• twoPage/：分两页显示的小说网站
• special/：需要特殊处理的网站（如需要登录、字体加密等）

三级图片文字解码方案

一些网站为了防止文本被抓取，会把文字替换成图片。novel-downloader采用了一套三步解码方案：

1. 文件名映射：根据图片文件名直接匹配文字（最快）
2. 哈希映射：下载图片并计算哈希值来匹配（较快）
3. OCR识别：使用PaddleOCR识别图片中的文字（最准确但较慢）

字体加密处理

晋江文学城等网站使用自定义字体显示内容，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 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; }` };

🛠️ 开发者指南：扩展支持新网站

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

创建新规则文件

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

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

注册新规则

在src/router/download.ts中添加新规则的选择逻辑，并在header.json文件的match字段中添加相应的URL匹配模式。

测试与构建

完成代码编写后，运行以下命令进行测试和构建：

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

上图展示了novel-downloader生成的纯文本格式文件，适合在各种设备上阅读。

🎯 实用技巧与最佳实践

提高下载成功率

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

处理特殊网站

• 需要登录的网站：确保已登录并获取相应的token
• 字体加密网站：脚本会自动处理，但可能需要手动配置字体映射
• 图片文字网站：脚本会自动进行OCR识别，但首次使用需要下载OCR模型

性能优化建议

• 对于章节较多的小说，建议分批下载
• 使用自定义筛选功能只下载需要的章节
• 调整并行下载线程数，找到适合当前网站的最佳值
• 定期更新脚本以获取最新的网站支持

上图展示了novel-downloader处理包含图片的小说内容的能力，可以看到文字和图片都被完整地保存下来。

🌟 项目架构与技术栈

核心模块

• 解析引擎：位于src/rules/目录，包含各种网站的解析规则
• 下载管理器：位于src/main/目录，负责章节的批量下载
• 用户界面：位于src/ui/目录，提供友好的操作界面
• 保存模块：位于src/save/目录，负责生成TXT和EPUB文件

技术特点

• TypeScript开发：提供更好的类型安全和开发体验
• Webpack构建：支持现代前端开发流程
• Vue.js界面：提供流畅的用户交互体验
• OCR集成：支持图片文字识别功能

📝 常见问题解答

Q：下载过程中卡住了怎么办？

A：按下F12打开开发者工具，查看控制台中的错误信息。常见原因包括网络问题、网站反爬机制触发等。

Q：下载的文件乱码或格式错误？

A：尝试在设置中启用调试模式，生成调试日志后提交issue寻求帮助。

Q：如何支持新的小说网站？

A：参考开发者指南创建新规则，或到项目issue页面提交请求。

Q：脚本在某个网站上不显示下载按钮？

A：确认该网站是否在支持列表中，或尝试刷新页面重新加载脚本。

🚀 开始你的离线阅读之旅

novel-downloader不仅是一个工具，更是数字内容保存的守护者。在信息快速变化的互联网时代，它帮助读者保存珍贵的阅读资源，确保优秀作品不会彻底消失。

无论你是普通读者想要离线阅读，还是技术爱好者想要收藏珍贵资源，novel-downloader都能满足你的需求。通过简单的安装和配置，你就能轻松下载全网小说，享受随时随地的阅读体验。

立即开始使用：克隆项目，安装脚本，开启你的离线阅读之旅！

温馨提示：请尊重作者版权，仅下载你已购买或有权阅读的内容。本工具旨在帮助读者更好地管理和阅读已拥有的数字内容，保护网络文学作品的多样性。

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