Mr.Lee 页面横幅
个人博客,记录代码、项目与生活。

写了个番茄小说一键下载器:免登录全本导出与零配置本地 WebUI

  • HOME
  • 随笔
  • 写了个番茄小说一键下载器:免登录全本导出与零配置本地 WebUI

写了个番茄小说一键下载器:免登录全本导出与零配置本地 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 自带记事本打开绝不乱码,章节标题与段落全角缩进均已统一排版。


背后的一点技术细节

工具的核心下载逻辑采用了双通道设计:

  1. APP 网关主通道:
  2. 首先向设备注册接口提交经过 TTEncrypt(gzip + SHA512 + AES-CBC)加密的设备元数据,获取合法的匿名 device_id。
  3. 随后通过内置算法生成带有 x-argus 与 x-ladon 动态签名的请求头,分批获取加密 XHTML 章节内容。
  4. 客户端通过 AES-CBC 解密正文。由于 App 端下发的是解密后直接可读的标准排版内容,因此完全避开了网页端复杂的字体映射逻辑。
  5. 频率与防风控控制:
  6. 网关对单设备高频请求相当敏感,工具默认设置为 30 章/批、批次间休眠 6 秒。实测 300~400 章的完结书约一分钟左右即可平稳下载完成,避免因触发频率阈值导致接口返回空响应。


快速使用

项目已在 GitHub 开源,代码与启动脚本均已就绪:

运行方式

Windows:
直接双击项目根目录下的 run.bat。

macOS / Linux:

chmod+xrun.sh
./run.sh

打开浏览器界面后:
1. 复制番茄小说 App 或网页端的任意分享文本(包含短链、链接均可);
2. 粘贴至输入框,点击 「解析书籍」;
3. 确认书名、作者与简介无误后,点击 「开始下载」;
4. 下载完毕后点击 「下载 TXT」,文件将保存在本地 downloads/ 目录中。


免责声明

本项目仅供个人编程学习、Python 异步开发与网络接口协议逆向的技术交流使用,请勿用于大规模商业爬取。小说内容版权归原作者及版权平台所有,请支持正版阅读。

— 本文由 AI 助手代笔

已读 0
评论
!
弱匿名说明:依据《中华人民共和国个人信息保护法》《中华人民共和国网络安全法》《互联网跟帖评论服务管理规定》等相关规定,本站会在评论提交时记录必要的安全日志,包括昵称、IP 地址、浏览器标识和提交时间,仅用于反垃圾、滥用排查、安全审计及依法配合有权机关处理,不会公开展示。请友善表达,避免发布违法、侵权或攻击性内容。