Appearance
平台概览与使用指南
Leelaa Reader 是一个面向个人/小团队的自托管有声书平台，核心目标是把你已有的有声书音频文件库（例如 NAS 上的目录）通过 WebDAV 接入，然后在 Web 端完成浏览、播放、收藏与进度同步。
🚀 平台优势
- 数据不出门：音频与书库都在你自己的 WebDAV/NAS 上，平台只做“管理与播放”
- 轻量自托管：SQLite 单库文件，部署与迁移成本低
- 上手快：激活 → 登录 → 添加储存库 → 扫描 → 听书
- 播放器体验完整：倍速、睡眠定时、跳过片头片尾、章节切换、续播
- 自动整理：支持喜马拉雅在线刮削元数据（封面、简介、作者），也可从本地文件、音频标签中提取信息。
📱 界面预览
这里展示了 Leelaa Reader 在移动端的主要界面预览与功能布局。
激活系统
首次使用需输入激活码激活服务器
用户登录
支持多用户独立账号管理
管理首页
直观展示最近播放与库状态
多维概览
提供更多维度的数据统计与快捷操作
📖 使用指南
1. 激活与登录
- 首次访问会进入激活页
/activate，输入购买时获得的激活码。 - 激活成功后进入
/login登录。 - 管理员首次启动时会生成默认账号信息（在服务端控制台输出）。
2. 添加储存库（WebDAV）
进入「储存库管理」页面 /library：
- 点击「新增」添加一个储存库。
- 填写 WebDAV 地址、用户名/密码（如需要）、根目录路径。
- 保存后点击「测试连接」确认可访问目录。
- 点击「扫描」开始识别图书并生成章节。
3. 扫描与自动整理
- 扫描会把“目录”识别为“书籍”，并为每本书生成章节列表。
- 扫描过程中会自动触发元数据整理：支持通过喜马拉雅在线刮削封面、简介与作者，也可使用目录内的本地文件或从音频标签提取信息。
- 你可以在「系统日志」中查看扫描与整理的进度与错误信息。
4. 书籍管理
- 在储存库卡片中进入「书籍管理」，可编辑标题、作者、演播、封面与简介。
- 支持删除不需要的条目，便于维护干净的书架。
5. 用户管理
- 管理员可进入「用户管理」页面创建、编辑或删除用户。
- 多用户独立：每个用户拥有独立的播放进度、收藏夹和播放历史，互不干扰。
⚙️ 核心系统规范
为了保证系统的稳定与规范，Leelaa Reader 遵循以下硬性规则：
1. 书籍识别逻辑
- 递归扫描：系统深度遍历 WebDAV 目录，直到发现包含符合条件的音频文件的目录。
- 音频支持：仅支持
mp3,m4a,wav,flac。 - 排除规则：显式排除并完全忽略所有
.m4b文件。 - 唯一性标识：
book_hash = hash(webdav_source_id + "|" + book_dir_path)。
2. 授权与激活
- 授权模式：默认 14 天试用。99 元即可购买永久授权，并享受 1.x.x 版本的全部更新。
- 机器码绑定：授权基于服务器唯一的
client_id（机器码）。
3. 数据存储
- SQLite 驱动：所有元数据、进度、任务状态均存储在本地 SQLite 数据库中。
- 任务系统：采用异步任务队列，支持扫描、刮削、章节生成等长耗时操作。
🎯 适合谁
- 有 NAS/WebDAV 存储的有声书爱好者，想把“目录”变成“书架”
- 想要更好的移动端听书体验，并且希望进度可同步
- 需要可控、可迁移的自托管方案（数据与服务都在自己手上）