书架管理

书架统一展示本地与网络书籍。每本书保存来源、目录、当前章节、章节内进度、更新时间和 用户管理状态。

添加书籍

• 从搜索或发现结果进入详情页后加入书架；
• 从“文件”导入 EPUB、TXT、MOBI/AZW/AZW3/PRC 或 CBZ；
• 下载网络文件型书源提供的 EPUB/TXT 后导入；
• 从备份或 iCloud 恢复。

排序与布局

书架支持列表/网格布局、搜索、置顶和自定义排序。布局和排序写入本地设置，重启后保持。 同一来源 URL 的重复记录会在服务层去重，避免 SwiftUI ForEach 身份冲突。

更新检查

自动更新只在书架和书源都加载完成后执行，并对同一数据签名去重。网络书会通过当前来源 刷新详情/目录；本地书不会进入网络更新链路。

进度展示用的是 durChapterIndex + 1 / totalChapterNum（当前阅读到第几章 / 目录总章数） 这一对字段，不是单独维护一个"已读章节数"计数器——所以刷新目录后总章数变化会立刻反映在 进度文案里，不需要额外触发一次进度重算。

长按与批量操作

常用操作包括继续阅读、查看详情、置顶、分组、换源、更新和删除。删除书架记录不会自动 删除用户原始导入文件之外的任意外部数据；涉及缓存清理时应在 UI 中明确说明。

常见问题

书籍显示但无法打开

先确认本地文件仍存在，或网络书的来源仍已导入且启用。iOS 更新后应用容器 UUID 可能变化， 本地书会按文件名回退到 Documents/LocalBooks 查找。

网络书更新失败

在书籍详情中确认当前来源，再到书源管理执行单源验证。不要只用来源首页是否能打开判断； 有效性需要目录和正文都能成功。