番茄小说下载器完整上手指南一条链接三步搭起个人离线书库【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader番茄小说下载器fanqienovel-downloader是一款用 Python 写的开源小工具给它一条书籍链接或一串 ID它就能把整本番茄小说抓成本地文件实现真正的番茄小说离线下载。它的价值主张只有一句——把在线阅读变成真正属于你自己的资产。先从一次书没了说起离线书库到底解决什么这一节先说清楚你天天在线阅读真正该防的麻烦是哪三件。有天晚上我在地铁上翻收藏夹追了三个多月的那本小说点进去只剩一行提示章节锁定。那一刻我才意识到在线阅读的读者手里其实什么都没有——页面存在别人的服务器上人家一改规则你连个备份都拿不出来。这个工具的诞生就是为了让书真正到手。它顺手解决了三件日常小事地铁、地下室、长途高铁这些信号死角照常能读平台下架、章节锁定、内容删改都动不了你本地那份换手机、换平板、换电纸书拷一份文件就走一句话总结它把阅读的主动权从平台手里重新放回读者手里。三步跑通网页版把第一本书下载到本地这一节的目标很单纯——从零开始三步之内把第一本书完整落到硬盘上。最省事的入口是网页版图形界面、进度条、下载队列都有全程不用碰代码逻辑。按顺序执行git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader cd fanqienovel-downloader pip install -r requirements.txt cd src python server.py然后用浏览器打开http://localhost:12930就看到管理界面了。想验证它好不好用别急着研究设置直接做一件事把一本小说的 ID 粘进去回车。页面功能其实很直白按书籍 ID 下载也支持贴完整目录页链接按书名搜索找书更新之前下载过的小说队列设计几本书排队批量处理实时进度条下载状态一目了然下载完成后浏览器直接把文件交给你内置在线预览阅读器一个小提示Web 版是服务器下载、浏览器取文件的模式所以它完全可以部署在远程服务器或容器里随时远程调用本地机器零负担。一条链接背后程序替你干了三件事这一节回答新手最常见的疑问——把链接扔进去之后黑窗口里到底在忙什么其实整个下载过程可以拆成三步流水线识书解析目录页自动识别书籍 ID 和章节结构。给完整链接可以只给一串数字 ID 也可以抓文逐章请求正文。为了不被当成脚本程序会随机切换浏览器 UA、自动初始化 cookie并在两次请求之间插入随机延时归档把抓到的章节按你指定的格式落盘同时把这本书的 ID 记进record.json为以后补更新留底有个细节值得单独夸cookie 是程序自动获取和检测的不需要你手动登录、复制粘贴任何凭证第一次跑通特别省心。整条流水线的结果就是一本排版干净的本地小说。五种保存格式怎么选一张表看清这一节帮你做一道选择题——下载完成后存成什么格式才最贴合你的阅读习惯。目前版本支持五种保存方式分别对应不同场景保存方式一句话说明适合谁整本保存单文件 TXT全书装进一个 .txt图省事、要体积最小分章保存每章一个 TXT一章一个文件想按章节整理、做批注EPUB 电子书格式标准电子书文件手机阅读 App、电纸书用户HTML 格式浏览器直接打开即读想立刻预览排版效果LaTeX 格式可二次编辑的排版源排版控、要做内容加工我自己的习惯是手机里放 EPUB电脑上留一份整本 TXT 当备份需要剪裁内容时才生成 LaTeX。这些选项在设置里随时切换不需要安装任何额外的格式转换工具。命令行版与手机版不打开浏览器也能下载这一节写给不爱开浏览器的人——命令行版把全部操作浓缩成了六个数字纯键盘就能完成同样的下载。进入src目录运行python main.py交互菜单长这样直接输入 ID 或目录页链接 → 立即下载单本书 输入 1 → 读取 record.json更新已下载书籍 输入 2 → 关键词搜索 输入 3 → 批量下载多本书 输入 4 → 设置段首占位符、延时、保存路径、保存方式 输入 5 → 备份小说文件与下载配置 输入 6 → 退出程序每层都有中文提示跟着走就行。想在手机上跑安卓装个 Termux运行的是ref_main.py——先把文件里 tkinter 的导入删掉再安装requests ebooklib tqdm beautifulsoup4这几个依赖如果安装 lxml 编译报错用CFLAGS-O0 pip install lxml重装即可。通勤路上想临时补一本手机完全够用。番茄小说批量下载与自动追更的完整流程这一节解决追更读者的核心痛点——连载小说每天更新怎么让下载器替你盯梢。答案是两条现成通道单本靠更新整批靠队列和脚本。每次下载完成书籍 ID 都会写进record.json想补新章节命令行输入 1 或网页版点更新程序自动对比已下载章节、只抓增量追更连载时每天跑一次即可。如果有一整批书要收写一段几行的循环脚本就能逐本处理novel_ids(7143038691944959011 7123456789012345678) for id in ${novel_ids[]}; do echo 开始下载$id python main.py $id sleep 2 done配合网页版的队列设计多本书排队依次处理追更这件事基本可以做到半自动。把下载速度调成舒适模式四个参数足够这一节讲调参——怎么让下载既不慢得难受又不会被网站的反爬机制盯上。核心配置由四个参数控制改完会保存在config.json里参数默认值作用使用建议delay[50, 150]章节请求间隔毫秒网络差时调大更稳xc16并发下载线程数网络好可提到 24 左右手机端调低save_mode1保存方式对应上文五种格式save_path默认下载目录小说保存位置改成自己顺手的位置网络状况良好的环境里适当降低延时、线程数提到 24 左右下载速度会明显提升手机端则建议调低线程数避免设备过热。这里有个必须记住的坑设置是整体覆盖式保存改任意一项都会覆盖原配置文件想恢复默认直接删除config.json再重启程序。新手排错速查五个常见坑一次讲完这一节是一份排错清单把最容易卡住新手的地方集中讲一遍遇到报错先来对号入座旧版本直接失效v1.1.5 及以下版本因官网 API 变动已无法使用务必使用 v1.1.6 及以上版本当前最新为 v1.1.14报 ProxyError / MaxRetryError多半是系统代理或加速器拦截了请求关闭代理、检查网络后重试设置被整体覆盖修改设置中的任意一项都会覆盖原配置改前先看清楚恢复默认就删config.json老版本 Python 兼容Python 3.8 及以下环境需把src目录里的原main.py删除再将main2.py改名为main.py后运行手机端 lxml 装不上按CFLAGS-O0 pip install lxml重装即可下载器之外配套工具让流水线成型这一节介绍三个与下载器配套的小工具——它们让下载从单点功能升级成一条完整的小说管理流水线。第一个用于检测番茄小说网页结构变化页面改版时能第一时间发现避免下载静默失败第二个用于在已下载的小说里做全文搜索想找某句台词、某个角色出场不用再翻几十个文件第三个按文件大小切分超长小说一本几百万字的书可以按需切成若干分卷。下载、搜索、分卷三步串联起来一套个人小说管理流水线就齐了相关说明集中在项目根目录的文档里按需查阅即可。守住边界也守住你的书单最后这一节想认真提醒两件事工具好用但边界要守住项目开源但作者需要被尊重。这个下载器的定位是个人学习、研究与离线阅读请一定不要高频抓取、不要商用传播尊重作者版权遵守网站的使用政策。项目遵循 AGPL-3.0 协议开源由 Yck、Yqy、Lingo 三位开发者维护遇到问题可以去 Issues 反馈或在交流群 428582738 里和开发者、其他用户一起讨论。那么下一步就去做把这个项目 clone 下来用你最近正在追的那本书试一次。五分钟之后你的专属离线书库就正式开张了——从此信号再差、平台再变书单始终都在你手里。【免费下载链接】fanqienovel-downloader下载番茄小说项目地址: https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考