小说下载器终极指南从零开始掌握多平台小说下载与本地化阅读【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloadernovel-downloader 是一款功能强大的浏览器脚本工具专门用于从多个小说网站下载小说内容并保存为本地文件。无论你是想要离线阅读、备份珍贵小说资源还是进行二次开发这款工具都能满足你的需求。本文将为你提供完整的安装配置、核心功能使用和高级定制指南帮助你充分利用这个开源工具。 准备篇环境搭建与基础配置1.1 项目获取与安装首先你需要获取 novel-downloader 的脚本文件。由于这是一个油猴脚本Tampermonkey 脚本你需要在浏览器中安装脚本管理器安装脚本管理器推荐使用 Tampermonkey支持 Chrome、Firefox、Edge 等主流浏览器也可以选择 Violentmonkey 或 Greasemonkey获取脚本文件git clone https://gitcode.com/gh_mirrors/no/novel-downloader或者直接在脚本管理器中安装GitHub 版更新最快https://github.com/404-novel-project/novel-downloader/raw/gh-pages/bundle.user.jsGreasyFork 版无压缩https://greasyfork.org/scripts/406070/code/小说下载器.user.js[!TIP]为什么这样做使用脚本管理器可以确保脚本在浏览器环境中稳定运行同时方便管理和更新。GitHub 版本更新更及时而 GreasyFork 版本便于查看源码。1.2 基础配置与权限说明novel-downloader 需要一些特殊权限来正常运行// 脚本所需权限 unsafeWindow // 获取自定义筛选函数、自定义保存参数等设置 GM_info/GM.info // 获取并输出脚本运行环境 GM_xmlhttpRequest // 用于跨域 HTTP 请求 GM_setValue // 本地存储统计信息核心配置文件src/setting.ts 包含了所有默认设置你可以根据需要进行调整。上图展示了 novel-downloader 在浏览器中运行的界面可以看到控制台中显示详细的下载日志包括章节获取状态和进度信息。1.3 支持网站概览novel-downloader 支持超过 100 个国内外小说网站包括主流中文网站起点中文网、晋江文学城、番茄小说、七猫中文网轻小说平台SF 轻小说、轻之文库、小説家になろう日本原创文学站长佩文学、海棠文化、息壤中文网转载站点笔趣阁系列、UU 看书网、69 书吧完整支持列表可在脚本设置中查看涵盖公共章节和付费章节下载需登录相应账号。 核心篇实战操作与功能详解2.1 快速开始下载使用 novel-downloader 下载小说非常简单打开目标小说目录页等待脚本加载页面右上角会出现下载图标点击下载按钮开始下载监控下载进度通过右下角进度条或 F12 控制台[!TIP]为什么这样做脚本会自动检测当前页面是否支持下载并在支持时显示下载按钮。这种方式无需手动配置用户体验友好。2.2 下载结果与格式下载完成后脚本会自动生成以下文件TXT 文档纯文本格式适合快速阅读和搜索EPUB 文件标准电子书格式支持目录导航和格式排版HTML 文件包含原始网页样式的章节文件下载完成后生成的小说目录页面保留了原网站的章节结构和封面信息便于离线阅读和导航。2.3 高级下载设置在脚本设置面板中你可以自定义下载参数// 自定义下载设置示例 { 并行下载线程数: 5, // 同时下载的章节数量 下载间隔: 1000, // 每章节下载间隔毫秒 最大下载间隔: 5000 // 最大间隔时间毫秒 }为什么需要这些设置并行下载线程数提高下载效率但设置过高可能导致网站封禁下载间隔避免触发网站反爬机制最大下载间隔防止因网络问题导致的无限等待2.4 OCR 图像文字识别功能一些小说网站如西瓜书屋为了防止文本被抓取会把文字替换成图片。novel-downloader 采用三层解码方案文件名映射根据图片文件名直接匹配文字最快哈希映射下载图片计算哈希值匹配较快OCR 识别使用 PaddleOCR 识别图片文字最准确但最慢[!NOTE] OCR 功能使用 PaddleOCR 中文识别模型模型文件会自动从 GitHub 下载并保存在本地存储中。下载的章节内容保持了原网页的排版格式包括段落结构、对话标记等确保离线阅读体验与在线一致。 扩展篇高级定制与二次开发3.1 自定义筛选函数如果你只想下载部分章节可以使用自定义筛选函数// 示例只下载前100章 function chapterFilter(chapter) { return chapter.chapterNumber 100; } // 示例只下载第一卷 function chapterFilter(chapter) { return chapter.sectionNumber 1; } // 示例只下载包含特定关键词的章节 function chapterFilter(chapter) { return chapter.chapterName.includes(武器); }使用方法在浏览器控制台F12中创建window.chapterFilter函数然后点击下载按钮。3.2 自定义保存参数你可以自定义保存文件的样式和内容格式// 自定义章节命名格式 const saveOptions { getchapterName: (chapter) { if (chapter.chapterName) { return 第${chapter.chapterNumber.toString()}章 ${chapter.chapterName}; } else { return 第${chapter.chapterNumber.toString()}章; } } }; // 自定义段落样式 const saveOptions { mainStyleText: p { text-indent: 2em; line-height: 1.8; margin: 1em 0; } }; // 自动注入脚本长期使用 // UserScript // name Noveldownloader Settings // match *://*/* // grant none // /UserScript (function() { const saveOptions { /* 你的配置 */ }; window.saveOptions saveOptions; })();3.3 添加新网站支持novel-downloader 采用模块化设计添加新网站支持非常简单。扩展模块目录src/rules/ 包含了所有网站的解析规则。基本规则模板结构// src/rules/onePage/template.ts 中的基础结构 export default { name: example-site, match: (url: string) url.includes(example.com), bookParse: (doc: Document) { // 解析书籍信息 return { bookUrl: url, bookname: 书名, author: 作者, introDom: introElement, coverUrl: 封面URL, aList: chapterLinks, sections: sectionElements }; }, chapterParse: (doc: Document) { // 解析章节内容 return contentElement; } };开发流程继承BaseRuleClass类实现bookParse和chapterParse方法在router/download.ts中添加选择规则在header.json的match字段添加匹配规则运行yarn build编译生成最终脚本3.4 Token 配置与高级认证部分网站如晋江文学城、息壤中文网需要手动配置登录 token// 晋江文学城 token 配置 const tokenOptions { Jjwxc: { token: 11111111_750afc84c839aaaaafccd841fffd11f1, user_key: 11ffffff-11ff-11ff-11ff-111111111fff }, Xrzww: { deviceIdentify: webh517657567560, Authorization: Bearer 453453453e03ee546456546754756756 } }; window.tokenOptions tokenOptions;获取 token 的方法脚本自动获取首次打开晋江页面时点击设置中的获取token按钮手动抓包使用抓包工具如 HttpCanary、Charles获取 Android app 的请求头信息3.5 调试与问题排查启用调试模式可以获取详细的日志信息在设置中启用调试模式下载完成后检查生成的debug.log文件或使用测试视图查看实时日志常见问题及解决方案下载卡住检查网络连接调整下载间隔设置乱码问题检查字体匹配表可能需要手动提交字体信息内存不足对于图片较多的站点如 Lofter使用筛选函数分批次下载 总结与最佳实践novel-downloader 作为一个成熟的小说下载工具提供了从基础下载到高级定制的完整解决方案。以下是使用建议定期更新脚本关注项目更新获取最新的网站支持和功能改进合理使用并行下载根据网站反爬策略调整线程数备份重要配置将自定义的筛选函数和保存参数备份到用户脚本中参与社区贡献遇到不支持的新网站时可以在项目 issue 中反馈或自行开发规则通过本文的介绍你应该已经掌握了 novel-downloader 的核心功能和高级用法。无论是简单的离线阅读需求还是复杂的二次开发项目这款工具都能提供强大的支持。开始你的小说下载之旅吧【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考