如何永久保存你最爱的小说：novel-downloader完整使用指南

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

在数字阅读时代，你是否曾遇到过心爱的小说突然消失？或者想要离线阅读却发现网站限制？novel-downloader正是为解决这些痛点而生的开源小说下载神器。这个强大的工具能够从超过140个国内外小说网站智能抓取内容，自动转换为TXT和EPUB格式，让你随时随地享受离线阅读的自由，真正实现小说自由。

为什么你需要novel-downloader？

在这个内容随时可能消失的互联网时代，许多优质小说因为网站关闭、内容下架或版权变动而无法访问。更糟糕的是，网络不稳定、付费章节限制、糟糕的阅读体验等问题也时常困扰着读者。

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两种格式的文件。

🔍 智能网站识别系统：支持140+个小说平台

novel-downloader采用模块化规则引擎设计，针对不同网站采用不同的解析策略。项目源代码中的规则目录结构清晰：

目前支持超过140个国内外小说平台，包括起点中文网、晋江文学城、七猫中文网、番茄小说、SF轻小说、书耽、海棠文化线上文学城等主流平台，以及カクヨム、小説家になろう、pixiv小说等国外平台。

🖼️ 三级图片文字识别技术：完美处理防爬图片

一些网站为了防爬虫，会将文字替换为图片。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支持超过140个国内外小说网站，以下是部分主流平台：

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

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

❓ 常见问题与解决方案

下载按钮不显示怎么办？

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

下载过程中卡住了？

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

付费章节无法下载？

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

下载的文件出现乱码？

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中添加新规则的选择逻辑，并在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