Koharia

简体中文

English

简体中文

English

Appearance

0.4.1

Koharia v0.4.1：本地书库、媒体导入与阅读体验升级

本次版本汇总了 v0.3.0 至 v0.4.1 的更新，是一次以本地阅读体验为重点的较大升级。

Koharia 现在可以直接管理本地文件夹中的漫画与书籍，并支持从 Android 系统直接打开或导入媒体文件；漫画与 EPUB 阅读器也加入了统一的多种翻页效果。同时，本版本集中优化了 Komga 阅读进度同步、离线缓存、页面加载和网络调度，并修复了一批 EPUB、启动和阅读器稳定性问题。

下载

版本信息与更新说明以 GitHub Releases 为准。请确认下载的版本为 0.4.1。

  • GitHub Releases：/changelogs//tag/v0.4.1
  • 夸克网盘：https://pan.quark.cn/s/f80624cde564?pwd=8tbp 提取码：8tbp
  • 百度网盘：https://pan.baidu.com/s/1DlOuovGpIkaQh6NSo7b4cw?pwd=6s2g 提取码：6s2g

中国大陆用户推荐优先使用夸克网盘或百度网盘下载。

如果不确定应该下载哪个 APK，请使用普通通用版本：

Koharia-v0.4.1-release.apk

本次同时提供 FOSS 通用版本及不同 CPU 架构的 APK。普通用户通常无需选择架构专用版本。

本地书库与媒体导入

  • 新增本地文件夹书库，无需 Komga 服务器即可直接管理和阅读设备中的漫画与书籍。

  • 支持添加多个 Android SAF 文件夹，并可分别管理漫画与书籍目录、重新关联目录或手动刷新。

  • 新增 系列库 与 单文件库 两种组织方式：

    • 系列库适合按照作品 / 章节目录组织的内容。
    • 单文件库会递归扫描目录，可直接从书架打开单个漫画或书籍文件。

  • 支持扫描和阅读 EPUB、PDF、CBZ / ZIP、CBR / RAR、7Z、TAR 以及图片目录。

  • 新增 Android 系统级媒体入口，可从文件管理器或其他应用中：

    • 直接使用 Koharia 打开并阅读文件
    • 将一个或多个媒体文件导入本地书库

  • 新增本地书库创建与管理界面，支持书架、筛选、排序、布局切换、元数据编辑 / 识别和封面提取。

  • 单文件条目可直接显示漫画页码进度或 EPUB 阅读百分比；系列条目显示已读章节数与总章节数。

  • 本地书库的阅读进度和状态保存在本地，不依赖 Komga API。

  • 优化大型本地书库的扫描、索引以及阅读进度刷新性能。

  • Koharia 不会自动移动、重命名或删除用户的原始媒体文件。

系列库与单文件库的组织模式在创建后固定，如需更换组织方式，请重新创建本地书库。

阅读器与翻页体验

  • 为漫画与 EPUB 分页阅读加入统一的翻页效果，可选择：

    • 平移
    • 覆盖
    • 仿真翻页
    • 上下翻页
    • 淡入
    • 缩放
    • 无动画

  • 漫画与 EPUB 可分别保存翻页效果设置；Webtoon 和 EPUB 连续滚动继续使用各自的滚动行为。

  • 漫画仿真翻页支持根据触摸位置改变翻页方向和角度，并改进连续快速翻页时的任务调度。

  • 优化漫画页面加载、预取、页面缓存和翻页调度，减少等待、重复加载和快速翻页造成的卡顿。

  • 优化 EPUB 资源加载、分页切换以及 Komga Readium 网络访问。

  • 修复 EPUB 中超长字符串无法正确换行的问题。

  • 优化 EPUB 图片文件命名，避免不同资源使用相同文件名时发生冲突。

  • 修复 EPUB 阅读器中的 S Pen 悬空翻页与章节导航。

  • 修复连续快速翻页时可能出现的状态异常。

