番茄小说下载器使用指南

概述

番茄小说下载器是一款开源工具，专门用于下载番茄小说网上的小说内容。该项目基于Python开发，支持多种操作系统环境，提供本地程序、Web版本和移动端等多种运行方式，为用户提供便捷的小说下载和管理服务。

核心功能

• 多格式下载：支持整本保存、分章节保存、EPUB电子书、HTML网页和LaTeX格式
• 批量操作：可实现多本小说的队列下载和批量处理
• 内容更新：自动检测并更新已下载小说的最新章节
• 搜索功能：通过小说ID或名称快速查找目标作品
• 在线阅读：Web版本支持直接在浏览器中阅读小说内容

安装部署

环境准备

首先需要安装必要的Python依赖包：

pip install tqdm requests urllib3 lxml ebooklib Flask beautifulsoup4

项目获取

通过Git克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader.git
cd fanqienovel-downloader

本地程序运行

进入项目src目录，运行主程序：

cd src
python ref_main.py

程序启动后，根据提示输入小说ID或链接即可开始下载。

Web服务器部署

使用Flask框架运行Web版本：

cd src
python server.py

服务启动后，在浏览器中访问 http://localhost:12930 即可使用Web界面。

Docker容器部署

使用Docker Compose快速部署：

docker-compose up

容器启动后，通过浏览器访问对应端口即可使用Web服务。

使用场景

单本小说下载

输入小说的目录页面链接或ID编号，程序会自动解析并下载整本小说内容。支持实时进度显示和下载状态监控。

批量小说管理

通过批量下载模式，可以一次性添加多本小说到下载队列。系统会自动按顺序处理所有任务，并提供详细的下载报告。

内容更新维护

对于已下载的小说，程序可以定期检查更新，自动下载新增章节内容，保持本地图书馆的最新状态。

格式转换导出

支持将下载的小说转换为多种格式，包括适用于电子阅读器的EPUB格式、便于网页浏览的HTML格式，以及学术用途的LaTeX格式。

扩展工具

网页结构检测工具

配套工具可以检测番茄小说网的网页结构变化，确保下载器能够适应网站更新，维持稳定的下载功能。

小说内容搜索工具

提供本地小说库的内容搜索功能，支持关键词检索和全文搜索，方便用户快速定位感兴趣的内容。

文件分割工具

根据文件大小自动分割小说内容，生成适合不同阅读设备的分卷文件，提升阅读体验。

注意事项

使用本工具时请遵守相关法律法规和网站使用条款，仅用于个人学习和研究目的。建议合理控制下载频率，避免对源站造成不必要的负担。

程序配置文件位于config.json，修改设置选项时会覆盖原有配置。如需恢复默认设置，只需删除该配置文件即可。