novel-downloader 2.3.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 -U novel-downloader

若需要启用字体解密功能 (decode_font), 请使用:

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

参见: 安装

---

快速开始

0. 设置语言 (可选)

支持多语言界面 (i18n), 可通过命令切换:

# 设置为中文
novel-cli config set-lang zh_CN

# 设置为英文
novel-cli config set-lang en_US

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

• 支持站点见: 支持站点列表
• 更多示例见: WEB 使用示例
• 运行中可使用 CTRL+C 停止服务

---

从源码安装 (开发版)

体验最新开发功能:

git clone https://github.com/saudadez21/novel-downloader.git
cd novel-downloader

# 可选: 启用多语言支持
# 安装 Babel 并编译翻译文件
# pip install babel
# pybabel compile -d src/novel_downloader/locales

pip install .
# 或安装带可选功能:
# pip install .[font-recovery]

---

文档导航

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

---

项目说明

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