导入与整理

添加书库

在网页“设置 → 书库来源和导入 → 书库”中添加书库，选择存放读物的目录和文件组织方式。Docker 使用快速开始示例时，选择 /libraries/books。

可先放几本书确认效果，再导入完整藏书。书库中已有内容后，不能直接修改根路径或组织方式。

方式	适合什么情况	导入后的样子
单本	每个文件分别显示为一本书	子文件夹中的文件也独立成书；图片或音轨文件夹可作为一本漫画或有声书
分卷	一套书、多卷小说或多集漫画放在一起	第一级文件夹是一部作品，里面的文件和子文件夹供进入后选择；根目录单独文件仍独立成书

例如：

library/
  散文集.epub
  长篇小说/
    01.epub
    02.epub
  故事音频/
    001.mp3
    002.mp3

选择“分卷”后，“长篇小说”下可选择两卷；选择“单本”后，两份 EPUB 分别显示。有声书的多段音轨放在同一文件夹，使用 001、002 等连续编号。多碟音轨可放在 CD1、CD2 等子文件夹；不同故事请分别放置。

漫画图片同样按 001.jpg、002.jpg 排序，也可以使用 CBZ/ZIP 或 CBR/RAR 图片包。完整范围见支持格式。

书名、作者和封面可能在文件出现后陆续补齐。没有封面不一定是导入失败。

在书库中搜索、筛选，将图书加入书架；需要修改书名、作者、标签或封面时，打开图书的管理入口。自动补充信息的来源可在“设置 → 智能整理”中配置。

重新扫描用于更新目录中的变化，不会替你移动或改名原文件。自动和手动扫描都可能移除已确认不存在的项目；如果 NAS 目录掉线，先恢复访问，再扫描。读取失败的目录会保留原记录。

移动或改名文件后，原来的进度和关联信息不保证自动跟过去。批量整理前先备份。删除图书或文件时，核对确认窗口是否会删除原文件。

检查书库是否启用、文件是否在正确目录，以及该书库的文件大小、后缀和忽略规则；再查看“导入记录”并重试。不要反复上传同一文件，或只改扩展名尝试导入。更多处理见常见问题。