如何用novel-downloader永久保存你心爱的小说？终极指南来了！

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

在这个数字内容随时可能消失的时代，你是否曾为心爱的小说突然无法访问而感到无助？当网站关闭、内容下架或网络限制时，那些珍贵的文字故事可能永远消失。novel-downloader正是为解决这一痛点而生的开源小说下载神器，它能够从超过100个国内外小说网站智能抓取内容，自动转换为TXT和EPUB格式，让你随时随地享受离线阅读的自由。

为什么你需要这个小说下载工具？

想象一下，你正在追更的小说突然被网站删除，或者你最喜欢的作者作品因为版权问题而无法访问。更糟糕的是，网络不稳定、付费章节限制、糟糕的阅读体验等问题也时常困扰着读者。novel-downloader的核心价值在于为你提供完整的解决方案：

• 永久保存：将喜欢的作品保存到本地，不再担心内容消失
• 离线阅读：随时随地阅读，无需网络连接
• 格式统一：自动转换为标准格式，兼容各种阅读设备
• 批量下载：一次性下载整本小说，节省时间精力

3分钟快速上手：从安装到下载

第一步：准备工作

首先，你需要在浏览器中安装脚本管理器。推荐使用Tampermonkey，它支持Chrome、Firefox、Edge等主流浏览器，安装简单，使用方便。

第二步：获取脚本

打开Tampermonkey，选择"添加新脚本"，然后将以下代码粘贴进去：

// 从GitCode获取最新版本 // 脚本地址：https://gitcode.com/gh_mirrors/no/novel-downloader/raw/gh-pages/bundle.user.js

如果你是开发者或想要自定义构建，可以通过命令行获取完整源代码：

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

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

第三步：开始下载

安装完成后，访问支持的小说网站（如起点中文网、晋江文学城等），当你打开小说目录页时，网页右上角会出现下载图标。点击下载图标，脚本就会开始自动抓取小说内容。

novel-downloader智能识别小说目录页面，展示完整的作品结构和章节导航

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

核心技术优势：为什么novel-downloader如此强大？

🔍 智能网站识别系统

novel-downloader采用模块化规则引擎设计，针对不同网站采用不同的解析策略。项目源代码中的规则目录结构清晰，每个规则文件都针对特定网站进行了优化：

• src/rules/onePage/：适用于章节列表在同一页面的网站
• src/rules/twoPage/：适用于章节分页显示的网站
• src/rules/special/：针对特殊加密或反爬机制的网站

目前支持超过100个国内外小说平台，包括起点中文网、晋江文学城、七猫中文网、番茄小说等主流平台。

🖼️ 三级图片文字识别技术

一些网站为了防爬虫，会将文字替换为图片。novel-downloader采用创新的三级解码方案：

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

这种分层处理策略既保证了效率，又确保了识别的准确性，特别适合处理那些将文字转为图片的网站。

novel-downloader精确提取小说正文内容，保持原有排版格式

🔤 字体加密自动处理

晋江文学城等知名网站使用自定义字体加密文字显示。novel-downloader会自动下载字体文件并建立映射关系，确保下载的内容文字正确显示，完全解决乱码问题。

实战应用：从零开始下载小说的完整流程

场景一：下载免费章节

访问支持的小说网站，找到你想下载的小说目录页。novel-downloader会自动检测页面并显示下载按钮。点击按钮后，工具会：

1. 分析页面结构，提取章节列表
2. 逐章下载内容
3. 清理格式，去除广告
4. 生成TXT和EPUB文件

场景二：处理付费内容

对于付费章节，你需要：

1. 登录相应网站账户
2. 确认已购买相应付费章节
3. 按照提示配置token（部分网站需要）

小贴士：部分网站如晋江文学城需要额外的token配置，具体方法可参考官方文档：docs/superpowers/plans/2026-05-16-sbxh-cf-shadow-dom.md

场景三：批量下载系列作品

如果你要下载多本小说或长篇系列，可以：

1. 调整并行下载线程数（默认3个）
2. 使用章节筛选功能只下载需要的部分
3. 分批下载，避免网络压力过大

novel-downloader完美处理图文混排的小说内容，保留插图的同时提取完整文本

高级定制：打造个性化阅读体验

智能章节筛选

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

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

自定义输出格式

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

const saveOptions = { // 自定义章节标题格式 getchapterName: (chapter) => { return `第${chapter.chapterNumber}章 ${chapter.chapterName || ""}`; }, // 自定义CSS样式 mainStyleText: `p { text-indent: 2em; line-height: 1.6; margin: 0.5em 0; }` };

自动配置注入

如果你总是使用相同的自定义设置，可以创建一个独立的用户脚本自动注入配置，无需每次手动设置。具体实现可参考src/ui/setting.ts中的配置管理逻辑。

支持的网站一览：覆盖主流平台

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

主流原创平台：

• 起点中文网、晋江文学城、七猫中文网
• 番茄小说、长佩文学、息壤中文网
• SF轻小说、书耽、海棠文化线上文学城

国外平台：

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

转载网站：

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

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

常见问题与解决方案

❓ 下载按钮不显示怎么办？

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

⏳ 下载过程中卡住了？

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

🔒 付费章节无法下载？

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

🔠 下载的文件出现乱码？

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

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

安全使用指南与合规提醒

重要提醒：

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

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中添加新规则的选择逻辑，并在header.json文件的match字段中添加相应的URL模式。

测试与构建

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

开启你的离线阅读之旅

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

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

现在就开始使用novel-downloader，享受真正的阅读自由吧！如果你在使用过程中遇到问题或有新功能建议，欢迎参与项目讨论，让我们一起为保存互联网上的优秀小说作品贡献力量。

温馨提示：使用过程中如遇到技术问题，建议查阅项目文档或向开发者社区寻求帮助。记住，合理使用工具，尊重原创，让阅读变得更加美好。

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