小说下载器完整指南：轻松保存100+网站小说，构建个人数字图书馆

小说下载器完整指南：轻松保存100+网站小说，构建个人数字图书馆

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

在数字阅读日益普及的今天，你是否曾遇到过这样的困扰：付费订阅的小说突然下架，精心收藏的网页链接失效，或是网络不稳定时无法继续阅读心爱的作品？novel-downloader 小说下载器正是为解决这些痛点而生的强大工具。这款基于 TypeScript 开发的浏览器扩展脚本，能够智能地从 100 多个小说网站抓取内容，并将其转换为格式规范的 TXT 和 EPUB 文件，让你随时随地享受离线阅读的乐趣。

🔍 数字阅读时代的痛点与解决方案

三大阅读困境

1. 内容易失性：网站关闭、内容下架或版权变动都可能导致已购买的小说消失
2. 平台依赖性：在线阅读受网络限制，无法在无网络环境下继续阅读
3. 格式不统一：不同网站的内容格式各异，缺乏统一的阅读体验

novel-downloader 通过智能解析算法，能够准确识别各种网站的结构差异，无论是单页展示还是分页加载，无论是纯文本还是图文混合章节，都能完整提取并格式化保存。它不仅仅是一个下载工具，更是你的个人数字图书馆管理员。

🚀 快速安装：三步开启收藏之旅

第一步：安装脚本管理器

novel-downloader 作为浏览器脚本运行，需要先安装脚本管理器。推荐使用 Tampermonkey，它在 Chrome、Firefox、Edge 等主流浏览器上都有良好支持。

第二步：获取脚本文件

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

方式一：直接安装访问项目仓库获取最新版本的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 的工作界面，左侧是小说章节列表，右侧是下载器的操作日志和进度信息

🛡️ 智能应对各类网站保护机制

图片文字的三层解码方案

部分网站为防止内容被抓取，会将文字转换为图片。novel-downloader 采用三级解码策略：

1. 文件名映射：根据图片文件名快速匹配文字
2. 哈希匹配：计算图片哈希值进行中等精度识别
3. OCR识别：使用 PaddleOCR 模型进行高精度光学字符识别

这种分层策略在保证识别速度的同时，最大化提高了准确率。相关解码模块位于src/lib/decoders/目录中。

字体加密的完美破解

晋江文学城等平台使用自定义字体保护内容。脚本会自动下载字体文件并建立字符映射关系，确保文字正确显示。在src/rules/lib/jjwxcFontDecode.ts中，你可以看到专门的字体解码实现。

付费章节的智能访问

对于需要登录的 VIP 内容，工具会使用你的浏览器登录状态进行访问。只要你已登录网站账户并购买了相关章节，novel-downloader 就能顺利下载，既尊重版权又方便用户。

📖 支持的网站类型与范围

主流原创平台

• 起点中文网、晋江文学城、七猫中文网：完整支持付费章节
• 长佩文学、书耽、海棠文化：支持 VIP 章节下载
• SF轻小说、刺猬猫：支持对话小说外的所有内容

海外内容平台

• カクヨム、pixiv小说：支持日语内容
• Lofter、小説家になろう：支持多语言平台

转载资源站点

从笔趣阁系列到 UU 看书网，从星空中文到乐文小说网，novel-downloader 覆盖了大多数热门转载站点。完整的支持列表包含 100 多个网站，规则文件存放在src/rules/目录的各个子文件夹中，按网站类型进行分类管理。

novel-downloader 生成的 HTML 格式阅读界面，章节结构清晰，排版规范

🎨 个性化定制功能

章节筛选与过滤

如果你只想下载小说的特定部分，可以通过自定义筛选函数实现：

// 只下载前50章 function chapterFilter(chapter) { return chapter.chapterNumber <= 50; } // 只下载特定章节 function chapterFilter(chapter) { return chapter.chapterName.includes("番外") || chapter.chapterName.includes("后记"); }

输出格式完全控制

通过saveOptions对象，你可以完全控制输出格式：

