@kadaliao/geektime-downloader 1.0.3 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# 更新日志
+
+## [1.1.0] - 2025-12-29
+
+### 新增功能
+- 支持 EPUB 格式输出
+- 新增 `--format` 选项，支持 pdf/epub/both 三种模式
+- EPUB 格式特性：
+  - 标准 EPUB 3 格式
+  - 完整的目录导航
+  - 响应式排版，适合各种阅读器
+  - 自动处理图片和代码块样式
+  - 文件体积通常小于 PDF
+
+### 技术改进
+- 添加 `epub-gen-memory` 依赖用于 EPUB 生成
+- 实现文章 HTML 内容提取功能
+- 实现并发内容提取机制
+- 优化 EPUB 样式，提升阅读体验
+
+### Bug 修复
+- 修复 epub-gen-memory 导入问题
+- 修复 EPUB 生成 API 调用错误
+- 优化 Cookie 过期检测，改用基于 API 响应的智能判断
+- 增加页面加载超时时间（30s → 60s）
+
+### 文档更新
+- 更新 README.md，添加 EPUB 使用说明
+- 更新命令行帮助信息
+- 添加多个使用示例
+- 新增 CHANGELOG.md
+
+## [1.0.4] - 之前版本
+
+### 功能
+- 批量下载极客时间专栏文章为 PDF
+- 支持 PDF 合并
+- 支持并发下载
+- 完整的文章内容提取
+- 自动添加 PDF 书签

package/README.md

@@ -1,13 +1,14 @@
 # 极客时间专栏下载器
 
-一键批量下载极客时间专栏文章为 PDF 格式。支持通过 `npx` 直接运行，无需安装。
+一键批量下载极客时间专栏文章为 PDF 或 EPUB 格式。支持通过 `npx` 直接运行,无需安装。
 
 ## ✨ 特性
 
 - 🚀 **零安装**：支持 `npx` 直接使用
 - 📦 **批量下载**：自动获取整个专栏的所有文章
-- 📄 **完整内容**：自动处理滚动容器，确保 PDF 包含完整内容
-- 🔗 **智能合并**：自动将所有章节合并为一个 PDF，以专栏名称命名（可选）
+- 📄 **完整内容**：自动处理滚动容器，确保包含完整内容
+- 📚 **多种格式**：支持 PDF、EPUB 或同时生成两种格式
+- 🔗 **智能合并**：自动将所有章节合并为一个文件，以专栏名称命名（可选）
 - ⚙️ **灵活配置**：命令行参数或配置文件，任选其一
 - 🎨 **友好界面**：彩色进度提示，实时显示下载状态
 
@@ -79,9 +80,11 @@ geektime-dl [选项]
   -u, --url <url>        专栏文章URL（任意一篇）
   -c, --cookie <cookie>  Cookie字符串（用于认证）
   -o, --output <dir>     输出目录 (默认: "./downloads")
+  -f, --format <format>  输出格式: pdf, epub, both (默认: "pdf")
   --headless <boolean>   无头模式 (默认: true)
   --concurrency <number> 并发下载数量 (默认: 5)
   --delay <ms>           每篇文章间延迟(ms) (默认: 2000)
+  --timeout <ms>         页面加载超时时间(ms) (默认: 60000)
   --dry-run              预览模式，只显示文章列表
   --limit <number>       限制下载数量（测试用）
   --no-merge             禁用PDF合并（默认会合并所有文章为一个PDF）
@@ -108,7 +111,7 @@ npx @kadaliao/geektime-downloader \
   --limit 2
 ```
 
-**下载整个专栏**
+**下载整个专栏（PDF 格式）**
 
 ```bash
 npx @kadaliao/geektime-downloader \
@@ -116,6 +119,24 @@ npx @kadaliao/geektime-downloader \
   -c "your_cookie"
 ```
 
+**下载为 EPUB 格式**
+
+```bash
+npx @kadaliao/geektime-downloader \
+  -u "https://time.geekbang.org/column/article/200822" \
+  -c "your_cookie" \
+  --format epub
+```
+
+**同时生成 PDF 和 EPUB**
+
+```bash
+npx @kadaliao/geektime-downloader \
+  -u "https://time.geekbang.org/column/article/200822" \
+  -c "your_cookie" \
+  --format both
+```
+
 **自定义输出目录**
 
 ```bash
@@ -138,7 +159,9 @@ npx @kadaliao/geektime-downloader \
 
 下载完成后，会在输出目录生成以下文件：
 
-### 单独章节 PDF（始终生成）
+### PDF 格式（--format pdf 或 both）
+
+**单独章节 PDF（始终生成）**
 
 ```
 001_开篇词___想吃透架构？你得看看真实、接地气的架构案例.pdf
@@ -150,7 +173,7 @@ npx @kadaliao/geektime-downloader \
 - 自动清理非法字符
 - 限制文件名长度
 
-### 合并后的 PDF（默认生成）
+**合并后的 PDF（默认生成）**
 
 ```
 专栏名称.pdf
@@ -159,8 +182,21 @@ npx @kadaliao/geektime-downloader \
 - 默认会将所有章节合并为一个完整的 PDF 文件
 - 文件名为专栏的标题（自动从 API 获取）
 - 包含所有成功下载的章节，按顺序排列
+- 自动添加书签导航
 - 如不需要合并版本，使用 `--no-merge` 选项
 
+### EPUB 格式（--format epub 或 both）
+
+```
+专栏名称.epub
+```
+
+- 标准 EPUB 3 格式
+- 完整的目录导航
+- 响应式排版，适合各种阅读器
+- 自动处理图片和代码块样式
+- 文件体积通常小于 PDF
+
 ## ⚙️ 配置方式
 
 ### 优先级
@@ -274,6 +310,7 @@ geektime-downloader/
 - **Chalk**: 彩色输出
 - **Ora**: 进度提示
 - **pdf-lib**: PDF 文档操作和合并
+- **epub-gen-memory**: EPUB 电子书生成
 
 ## 📄 License