番茄小说下载器：一站式离线阅读与有声小说生成终极指南

番茄小说下载器：一站式离线阅读与有声小说生成终极指南

【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader

你是否厌倦了在线阅读时频繁的网络中断？是否想在通勤路上享受番茄小说的精彩内容？番茄小说下载器为你提供了完美的解决方案——将番茄小说内容下载到本地，并转换为多种格式，让你随时随地享受阅读乐趣！

为什么选择番茄小说下载器？

这款基于Rust开发的开源工具不仅下载速度快，还提供了多种输出格式选择。无论你想要在Kindle上阅读EPUB电子书，还是想在开车时听有声小说，这个工具都能满足你的需求。最棒的是，它完全免费且开源，支持Windows、Linux、macOS和Android等多个平台。

快速开始：三种安装方式任你选

方式一：一键安装脚本（推荐新手）

对于不想折腾技术细节的用户，最简单的安装方式就是使用一键安装脚本：

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目录下找到可执行文件即可运行。

方式三：Docker部署（适合服务器用户）

对于想在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即可使用Web界面。

三大界面模式：总有一种适合你

Web UI模式：最直观的图形界面

这是最适合普通用户的界面，启动命令如下：

./Tomato-Novel-Downloader --server

Web UI提供了完整的图形化操作界面，包括：

• 📚书籍搜索功能：直接搜索小说名称，无需手动查找ID
• 📥下载任务管理：实时查看下载进度，支持暂停和取消
• 📁文件浏览：按目录结构浏览已下载的小说
• ⚙️在线配置：直接在网页上修改下载设置

TUI终端界面：键盘党的最爱

如果你习惯命令行操作，TUI（终端用户界面）提供了高效的键盘操作体验：

./Tomato-Novel-Downloader

TUI界面简洁高效，所有操作都可以通过键盘完成，特别适合在服务器上使用。

NOUI无界面模式：自动化脚本的最佳搭档

位于src/ui/noui/目录的无界面模式专为自动化任务设计：

./Tomato-Novel-Downloader --update 7318247498772674083

这个模式可以自动更新已下载的小说，非常适合配合定时任务使用，实现自动追更。

核心功能详解：从下载到转换的全流程

智能下载引擎：稳定高效

下载模块位于src/download/目录，是整个工具的核心。它采用了智能重试机制和分段下载技术，即使网络不稳定也能保证下载成功率。当你输入小说ID或搜索关键词后，工具会自动：

1. 解析小说基本信息（标题、作者、封面等）
2. 获取完整的章节列表
3. 按顺序下载所有章节内容
4. 保存到本地指定目录

实用技巧：如果你需要下载多本小说，可以一次性输入多个小说ID，用逗号分隔。工具会自动排队处理，避免重复操作。

EPUB电子书生成：完美的阅读体验

EPUB生成模块位于src/book_parser/epub_generator.rs，它负责将下载的文本内容转换为标准的EPUB格式。转换过程包括：

• 📖 自动生成目录结构
• 🎨 应用统一的样式表
• 🖼️ 嵌入小说封面图片
• 📝 添加书籍元数据

生成的EPUB文件可以在任何支持该格式的阅读器上打开，包括Kindle、iPad、手机阅读应用等。

有声小说生成：解放双眼的听书体验

音频生成功能是番茄小说下载器的一大亮点。通过集成微软的Edge TTS服务，工具可以将文本内容转换为自然流畅的语音。相关代码位于src/book_parser/audio_generator.rs和src/book_parser/edge_tts.rs。

配置建议：

• 🎙️ 默认使用zh-CN-XiaoxiaoNeural语音，声音清晰自然
• ⚡ 可以调整语速、音量和音调参数
• 🎵 支持MP3和WAV两种输出格式
• 📁 音频文件按章节顺序命名，方便管理

生成的音频文件会保存在{书名}_audio文件夹中，你可以直接导入到手机或播放器中收听。

实战教程：从零开始下载第一本小说

第一步：获取小说ID

在番茄小说App中找到你想下载的小说，通过分享功能获取小说ID。或者直接在Web UI的搜索框中输入小说名称进行搜索。

第二步：选择下载模式

