追更的小说突然404靠什么抢救novel-downloader 小说下载器完整上手方案【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader如果你在起点、晋江或刺猬猫追过连载大概率经历过这样的时刻某天照常点开书架发现收藏的小说毫无征兆地消失连购买过的章节也一并人间蒸发。这种404并不罕见——平台清理、版权到期、整站关停理由千奇百怪结果却只有一个你花钱和时间追完的故事再也找不回来了。而 novel-downloader 小说下载器要解决的正是这个问题在小说还在线上的时候把它完整、干净地搬回你自己的硬盘。为什么手动另存为永远救不了你的书单在介绍方案之前先拆解一下问题到底出在哪几环。第一环平台的删除机制不可预测。不少网站对已入库作品存在主动下架机制与热度、是否入V、读者是否订阅都无关。有些小说首发站找不到却被笔趣阁等转载站收录读者尚能睹其风采但更多不够热门的作品根本没有转载站愿意搬运一旦下架就是彻底消失。第二环人工备份的成本被严重低估。一部三百万字的小说动辄上千章节逐个复制粘贴会消耗大量时间就算借助浏览器的另存为得到的也是夹杂广告、导航、脚本报错的脏页面几乎不可读。第三环常见的抓取工具过不了反爬。如今不少站点会用字体加密、图片替换正文、Shadow DOM 隔离等手段对抗采集普通的读取页面源码思路在第一关就会卡住。这三环叠加决定了随时可读的离线副本必须由专门工具来完成而不是靠运气和耐心。novel-downloader 的解题思路把每个站点当作一个可插拔的规则文件作为一个可扩展的通用型小说下载器novel-downloader 没有采用一套抓取逻辑打天下的笨办法而是把适配能力拆散到src/rules/目录下按站点类型归档单页站点、目录翻页站点、需要登录鉴权的特殊站点、以及存在图片防爬的转载站各自拥有独立的规则文件。想支持新网站通常只需新建一个规则文件并注册路由不动核心逻辑。针对反爬它的处理也分了三层图片文字解码某些站点把正文汉字替换成图片脚本按文件名映射 → 哈希映射 → OCR识别的顺序依次尝试前两层靠本地映射表秒级完成最后一层才动用 PaddleOCR 模型兜底实现见src/lib/decoders/。字体映射晋江、番茄等站点用自定义字体渲染文字下载后文档会出现乱码脚本内置字体匹配表如src/rules/lib/hongxiuzhao.ts也可按日志提示手动补齐。Shadow DOM 穿透针对 closed shadow-root 的现代前端框架专门实现了穿透查询工具src/lib/pierceShadow.ts让内容在看不见的组件树里也能被捞出来。与两种传统做法相比差异很直观方案成品可读性反爬适配章节完整性扩展新站成本浏览器另存为低夹杂大量页面杂质无需手动翻页不适用通用爬虫脚本中需自行清洗弱遇加密即失败需自写调度每站重写novel-downloader 小说下载器高输出TXT与EPUB双格式三层解码字体映射自动遍历目录与分卷一个规则文件即可从零到跑通第一次下载的 4 步实操路径第一步装好脚本管理器脚本以油猴脚本形式分发因此浏览器需要先安装 Tampermonkey、Violentmonkey 或 Greasemonkey 之一。三者任选其一直接在浏览器扩展商店搜索安装即可全程无需配置。第二步获取并安装脚本两种方式任选直接安装从脚本分发渠道如 Greasyfork一键安装最新版适合想马上使用的新手。本地构建想要源码级掌控可执行以下命令编译产物git clone https://gitcode.com/gh_mirrors/no/novel-downloader cd novel-downloader yarn install yarn run build构建完成后把生成的dist/bundle.user.js拖入脚本管理器即可完成安装。第三步打开目录页并触发下载进入任意受支持小说的目录页网页右上角会出现下载图标点击即开始。脚本会在后台播放无声音频防止浏览器休眠机制中断任务长篇小说等待时间较长此时可以切到其他标签页继续做自己的事。第四步查看进度与产物下载过程中可通过右下角进度条了解状态或按 F12 打开控制台查看实时日志。任务完成后会自动产出两个文件TXT 纯文本记事本、阅读 App 通吃和 EPUB导入任意电子书阅读器即可排版阅读。提示如果打开页面后右上角没有出现下载图标且该站是单页应用如长佩、pixiv按 F5 强制刷新当前页面通常即可解决。4 个容易被忽略的高价值用法1. 用自定义筛选函数只下载想要的章节点击下载前在控制台定义window.chapterFilter即可按任意规则裁剪章节。比如只保留前 100 章或只下载某卷、某关键词章节超长篇分批次下载的常见诉求都能一行函数搞定。function chapterFilter(chapter) { return chapter.sectionNumber 1; // 只下载第一卷 } window.chapterFilter chapterFilter;2. 用自定义保存参数重塑输出样式window.saveOptions可以控制章节标题格式、TXT 段落缩进、EPUB 空行清理甚至章节排序。比如把标题统一改成第x章 xxx的格式或者给 TXT 每个自然段前补上缩进空格让导出的文件更符合个人排版习惯。设置面板中也提供了自定义下载设置可调整并行线程数与下载间隔应对反爬严格的站点。3. 用完成回调自动收尾定义window.customFinishCallback下载完成后脚本会自动执行你的逻辑例如自动关闭当前标签页——适合深夜挂机批量下载的场景。4. 用调试模式精准定位问题在设置面板开启调试模式后下载生成的 ZIP 内会附带debug.log若任务卡住没产出任何文件可开启测试视图复制日志选项卡内容。排查问题时这些信息远比描述现象有效。高频问题速查表问题结论下载速度太慢怎么办设置中提高并行下载线程数建议 3–5反爬严格的站点可降到 1–2 并增加下载间隔下载的章节有乱码或特殊字符多为站点字体加密查看日志中[jjwxc-font]或[fanqie-font]提示并按指引处理付费章节下载不了需先在对应网站登录并购买该章节未购买章节会被直接跳过这是刻意设计支持列表里没有我想要的网站可在项目 issue 区反馈更欢迎直接贡献规则代码下载过程中内存占用过高图片较多的站点如 Lofter注意监控内存或使用筛选函数分次下载参与这个开源项目三种方式都欢迎novel-downloader 的价值不止于能用更在于它把站点适配的门槛降到了单个文件。想深度参与可以从三个入口进入反馈遇到问题先在支持页面检索是否已有重复 issue再按模板提交并附上调试日志。提交规则阅读src/rules/下同类站点的实现继承基础类补全bookParse与chapterParse再在src/router/download.ts注册路由、在src/header.json补充匹配规则即可。共建映射数据图片映射表、字体映射表这类脏活数据同样需要社区持续维护随手提交一份就能帮到很多人。最后提醒一句工具负责保存内容选择权在你。只下载已购买或合法获取的作品、不过度压榨目标站点、不将产物用于商业用途是让这个生态长期运转的基本默契。下一次当你喜欢的作品悄然消失时希望你的硬盘里早已有了一份干净的备份——这就是 novel-downloader 小说下载器存在的全部理由。现在打开你常逛的小说网站点一下右上角那个下载图标离线阅读自由就从这一步开始。【免费下载链接】novel-downloader一个可扩展的通用型小说下载器。项目地址: https://gitcode.com/gh_mirrors/no/novel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
