书库管理
导入、整理和管理您的电子书收藏
书库管理是小幻阅读书籍模块的核心功能，帮助你导入、整理和快速定位电子书。
界面概览
书籍模块界面由以下部分组成：
| 区域 | 功能 |
|---|---|
| 侧边栏 | 虚拟文件夹（全部、收藏）、书架列表、数据源入口 |
| 标题栏 | 面包屑导航、搜索框、书籍数量 |
| 内容区 | 书籍列表，支持多种视图模式 |
导入书籍
小幻阅读支持多种导入方式，从本地文件到在线书库应有尽有。
本地导入
| 方式 | 操作 |
|---|---|
| 拖拽导入 | 将文件或文件夹拖拽到应用窗口 |
| 文件选择 | 点击标题栏的导入按钮，选择文件 |
| 文件夹导入 | 选择整个文件夹，递归扫描所有电子书 |
| 本地存储源 | 通过侧边栏的本地存储源浏览并导入 |
在线数据源
小幻阅读支持多种在线数据源，可以在侧边栏的数据源区域找到：
| 数据源 | 说明 | 需要配置 |
|---|---|---|
| OPDS | 连接 OPDS 格式的在线书库（如 Calibre、Kavita） | 服务器地址、可选认证 |
| WebDAV | 从 WebDAV 服务器浏览和下载书籍 | 服务器地址、用户名密码 |
| Legado | 连接阅读 3.0 (Legado) 应用，同步书架 | 服务器地址、服务器类型 |
| ZLibrary | 从 ZLibrary 搜索和下载电子书 | 邮箱、密码登录 |
提示
OPDS、WebDAV、Legado 需要先添加数据源配置，ZLibrary 是全局数据源，直接使用即可。
支持的格式
| 格式 | 说明 |
|---|---|
| EPUB | 主流电子书格式，支持富文本和图片 |
| 便携文档格式，保留原始排版 | |
| Mobi | Amazon Kindle 格式 |
| FB2 | FictionBook 格式 |
| TXT | 纯文本格式（支持编码检测和章节分割） |
| CBZ/ZIP | 漫画/图片集压缩包 |
导入设置
在设置 → 书籍中可以配置导入行为：
- 导入后自动打开：导入完成后自动打开第一本书
- 导入时自动刮削：自动从网络获取书籍信息
提示
导入时会自动检测重复书籍（基于文件哈希），避免重复导入同一本书。
书架管理
书架帮助你按主题、类型或阅读状态组织书籍。
虚拟文件夹
侧边栏顶部提供两个预设的虚拟文件夹：
| 文件夹 | 内容 |
|---|---|
| 全部书籍 | 显示所有导入的书籍 |
| 收藏 | 显示标记为收藏的书籍 |
创建书架
- 点击侧边栏"书架"区域旁的 + 按钮
- 输入书架名称
- 选择图标（可选）
- 选择所属分组（可选）
书架分组
书架可以归入分组，方便管理大量书架：
- 点击"书架"区域旁的**文件夹+**按钮创建分组
- 创建或编辑书架时选择所属分组
- 分组支持展开/折叠
书架操作
右键点击书架可以进行以下操作：
| 操作 | 说明 |
|---|---|
| 编辑 | 修改书架名称、图标、分组 |
| 上移/下移 | 调整书架在列表中的位置 |
| 置顶/置底 | 快速移动到列表顶部或底部 |
| 删除 | 删除书架（可选是否同时删除书籍） |
添加书籍到书架
- 单本添加：右键书籍 → 管理书架 → 勾选目标书架
- 批量添加：多选书籍 → 右键 → 添加到书架
- 拖拽添加：将书籍拖拽到侧边栏的书架上
- 导入时添加：从书架页面导入时自动添加到当前书架
使用书籍创建书架
选中多本书籍后，右键选择创建书架，可以一键创建新书架并添加所选书籍。
视图模式
书籍列表支持三种视图模式：
| 模式 | 特点 | 适用场景 |
|---|---|---|
| 封面视图 | 大封面，信息精简 | 浏览封面、视觉导向 |
| 网格视图 | 中等封面 + 作者、进度等信息 | 日常使用（默认） |
| 列表视图 | 紧凑列表，详细信息 | 快速浏览、批量管理 |
视图设置
在设置 → 书籍中可以配置：
- 使用全局视图模式：所有书架使用相同的视图模式
- 关闭后，每个书架可以独立设置视图模式
排序和搜索
排序选项
点击标题栏的排序按钮，可按以下方式排序：
| 排序方式 | 说明 |
|---|---|
| 按标题 | 按书名字母顺序 |
| 按作者 | 按作者名称 |
| 按添加时间 | 按导入日期 |
| 按最近阅读 | 按最后阅读时间 |
每种排序都支持升序和降序切换。
搜索书籍
标题栏的搜索框支持实时搜索：
- 输入关键词搜索书名
- 显示搜索建议（最多 15 条）
- 点击建议项直接打开书籍
提示
排序设置可以设为全局或独立。在设置 → 书籍 → 使用全局排序中配置。
元数据编辑
右键书籍选择编辑元信息，可以修改书籍的详细信息：
可编辑字段
| 字段 | 说明 |
|---|---|
| 书名 | 书籍标题 |
| 作者 | 作者列表（支持多作者） |
| 副标题 | 书籍副标题 |
| 译者 | 译者列表 |
| 出版社 | 出版社名称 |
| 出版日期 | 出版日期 |
| ISBN | 国际标准书号 |
| 描述 | 书籍简介 |
| 封面 | 上传本地图片或输入 URL |
封面管理
- 点击封面区域上传本地图片
- 支持从剪贴板粘贴图片
- 支持常见图片格式（PNG、JPG、WebP）
书籍刮削
刮削功能可以自动从网络获取书籍信息，补全元数据。
刮削源
| 来源 | 适用内容 |
|---|---|
| 豆瓣 | 中文书籍 |
| Google Books | 英文书籍 |
| 番茄小说 | 网络小说 |
| 起点中文网 | 网络小说 |
| 晋江文学城 | 网络小说 |
| Bangumi | 轻小说、日本文学 |
| Pixiv | 同人作品 |
使用刮削
- 右键书籍 → 刮削书籍信息 → 选择刮削源
- 自动搜索书名（或手动输入关键词）
- 从搜索结果中选择匹配项
- 选择要应用的字段（书名、作者、封面等）
- 确认应用
提示
开启导入时自动刮削后，新导入的书籍会在后台自动尝试获取信息，不会阻塞导入流程。
批量操作
选中多本书籍后，可以进行批量操作：
选择书籍
- 单击：选中单本书籍
- Ctrl + 单击：添加/移除选择
- Shift + 单击：范围选择
- Ctrl + A：全选/取消全选
- 框选：按住鼠标左键拖拽，框选多本书籍
批量操作菜单
选中多本书籍后右键，可以：
| 操作 | 说明 |
|---|---|
| 添加到书架 | 将所选书籍添加到一个或多个书架 |
| 从书架移除 | 从当前书架移除（仅在书架视图中可用） |
| 创建书架 | 使用所选书籍创建新书架 |
| 切换收藏 | 批量添加或移除收藏标记 |
| 删除 | 批量删除书籍 |
数据源
侧边栏的数据源区域提供了多种获取书籍的方式。
本地存储
本地存储源让你无需导入即可浏览本地文件夹中的电子书。
添加本地存储源：
- 在侧边栏点击本地存储旁的 + 按钮
- 选择要浏览的目录
- 浏览文件夹中的电子书
支持的操作：
- 浏览文件夹中的所有电子书
- 搜索文件名
- 按文件名、修改时间、文件大小排序
- 选择文件后导入到书库
提示
本地存储源支持两种导入方式：引用导入（不复制文件）和复制导入（将文件复制到书库）。
OPDS 书库
OPDS（Open Publication Distribution System）是一种用于分发电子书的开放标准。许多书库软件支持 OPDS，如 Calibre、Kavita、Komga 等。
添加 OPDS 源：
- 点击OPDS旁的 + 按钮
- 输入源名称和 OPDS 目录地址
- 如需认证，输入用户名和密码
使用 OPDS：
- 浏览目录树结构
- 搜索书籍（如服务器支持）
- 选择书籍下载并导入
WebDAV
从 WebDAV 服务器浏览和下载书籍文件。
添加 WebDAV 源：
- 点击WebDAV旁的 + 按钮
- 输入源名称和服务器地址
- 输入用户名和密码
使用 WebDAV：
- 浏览服务器上的文件和目录
- 搜索文件
- 选择文件下载并导入
Legado（阅读 3.0）
连接运行在 Android 设备上的阅读 3.0 应用，同步书架内容。
添加 Legado 源：
- 在手机上开启 Legado 的 Web 服务
- 点击Legado旁的 + 按钮
- 输入源名称和服务器地址（如
http://192.168.1.100:1122） - 选择服务器类型（Legado App 或 Hectorqin 服务器）
导入方式：
- 下载导入：将书籍下载为 EPUB 文件导入到本地书库
- 在线导入：创建在线书籍引用，阅读时从 Legado 服务获取内容
ZLibrary
从 ZLibrary 搜索和下载电子书。
首次使用：
- 在侧边栏点击ZLibrary
- 使用邮箱和密码登录
- 登录后可保存凭证自动登录
使用方式：
- 搜索书名、作者或 ISBN
- 选择书籍下载并导入
- 支持快速导入或选择目标书架
提示
ZLibrary 支持自定义镜像地址，可在登录界面设置。
书籍信息显示
书籍卡片会显示以下信息：
| 信息 | 说明 |
|---|---|
| 封面 | 书籍封面图片 |
| 书名 | 书籍标题 |
| 作者 | 作者名称（多作者用逗号分隔） |
| 阅读进度 | 进度条显示阅读百分比 |
| 最近阅读 | 相对时间（如"3天前"） |
| 阅读时长 | 累计阅读时间（如"2小时30分"） |
| 收藏标记 | 星形图标标识收藏状态 |
| 刮削状态 | 后台刮削时显示指示器 |
常见问题
导入的书籍在哪里？
导入的书籍文件存储在书库目录的 Books/<服务ID>/files/ 文件夹中。
如何批量修改书籍信息？
目前不支持批量编辑元数据。可以在设置 → 书籍中开启导入时自动刮削，新导入的书籍会自动获取信息。
删除书籍会删除文件吗？
- 库内书籍（导入到书库的）：删除时会同时删除文件
- 引用书籍（来自本地存储源等）：仅删除数据库记录，不删除原始文件
如何恢复误删的书籍？
如果文件已被删除，需要重新导入。建议定期备份书库目录。