Changelog
v0.2.3Latest
Koharia v0.2.3
本次版本重点优化了 EPUB 连续阅读、正文图片交互、图片型 EPUB 路由，以及书库筛选和作品详情页的显示体验。
下载
版本信息与更新说明以 GitHub Releases 为准。请确认下载文件的版本为 0.2.3。
EPUB 阅读体验
- 连续滚动模式现在可以自然衔接相邻内部章节，到达章节末尾后可直接继续向下阅读。
- 连续阅读仅保留当前章节附近的内容，在保持进度、书签和 Komga 同步的同时降低长篇书籍的内存占用。
- 优化平板排版宽度，减少正文两侧过多留白，更充分利用大屏阅读区域。
- 优化章节标题、右对齐署名和图片段落的首行缩进，避免结构性内容被错误缩进。
- 出版商样式默认开启；已有用户明确保存的设置不会被覆盖。
- 优化亮度、字号和背景颜色快捷设置的布局，中英文界面下更加紧凑稳定。
EPUB 图片预览与操作
- 正文图片现在支持单击全屏预览和长按操作。
- 全屏预览支持双击缩放、双指缩放、拖动，以及点击图片切换顶部控件。
- 长按图片可执行预览、保存、分享和复制到剪贴板。
- 支持普通图片、
picture、独立 SVG，以及href/xlink:href引用的 SVG 图片。 - 保存和分享会保留图片原始格式、扩展名和字节内容。
- 连续滚动模式中的图片也能正确定位和加载。
- 链接图片仍保留原有跳转行为，不会被普通单击预览拦截。
- 优化 EPUB 与漫画图片操作面板的样式和按钮辨识度。
图片型 EPUB 自动选择阅读器
- 根据 Komga 媒体信息自动区分普通可重排 EPUB 和图片页 EPUB。
- 图片型、扫描型 EPUB 默认使用漫画分页阅读器打开。
- 普通 EPUB 继续使用 Readium 阅读器。
- 旧章节会在首次联网打开时自动补齐分类信息，不需要数据库迁移。
- 离线且无法确定类型时会优先使用 EPUB 阅读器，避免错误路由。
书库筛选
- 漫画书架和书籍书架现在分别保存筛选状态，互不干扰。
- 修复从作品详情返回、刷新书架或重启应用后筛选条件丢失的问题。
- 修复启动阶段服务器筛选信息尚未加载时，已保存的媒体库选择被临时状态覆盖的问题。
- 根据系列、阅读列表和单本文件动态显示适用的筛选项。
- 优化阅读状态、单本文件、作者角色等筛选文案和分组。
- 只有配置多个服务器时才显示服务器切换按钮。
作品详情页
- 显示模式拥有独立的顶部切换按钮，不再放在筛选菜单内。
- 支持松散网格、紧凑网格、纯封面和列表四种章节显示模式。
- 网格模式可显示阅读百分比和已读勾选角标。
- 漫画网格进度统一显示为百分比，列表模式继续显示已读页数。
- 新增全局“显示阅读进度与已读状态”设置。
- 详情页中的显示开关只对当前页面临时生效，只有选择“设为默认”时才会写入全局设置。
- 优化进度文字阴影、已读角标、封面明暗和角标圆角效果。
- 修复网格模式下顶部封面背景无法铺满屏幕左右边缘的问题。
- 作品简介默认收起，折叠预览由 3 行增加到 4 行。
- 顶部按钮调整为“显示模式 → 筛选 → 下载 → 更多”。
社区与问题反馈
可加入 Komga Discord，前往其中的 Koharia 子频道交流使用体验和反馈问题。
如果遇到崩溃、白屏、排版异常、图片无法操作、进度错误或阅读器选择错误，也欢迎通过 GitHub Issues 反馈：
https://github.com/Mister-album/Koharia/issues
反馈时请尽量附上：
- 问题复现步骤
- Android 版本和设备型号
- 应用截图或录屏
- 应用生成的崩溃日志
- 涉及的文件类型、阅读模式和 Komga 媒体信息
交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)
Koharia v0.2.3
This release improves EPUB continuous reading, in-content image interaction, image-based EPUB routing, library filters, and manga detail presentation.
Downloads
Release information on GitHub Releases is authoritative. Make sure the downloaded build reports version 0.2.3.
- GitHub Releases: https://github.com/Mister-album/Koharia/releases/latest
- Quark Drive: add the 0.2.3 link after upload
- Baidu Netdisk: add the 0.2.3 link after upload
EPUB reading
- Continuous scrolling now flows naturally into adjacent internal chapters.
- Nearby resources are retained while distant chapters are released to limit memory use in long books.
- Progress persistence, bookmarks, navigation, and Komga synchronization continue to work across chapter boundaries.
- Tablet layouts use more of the available reading width.
- Paragraph indentation no longer incorrectly affects headings, signatures, or image-only paragraphs.
- Publisher styles are enabled by default without overriding an existing explicit preference.
- Brightness, font-size, and background controls now have a clearer and more stable layout.
EPUB image interaction
- Tap EPUB images to open a fullscreen preview.
- Long-press images to preview, save, share, or copy them to the clipboard.
- The viewer supports double-tap zoom, pinch zoom, and panning.
- Supports regular images,
picture, standalone SVG images, and SVGhref/xlink:hrefreferences. - Save and share operations preserve the original image format and bytes.
- Images inside continuous-scroll chapters are resolved against the correct EPUB resource.
- Linked images keep their original navigation behavior.
- EPUB and comic image action panels now use clearer and more consistent styling.
Image-based EPUB routing
- Komga metadata is used to distinguish reflowable EPUB books from image-based or scanned EPUB files.
- Image-based EPUB files open in the comic page reader.
- Regular EPUB books continue to use the Readium reader.
- Existing chapter metadata is completed automatically on the first online open.
- When offline classification is unavailable, Koharia falls back conservatively to the EPUB reader.
Library filters
- Comic and book shelves now persist their filter state independently.
- Filters survive detail-page navigation, shelf refreshes, and app restarts.
- Persisted library selections are no longer overwritten while server metadata is still loading.
- Filter groups adapt to series, read lists, and one-shot books.
- Server switching is shown only when multiple server profiles exist.
Manga details
- Display mode now has a dedicated toolbar action instead of being placed in the filter menu.
- Added comfortable grid, compact grid, cover-only, and list modes.
- Grid layouts show reading percentages and read checkmarks.
- Comic grid progress is displayed as a percentage, while list mode retains page-count text.
- Added a global preference for progress and read-state indicators.
- Detail-screen changes remain temporary until “Set as default” is selected.
- Refined progress shadows, read badges, cover dimming, and corner styling.
- Fixed the cover backdrop not reaching both screen edges in grid mode.
- Descriptions are collapsed by default and now show four preview lines.
- Toolbar actions are ordered as “Display mode → Filter → Download → More.”
Community and feedback
Join the Komga Discord server and visit the Koharia channel.
Report crashes, blank screens, layout problems, image interaction failures, incorrect progress, or reader-routing issues through GitHub Issues:
https://github.com/Mister-album/Koharia/issues
Contributors
v0.2.2
Koharia v0.2.2
本次版本重点升级了 EPUB 书籍阅读器，并对漫画加载、书架管理、离线缓存、下载目录和旧版本升级兼容进行了优化。
下载
国内用户可优先选择夸克网盘或百度网盘下载。版本信息与更新说明以 GitHub Releases 为准。
- GitHub Releases：/changelogs//latest
- 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp
提取码：8tbp - 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g
提取码：6s2g
EPUB 书籍阅读器重点更新
- 新增基于 Readium 的原生 EPUB 阅读器，为书籍提供独立于漫画的阅读体验。
- 支持分页、连续滚动、从左到右和从右到左等阅读方式。
- 新增目录、书签、全文搜索、章节切换、进度拖动和音量键翻页。
- 支持调整字号、字体、行距、段落间距、页边距、首行缩进和阅读区域。
- 支持自定义背景颜色、亮度、出版商样式以及屏幕刘海区域显示。
- 优化阅读进度恢复与服务器进度同步，减少错误跳转和重复提示。
- 新增当前页、总页数和视觉分页缓存；排版变化后会重新计算页面信息。
- 优化 EPUB 首屏加载、书籍缓存和按需资源读取，减少重复网络请求。
- 修复横竖屏切换、行距调整、出版商样式、文字方向和页面背景等问题。
- 优化 EPUB 下载、离线打开和缓存管理。
其他重点更新
- 优化漫画首屏加载，优先请求当前页面并双向预载相邻页面。
- 优化漫画快速翻页、页面缓存和网络较慢时的阅读体验。
- 书架可按服务器媒体库划分为“漫画”和“书籍”，也可以继续合并显示。
- 完善多服务器管理、服务器重命名、删除和重新添加流程。
- 优化下载目录结构，并兼容旧版本已经下载的内容。
- 区分手动下载、书籍缓存和漫画页面缓存，避免缓存状态与下载状态混淆。
- 完善旧版本数据库和单服务器配置迁移，提高直接升级的兼容性。
- 更新应用内帮助文档、隐私政策和中英文网站链接。
已知风险与问题反馈
v0.2.2 包含大量 EPUB 阅读器功能和底层加载流程调整。不同书籍排版、设备、Android WebView 版本和服务器环境之间可能仍存在一些 Bug。
如果遇到崩溃、白屏、排版异常、进度错误、加载缓慢或其他问题，欢迎通过 GitHub Issues 反馈：
https://github.com/Mister-album/Koharia/issues
提交问题时请尽量附上：
- 问题复现步骤
- Android 版本和设备型号
- 应用截图或录屏
- 应用生成的崩溃日志
- 涉及的文件类型和阅读模式
交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)
升级异常处理
如果覆盖安装后出现无法启动、数据库迁移失败或旧设置冲突，可以在确认阅读进度已经同步、重要数据已经备份后：
- 卸载旧版本 Koharia。
- 下载并直接安装 v0.2.2 新版本。
- 重新添加服务器并恢复必要设置。
注意：卸载应用通常会清除本地设置、未同步的阅读进度及其他仅保存在 App 内的数据，请在操作前完成备份或同步。
Koharia v0.2.2
This release focuses on a major upgrade to the EPUB book reader, along with improvements to comic loading, library management, offline caching, download directories, and compatibility when upgrading from older versions.
Downloads
- GitHub Releases: https://github.com/Mister-album/Koharia/releases/latest
- Quark Drive: https://pan.quark.cn/s/f80624cde564?pwd=8tbp
Access code:8tbp - Baidu Netdisk: https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g
Access code:6s2g
EPUB reader highlights
- Added a native Readium-based EPUB reader with a dedicated book-reading experience.
- Added paged and continuous scrolling modes with multiple reading directions.
- Added table of contents, bookmarks, full-text search, chapter navigation, progress seeking, and volume-key page turning.
- Added controls for font size, font family, line height, paragraph spacing, margins, first-line indentation, and the reading area.
- Added custom background colors, brightness control, publisher styles, and display cutout support.
- Improved local position restoration and server progress synchronization.
- Added visual page counts and pagination caching, with recalculation after layout changes.
- Improved first-screen loading, book caching, and on-demand resource access.
- Fixed issues involving orientation changes, line spacing, publisher styles, writing direction, and reader backgrounds.
- Improved EPUB downloads, offline opening, and cache management.
Other highlights
- Improved comic startup by prioritizing the current page and prefetching nearby pages in both directions.
- Improved rapid page turning, page caching, and reading on slower connections.
- Added optional Comics and Books library sections based on server library classification.
- Improved multiple-server management, renaming, removal, and re-adding behavior.
- Simplified download directories while preserving compatibility with existing downloads.
- Separated manual downloads, book cache, and comic page cache.
- Improved database and legacy single-server migrations for safer upgrades.
- Updated in-app documentation, privacy, and localized website links.
Known risks and feedback
Koharia v0.2.2 contains extensive EPUB reader features and underlying loading changes. Some bugs may still occur with particular book layouts, devices, Android WebView versions, or server environments.
If you encounter crashes, blank screens, layout problems, incorrect progress, slow loading, or other issues, please report them through GitHub Issues:
https://github.com/Mister-album/Koharia/issues
When possible, include:
- Steps to reproduce the problem
- Your Android version and device model
- Screenshots or screen recordings
- Crash logs generated by the app
- The affected file type and reading mode
Troubleshooting upgrades
If an in-place update causes startup failures, migration errors, or conflicts with older settings, first make sure important progress is synchronized or backed up. You can then:
- Uninstall the previous version of Koharia.
- Download and install Koharia v0.2.2 as a fresh installation.
- Add your servers again and restore any required settings.
Uninstalling the app normally removes local settings, unsynchronized reading progress, and other app-only data. Back up or synchronize important data before proceeding.
Contributors
v0.1.8
此版本围绕 Komga 多服务器使用场景进行了较大幅度增强，新增服务器管理、共用下载目录下的跨服务器下载复用，并继续优化书架、章节显示、元数据展示、离线缓存与阅读进度同步体验。
新增与增强
- 新增 Komga 多服务器管理，可添加、编辑、删除并快速切换服务器。
- 新增本地配置模式，可选择共用配置或按服务器分别保存配置。
- 新增下载目录模式，可选择按服务器分目录或使用共用下载目录。
- 在共用下载目录模式下支持跨服务器复用已下载文件，减少同一文件在不同服务器之间重复下载。
- 新增 Komga 共享下载索引，用于记录远端书籍与本地文件的匹配关系。
- 下载、重命名、删除流程会同步维护共享下载索引，提高共用目录模式下的一致性。
- 预留删除服务器时联动清理下载文件的底层能力；当前默认仍保留下载文件，避免误删高价值内容。
- 在漫画详情页集成更多 Komga 元数据展示。
- 新增章节封面显示模式与默认章节标题显示设置。
- 优化书架显示模式、列数设置、筛选入口、排序与重置行为。
修复与改进
- 修复 Komga 阅读进度同步问题，避免后台同步使用过期漫画数据。
- 优化离线缓存与断网阅读行为，减少服务器不可用时的阅读失败。
- 将本地缓存迁移到应用存储，并增加缓存清理控制。
- 优化 Komga 元数据缓存与服务器错误时的回退行为。
- 修复应用更新下载通知进度与安装权限引导问题。
- 优化多服务器删除流程，删除服务器时会按配置模式清理对应本地配置，默认不删除下载文件。
- 修复共用目录模式下旧下载目录兼容问题，已有
Komga (ALL)等旧目录仍可被识别。 - 修复共享索引路径更新与删除边界问题，降低重命名或删除时产生脏索引的风险。
其他
- 移除部分 Mihon 遗留迁移功能及不适合 Komga 专属客户端方向的设置。
- 升级 Gradle Wrapper 至 9.6.1。
- 增加 PR Agent 与 CI 相关配置，改进后续开发与审查流程。
预览
| |
|
|
Contributors
0.1.6
此版本主要修复离线阅读与离线缓存队列相关问题，并进一步提升断网场景下的稳定性与使用体验。
修复与改进
- 修复断网时无法正常阅读已下载或已缓存内容的问题
- 修复已下载 PDF 的本地离线阅读问题
- 优化离线缓存未命中时的错误处理，不再直接显示
504错误 - 完善离线缓存队列的单项开始、暂停与取消控制
- 修复应用重启后缓存进度显示异常及恢复不正确的问题
- 优化下载进度刷新与状态同步逻辑，减少界面闪烁
- 调整缓存队列相关界面交互与提示文案
- 修复应用内更新下载通知不显示进度的问题
- 修复应用更新下载进度与安装权限引导
Contributors
v0.1.1
v0.1.1 Preview
修复 Komga 书架刷新与排序问题
本次预览版本主要修复并优化了 Komga 书架页面的刷新与排序体验。
- 修复重新进入书库标签页或重新选择书库标签页时，Komga 书架不会自动刷新的问题。
- 新增下拉刷新功能，并加入可见的拖拽反馈，刷新操作更加直观。
- Komga 书库排序现在会按照服务器 Web UI 中的排序设置显示，使客户端与服务端的书库顺序保持一致。
Contributors
v0.1.0
Koharia v0.1.0 Preview
这是 Koharia 的第一个公开预览版本。
Koharia 是一个面向 Komga 服务器内容浏览与阅读的独立第三方 Android 阅读器，基于 Mihon 项目衍生而来，并针对连接 Komga 服务器后的书架浏览、章节阅读与离线访问场景进行了适配。
注意：Koharia 是独立第三方项目，与 Mihon 项目或 Komga 项目不存在隶属、背书或官方维护关系。文中提及 Mihon 与 Komga 仅用于说明项目来源与兼容场景。
主要内容
- 基于 Mihon 代码库创建 Koharia 项目分支。
- 调整应用名称、项目标识与相关品牌内容。
- 面向 Komga 服务器内容浏览与阅读流程进行适配。
- 保留继承自 Mihon 的 Android 阅读器基础体验。
- 支持在已配置的 Komga 服务器中浏览书架内容。
- 支持阅读 Komga 提供的受支持书籍与章节。
- 支持为离线使用缓存内容。
- 在服务器与文件格式支持时，可直接下载原始文件。
- 当原始文件不适合当前阅读路径时，保留页面缓存下载方式，以维持阅读器自动下载兼容性。
- 保留底层应用现有的追踪器集成能力。
系统要求
- Android 8.0 或更高版本。
- 需要可访问的 Komga 服务器。
- 可访问的内容取决于所连接 Komga 服务器及其管理员授予的权限。
构建说明
本版本可通过 Android Studio 打开项目，或使用 Gradle 在本地构建。
推荐验证命令：
./gradlew.bat :app:compileDebugKotlin
已知说明
- 当前版本仍处于早期预览阶段，功能与交互可能继续调整。
- Koharia 不托管、不提供任何漫画或书籍内容。
- 本项目主要面向 Komga 使用场景，并不代表 Mihon 或 Komga 的官方客户端。
- 若你再分发 Koharia 或创建自己的衍生版本，请保留许可证与署名说明，并避免将修改版本表述为 Mihon 或 Komga 的官方发布版本。
致谢
Koharia 建立在 Javier Tomas 为 Mihon 最初完成的工作，以及后续 Mihon 项目贡献者持续投入的基础之上。感谢所有上游项目贡献者与继续改进这一衍生版本的贡献者。
许可证
本项目基于 Apache License 2.0 授权。请参阅仓库中的 LICENSE 与 NOTICE 文件了解完整许可与署名信息。
下载
请在本页面下方的 Assets 中下载 APK 文件并手动安装。