novel-downloader 1.4.1

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

novel-downloader

一个基于 playwright 和 aiohttp 的小说下载工具/库。

本项目开发环境为 Python 3.12, 需确保运行环境为 Python 3.11 及以上版本

功能特性

• 支持断点续爬, 自动续传未完成任务
• 自动整合所有章节并导出为:
  • TXT
  • EPUB (可选包含章节插图)
• 支持活动广告过滤:
  • 章节标题
  • 章节正文

---

快速开始

安装

使用 pip 安装:

pip install novel-downloader

如需使用浏览器模式 (即 mode: browser), 请确保已安装 Playwright 依赖:

playwright install

如需启用字体解密功能 (decode_font, 用于处理起点中文网对近一个月更新章节所采用的字体混淆技术), 请使用扩展安装方式:

pip install novel-downloader[font-recovery]

---

CLI 模式

# 初始化默认配置 (生成 settings.toml)
novel-cli config init

# 编辑 ./settings.toml 完成 site/book_ids 等
# 可查看 docs/3-settings-schema.md

# 执行下载任务
novel-cli download 123456

• 详细可见: 支持站点列表
• 更多使用方法, 查看 使用示例

---

TUI 模式 (终端用户界面)

注意: TUI 模式仍在开发中, 目前尚未实现登录和修改设置等功能。建议优先使用稳定的 CLI 模式。

# 初始化默认配置 (生成 settings.toml)
novel-cli config init

# 编辑 ./settings.toml 修改网络配置
# 可查看 docs/3-settings-schema.md

# 启动 TUI 界面
novel-tui

• 详细可见: 支持站点列表
• 更多使用方法, 查看 使用示例

---

GUI 模式 (图形界面)

尚未实现

---

从 GitHub 安装 (开发版)

如需体验开发中的最新功能, 可通过 GitHub 安装:

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

---

文档结构

• 项目简介
• 安装
• 配置
• settings.toml 配置说明
• 支持站点列表
• TUI 使用示例
• CLI 使用示例
• 复制 Cookies
• 文件保存
• TODO
• 开发
• 项目说明

---

项目说明

• 本项目仅供学习和研究使用, 不得用于任何商业或违法用途。请遵守目标网站的 robots.txt 以及相关法律法规。
• 本项目开发者对因使用该工具所引起的任何法律责任不承担任何责任。
• 如果遇到网站结构变化或其他问题, 可能导致程序无法正常工作, 请自行调整代码或寻找其他解决方案。