novel-downloader 1.2.1

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

novel-downloader

一个基于 DrissionPage 和 requests 的小说下载器。

---

项目简介

novel-downloader 是一个通用的小说下载库 / CLI 工具,

• 大多数支持的站点仅依赖 requests 进行 HTTP 抓取
• 对于起点中文网 (Qidian), 可在配置中选择:
  • mode: session : 纯 Requests 模式
  • mode: browser : 基于 DrissionPage 驱动 Chrome 的浏览器模式 (可处理更复杂的 JS/加密)。
• 如果在 browser 模式下且 login_required: true, 首次运行会自动打开浏览器, 请完成登录后继续。

快速开始

# 克隆 + 安装
pip install novel-downloader

# 如需支持字体解密功能 (decode_font), 请使用:
# pip install novel-downloader[font-recovery]

# 如需启用异步抓取模式 (mode=async), 请使用:
# pip install novel-downloader[async]

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

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

# 运行下载
novel-cli download 123456

从 GitHub 安装 (开发版)

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

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

更多使用方法, 查看 使用示例

---

功能特性

• 爬取起点中文网的小说章节内容 (支持免费与已订阅章节)
• 自动整合所有章节并输出为完整的 TXT 文件
• 支持活动广告过滤:
  • 章节标题
  • 章节正文
  • 作者说

---

文档结构

• 项目简介
• 安装
• 环境准备
• 配置
• settings.yaml 配置说明
• 使用示例
• 文件保存
• TODO
• 开发
• 项目说明

---

项目说明

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