THE READING GUIDE

连接网盘漫画库

连接自己的网盘或 WebDAV,按需阅读云端漫画。

VeneraPlus 可通过内置 OpenList 内核连接百度网盘、夸克网盘、115 网盘、123 云盘、OneDrive 和 Google Drive;WebDAV 仍可作为一个独立账号使用。

内置内核由 Venera-OpenList-Core 独立构建并随应用打包;应用只使用已发布的固定内核版本,不会在设备上下载或运行 OpenList 服务。

在“存储与同步”的网盘账号管理页点击“添加”,先进入网盘来源列表,再点击来源打开对应账号配置页,填写信息或登录授权后,点击页面底部固定的“保存并测试连接”按钮。编辑已有账号时直接进入对应配置页;从配置页返回可重新选择来源,从来源列表返回则取消添加。百度网盘、115 网盘、123 云盘和 OneDrive 可点击“登录并授权”,在应用的 WebView 中完成官方授权并自动填入令牌。授权及在线令牌刷新继续使用 OpenList 官方 API;应用不会把 OpenList HTTP 服务暴露到网络。

令牌自动授权统一使用“OpenList 提供的参数”,分别对应 115 验证登录(OAuth App)、123 验证登录(OAuth官方)、百度验证登录(OAuth App)和 OneDrive 个人版本(OAuth App)。无需填写客户端 ID 或应用密钥。

夸克改用 Quark Cookie 驱动。点击“登录并授权”后在应用 WebView 中登录夸克官网,应用确认能读取网盘目录后,通过原生 Cookie 存储提取包括 HttpOnly 在内的完整 Cookie 并回填;也可手动填写 Cookie。保存后测试连接。已有 QuarkOpen 账号需重新登录,保存时保留账号标识及已配置的目录,不再使用旧令牌、AppID 或 SignKey。

Google Drive 仍使用 OpenList Token 页面 手动获取授权。使用令牌的网盘也可直接填写令牌。百度、123、OneDrive 和 Google Drive 需要刷新令牌,115 需要访问令牌与刷新令牌。

“设置 → 存储与同步”按用途集中展示网盘账号、在线漫画库、应用数据同步和漫画归档备份,并显示当前账号、目录及同步状态。账号只需添加一次,各用途共用授权;选择账号时可直接添加新账号,完成后继续当前配置。首次成功连接账号后,也可直接选择用途。

“设置 → 来源与服务 → 内容来源”统一管理网站源和远程漫画库,并按类型分组。点击“添加”后选择来源类型:网站源可从仓库安装或通过链接、文件导入;远程漫画库直接选择网盘账号和漫画目录,也可在配置途中新增账号。“存储与同步”中的“在线漫画库”以及发现、搜索中的来源管理入口均打开同一页面。

“在线漫画库”可为每个漫画库选择一个账号和一个或多个识别目录。目录会合并展示;相同完整远端路径的漫画只显示一次,不同目录下的同名漫画会分别显示。应用数据同步和漫画归档备份各自选择一个账号和一个目录:前者同步设置、收藏、阅读记录等应用数据,后者备份和恢复 CBZ 漫画文件。

选择目录时,点击文件夹名称进入,点击行尾选框勾选;“当前文件夹”一行可选择当前目录,包括根目录和空文件夹。跨目录浏览会保留勾选,底部显示已选数量,点击右下角“完成”返回配置页;返回键取消本次选择。漫画库可多选,同步和备份只允许选一个目录。

在线漫画库支持图片目录、远端 ZIP/CBZ、图片型 EPUB 和 PDF。同一作品的分卷文件可聚合展示,明确的版本目录与重复卷使用阅读分组切换;不同格式的非重复分卷可连续阅读。各卷及封面按需解析和缓存,连续阅读与预加载不会越过版本边界。独立 ZIP/CBZ 保留章节目录与分组,EPUB 按 spine 顺序阅读并区分章节与页码导航,PDF 按原始页码渲染并支持书签分章。布局示例和元数据规则见漫画导入与在线阅读。

云端文件按需阅读要求实际文件服务支持 HTTP Range。服务器忽略 Range、返回整包或无效分段时会明确失败,不会自动下载整个文件;通过网盘直链、代理或重定向访问时同样适用。ZIP/CBZ 支持 Store/Deflate 的 ZIP/ZIP64,不支持加密、分卷或其他压缩方式。7z/CB7 仍需先下载后本地导入,或将漫画图片解压到远端目录。

旧 WebDAV 同步和归档配置会自动接入统一账号,保留原同步目录和归档目录。本地漫画位置、缓存与下载线程归入“本地存储与下载”,手动数据导入和导出归入“应用数据导入与导出”。

所有已保存的网盘账号及授权信息都会随应用数据快照同步,包括尚未用于漫画库的账号。123 云盘的访问令牌、刷新令牌、绝对过期时间与授权更新时间整组同步,同一账号采用较新的授权,旧快照不会覆盖较新的本机令牌。新设备和重启后优先使用已有访问令牌,到期或接口明确拒绝后才刷新;旧授权没有过期时间时先尝试访问,不在导入时重新计算有效期。其他网盘恢复快照时仍优先保留本机有效授权;数据同步目标始终保留在本机。漫画备份配置是否同步由“同步备份配置”选项决定。

123 云盘刷新遇到临时网络或服务异常后可再次重试;明确的 invalid_grant 会保留原始错误并标记授权失效,需要重新登录或同步更新的授权。若网盘在刷新后废弃旧刷新令牌,尚未同步新授权的设备仍可能需要重新授权。

网盘账号名称必须唯一,比较时忽略首尾空格和英文大小写。同一账号在不同设备上请使用相同名称,不同账号请使用不同名称;同步时,同名且网盘类型相同的账号会自动合并,并更新漫画库、同步和备份目录的账号引用,保留漫画库标识与收藏关联。同名但类型不同的账号会保留,并自动添加名称后缀以区分。修改账号名称仍保留内部账号标识。

macOS 应用仍支持 macOS 12;受 Go 1.27 运行时限制,OpenList 六种网盘仅在 macOS 13 及以上可用。在 macOS 12 上,WebDAV 和本地功能仍可使用。