如何用开源工具轻松下载全网小说？novel-downloader终极解决方案
【免费下载链接】novel-downloader 一个可扩展的通用型小说下载器。 项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader
你是否曾经遇到过这样的情况：收藏的网络小说突然下架了？付费购买的章节因为网站维护无法访问？或者想要在通勤路上阅读却苦于没有网络信号？在数字阅读时代，这些烦恼困扰着无数小说爱好者。今天，我要向你介绍一个革命性的解决方案——novel-downloader，这个开源工具能够帮你轻松下载全网200+小说网站的内容，建立属于自己的永久数字图书馆。
novel-downloader是一款基于浏览器脚本的智能小说下载器，它支持起点中文网、晋江文学城、SF轻小说、海棠文化、刺猬猫等主流平台，无论是免费章节还是付费内容，只要你有访问权限，都能一键下载保存。这个工具不仅功能强大，而且完全开源免费，让每个读者都能拥有自己的数字书库。
🚀 项目亮点：为什么novel-downloader是小说爱好者的必备神器？
广泛的平台兼容性
想象一下，一个工具就能覆盖你所有的小说阅读需求！novel-downloader支持超过200个小说网站，包括：
主流付费平台：起点中文网、晋江文学城、刺猬猫、SF轻小说免费阅读网站：笔趣阁、UU看书网、爱下电子书轻小说平台：轻之文库、小説家になろう、カクヨム海外中文站：息壤中文网、有毒小说网、独阅读
无论你在哪个平台追更，都能找到对应的支持。工具会自动识别网站类型，无需手动配置。
智能解析与内容保护
novel-downloader最令人惊叹的是它的智能解析能力。面对不同网站复杂的页面结构，它采用了模块化的规则系统。每个支持的网站都有专门的解析规则文件，例如：
src/rules/onePage/template.ts - 处理单页显示的小说网站src/rules/special/qidian.ts - 专门处理起点中文网的特殊需求src/rules/twoPage/template.ts - 处理分页显示的章节内容
novel-downloader批量解析界面展示章节列表与下载日志
🔍 创新技术：三层解码方案应对网站反爬措施
有些网站为了保护内容，会将文字替换成图片。novel-downloader为此设计了创新的三层解码方案，确保能够准确提取内容：
1. 文件名映射解码
这是最快的方法！工具首先尝试根据图片文件名直接匹配对应的文字字符。想象一下，网站把"我"字替换成"img_wo.png"这样的图片，工具就能立即识别出来。
2. 哈希值匹配解码
如果文件名无法直接匹配，工具会下载图片并计算其哈希值进行比对。这就像给每个图片建立了一个独特的"指纹"，通过比对"指纹"库来识别文字。
3. OCR光学字符识别
当前两种方法都失败时，工具会启动OCR识别功能。它使用PaddleOCR中文识别模型，能够准确识别图片中的文字内容。虽然这是最慢的方法，但也是最后的保障。
这套三层解码方案在src/lib/decoders/目录下实现，包括FilenameDecoder.ts、HashDecoder.ts和OCRDecoder.ts等核心模块。
🎯 快速入门：三步开启你的小说下载之旅
第一步：安装脚本管理器
novel-downloader是一个油猴脚本，需要先在浏览器中安装脚本管理器。推荐使用Tampermonkey或Violentmonkey，它们都支持主流浏览器。
第二步：获取并安装脚本
访问项目仓库 https://gitcode.com/gh_mirrors/no/novel-downloader 获取最新版本的脚本文件。脚本管理器会自动检测并提示安装。
小贴士：脚本执行下载任务时会播放无声音频，这是为了保证后台运行时不被浏览器休眠机制中断，完全不用担心会影响你的使用体验。
第三步：开始下载小说
打开任意支持的小说目录页面，你会看到右上角出现下载图标。点击它，novel-downloader就会开始工作！
novel-downloader自动识别小说目录页面并显示下载按钮
下载过程中，你可以通过右下角的进度条实时查看进度，或者按F12打开控制台查看详细状态。完成后，工具会自动下载TXT和EPUB两种格式的文件，满足不同阅读需求。
🛠️ 进阶应用：个性化定制你的阅读体验
自定义章节筛选
对于超长篇小说，你可能只想下载特定部分。novel-downloader提供了灵活的筛选功能：
// 只下载前50章
function chapterFilter(chapter) {
return chapter.chapterNumber <= 50;
}
// 只下载特定卷的内容
function chapterFilter(chapter) {
return chapter.sectionName === "第一卷";
}
输出格式深度定制
通过自定义保存参数，你可以完全控制输出文件的样式：
const saveOptions = {
// 自定义章节标题格式
getchapterName: (chapter) => {
return `第${chapter.chapterNumber}章 ${chapter.chapterName}`;
},
// 调整段落样式
mainStyleText: `p {
text-indent: 2em;
line-height: 1.8;
margin: 0.5em 0;
}`,
// 删除空行
genChapterEpub: (contentXHTML) => {
return contentXHTML.replaceAll("
}
};
下载后的小说阅读界面，支持自定义样式调整
付费章节下载配置
对于需要登录的付费网站，如晋江文学城，需要配置相应的token。你可以在src/setting.ts中设置，或者通过专门的用户脚本注入：
const tokenOptions = {
Jjwxc: {
token: "你的token",
user_key: "你的user_key"
}
};
🏗️ 技术架构：模块化设计的智慧
清晰的分层架构
novel-downloader采用精心设计的四层架构：
解析层（src/rules/） - 负责从不同网站提取章节信息处理层（src/lib/） - 清理HTML、处理图片、解码特殊内容输出层（src/save/） - 生成TXT、EPUB等格式文件UI层（src/ui/） - 提供用户界面和进度显示
扩展开发：为新网站添加支持
为新的小说网站添加支持非常简单。你只需要继承BaseRuleClass并实现关键方法：
export default class NewSiteRule extends BaseRuleClass {
async bookParse() {
// 实现书籍信息提取逻辑
}
async chapterParse() {
// 实现章节内容提取逻辑
}
}
novel-downloader能够正确处理图文混合内容，保留原始排版
💡 最佳实践：高效使用技巧大公开
性能优化策略
合理设置并发数：在设置中调整downloadThreads参数，避免对目标网站造成过大压力启用断点续传：大型小说可分批次下载，利用章节筛选功能实现利用缓存机制：重复下载相同内容时会使用本地缓存，节省时间和流量
错误处理与调试
当遇到下载问题时，可以启用调试模式：
在设置中开启调试选项下载生成的ZIP文件中包含debug.log查看控制台输出获取详细错误信息
重要提示：调试日志可能包含敏感信息，请勿直接上传到公开平台。
批量处理技巧
对于系列作品或多部小说，可以编写自动化脚本进行批量处理：
// 批量下载示例
const novelUrls = [
'https://example.com/novel/1',
'https://example.com/novel/2',
'https://example.com/novel/3'
];
novelUrls.forEach(url => {
window.open(url); // 自动打开页面并触发下载
});
下载的TXT文件在文本编辑器中的显示效果，格式清晰可读
🔮 未来展望：共同建设更好的数字阅读生态
社区参与与贡献
novel-downloader是一个完全开源的项目，欢迎所有开发者参与贡献：
添加新网站支持：参考现有规则文件编写新规则改进现有功能：优化解析算法或添加新特性修复问题：提交issue或直接提交PR
项目代码托管在https://gitcode.com/gh_mirrors/no/novel-downloader，采用AGPL-3.0开源协议。
未来发展方向
项目团队正在探索以下功能增强：
智能推荐系统：基于阅读习惯推荐相似作品云同步功能：多设备间阅读进度同步阅读统计：记录阅读时间和进度分析格式转换：支持更多电子书格式输出
资源保护与合理使用
novel-downloader的设计初衷是帮助读者保存可能消失的优秀作品。我们鼓励用户：
尊重版权：仅下载已购买或合法获取的内容合理使用：个人阅读使用，不进行商业传播支持作者：喜欢的作品请通过正规渠道支持创作者
📚 结语：打造属于你的数字图书馆
novel-downloader不仅仅是一个下载工具，它是数字阅读时代的重要辅助。通过这个工具，你可以：
建立个人书库：收藏喜欢的作品，随时重温经典实现离线阅读：摆脱网络限制，随时随地享受阅读保护阅读资源：应对网站关闭或内容下架风险个性化定制：按照自己的喜好调整阅读体验
无论你是技术爱好者想要深入了解网页解析技术，还是普通读者希望更方便地保存网络小说，novel-downloader都能提供强大的支持。开源项目的魅力在于社区的共同建设，期待更多人加入这个项目，共同完善这个优秀的工具。
温馨提示：使用任何网络工具都应遵守相关法律法规和网站使用条款，尊重内容创作者的劳动成果。novel-downloader旨在帮助读者更好地管理和保存已获取的阅读内容，请合理使用这一强大工具。
现在就开始你的小说下载之旅吧！访问项目仓库https://gitcode.com/gh_mirrors/no/novel-downloader，按照指南安装脚本，开启你的数字阅读新体验。
【免费下载链接】novel-downloader 一个可扩展的通用型小说下载器。 项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader