a

2026-07-03 16:58:28 +08:00
commit 32b43f85bd
6240 changed files with 1987678 additions and 0 deletions
@@ -0,0 +1,85 @@
+# 📚 Loyal Books Scraper
+
+从 https://www.loyalbooks.com 抓取免费有声书（LibriVox 项目）
+
+## 目标
+
+Children 分类前 6 页，约 **585 本书**
+
+## 抓取内容
+
+每本书包含：
+- **TXT 文本** - 完整书籍文本
+- **MP3 ZIP** - 64kbps 压缩包（来自 Archive.org）
+
+## 存储结构
+
+```
+/home/ubuntu/media/loyalbooks/
+└── children/                    # 小写
+    └── Book-Name/
+        ├── Book-Name.txt      # 文本文件
+        └── mp3_64kb.zip       # MP3 压缩包
+```
+
+## 特性
+
+- ✅ **断点续传** - 大文件支持 HTTP Range 请求
+- ✅ **不重复下载** - 已存在且大小有效的文件自动跳过
+- ✅ **临时文件保护** - 下载中使用 `.tmp` 后缀，完成后重命名
+- ✅ **空间预估** - 显示已用空间和预计需用空间
+
+## 使用方法
+
+### 1. 获取书籍列表（Phase 1）
+
+```bash
+./start.sh fetch
+```
+
+- 抓取 6 页列表
+- 访问每本书详情页获取下载链接
+- 生成 `config/loyalbooks_children_index.json`
+
+### 2. 下载书籍（Phase 2）
+
+**前台模式**：
+```bash
+./start.sh download
+```
+
+**后台模式**（推荐）：
+```bash
+./start.sh download-bg
+```
+
+### 3. 查看状态
+
+```bash
+./start.sh status
+```
+
+## 技术细节
+
+| 阶段 | 间隔 | 预计时间 |
+|------|------|----------|
+| 列表抓取 | 3 秒 | ~1 分钟 |
+| 详情抓取 | 5 秒 | ~50 分钟 |
+| 文件下载 | 5 秒 | 数小时 |
+
+## 网站结构
+
+```
+/genre/Children?results=100&page=N
+    ↓ 点击书籍
+/book/Book-Name-by-Author
+    ↓ 解析详情页
+/download/text/Book-Name.txt
+http://www.archive.org/download/..._64kb_mp3.zip
+```
+
+## 注意事项
+
+- 文件较大（MP3 ZIP 可能数百 MB）
+- 建议后台模式 `./start.sh download-bg`
+- 支持断点续传