番茄小说下载器项目完整使用教程

番茄小说下载器是一个功能强大的开源工具，可以帮助读者下载和保存番茄小说平台上的小说内容。该项目支持多种下载格式和丰富的自定义选项，让用户可以灵活地管理自己的小说收藏。

项目概述

番茄小说下载器由Python开发，提供了本地命令行版本和Web版本两种使用方式。项目采用模块化设计，支持多线程下载、断点续传、多种输出格式等功能。

项目结构

fanqienovel-downloader/
├── src/                    # 源代码目录
│   ├── main.py            # 本地命令行版本主程序
│   ├── ref_main.py        # 手机版适配程序
│   ├── server.py          # Web服务器版本
│   ├── charset.json       # 字符编码配置文件
│   ├── static/            # 静态资源
│   │   ├── css/style.css  # 样式文件
│   │   └── js/main.js     # JavaScript脚本
│   └── templates/         # HTML模板
│       ├── index.html     # 主页模板
│       └── components/    # 组件模板
│           ├── library.html
│           ├── reader.html
│           ├── search.html
│           └── settings.html
├── Dockerfile             # Docker容器配置
├── docker-compose.yml     # Docker编排配置
├── requirements.txt       # Python依赖包
├── phone.md              # 手机版使用说明
└── README.md             # 项目说明文档

功能特性

支持多种下载格式

• 整本TXT：将所有章节合并为一个文本文件
• 分章TXT：每个章节保存为单独的文本文件
• EPUB电子书：生成标准EPUB格式电子书
• HTML格式：生成网页格式便于在线阅读
• LaTeX格式：生成学术排版格式

智能下载功能

• 多线程并行下载，大幅提升下载速度
• 断点续传支持，网络中断后可继续下载
• 自动重试机制，处理网络波动问题
• 智能字符解码，正确处理小说特殊编码

自定义配置选项

• 段首空格设置：可自定义段落缩进字符和数量
• 下载延时调整：设置请求间隔避免被封禁
• 保存路径配置：自定义小说保存位置
• 线程数控制：调整并发下载线程数量

安装方法

方法一：Python环境运行

1. 克隆项目到本地：

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

2. 安装依赖包：

pip install -r requirements.txt

3. 运行本地版本：

cd src
python main.py

4. 运行Web版本：

cd src
python server.py

方法二：Docker容器运行

1. 使用Docker Compose一键部署：

docker-compose up -d

2. 访问Web界面： 打开浏览器访问 http://localhost:12930

方法三：手机Termux运行

1. 安装Termux并换源
2. 安装必要的Python包
3. 运行手机适配版本

使用教程

本地命令行版本

启动程序后，您将看到以下选项：

1. 输入小说ID或链接：直接下载指定小说
2. 更新已下载小说：读取记录文件更新已有小说
3. 搜索小说：通过关键词搜索小说
4. 批量下载：批量下载多本小说
5. 设置选项：配置下载参数
6. 备份数据：备份下载的小说和配置
7. 退出程序

Web界面版本

Web版本提供图形化操作界面，包含以下功能模块：

• 小说库管理：查看已下载的小说列表
• 搜索功能：通过名称或ID搜索小说
• 在线阅读器：直接在浏览器中阅读小说
• 设置面板：调整各种下载参数
• 下载队列：管理批量下载任务

配置说明

配置文件位置

程序会自动在data目录下生成配置文件：

• config.json：主要配置文件
• record.json：下载记录文件
• cookie.json：网络会话文件

重要配置项

{
  "kg": 2,                     // 段首空格数量
  "kgf": "　",                 // 段首空格字符
  "delay": [50, 150],          // 下载延时范围(毫秒)
  "save_path": "./downloads",  // 保存路径
  "save_mode": 1,              // 保存模式(1-5)
  "xc": 8,                     // 线程数量
  "space_mode": "halfwidth"    // 空格模式
}

常见问题解答

Q1：网络连接错误

如果出现代理连接错误，请检查网络设置，关闭VPN或代理软件后重试。

Q2：下载内容乱码

程序内置字符解码器，会自动处理番茄小说的特殊编码格式。

Q3：下载速度慢

可以适当增加线程数(xc)，但请注意不要设置过高以免被封IP。

Q4：章节顺序错乱

程序会按照原始章节顺序下载和保存，确保章节顺序正确。

注意事项

1. 合理使用：请勿频繁大量下载，尊重网站服务器负载
2. 版权声明：下载内容仅限个人学习使用，请勿用于商业用途
3. 数据备份：定期备份data目录下的重要文件
4. 更新维护：关注项目更新，及时获取最新版本

技术特点

• 采用异步IO和多线程技术，提高下载效率
• 模块化设计，便于功能扩展和维护
• 支持跨平台运行（Windows、Linux、macOS）
• 提供RESTful API接口，便于二次开发

通过本教程，您应该能够顺利安装和使用番茄小说下载器。如果在使用过程中遇到任何问题，可以参考项目文档或寻求社区帮助。