const saveOptions = { getchapterName: (chapter) => { // 自定义章节标题格式 return `第${chapter.chapterNumber}章 ${chapter.chapterName}`; }, mainStyleText: `p { text-indent: 2em; // 首行缩进 line-height: 1.8; // 行高调整 margin-bottom: 1em; // 段落间距 }` };

下载参数优化

在设置面板中，你可以根据网站特性调整下载参数：

• 并行下载线程数：控制同时下载的章节数量
• 下载间隔：避免触发网站反爬机制
• 最大下载间隔：限制下载速度

下载生成的 TXT 文件在文本编辑器中的效果，章节结构清晰，格式规范

🔧 高级使用技巧与故障排除

优化下载性能

如果遇到下载速度慢的问题，可以尝试：

1. 降低并行下载线程数（默认值为5）
2. 增加下载间隔时间
3. 分批下载大型作品

常见问题解决方案

下载卡顿或中断：检查网络连接，降低并行下载数内容出现乱码：确认网站编码设置，工具会自动处理大部分情况脚本不工作：检查网站是否在支持列表中，或查看控制台错误信息

扩展支持新网站

如果你发现某个网站不受支持，可以参考项目文档创建新的规则文件。项目采用模块化设计，所有规则都存放在src/rules/目录下，分为onePage/、twoPage/、special/等类型，扩展非常简单。

🌟 项目特色与技术优势

可扩展的架构设计

novel-downloader 采用模块化设计，每个网站的支持规则都是独立的 TypeScript 文件。这种设计使得：

• 易于维护：每个网站的规则独立，互不影响
• 便于扩展：添加新网站只需创建新的规则文件
• 灵活配置：可以根据网站特性定制解析逻辑

智能内容处理

• 自动章节识别：智能识别章节链接和内容结构
• 多格式支持：同时生成 TXT 和 EPUB 格式文件
• 图片处理：自动下载并嵌入章节中的图片

novel-downloader 能够完整处理图文混合内容，保留原文中的插图

开源社区支持

作为一个完全开源的项目，novel-downloader 欢迎开发者贡献代码。如果你有编程经验，可以为新网站添加支持规则；如果你发现了 bug，可以提交 issue 帮助改进；如果你有使用建议，可以在社区中分享。

📋 开始使用前的准备工作

环境要求

• 现代浏览器（Chrome、Firefox、Edge 等）
• 脚本管理器（Tampermonkey、Violentmonkey 等）
• 稳定的网络连接

权限说明

脚本需要以下权限：

• unsafeWindow：获取自定义筛选函数和保存参数
• GM_xmlhttpRequest：进行跨域 HTTP 请求
• GM_setValue/GM_getValue：本地统计运行次数

隐私保护

脚本会收集以下信息用于存档至互联网档案馆：

• IP 地址、User-Agent、Referer
• 书籍详情页和目录页 URL
• 脚本版本信息

🛠️ 开发者指南

项目结构

src/ ├── rules/ # 网站规则文件 │ ├── onePage/ # 单页式网站规则 │ ├── twoPage/ # 两页式网站规则 │ └── special/ # 特殊网站规则 ├── lib/ # 核心库文件 ├── main/ # 主逻辑模块 └── save/ # 保存功能模块

添加新网站支持

1. 继承BaseRuleClass类
2. 实现bookParse和chapterParse方法
3. 在router/download.ts中添加选择规则
4. 在header.json的match字段添加匹配规则

构建与测试

yarn lint # 代码规范检查 yarn build # 构建脚本文件 yarn test # 运行功能测试

📚 构建你的数字图书馆

novel-downloader 不仅仅是一个技术工具，它代表了一种新的阅读理念：数字内容应该被尊重、被保存、被传承。在这个信息快速流动的时代，我们需要的不仅是即时消费，更是深度收藏。

立即行动步骤

1. 安装脚本管理器，为浏览器增添新功能
2. 获取 novel-downloader 脚本，开启智能下载之旅
3. 访问你喜欢的小说网站，体验一键收藏的便利
4. 在任何时间、任何地点，享受完整的阅读体验

长期价值

• 内容永久保存：不再担心网站关闭或内容下架
• 统一阅读体验：所有小说统一格式，方便整理和阅读
• 离线自由：摆脱网络限制，随时随地阅读
• 个性化管理：按照自己的喜好整理和筛选内容

让每一本好作品都能陪伴你走过每一个美好时光。在数字阅读的世界里，novel-downloader 为你保驾护航，确保精彩永不消失。无论是通勤路上的碎片时间，还是深夜的沉浸阅读，你的私人数字图书馆随时为你开放。

开始构建你的数字图书馆吧，让精彩内容永远陪伴在你身边！

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