番茄小说下载器完整使用指南

番茄小说下载器是一个功能强大的开源工具，支持多种格式的小说下载和本地保存。通过Python实现，它可以让用户轻松下载番茄小说网上的小说内容，并提供多种输出格式选择。

项目介绍

番茄小说下载器是一个专为番茄小说爱好者设计的下载工具，支持以下核心功能：

• 通过小说ID或链接直接下载整本小说
• 支持多种保存格式：整本TXT、分章TXT、EPUB电子书、HTML网页、LaTeX文档
• 智能更新已下载的小说内容
• 小说搜索功能
• 批量下载管理
• 支持本地程序、Web版和手机版多种运行方式

快速启动指南

本地程序启动方式

1. 克隆项目到本地：

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

2. 进入项目目录：

cd fanqienovel-downloader

3. 安装Python依赖：

pip install -r requirements.txt

4. 运行主程序：

python ref_main.py

Web版启动方式

1. 安装依赖后，进入src目录：

cd src

2. 启动Web服务器：

python server.py

3. 在浏览器中访问 http://localhost:12930 即可使用Web界面

Docker容器部署

项目提供Docker支持，可以使用以下命令快速部署：

docker compose up

或者后台运行：

docker compose up -d

部署完成后通过浏览器访问 http://localhost:12930 即可使用。

功能详解

下载模式选择

程序启动后提供多种操作选项：

1. 输入ID或链接下载 - 直接下载指定小说
2. 更新已下载小说 - 读取record.json中的ID进行内容更新
3. 搜索小说 - 通过关键词搜索目标小说
4. 批量下载 - 批量处理多个小说下载任务
5. 设置选项 - 调整下载参数和保存配置
6. 备份功能 - 备份已下载的小说和配置

保存格式说明

目前支持5种保存格式：

1. 整本保存 - 所有章节保存在单个TXT文件中
2. 分章保存 - 每个章节保存为单独的TXT文件
3. EPUB格式 - 生成标准的EPUB电子书文件
4. HTML格式 - 生成网页格式，便于在线阅读
5. LaTeX格式 - 生成学术排版格式的文档

手机端使用

通过Termux应用可以在Android手机上运行：

1. 安装Termux并配置清华源
2. 安装必要的Python包
3. 删除ref_main.py中的tkinter导入
4. 运行python ref_main.py

具体配置步骤参考项目中的phone.md文档。

配置选项详解

程序提供丰富的配置选项，通过设置菜单可以调整：

• 段首占位符 - 控制章节开头的空格数量
• 下载延时 - 设置请求间隔防止被限制
• 保存位置 - 自定义小说存储目录
• 保存模式 - 选择输出格式
• 空格模式 - 全角或半角空格选择

常见问题解答

网络连接问题

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

Cookie获取失败

程序会自动获取和更新Cookie，如果连续失败请检查网络环境。

章节下载异常

某些章节可能因网络问题下载失败，程序会自动重试并记录错误信息。

注意事项

1. 请合理使用下载功能，避免对服务器造成过大压力
2. 下载内容仅限个人使用，请尊重版权
3. 定期更新程序以获取最新功能和修复
4. 修改配置前建议备份原有设置

项目结构

fanqienovel-downloader/
├── src/                 # 源代码目录
│   ├── main.py         # 主程序逻辑
│   ├── server.py       # Web服务器
│   ├── charset.json    # 字符编码配置
│   ├── static/         # 静态资源
│   └── templates/      # 网页模板
├── requirements.txt    # Python依赖
├── Dockerfile         # Docker构建文件
└── docker-compose.yml # Docker编排配置

通过本指南，您可以快速上手使用番茄小说下载器，享受便捷的小说下载和管理体验。记得遵守使用规则，合理使用这一强大工具。