下载 Koharia
最新正式版发布于 。
Koharia 需要 Android 8.0 或更高版本，可连接你自行配置的 Komga 服务器，也可直接使用设备上的本地媒体库。
更新日志
Koharia v0.5.0：LANraragi 接入、书架缓存与阅读体验升级
本次版本新增 LANraragi 书库支持，优化 Komga 与 LANraragi 的书架缓存和进度同步，并修复连续滚动、注释点击及漫画双页缩放等阅读问题。
下载
版本信息与更新说明以 GitHub Releases 为准，请确认下载的版本为 0.5.0。
- GitHub Releases：[下载页面](#v0.5.0)
- 夸克网盘：[下载链接](https://pan.quark.cn/s/f80624cde564?pwd=8tbp)，提取码：
8tbp - 百度网盘：[下载链接](https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g)，提取码：
6s2g
如果不确定应该下载哪个 APK，请使用普通通用版本：
Koharia-v0.5.0-release.apk
同时提供 FOSS 通用版本和不同 CPU 架构的普通版 APK。FOSS 版不包含遥测组件，使用独立应用标识，可与普通版共存，不能直接覆盖普通版。
同渠道、同签名版本可直接覆盖升级，无需卸载或清除应用数据。
LANraragi 书库
- 新增内置 LANraragi 连接，支持添加和切换多个服务器。
- 支持 Archive 独立作品、Tankoubon 合集和 Category 分类；合集详情显示其中的多个 Archive，分类保留在书架顶部。
- Archive 默认可直接进入漫画阅读器，也可选择先打开详情与逐页网格预览，再从指定页面开始阅读。
- 支持搜索、标签与阅读状态筛选、排序，以及手动下载后离线阅读。
- 缓存书库元数据，离线时仍可浏览和搜索；正文需要另行下载，元数据缓存不代表作品已下载。
- 按 Archive 同步阅读进度，离线阅读记录可在恢复连接后补传；需要服务器开启进度记录并提供相应权限。
- “标记未读”仅重置本地状态，不清零服务器进度。
- 统一连接编辑、顶部导航与筛选样式，改善首次进入书库、空库刷新及部分作品首图加载体验。
书架缓存与启动体验
- Komga 与 LANraragi 书架优先读取本地缓存，已有缓存时，启动和返回书架不再等待网络刷新。
- 缓存缺失时获取书架数据；后续通过手动刷新或服务器更新事件更新内容。
- 刷新失败时保留已有缓存，减少网络波动导致的空白书架。
- 区分有效空库与尚未建立缓存的状态，改善首次加载和失败重试。
- 不同连接的缓存保持隔离，阅读进度同步独立运行。
- 优化大书库元数据缓存的读取与处理，减少内存占用。
阅读进度同步
- 修复部分 Komga 漫画阅读进度未能正常上传的问题。
- 改善上传失败后的补传处理，待同步记录可在应用重新启动后继续处理。
- 按连接隔离同步任务，减少切换服务器时的状态串用。
- 保持书籍阅读位置与设备相关视觉页数的区分，避免排版变化影响云端进度。
漫画阅读
- 双页阅读新增“保存合并页”，可将当前两页合并保存为一张图片。
- 修复双页模式下两张图片缩放不同步的问题，改善共同缩放与平移体验。
- 修复“适应宽度”配合仿真翻页时，动画结束后画面出现缩放跳变的问题。
- 增加滑动翻页控制，支持按阅读习惯关闭左右滑动翻页。
EPUB 与连续滚动
- 修复连续滚动时，斜向滑动可能误触发横向跳章的问题。
- 修复短章节或扉页未能及时衔接后续内容，导致上下滑动无反应的问题。
- 修复点击嵌入章节的文字或空白区域后，阅读位置可能跳到书籍底部的问题。
- 修复连续滚动中部分注释点击无反应的问题，改善同章、跨章及图标注释的处理。
- 保留图片预览、章节链接与文本选择，减少重复创建章节页面造成的位置扰动。
- 改善阅读器返回操作及章节切换后的状态恢复。
稳定性
- 修复部分作品元数据编辑页在状态恢复时的崩溃。
- 改善异常处理，避免错误提示过程中再次触发异常。
- 加强异常 EPUB 内容校验和部分页面导出处理。
- 补充书架缓存、阅读进度、连续滚动及仿真翻页相关回归测试。
交流与问题反馈
Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)**，还原加入交流使用体验、功能建议和常见问题。
可稳定复现的问题欢迎提交至 [GitHub Issues](https://github.com/Mister-album/Koharia/issues)。
反馈时请尽量提供复现步骤、Android 版本与设备型号、Koharia 版本、书库类型及阅读模式。涉及书籍时，请注明文件格式；涉及 PDF 时，请注明使用原版还是重排阅读。
截图、录屏和日志有助于定位问题，请隐藏账号、密码和访问令牌等私人信息。
感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。
文件校验 / File verification
所有 APK 的 SHA-256 摘要见发行附件 SHA256SUMS.txt。
SHA-256 digests for all APKs are available in the attached SHA256SUMS.txt.
完整变更 / Full changelog: https://github.com/Mister-album/Koharia/compare/v0.4.5...v0.5.0