离线与同步

Koharia 将元数据缓存、阅读缓存和手动下载分开管理。看到书架或作品详情，不代表正文已经保存到设备。

四种本地状态

• 书架元数据缓存：封面、标题、章节和筛选结果，可让部分书架在断网时继续显示。
• 书籍或页面缓存：阅读过程中按需保存的 EPUB 资源或漫画页面，受缓存策略和容量限制影响。
• 手动下载：明确保存到下载目录的完整章节或文件，用于可靠的离线阅读。
• 待同步记录：断网时产生的阅读进度、已读状态、书签或批注变更，联网后再提交服务器。

清理临时缓存不会以清理缓存为目的删除已完成下载；清除应用数据则可能删除连接、阅读记录和仅保存在数据库中的元数据。

各来源的差异

• Komga：书架优先使用本地缓存；支持的进度和历史会在联网后同步，EPUB 可按设置使用书籍缓存或手动下载。
• Kavita：离线搜索覆盖已下载书籍，已保存筛选使用缓存结果；进度、批注和书签可能进入待同步队列，并支持冲突选择。
• LANraragi：Archive 元数据可离线浏览和搜索，但页面正文需要单独下载；进度同步要求服务器开启进度记录。
• smanga：书架和详情数据持久缓存，章节正文需完整下载后才能离线阅读；进度、已读状态和历史会排队重试。
• 本地库：内容本身已经在设备或授权目录中，离线能力不依赖远程服务器；阅读记录和元数据保存在本地。

进度冲突

当服务器上的位置与本地位置不一致，或文件页序发生变化时，应用可能要求选择本地或服务器进度。确认前请检查最近一次阅读设备和当前内容版本；不要把视觉页码直接当作所有服务器都能同步的稳定位置。

开始大批量下载前，请先阅读存储指南并确认有足够空间。