储存库概览
储存库是 Leelaa Reader 获取有声书数据的核心源头。通过将您的有声书目录挂载为储存库，系统将自动进行扫描、解析与信息补全。
什么是储存库？
在 Leelaa Reader 中，储存库（Library） 类似于一个虚拟的书架。无论您的原始音频文件是存放在本地硬盘、NAS 还是第三方网盘中，只要将其目录作为储存库挂载，系统就会：
- 自动识别目录结构与音频文件。
- 自动提取封面与音频标签（ID3）。
- 自动匹配或抓取外部的演播、年份等元数据信息。
管理员权限说明：储存库的添加、修改、扫描与回收站管理属于核心后台操作，为了保障数据安全，仅支持使用管理员账号在网页端或移动端进行操作。普通用户无法看到储存库的配置入口。
储存模式对比
为了适配不同的服务器环境与文件存放习惯，Leelaa Reader 提供了三种储存模式，请根据您的实际情况选择最合适的方式：
| 模式 | 适用场景 | 扫描速度 | 稳定性 | 额外配置 |
|---|---|---|---|---|
| 本地挂载 (Local) | 书籍直接存放在服务器硬盘，或已通过 Docker Volume 映射。 | 极快 | 极高 | 仅需输入绝对路径 |
| WebDAV 模式 | 书籍存放在支持标准 WebDAV 协议的 NAS 或 Nextcloud 中。 | 快 | 高 | 需要地址与账号密码 |
| 网盘模式 (Netdisk) | 书籍存放在公有云盘，并通过第三方工具转出为 WebDAV 协议。 | 中等 | 中 | 建议开启网盘模式 |
| RSS 播客订阅 | 通过 RSS 链接订阅播客节目，自动同步并更新单本书内容。 | 快 | 高 | 仅需输入 RSS 订阅地址 |
目录选择与挂载体验
对于 WebDAV 和 网盘模式，系统提供了直观的两步式挂载体验：
- 连接验证：输入服务器信息后，系统会实时验证连通性。
- 可视化选择：系统会弹出文件浏览器，您可以直接点选需要作为书库根目录的文件夹。
注意：对于 本地挂载 (Local)，出于服务器安全考虑，不提供可视化目录浏览功能。您需要直接准确输入容器内部的绝对路径（如
/app/media）。
日常管理入口
当您已经添加了一个或多个储存库后，日常维护通常会围绕下面这些入口展开：
- 新增与编辑储存库：用于新增新来源、修改地址、调整根目录或切换同步策略
参考：储存库新增与编辑 - 书籍管理：进入某个储存库后查看当前书籍、搜索、回收站恢复、单本编辑
参考：书籍管理 - 扫描 / 开始刮削：对当前储存库重新扫描，导入新增书籍并更新目录索引
参考：扫描与回收站 - 清理：对当前储存库执行脏数据清理，移除数据库中已失效的记录
参考：扫描与回收站 - 任务管理：查看扫描、清理、导入导出、AI 分类等后台任务进度
参考：任务与日志 - 库日志：查看某个储存库相关的运行日志与失败信息
参考：任务与日志
编辑与清理储存库
- 编辑储存库：如果您更换了服务器、修改了网盘密码或更新了挂载路径，可以直接在“储存库管理”列表中点击对应的储存库进行编辑修改。只要路径下的书籍结构未变，系统会自动重新匹配，不会丢失原有的阅读进度。
- 清理储存库：当您在 NAS 或网盘上删除了某些实体文件夹，或移动了大量书籍后，可以点击储存库列表中的“清理”按钮。系统会自动对比本地数据库与远程实际文件，将那些“已丢失”的书籍进行软删除并移入回收站，保持书库的整洁。
数据安全承诺
Leelaa Reader 在处理您的有声书资源时，始终秉持“只读优先”的原则：
- 扫描与刮削：所有的封面提取、章节切分与重命名操作，均仅在系统的独立数据库中进行，绝不会修改您的原始音频文件或重命名您的原始文件夹。
- 文件清理：即使您在系统中删除了某本书，或清空了回收站，也永远不会删除您网盘或 NAS 上的原始文件。