番茄小说下载器完整使用指南：从新手到专家的详细教程

你是否曾经想要收藏喜欢的番茄小说，却苦于无法离线阅读？或者想要整理自己的小说库，却发现手动保存太麻烦？番茄小说下载器正是为你量身打造的解决方案！这款开源工具能够轻松下载番茄小说平台上的内容，支持多种格式输出，让你随时随地享受阅读乐趣。

快速上手：三分钟完成安装

环境准备与一键安装

首先确保你的系统已安装Python 3.7或更高版本。然后通过以下命令快速开始：

git clone https://gitcode.com/gh_mirrors/fa/fanqienovel-downloader
cd fanqienovel-downloader
pip install -r requirements.txt

如果你更喜欢图形化界面，可以直接运行Web版本：

cd src
python server.py

启动后打开浏览器访问 http://localhost:12930 即可使用。

首次使用配置

首次运行时，程序会自动在项目目录下创建data文件夹，包含以下重要文件：

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

核心功能详解

多格式下载支持

番茄小说下载器支持五种不同的保存格式，满足各种阅读需求：

1. 整本TXT格式 - 所有章节合并为单个文件，适合手机阅读
2. 分章TXT格式 - 每个章节独立保存，便于管理
3. EPUB电子书 - 标准电子书格式，兼容各类阅读器
4. HTML网页格式 - 精美排版，支持图片和样式
5. LaTeX学术格式 - 适合打印和学术用途

智能下载技术

程序采用先进的下载技术确保最佳体验：

• 多线程并行下载：最高支持8个线程同时工作
• 断点续传功能：网络中断后可从断点继续
• 智能重试机制：自动处理网络波动问题
• 字符编码优化：内置解码器正确处理特殊字符

自定义配置选项

在 src/main.py 中你可以找到丰富的配置选项：

# 基础配置示例
config = {
    "kg": 2,                    # 段首空格数量
    "kgf": "　",                # 段首空格字符
    "delay": [50, 150],         # 请求延时范围(毫秒)
    "save_path": "./downloads", # 保存路径
    "save_mode": 1,             # 保存模式(1-5)
    "xc": 8,                    # 线程数量
    "space_mode": "halfwidth"   # 空格模式
}

实战操作指南

命令行版本使用

进入src目录运行 python main.py 后，你会看到清晰的菜单界面：

1. 输入小说ID或链接 - 直接下载指定小说
2. 更新已下载小说 - 自动检查并更新已有内容
3. 搜索小说功能 - 通过关键词快速查找
4. 批量下载模式 - 一次性下载多本小说
5. 设置配置选项 - 调整下载参数
6. 数据备份功能 - 保护你的收藏
7. 退出程序

Web界面操作

Web版本提供更直观的操作体验：

• 小说库管理 - 查看已下载的所有小说
• 智能搜索 - 支持名称和ID双重搜索
• 在线阅读 - 直接在浏览器中阅读
• 设置中心 - 图形化配置各项参数

手机端使用说明

对于手机用户，项目提供了专门的手机适配版本。在Termux环境中运行 python ref_main.py 即可享受移动端优化体验。

高级技巧与优化

下载速度提升

想要更快地下载小说？试试这些技巧：

• 将线程数(xc)设置为4-8之间
• 适当减少延时参数，但不要低于50毫秒
• 确保网络连接稳定，关闭不必要的下载任务

存储管理建议

合理管理你的下载内容：

• 定期清理不需要的小说文件
• 使用分章TXT格式便于管理大量内容
• 设置合理的保存路径，避免占用系统盘空间

常见问题解决方案

网络连接问题

如果遇到代理连接错误，请检查：

• 是否开启了VPN或代理软件
• 网络防火墙设置是否阻止连接
• 尝试切换不同的网络环境

内容显示异常

下载后内容出现乱码或格式错乱：

• 程序会自动处理字符编码，无需手动干预
• 检查保存格式是否适合你的阅读器
• 确保下载的小说ID或链接正确无误

性能优化建议

• 在配置较低的设备上，建议将线程数设置为4
• 下载大量小说时，建议分批进行
• 定期更新程序版本以获得最新优化

注意事项与最佳实践

1. 合理使用原则：请适度使用下载功能，避免对服务器造成过大压力
2. 版权声明：下载内容仅限个人学习使用，请尊重原作者权益
3. 数据安全：定期备份data目录下的重要配置文件
4. 版本更新：关注项目更新，及时获取功能改进和bug修复

通过本指南，你应该能够熟练掌握番茄小说下载器的各项功能。从基础安装到高级配置，从常见问题到优化技巧，这份全面的教程将帮助你充分发挥这款工具的价值。开始你的小说收藏之旅吧！