novel-downloader 2.1.0

A command-line tool for downloading Chinese web novels from Qidian and similar platforms.

novel-downloader

基于 aiohttp 的异步小说下载工具 / 库。支持断点续传、广告过滤与 TXT/EPUB 导出, 提供 CLI 与 Web 图形界面。

运行要求: Python 3.11+ (开发环境: Python 3.12)

功能特性

• 可恢复下载: 运行时自动检测本地已完成的部分, 跳过已下载内容
• 多格式导出: 合并所有章节为
  • TXT
  • EPUB (可选打包章节插图)
• 广告/活动过滤:
  • 章节标题过滤
  • 章节正文过滤
• 可选字体混淆还原: decode_font
• 双形态使用: 命令行 (CLI) 与 Web 图形界面 (GUI)

---

安装

使用 pip 安装稳定版:

pip install novel-downloader

启用字体解密功能 (decode_font):

pip install "novel-downloader[font-recovery]"

参见: 安装

---

快速开始

1. 初始化配置

# 生成默认配置 ./settings.toml
novel-cli config init

编辑生成的 ./settings.toml, 可修改 request_interval、book_ids 等配置 (参考 settings.toml 配置说明)

2. 命令行 (CLI)

# 直接通过 URL 启动下载
novel-cli download https://www.hetushu.com/book/5763/index.html

# 使用配置文件中的 book_ids 启动下载
novel-cli download --site qidian

# 指定站点 + 书籍 ID 启动下载
novel-cli download --site n23qb 12282

• 支持站点见: 支持站点列表
• 更多示例见: CLI 使用示例
• 运行中可使用 CTRL+C 取消任务

3. 图形界面 (GUI / Web)

# 启动 Web 界面 (基于当前 settings.toml)
novel-web

# 如需提供局域网/外网访问 (请自行留意安全与网络环境)
# novel-web --listen public

• 运行中可使用 CTRL+C 停止服务

---

从源码安装 (开发版)

体验最新开发功能:

git clone https://github.com/saudadez21/novel-downloader.git
cd novel-downloader
pip install .
# 或安装带可选功能:
# pip install .[font-recovery]

---

文档导航

• 安装
• 配置
• settings.toml 配置说明
• 支持站点列表
• CLI 使用示例
• 复制 Cookies
• 文件保存
• 模块与接口文档
• TODO
• 开发

---

项目说明

• 本项目仅供学习和研究使用, 不得用于任何商业或违法用途; 请遵守目标网站的 robots.txt 及相关法律法规
• 由于网站结构可能变化或其他问题, 可能导致无法正常工作, 请按需自行调整代码或寻找其他解决方案
• 使用本项目造成的任何法律责任由使用者自行承担, 项目作者不承担相关责任