🌟 高效、优雅且功能强大的番茄小说下载解决方案 🌟
| 📚 高质量内容获取 | 🔄 多格式转换 |
| * 支持番茄小说全平台内容下载 | * 支持输出纯净 TXT 格式 |
| * 智能解析章节结构与内容 | * 生成精美排版的 EPUB 电子书 |
| * 自动校正小说格式与标点 | * 保留原书籍章节结构 |
| ⚡ 高效下载引擎 | 🖥️ 界面体验 |
| * 多线程并发下载技术 | * 直观友好的图形界面 |
| * 智能调节网络请求频率 | * 实时下载进度可视化 |
| * 断点续传与状态恢复 | * 跨平台一致性体验 |
点击展开详细步骤
利用GitHub Actions的强大功能，无需在本地安装任何软件即可下载小说：
- 在GitHub仓库页面，点击 "Actions" 选项卡
- 左侧选择 "在线下载小说" 工作流
- 点击 "Run workflow" 按钮
- 填写以下信息：
- 小说ID：从番茄小说网址中获取（例如：
https://fanqienovel.com/page/7105916563中的7105916563） - 下载线程数：默认为5，可选1-10
- 输出格式：选择txt或epub
- 小说ID：从番茄小说网址中获取（例如：
- 点击 "Run workflow" 开始下载
- 下载完成后，点击运行记录中的 "Summary" 标签
- 在 "Artifacts" 部分找到并下载小说文件（保存期限为7天）
点击查看各平台预编译版本
从 📥 官方发布页 下载适合您系统的预编译版本：
| 平台 | 下载链接 | 说明 |
|---|---|---|
| Windows | Fanqie-Novel-Downloader-Windows.zip |
解压后双击运行 番茄小说下载器.exe |
| MacOS | Fanqie-Novel-Downloader-MacOS.zip |
解压后运行 番茄小说下载器 应用 |
| Linux | Fanqie-Novel-Downloader-Linux.zip |
解压后运行 番茄小说下载器 可执行文件 |
点击展开开发者指南
# 1. 克隆代码仓库
git clone https://github.com/POf-L/Fanqie-Tomato-Downloader.git
cd Fanqie-Tomato-Downloader
# 2. 安装依赖库
pip install -r requirements.txt
# 3. 启动应用
python gui.py在番茄小说网站上，打开您想要下载的小说页面，URL中的数字部分就是小说ID。
例如：
https://fanqienovel.com/page/7105916563中的7105916563就是小说ID。
- GUI应用：下载的文件保存在您指定的保存路径中
- 在线下载：文件将作为GitHub Artifacts提供下载，保存期限为7天
本项目主要使用 Python 和 customtkinter 构建。核心模块交互如下：
graph LR
GUI_Module[GUI_Module gui.py\nNovelDownloaderGUI]
LibraryWindowModule[LibraryWindowModule library.py\nLibraryWindow]
ReaderWindowModule[ReaderWindowModule reader.py\nReader]
SettingsDialogModule[SettingsDialogModule settings.py\nSettingsDialog]
SplashScreenModule[SplashScreenModule splash.py\nSplashScreen]
DownloaderLogic[DownloaderLogic gui.py\ndownload_novel,\nstart_download]
LibraryManager[LibraryManager library.py\nload/save/add/remove,\nLibrary Logic]
ConfigManager[ConfigManager config.py\nload/save UserConfig]
RequestHandlerModule[RequestHandlerModule request_handler.py\nRequestHandler,\nget_book_info,\ndown_text,\nextract_chapters]
UserConfig_JSON[user_config.json\nUserConfig]
LibData_JSON[library.json\nLibraryData]
CookieData_JSON[cookie.json\nCookieData]
NovelFiles[NovelFiles]
GUI_Module --> DownloaderLogic
GUI_Module --> LibraryWindowModule
GUI_Module --> SettingsDialogModule
GUI_Module -- 调用 --> LibraryManager
GUI_Module -- 调用 --> ConfigManager
LibraryWindowModule --> LibraryManager
LibraryWindowModule --> ReaderWindowModule
ReaderWindowModule --> ConfigManager
SettingsDialogModule --> ConfigManager
DownloaderLogic -- 使用 --> RequestHandlerModule
LibraryManager -- 使用 --> RequestHandlerModule
LibraryManager -- 操作 --> LibData_JSON
ConfigManager -- 操作 --> UserConfig_JSON
RequestHandlerModule -- 获取/更新 --> CookieData_JSON
DownloaderLogic -- 生成 --> NovelFiles
style UserConfig_JSON fill:#f9f,stroke:#333,stroke-width:2px
style LibData_JSON fill:#f9f,stroke:#333,stroke-width:2px
style CookieData_JSON fill:#f9f,stroke:#333,stroke-width:2px
style NovelFiles fill:#ccf,stroke:#333,stroke-width:2px
- UI 层：
customtkinter构建图形界面。 - 应用逻辑层：核心业务逻辑，控制下载、书库、配置等。
- 数据交互层：
request_handler.py负责网络请求和数据处理。 - 数据存储层：JSON 和 TXT/EPUB 文件存储数据。
本项目采用 GitHub Actions 进行自动化构建和发布流程，build-and-release.yml 描述了详细的构建步骤。
- 多平台构建：支持 Windows, macOS, Linux。
- 环境配置：自动配置 Python 环境和依赖。
- 代码编译：PyInstaller 打包 Python 代码。
- 性能优化：优化体积和性能。
- 版本发布：自动上传到 GitHub Releases 页面。
- GitHub Actions 页面：在仓库 Actions 页面选择 "build-and-release" 工作流。
- 运行工作流：点击 "Run workflow"，填写版本信息。
- 等待完成：等待 GitHub Actions 完成构建和发布。
遇到下载问题？
- 检查网络：确保网络连接正常。
- 线程调整：尝试在设置中调整下载线程数。
- Cookie：检查或清除
cookie.json文件，重新获取 Cookie。 - API 限制：部分小说可能存在下载限制，请更换其他源或稍后重试。
程序启动异常？
- 版本兼容：确认下载版本与操作系统匹配。
- 依赖安装：源码运行请检查
requirements.txt依赖是否安装完整。 - 系统环境：确保系统满足运行最低配置要求。
- 文件完整性：尝试重新下载发布版本，避免文件损坏。
本项目基于 MIT License 开源，您可以自由使用和修改。