Koharia

Koharia 是一款面向 Komga 服务器与本地媒体库的第三方 Android 客户端和阅读器。它为漫画、扫描图像内容、PDF 以及 EPUB、TXT、MOBI 等可重排书籍提供对应的阅读体验，并将内容浏览、作品详情、阅读进度、离线访问与阅读设置整合在同一个应用中。

项目基于 Mihon 的成熟 Android 阅读基础持续开发。Koharia 不提供或托管内容，你能浏览的作品取决于所连接的服务器、账号权限以及主动授权给应用的本地目录。

适合谁使用 ・希望在同一个 Android 应用中阅读漫画、PDF 与多种电子书格式。 ・拥有个人或家庭媒体库，需要封面浏览、作品详情、历史记录与进度同步。 ・希望直接关联设备上的现有目录，或由应用创建并管理漫画与书籍目录。 ・重视阅读方向、字体排版、背景颜色、翻页方式和离线访问等个性化体验。 ・希望将手动下载、书籍缓存和漫画页面缓存分开管理。

Koharia 专注于个人媒体库阅读，不提供公共在线内容源，也不以恢复传统扩展生态为目标。

主要功能

漫画与书籍统一管理 ・可选择将媒体库划分为“漫画”和“书籍”，也可以保持合并书架。 ・支持封面网格、列表、搜索、筛选、排序、作品详情、阅读历史和多服务器快速切换。 ・Komga 服务器库分类与本地书库设置相互独立，便于按不同来源组织内容。

本地库与文件导入 ・可通过 Android 系统目录授权关联已有文件夹，扫描过程不会移动或删除原文件；也可由 Koharia 创建 Comics、Books 与 .koharia 目录结构。 ・本地目录可标记为漫画、书籍或混合内容，并分别归入自定义书库。 ・提供“系列库”和“单文件库”两种组织方式：前者将一级文件夹视为系列，后者递归展示可直接阅读的文件和图片目录。 ・支持本地索引、下拉刷新、封面提取、格式筛选、条目详情编辑，以及从第一页生成封面。 ・可从 Android 文件打开或分享入口临时阅读支持的文件，也可将文件导入具备写入权限的本地目录。 ・统一使用扩展名、MIME 类型和文件特征识别格式，降低文件名缺失或扩展名不准确造成的导入失败。 ・元数据编辑结果可仅保存在应用数据库，也可写入作品旁的 ComicInfo.xml / metadata.opf，或本地库的 .koharia/metadata 统一目录。

漫画阅读 ・支持分页、连续滚动、从左到右、从右到左及双页等阅读方式。 ・提供缩放、旋转、裁边、阅读方向、章节切换和进度拖动等常用控制。 ・优先加载当前页面，并根据阅读方向预取相邻页面，提升连续翻页体验。 ・支持单页缓存和手动下载，已缓存内容可在网络不稳定时继续阅读。

EPUB 书籍阅读 ・使用原生 EPUB 阅读流程，支持分页、连续滚动及不同翻页方向。 ・可调整字号、字体、行距、段落间距、页边距、首行缩进和阅读区域。 ・支持自定义背景颜色、亮度、出版商样式、音量键翻页及刘海区域显示。 ・提供目录、书签、全文搜索、章节切换、阅读百分比与视觉页数显示。 ・排版变化后重新计算当前页与总页数，并缓存相同设备和排版设置下的分页结果。

进度、离线与数据管理 ・保存本地阅读位置、历史记录和书签，并与服务器同步支持的阅读进度。 ・手动下载、书籍缓存和漫画页面缓存使用独立策略，缓存不会被误标记为已下载内容。 ・支持缓存容量限制、按需资源读取、离线访问，以及按服务器组织下载目录。 ・支持多服务器和本地库连接、独立阅读设置、备份恢复和旧版本数据库迁移。