根据你的需求选择合适的界面：

• Web UI：适合大多数用户，图形化操作简单直观
• TUI：适合习惯命令行的用户，操作效率高
• NOUI：适合自动化脚本，无需人工干预

第三步：配置下载选项

在下载前，你可以调整以下设置：

1. 输出格式：选择EPUB或音频格式（或两者都生成）
2. 保存路径：指定文件保存位置
3. 章节范围：可以只下载特定章节，避免下载整本书
4. 音频参数：调整语音、语速、音量等

第四步：开始下载并等待完成

点击开始下载后，工具会显示实时进度。你可以：

• 📊 查看已下载的章节数
• 🚀 监控下载速度
• ⏸️ 暂停或取消任务
• 📋 查看详细的日志信息

下载完成后，文件会保存在你指定的目录中。EPUB文件可以直接用阅读器打开，音频文件可以导入到播放器中。

高级使用技巧：提升你的使用体验

批量更新已下载的小说

如果你经常追更多本小说，可以使用命令行模式进行批量更新：

./Tomato-Novel-Downloader --update 7318247498772674083

这个命令会自动检查并下载小说最新的章节，非常适合配合定时任务使用。你可以在src/base_system/novel_updates.rs中找到更新逻辑的实现。

自定义配置文件

工具的配置文件位于src/base_system/config.rs中定义的结构体。你可以修改以下常用设置：

• default_save_path：默认保存路径
• max_concurrent_downloads：最大并发下载数
• use_official_api：是否使用官方API
• enable_audio_generation：是否生成音频文件

重要提示：修改并发数时请保持合理范围（建议2-5），过高的并发会给服务器带来压力。

移动端使用方案

虽然TUI界面在小屏幕上操作不便，但你可以在安卓设备的Termux中运行Web UI模式：

1. 安装Termux和Termux:API
2. 下载Android arm64版本的构建产物
3. 启动Web UI服务：

   TOMATO_WEB_ADDR=0.0.0.0:18423 tomato-novel-downloader --server

4. 在手机浏览器中访问http://127.0.0.1:18423

这样你就可以在手机上轻松管理小说下载任务了。

常见问题排查指南

下载失败怎么办？

1. 检查网络连接：确保设备可以正常访问互联网
2. 验证小说ID：确认输入的小说ID是否正确
3. 查看日志文件：日志中会记录详细的错误信息
4. 尝试切换API模式：在配置中将use_official_api改为false

EPUB文件显示异常

如果生成的EPUB文件在某些阅读器上显示不正常：

1. 检查阅读器是否支持EPUB3格式
2. 尝试使用Calibre等专业阅读软件打开
3. 查看src/book_parser/finalize_epub.rs中的EPUB生成逻辑

音频生成速度慢

音频生成需要调用微软的在线服务，速度受网络影响：

1. 降低并发数（默认是2）
2. 检查网络连接质量
3. 考虑在网络状况好的时候批量生成

安全使用和注意事项

重要提醒：请合理使用本工具，遵守以下原则：

1. 📚 下载的小说仅供个人阅读使用
2. 🚫 不要将下载的内容用于商业用途或传播
3. 👨‍💻 尊重作者版权，支持正版阅读
4. ⚖️ 合理控制下载频率，避免给服务器带来过大压力

工具内置了速率限制和错误重试机制（参见src/base_system/cooldown_retry.rs），确保使用过程既高效又负责任。

开始你的离线阅读之旅

无论你是想建立个人数字图书馆，还是希望在通勤路上听书，番茄小说下载器都能为你提供便捷的解决方案。它的多格式支持、跨平台特性和友好的用户界面，让小说下载和格式转换变得简单易行。

现在就尝试一下吧！从下载到转换，整个过程只需要几分钟时间。如果你在使用过程中遇到问题或有改进建议，欢迎参与项目的开发和讨论。

记住：技术是为了让生活更美好。合理使用工具，享受阅读的乐趣，同时也要尊重创作者的劳动成果。Happy reading！📚

【免费下载链接】Tomato-Novel-Downloader番茄小说下载器不精简版项目地址: https://gitcode.com/gh_mirrors/to/Tomato-Novel-Downloader