Komga、阅读进度与离线体验

  • 修复 Komga 书架中阅读进度显示不完整的问题，改为结合服务器数据统计已读章节数与总章节数。

  • 网格布局现在可以显示阅读进度角标，列表布局显示文字进度，并新增书架阅读进度显示开关。

  • 修复统计页面仅依赖本地数据而导致 Komga 阅读统计不准确的问题。

  • 改进 Komga SSE、手动刷新和阅读器进度上传之间的同步与并发协调。

  • 阅读器上传进度前会更谨慎地比较服务器状态，防止较旧的本地阅读进度覆盖服务器上的较新进度。

  • 完善漫画未读重置、EPUB 阅读位置以及单本增量进度刷新。

  • 优化 Komga 阅读进度读取缓存，减少书架刷新和生命周期变化造成的重复请求。

  • 优化本地章节与 EPUB 阅读进度查询，大型书库下减少重复数据库访问。

  • 改进 仅显示缓存 / 离线模式：

    • 避免不必要的网络回退。
    • 完善书架、作品详情和阅读器章节筛选。
    • 正确识别完整缓存的 EPUB。
    • 离线状态下可继续使用本地阅读状态、标签、作者、状态和排序信息。

  • 优化 Komga API、SSE 和网络请求调度，减少重复请求和无效等待。

  • 阅读器处于前台时会优先保证阅读请求，降低后台下载与页面加载争抢网络资源造成的影响。

数据兼容与稳定性

  • 重构书库连接架构，将 Komga 与本地文件夹统一到新的连接管理体系，并保留现有 Komga 配置的升级兼容。
  • Koharia 备份使用专用的 .kohariabackup 格式，避免误导入不兼容的 .tachibk 备份。
  • 优化冷启动初始化流程，减少启动阶段不必要的阻塞。
  • 修复并调整启动页与桌面应用图标显示。
  • 改进阅读器、书架和连接切换过程中的状态清理与异常恢复。
  • 问题反馈模板现已同时提供中文与英文说明。

交流与问题反馈

中文用户可以加入 Koharia QQ 交流群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)，交流使用体验、功能建议以及常见问题。

如果遇到可以稳定复现的问题，也欢迎通过 GitHub Issues 反馈：

https://github.com/Mister-album/Koharia/issues

反馈 Bug 时请尽量附上：

  • 问题的完整复现步骤，以及预期结果与实际结果。
  • Android 版本和设备型号。
  • Koharia 版本，以及使用的是 Komga 书库还是本地书库。
  • 涉及的文件格式和阅读模式，例如 EPUB、PDF、CBZ、分页或连续滚动。
  • 如果使用 Komga，请提供 Komga 版本，以及问题是否发生在在线、离线或仅显示缓存模式。
  • 截图、录屏或 Koharia 生成的崩溃日志。
  • 本地书库相关问题请说明使用的是系列库还是单文件库，以及大致的目录组织方式。

提交日志、截图或配置时，请注意隐藏服务器地址、账号、访问令牌以及其他私人信息。

感谢所有参与测试、反馈问题和持续改进 Koharia 的用户。

What's Changed

  • 修复 EPUB S Pen 悬空翻页 / Fix S Pen air-action paging in EPUB reader by @Mister-album in https://github.com/Mister-album/Koharia/pull/66
  • feat: 统一 EPUB 与漫画翻页动画 / Unify EPUB and comic page transitions by @Mister-album in https://github.com/Mister-album/Koharia/pull/67
  • 修复 EPUB 长字符串换行并优化图片命名 / Fix EPUB long-word wrapping and image naming by @Mister-album in https://github.com/Mister-album/Koharia/pull/70
  • 修复仅显示缓存的离线书架 / Fix cached-only offline shelves by @Mister-album in https://github.com/Mister-album/Koharia/pull/71
  • 实现本地书库与媒体导入 / Add local libraries and media import by @Mister-album in https://github.com/Mister-album/Koharia/pull/74
  • 修复 Komga 未读与进度同步 / Fix Komga unread and progress synchronization by @Mister-album in https://github.com/Mister-album/Koharia/pull/75
  • 优化冷启动初始化与启动页 / Optimize cold-start initialization and splash readiness by @Mister-album in https://github.com/Mister-album/Koharia/pull/76
  • perf: 优化阅读器与 Komga 网络性能 / Optimize reader and Komga network performance by @Mister-album in https://github.com/Mister-album/Koharia/pull/77
  • fix: 修复 Komga 阅读进度与统计显示 / Fix Komga progress and stats display by @Mister-album in https://github.com/Mister-album/Koharia/pull/78

Full Changelog: https://github.com/Mister-album/Koharia/compare/v0.3.0...v0.4.1

文件 7