写了个番茄小说一键下载器:免登录全本导出与零配置本地 WebUI
有时候想把追的小说存到电纸书离线看,或者留一份排版干净的本地文本备用。
番茄小说虽然书库全,但网页端通常只放前几章,正文还加了自定义字体混淆(Unicode 私有区映射);App 端虽然内容完整,但满屏信息流广告,复制出来还附带一长串推广杂质。市面上能找到的下载工具,要么接口早已失效,要么依赖一整套复杂的 Node.js 前端编译链,甚至需要扫码绑定个人账号,稍不留神就会招致账号风控。
为了图个干净省心,我顺手写了这个轻量级的本地工具 —— fanqie-novel-downloader。核心诉求就三个:不登账号、双击即用、排版干净。
核心设计与特性
- 免登录全本下载:主力通道直接对接番茄 App 网关,利用匿名设备注册与接口动态签名拉取正文。即使是 App 独占或会员章节也能完整获取,完全无需登录个人账号,杜绝账号风险。
- 动态字体反混淆兜底:除了 App 主力通道,工具还保留了网页端备用通道。内置了 362 个字符的 Unicode 私有区(PUA)映射表,即使网页端有字体加密,也能自动还原为真实汉字。
- 纯单文件 WebUI,零构建依赖:后端基于 FastAPI,前端直接采用 Vue3 + Tailwind CSS CDN 编写成单一 HTML。不需要配置 npm,不产生庞大的
node_modules目录,极度轻量。 - 双击即用与一键彻底清理:
- Windows 用户双击
run.bat,Linux/macOS 用户执行./run.sh,脚本会自动检测 Python 环境、创建专属虚拟环境并拉起浏览器界面。 - 配套提供了
clean.bat/clean.sh,一键删除生成的虚拟环境与临时文件,不写注册表、不留系统垃圾。 - 规整 TXT 导出与实时进度:基于 SSE(Server-Sent Events)向前端流式推送下载进度与当前章节名称;导出的 TXT 文件带有 UTF-8 BOM,Windows 自带记事本打开绝不乱码,章节标题与段落全角缩进均已统一排版。
背后的一点技术细节
工具的核心下载逻辑采用了双通道设计:
- APP 网关主通道:
- 首先向设备注册接口提交经过 TTEncrypt(gzip + SHA512 + AES-CBC)加密的设备元数据,获取合法的匿名
device_id。 - 随后通过内置算法生成带有
x-argus与x-ladon动态签名的请求头,分批获取加密 XHTML 章节内容。 - 客户端通过 AES-CBC 解密正文。由于 App 端下发的是解密后直接可读的标准排版内容,因此完全避开了网页端复杂的字体映射逻辑。
- 频率与防风控控制:
- 网关对单设备高频请求相当敏感,工具默认设置为 30 章/批、批次间休眠 6 秒。实测 300~400 章的完结书约一分钟左右即可平稳下载完成,避免因触发频率阈值导致接口返回空响应。
快速使用
项目已在 GitHub 开源,代码与启动脚本均已就绪:
运行方式
Windows:
直接双击项目根目录下的 run.bat。
macOS / Linux:
chmod+xrun.sh
./run.sh
打开浏览器界面后:
1. 复制番茄小说 App 或网页端的任意分享文本(包含短链、链接均可);
2. 粘贴至输入框,点击 「解析书籍」;
3. 确认书名、作者与简介无误后,点击 「开始下载」;
4. 下载完毕后点击 「下载 TXT」,文件将保存在本地 downloads/ 目录中。
免责声明
本项目仅供个人编程学习、Python 异步开发与网络接口协议逆向的技术交流使用,请勿用于大规模商业爬取。小说内容版权归原作者及版权平台所有,请支持正版阅读。
— 本文由 AI 助手代笔