番茄小说下载器：一键保存EPUB和有声小说的完整解决方案
番茄小说下载器：一键保存EPUB和有声小说的完整解决方案
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
你是否曾因网络不佳而无法继续追更番茄小说的精彩章节？是否希望在Kindle上离线阅读，或在通勤路上听书？Tomato-Novel-Downloader正是为解决这些需求而生的开源工具。这个基于Rust开发的项目，能将番茄小说内容下载到本地，并转换为EPUB电子书或生成有声小说音频，支持TUI终端界面、Web UI网页界面和命令行模式，让不同用户都能轻松使用。
🚀 快速开始：三种方式立即体验
一键安装脚本（推荐新手）
对于不想折腾技术细节的用户，最简单的方式是使用一键安装脚本：
bash <(curl -sL https://dl.zhongbai233.com/installer.sh)脚本会自动处理所有依赖和环境配置，完成后即可直接运行程序。
手动构建（适合开发者）
如果你喜欢手动控制或有开发需求，可以使用Cargo构建：
git clone https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader cd Tomato-Novel-Downloader cargo build --release构建完成后，在target/release目录找到可执行文件。对于更小的二进制体积和更好的性能，可以使用优化选项：
cargo build --release --features no-official-apiDocker容器化部署
对于服务器或NAS用户，Docker是最便捷的部署方式：
docker run -d \ --name tomato-novel-webui \ -p 18423:18423 \ -v /host/data:/data \ -e TOMATO_WEB_ADDR=0.0.0.0:18423 \ -e TOMATO_WEB_PASSWORD=你的密码 \ zhongbai233/tomato-novel-downloader-webui:latest --server --data-dir /data启动后访问http://localhost:18423即可使用网页界面。对于软路由或NAS系统，建议使用musl版本镜像以获得更好的资源效率。
📚 核心功能详解：从下载到格式转换
智能下载引擎
下载模块位于src/download/目录，是整个工具的核心。它采用智能重试机制，即使网络不稳定也能保证下载成功率。当你输入小说ID或搜索关键词后，工具会自动：
- 解析小说基本信息（标题、作者、封面等）
- 获取完整的章节列表
- 按顺序下载所有章节内容
- 保存到本地指定目录
实用技巧：如果需要下载多本小说，可以一次性输入多个小说ID，用逗号分隔。工具会自动排队处理，避免重复操作。
EPUB电子书生成
EPUB生成模块位于src/book_parser/epub_generator.rs，负责将下载的文本内容转换为标准的EPUB格式。转换过程包括：
- 自动生成目录结构
- 应用统一的样式表
- 嵌入小说封面图片
- 添加书籍元数据
生成的EPUB文件可以在任何支持该格式的阅读器上打开，包括Kindle、iPad、手机阅读应用等。你可以在src/book_parser/html_utils.rs中找到HTML模板，自定义电子书的显示样式。
有声小说音频生成
音频生成功能是Tomato-Novel-Downloader的一大亮点。通过集成微软的Edge TTS服务，工具可以将文本内容转换为自然流畅的语音。相关代码位于src/book_parser/audio_generator.rs和src/book_parser/edge_tts.rs。
配置建议：
- 默认使用
zh-CN-XiaoxiaoNeural语音，声音清晰自然 - 可以调整语速、音调和音量参数
- 支持MP3和WAV两种输出格式
- 音频文件按章节顺序命名，方便管理
生成的音频文件会保存在{书名}_audio文件夹中，你可以直接导入到手机或播放器中收听。
🖥️ 三种界面满足不同需求
Web UI网页界面（最易用）
Web UI提供了完整的图形化操作界面，适合大多数用户：
./tomato-novel-downloader --server启动后在浏览器中访问http://localhost:18423，即可使用以下功能：
- 搜索书籍并创建下载任务
- 实时查看下载进度
- 管理已下载的文件库
- 在线修改配置
- 文件夹打包下载
TUI终端界面（轻量高效）
对于习惯命令行的用户，TUI界面提供了简洁高效的操作体验：
./tomato-novel-downloader所有操作都可以通过键盘完成，界面响应迅速，适合在服务器或远程终端中使用。
NOUI命令行模式（适合自动化）
位于src/ui/noui/目录的NOUI模式主要用于脚本调用和自动化任务：
./tomato-novel-downloader --update 7318247498772674083这个命令会自动检查并下载小说最新的章节，非常适合配合定时任务使用，实现自动追更。
🔧 实战操作指南
第一步：搜索和选择小说
在Web UI中，点击搜索框输入小说名称或关键词。工具会显示匹配的结果列表，包括书名、作者和简介。选择你想下载的小说，系统会自动获取小说ID。
小贴士：如果你已经知道小说ID，可以直接在TUI界面中输入。小说ID通常是一串很长的数字，可以在番茄小说App的分享链接中找到。
第二步：配置下载选项
在下载前，你可以调整以下设置：
- 输出格式：选择EPUB或音频格式（或两者都生成）
- 保存路径：指定文件保存位置
- 章节范围：可以只下载特定章节，避免下载整本书
- 音频参数：调整语音、语速、音量等
这些配置会保存在config.yml文件中，下次使用时无需重复设置。
第三步：开始下载并监控进度
点击开始下载后，工具会显示实时进度。你可以：
- 查看已下载的章节数
- 监控下载速度
- 暂停或取消任务
- 查看详细的日志信息
下载完成后，文件会保存在你指定的目录中。EPUB文件可以直接用阅读器打开，音频文件可以导入到播放器中。
📱 移动端使用方案
虽然TUI界面在小屏幕上操作不便，但你可以在安卓设备的Termux中运行Web UI模式：
- 安装Termux和Termux:API
- 下载Android arm64版本的构建产物
- 启动Web UI服务：
TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server - 在手机浏览器中访问
http://127.0.0.1:18423
这样你就可以在手机上轻松管理小说下载任务了。
⚙️ 高级配置与优化
自定义配置文件
工具的配置文件位于src/base_system/config.rs中定义的结构体。你可以修改以下常用设置：
default_save_path：默认保存路径max_concurrent_downloads：最大并发下载数use_official_api：是否使用官方APIenable_audio_generation：是否生成音频文件
重要提示：修改并发数时请保持合理范围（建议2-5），过高的并发会给服务器带来压力。
批量更新已下载的小说
如果你经常追更多本小说，可以使用命令行模式进行批量更新：
./tomato-novel-downloader --update 7318247498772674083这个命令会自动检查并下载小说最新的章节，非常适合配合定时任务使用。你可以在src/base_system/novel_updates.rs中找到更新逻辑的实现。
🔍 常见问题排查
下载失败怎么办？
- 检查网络连接：确保设备可以正常访问互联网
- 验证小说ID：确认输入的小说ID是否正确
- 查看日志文件：日志中会记录详细的错误信息
- 尝试切换API模式：在配置中将
use_official_api改为false
EPUB文件显示异常
如果生成的EPUB文件在某些阅读器上显示不正常：
- 检查阅读器是否支持EPUB3格式
- 尝试使用Calibre等专业阅读软件打开
- 查看
src/book_parser/finalize_epub.rs中的EPUB生成逻辑
音频生成速度慢
音频生成需要调用微软的在线服务，速度受网络影响：
- 降低并发数（默认是2）
- 检查网络连接质量
- 考虑在网络状况好的时候批量生成
🛡️ 安全使用指南
重要提醒：请合理使用本工具，遵守以下原则：
- 下载的小说仅供个人阅读使用
- 不要将下载的内容用于商业用途或传播
- 尊重作者版权，支持正版阅读
- 合理控制下载频率，避免给服务器带来过大压力
工具内置了速率限制和错误重试机制（参见src/base_system/cooldown_retry.rs），确保使用过程既高效又负责任。
🎯 开始你的小说下载之旅
无论你是想建立个人数字图书馆，还是希望在通勤路上听书，Tomato-Novel-Downloader都能为你提供便捷的解决方案。它的多格式支持、跨平台特性和友好的用户界面，让小说下载和格式转换变得简单易行。
现在就尝试一下吧！从克隆仓库到下载第一本小说，整个过程只需要几分钟时间。如果你在使用过程中遇到问题或有改进建议，欢迎参与项目的开发和讨论。
记住：技术是为了让生活更美好。合理使用工具，享受阅读的乐趣，同时也要尊重创作者的劳动成果。Happy reading！📚
【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考