小说下载工具

从 zhenhunxiaoshuo.com 下载小说的命令行工具，支持自动下载所有章节并合并为完整的 txt 文件。

快速开始

# 1. 安装依赖
pip install -r requirements.txt

# 2. 查看可下载的小说列表
python novel.py list

# 3. 下载小说（例如：天官赐福）
python novel.py download "天官赐福"

# 4. 合并章节（可选）
python novel.py merge "天官赐福"

详细说明

命令行选项

1. 列出可下载的小说

python novel.py list

2. 下载指定的小说

python novel.py download "小说名称"

3. 合并已下载的章节

# 使用默认输出文件名（小说名称_完整版.txt）
python novel.py merge "小说名称"

# 指定输出文件名
python novel.py merge "小说名称" --output "自定义文件名.txt"

下载的文件结构

tianguancifu/                # 项目根目录
├── 小说名称_chapters/      # 下载的章节文件夹
│   ├── chapter_1_第1章.txt
│   ├── chapter_2_第2章.txt
│   └── ...
└── 小说名称_完整版.txt    # 合并后的完整文件

添加新小说

在 config.py 中的 NOVELS 字典中添加新条目：

NOVELS = {
    "小说中文名": {                                         # 用于命令行中指定小说
        "url": "https://www.zhenhunxiaoshuo.com/路径/",    # 小说目录页面的URL
        "name": "小说英文名"                               # 用于文件夹和文件命名
    }
}

项目结构

tianguancifu/
├── novel.py           # 主程序入口，提供命令行界面
├── config.py          # 配置文件，包含小说信息
├── download_novel.py  # 下载功能的核心实现
├── merge_chapters.py  # 章节合并功能的实现
├── requirements.txt   # 项目依赖
└── README.md         # 项目说明文档

功能特点

• 支持批量下载整本小说
• 自动重试失败的下载
• 自动合并为单个txt文件
• 下载进度显示
• 智能章节排序
• 断点续传支持

常见问题

1. 下载速度过慢

   • 已内置下载间隔，避免请求过快
   • 支持断点续传，可以重新运行下载命令继续未完成的下载

2. 章节顺序混乱

   • 程序会自动根据章节号排序
   • 合并时会保持正确的章节顺序

3. 下载失败

   • 程序会自动重试失败的下载
   • 可以重新运行下载命令，会自动跳过已下载的章节

注意事项

• 仅支持 zhenhunxiaoshuo.com 网站
• 下载的内容仅供个人学习使用
• 建议适当控制下载频率，避免对服务器造成压力
• 请遵守相关法律法规