常见问题

WebDAV 资源接入

哪些网盘支持 WebDAV 直连？

目前市面上主流支持 WebDAV 协议的网盘包括：

• 123 网盘：支持 WebDAV 协议（需开通会员），速度快，空间大。
• 115 网盘：支持 WebDAV 协议（需开通会员），资源丰富。
• 坚果云：国内最早支持 WebDAV 的网盘，虽然免费空间较小，但同步非常稳定。
• OpenList：支持将多种网盘转化为 WebDAV 协议（推荐方案）。
• NAS 自建：群晖、威联通、飞牛 (fnOS) 等 NAS 系统均可轻松开启 WebDAV 服务。

如果我的网盘不支持 WebDAV 怎么办？

如果你使用的是阿里云盘、百度网盘、夸克、迅雷等官方不支持 WebDAV 的服务，推荐使用 OpenList。

• OpenList：
  • 目前最主流的网盘挂载工具，支持几乎所有主流网盘。
  • 性能优异，WebDAV 协议兼容性好，是目前对接 Leelaa Reader 的最佳方案。
  • 部署 OpenList 后，将网盘挂载进去，再将 Leelaa Reader 对接到 OpenList 提供的 WebDAV 地址即可。

---

刮削识别与目录规范

如何提高刮削成功率？

Leelaa Reader 的刮削逻辑高度依赖目录名称。为了获得最佳的刮削效果，建议采用以下规范：

1. 标准命名规则 (推荐)

使用 . 分隔书名、演播信息和其他元数据。

• 推荐格式：书名.演播[演播者].[其他信息]
• 示例：八仙饭店.演播泡芙先生_.李狗嗨.2022.AAC.96~128kbps
• 解析：系统会自动提取第一个 . 之前的内容作为书名进行在线刮削。

2. 本地元数据文件 (高优先级)

如果你希望书籍信息更加精准，或者在线刮削不到信息，可以在书籍目录下放置以下文件：

• cover.jpg / cover.png：书籍封面（会自动作为首选封面）。
• desc.txt：书籍简介内容。
• reader.txt：演播者/播音信息。
• author.txt：作者信息。

3. 避免干扰

文件夹名称中尽量不要包含广告词、多余的符号（如：【关注微信公众号：xxx】雪中悍刀行）。

---

为什么识别出来的书名不对（如：识别为“第一季”）？

这是典型的目录层级过深导致的。

• 错误示例：有声书/庆余年/第一季/001.mp3
• 原因分析：系统的扫描逻辑是“自上而下”寻找包含音频文件的最底层目录。在上述例子中，系统会识别出 第一季 是包含音频的文件夹，因此将 第一季 作为书名创建。
• 解决方案：将 第一季 下的文件移动到 庆余年 目录下，或者将目录改名为 庆余年 第一季。

刮削不到封面或简介？

• 确认该书籍在喜马拉雅等平台上是否存在，且名称是否完全一致。
• 检查网络环境，确保服务器能够访问刮削接口。
• 如果在线刮削失败，你可以手动在书籍文件夹内放入一张名为 cover.jpg 或 cover.png 的图片作为封面。

---

扫描不到书

• 确认储存库的 WebDAV 地址与根目录路径填写正确
• 先在「储存库管理」里点击「测试连接」，确保能看到目录内容
• 仅支持常见音频格式（如 mp3/m4a/wav/flac），确认文件扩展名是否匹配

扫描很慢

• 大型目录首次扫描需要时间，建议先缩小根目录范围
• 适当降低递归深度或调整目录结构（按“每本书一个目录”更快）

播放失败或没有声音

• 先确认该章节音频文件在 WebDAV 中可直接访问
• 尝试在同一本书内切换到下一章，排除单个文件损坏

一直提示未激活

• 确认已在 /activate 完成激活
• 刷新页面并重新登录
• 如果你在多设备使用，确保每台设备都完成激活/登录流程