docs: Audiobookshelf 章节排序三层同步铁律 + 完整下载工作流

daily/2026-06-20.md

@@ -0,0 +1,45 @@
+# 2026-06-20 Audiobookshelf 部署 + 章节排序经验
+
+## Audiobookshelf 部署
+
+- Docker 容器：ghcr.io/advplyr/audiobookshelf:latest (v2.35.1)，端口 13378
+- docker-compose 管理，路径：`/home/ubuntu/audiobookshelf/`
+- Caddy 反代：podcast.xybkwd.top
+- 数据目录：config/ metadata/ audiobooks/ podcasts/
+
+## 章节排序三层同步铁律
+
+Audiobookshelf 的章节显示依赖三层数据：
+
+| 层 | 数据位置 | 关键字段 |
+|:---|:---|:---|
+| 文件系统 | 文件名 `01-标题.mp3` | 数字前缀保证字母序 |
+| books.chapters (SQLite) | JSON 数组 | `start` 时间戳递减 |
+| books.audioFiles (SQLite) | JSON 数组 | `index` 顺序递增 |
+
+**只改文件名不生效**，必须三条线同步。
+
+## 完整工作流
+
+```
+yt-dlp 下载 → --print upload_date 获取发布时间
+  → 按 upload_date 排序 → 生成 01~N 前缀
+  → 重命名 01-源端完整标题.mp3
+  → 放入 /home/ubuntu/audiobookshelf/audiobooks/专辑名/
+  → watcher 自动检测（不重启容器）
+  → 验证 chapters.start + audioFiles.index 顺序正确
+```
+
+## B站下载要点
+
+- 需 cookies 认证（从本地 Firefox cookies.sqlite 提取 → SCP 上传 /tmp/bilibili_cookies.txt）
+- B站无纯音频流，用 `-f worstvideo+worstaudio/worst -x` 最小化下载量
+- 每集 ~40-50MB（音频），下载速度 6-14 MB/s（日本 CDN 节点）
+- 服务器带宽 1.5TB/月，完全够用
+
+## 踩坑记录
+
+1. `rm` 数据库必须先问用户 - 造成账号数据丢失
+2. Audiobookshelf 章节排序不是靠文件名，是靠 start 时间戳
+3. 操作文件前不要盲目 rm，先用 ls 确认
+4. 容器不需要频繁重启，watcher 会自动检测文件变化