常见问题

Koharia 是什么？

Koharia 是面向 Komga、Kavita、LANraragi、smanga 和本地媒体库的第三方 Android 漫画与书籍阅读器。

Koharia 提供内容吗？

不提供。Koharia 只显示你有权通过自己配置的服务器访问，或主动授权给应用扫描的本地内容。

必须部署服务器吗？

不需要。选择“使用本地文件夹”即可创建本地库连接；服务器连接和本地库可以同时存在。

各服务器需要什么版本和认证？

Kavita 以 0.8.0 及以上版本为目标，需要 Auth Key/API Key。smanga 以 4.3 API 为目标，必须开启 OPDS，并使用用户名和密码。LANraragi 以 0.9.70 及以上版本为目标，使用服务器地址和可选 API Key；Komga 支持 API Key 或用户名密码。

关联目录会移动或删除文件吗？

不会。添加已有目录只会授予访问权限并建立索引；移除目录也不会删除原文件。导入媒体、创建书库目录或写入 sidecar 元数据需要写入权限。

支持哪些格式？

支持图片、漫画压缩包、PDF、EPUB、TXT、Markdown、MOBI/PRC/AZW/AZW3 和 DjVu。Markdown 支持标题、列表、引用、代码块和大纲，但不渲染内嵌图片，表格降级为文本，单文件上限为 16 MiB。MOBI 等格式为实验性支持；DjVu 依赖 Android WebView 的 WebAssembly。

为什么元数据能看到，但正文不能离线阅读？

书架元数据缓存、阅读缓存和手动下载是不同状态。需要离线阅读时，必须下载完整章节或文件；详情见离线与同步。

阅读进度如何同步？

各服务器只同步其支持的进度、历史、书签或批注。本地库的阅读位置和本地书签保存在设备上。网络中断时，部分服务器会把变更放入待同步队列；发生冲突时需要选择本地或服务器版本。

TTS 会上传正文吗？

会。使用 Edge 或 MiMo 朗读时，当前章节正文会发送给所选 TTS 厂商以生成语音。API Key 在设备上加密保存；不希望正文外发时请不要使用网络朗读引擎。

下载失败怎么办？

检查设备空间、目录权限、网络和服务器账号权限，并确认对应服务器网页端可以打开该内容。不同来源的下载权限和 PDF/Archive 行为不同。

支持哪些 Android 版本？

Koharia 需要 Android 8.0 或更高版本。