平台概览 (Overview)

Leelaa Reader 是一个面向个人/小团队的自托管有声书平台，核心目标是把你已有的有声书音频文件库（例如 NAS 上的本地目录或 WebDAV）接入，然后在各端完成浏览、播放、收藏与进度同步。

🚀 平台优势

数据不出门：音频与书库都在你自己的本地存储或 WebDAV/NAS 上，平台只做“管理与播放”
轻量自托管：SQLite 单库文件，部署与迁移成本低
上手快：激活 → 登录 → 添加储存库 → 扫描 → 听书
播放器体验完整：倍速、睡眠定时、跳过片头片尾、章节切换、续播
自动整理：支持在线刮削元数据（封面、简介、作者），也可从本地文件、音频标签中提取信息。

📖 使用指南

1. 激活与登录

首次访问会进入激活页 /activate，输入购买时获得的激活码。
激活成功后进入 /login 登录。
管理员首次启动时会生成默认账号信息（在服务端控制台输出）。

2. 添加储存库 (Storage Sources)

进入「储存库管理」页面 /library：

三种模式：支持 本地目录、WebDAV、网盘（不刮削音频时长）。
可视化流程：先验证连接，再通过内置文件浏览器直接选择书籍根目录，无需手动复制路径。
自动纠错：WebDAV 地址自动补齐 http:// 协议头。
扫描书籍：保存后点击「扫描」开始识别图书并生成章节。

3. 扫描与自动整理

扫描会把“目录”识别为“书籍”，并为每本书生成章节列表。
扫描过程中会自动触发元数据整理：支持在线刮削封面、简介与作者，也可使用目录内的本地文件或从音频标签提取信息。
你可以在「系统日志」中查看扫描与整理的进度与错误信息。

4. 书籍管理

在储存库卡片中进入「书籍管理」，可编辑标题、作者、演播、封面与简介。
支持删除不需要的条目，便于维护干净的书架。

5. 用户管理

管理员可进入「用户管理」页面创建、编辑或删除普通用户。
系统不支持多个管理员；用户管理不能新增管理员，也不能把已有用户修改为管理员。
普通用户默认需要通过分类权限显式分配可访问内容。
多用户独立：每个用户拥有独立的播放进度、收藏夹和播放历史，互不干扰。

6. AI 分类

管理员可在「分类管理」页选择储存库后，点击「一键生成预设分类」执行 AI 分类。
任务会异步执行，可在「任务管理」查看 进行中/已完成/失败 与处理进度。
页面刷新后会按服务端任务状态回显，不应丢失正在执行的进度展示。

⚙️ 核心系统规范

为了保证系统的稳定与规范，Leelaa Reader 遵循以下硬性规则：

1. 书籍识别逻辑

递归扫描：系统深度遍历存储目录，直到发现包含符合条件的音频文件的目录。
音频支持：官方支持 .mp3, .m4a, .m4b, .flac, .wav, .wma；其中 .wma 通过服务端 FFmpeg 转码播放。明确不支持 .aac (裸流), .ogg, .opus。
唯一性标识：基于存储路径生成唯一标识，路径变更会导致书籍重置。

2. 授权与激活

授权模式：默认 14 天试用。99 元即可购买服务端永久授权，并享受 1.x.x 版本的全部更新。
iOS 客户端：App Store 版本为独立客户端付费 9.9 元（与服务端授权分开）。
机器码绑定：授权基于服务器唯一的 client_id（机器码）。
授权迁移（备份与还原）：管理员可在当前服务器导出加密 .lltf 授权备份，并在新服务器还原后提交换绑申请。该流程只迁移授权状态，不包含书库、音频文件或用户数据。备份不会因导出时间自动失效；同一授权 7 天内最多还原或换绑一次，最终结果由授权平台裁决。
数据导入与导出：个人中心中的入口当前已禁用，暂时不能用于书库数据导入、导出、服务器迁移或数据库备份。
联系我们：如有疑问或需购买授权，请添加微信：
微信号：Yay_ls

3. 数据存储

SQLite 驱动：所有元数据、进度、任务状态均存储在本地 SQLite 数据库中。
任务系统：采用异步任务队列，支持扫描、刮削、章节生成等长耗时操作。

4. 分类系统规范

显式授权：除管理员外，用户仅能查看被显式授权且状态为启用 (enabled=1) 的分类。
排序一致性：全平台统一使用 sort_order (升序) 作为首要排序依据，id 或 name 作为次要依据。
数据联动：分类变更（启用状态、书籍增减）应实时反映在各端展示页面。
AI 分类任务一致性：AI 分类状态以服务端任务为准，前端负责状态回显与展示，不做结果裁决。

🎯 适合谁

有 NAS 本地存储或 WebDAV 存储的有声书爱好者，想把“目录”变成“书架”
想要更好的移动端听书体验，并且希望进度可同步
需要可控、可迁移的自托管方案（数据与服务都在自己手上）