企业官网建设流程全解析

Wenku8_Flutter是一款免费开源的轻小说文库 Flutter 阅读客户端（Android 手机与平板）。它支持通过网盘导入功能，直接从OpenList / WebDAV与夸克网盘把 TXT、EPUB、Kindle 等电子书下载到本机离线阅读，全程只读取文件、不改动网盘原书。本教程带你一步步完成 OpenList、WebDAV 与夸克网盘三种入口的连接、Cookie 配置和批量导入。

Wenku8_Flutter 阅读客户端

📦 功能总览：支持哪些网盘与书籍格式

💡 百度网盘、OneDrive、Google Drive 等网盘，可先挂载到自己的 OpenList，再统一从这里导入；需要代理下载的网盘，在 OpenList 对应存储中开启下载代理即可。

完整官方说明见 docs/CLOUD_IMPORT.md，功能介绍也可参考 README.md。

🚀 快速开始：找到「从网盘导入」入口

进入网盘导入页只需两步：

1. 打开 App，底部切换到本地；若已开启设置 → 使用方式 → 合并书架，底部会隐藏「本地」，改为从书架 → ＋进入；
2. 点击右上角＋→从网盘导入，在「网盘来源」中选择OpenList / WebDAV或夸克网盘。

该入口定义在 lib/local_book_importer.dart，连接与浏览页面实现在 lib/cloud_library_page.dart。

🔗 OpenList / WebDAV 连接四步走

这是最通用、也最稳定的网盘导入方式：只要你的网盘能通过 OpenList 或 NAS 暴露 WebDAV 服务，就能直接用。

第一步：在 OpenList 或 NAS 上开启 WebDAV

在 OpenList 或 NAS 的存储管理中开启WebDAV 功能，并给阅读账号授予读取权限。只读权限就够用了，更安全。

第二步：填写连接信息

在连接页填写三个字段：

⚠️ HTTPS 默认开启。可信局域网中的 HTTP 服务需要手动打开「允许 HTTP 连接」开关，但 HTTP 会明文传输凭据，请勿在不可信网络使用。

第三步：连接并浏览

点击连接并浏览，App 会校验服务可用性——如果地址不对，会提示「该地址不是 WebDAV 服务，请检查 /dav/ 路径」（校验逻辑见 lib/cloud_sources.dart）。连接成功后即可逐级进入网盘目录。

第四步：选择书籍导入

进入书籍目录后，点击一本直接导入，或勾选多本批量导入。解析在后台逐本进行：

• 单本失败时其余书籍继续导入，结果页会列出失败文件；
• 重复文件不会新增副本，压缩包与网盘原文件都不会被改动。

各格式的大小上限：

🍪 夸克网盘导入（实验性）：Cookie 配置教程

没有 OpenList 也可以直接连夸克网盘。此入口使用网页版接口，属于实验性功能。

如何获取夸克网盘 Cookie

1. 在电脑浏览器登录自己的pan.quark.cn；
2. 打开开发者工具的网络（Network）面板，刷新后选择一条网盘文件列表请求；
3. 在请求头中找到Cookie，复制它的完整值；
4. 回到 App，在「夸克网盘 → 配置夸克 Cookie」中粘贴，点击连接并浏览。

Cookie 中需要包含__puus字段，否则保存时会提示「请粘贴本人夸克网页的完整 Cookie，需要包含 __puus」。操作提示界面见 lib/cloud_library_page.dart。

⚠️ 实验性说明：接口或风控变化可能影响使用；服务端更新会话时会同步更新本机记录，登录失效后重新填写即可。下载速度仍由网盘自身决定。

📚 导入之后：合并分卷与跨设备同步

• 自动识别同系列分卷：批量导入全部完成后，App 会统一列出识别到的分卷并按卷号排序，点击确认合并即可合为一本书，详情页目录按卷展开、阅读器可连续阅读；选择暂不合并则各卷独立显示，之后仍可在书籍… → 合并分卷中操作。
• 原书保留：合并后原 EPUB 保留，文中插图、阅读进度和书签按原章节对应，还可以管理分卷增删调整。
• 跨设备同步：在本地 → 书库设置 → 跨设备同步设置中连接.wenku8sync同步文件，可同步原书、进度书签与本地分类。注意 WebDAV 和夸克入口当前只用于导入，不会向网盘上传阅读进度。

🛡️ 常见问题与安全说明

安全方面可以放心使用：

• 连接密码与 Cookie 使用Android Keystore 加密保存在设备上，不进入书库同步文件或 Android 备份；
• 导入过程为只读，不会移动、删除或修改网盘中的任何文件；
• 客户端以 Dart 独立实现了 WebDAV 只读请求（lib/cloud_sources.dart），并未打包 OpenList 服务本身。

写在最后

通过 OpenList / WebDAV 或夸克网盘入口，你可以把散落在各网盘里的 EPUB、TXT、Kindle 书籍批量收入 Wenku8_Flutter 的立体书架，导入后即可离线阅读、听书，并和在线书架合并管理。没有 OpenList 环境时夸克 Cookie 是不错的轻量方案，而 OpenList + WebDAV 则是长期稳定使用的首选——建议新手优先走 WebDAV 路线，一步配置、多网盘通用。