Koharia

English

简体中文
简体中文

English

简体中文
简体中文

Appearance

0.3.0 Latest

Koharia v0.3.0

本次版本重点扩展 EPUB 字体、注释和排版能力，加入漫画双页阅读，提升 Komga 搜索、书架与服务器管理体验，并全面优化应用更新下载、非标准 EPUB 兼容和运行稳定性。

EPUB 字体与排版

  • 新增统一字体选择器，支持内置字体、Android 系统字体和本地导入字体。
  • 支持导入 TTF、OTF、TTC 和 OTC 字体，并按字体家族折叠归组。
  • 字体选择页面支持名称搜索、字体系列展开、本地字体导入和删除。
  • 支持常规、粗体、斜体、字体集合和可变字体信息。
  • 修复部分中文字体名称乱码，兼容常见 Macintosh 中日韩编码及异常字体名称记录。
  • 本地字体通过应用私有字体库加载，不会上传到服务器。
  • 新增起始、左、右和两端对齐；两端对齐时支持英文断词。
  • 对齐方式会同步应用于分页、连续滚动和分页扫描，不再错误复用旧分页缓存。
  • 修复左右对齐下首行缩进失效或方向错误的问题。
  • 根据 EPUB 目录锚点保持章节分页边界，避免章节标题前残留上一章内容。
  • 优化作品详情中的出版社、语言、年龄分级和册数换行，长文本不再挤出屏幕。

EPUB 注释与兼容性

  • 点击正文注释标记后，可在当前阅读页打开紧凑、可滚动的注释弹窗。
  • 支持标准 epub:type="noteref"、无障碍角色，以及多看等常见非标准脚注格式。
  • 注释弹窗会使用当前阅读背景和正文设置字号，不需要离开当前阅读位置。
  • 优化文字、图片和 SVG 注释标记的大小、上标位置与点击范围。
  • 分页和连续滚动模式均支持注释交互。
  • 增加常见非标准 XHTML 修复，兼容无值属性等可能导致严格解析失败的内容。
  • 将段落缩进、图片颜色和兼容策略并入首帧准备流程，减少翻页后的排版变化。
  • 修复本地 EPUB 打开时阅读进度被临时分页位置错误覆盖的问题。
  • 修复资源末尾进度同步可能被 Komga 拒绝的问题。
  • 改进 EPUB 预取异常隔离，单个资源错误不再影响整个阅读会话。

EPUB 图片颜色

  • 新增默认开启的“反色时保持图片原色”设置。
  • 设置可在全局阅读设置和 EPUB 阅读器快捷设置中同步调整。
  • 支持分页、连续滚动、普通图片、picture 和 SVG 内容。
  • 修复翻页时图片先被反色、随后才恢复原色的闪烁。
  • 关闭该设置后，可让图片跟随阅读页面一起反色。

漫画双页阅读

  • 横向分页阅读器新增单页、双页、自动单页和自动双页布局。
  • 可识别横向跨页、动画页、异常比例页面和尺寸不兼容的相邻页面。
  • 自动决定页面应拆分、配对或独占显示。
  • 支持双页偏移和左右位置交换，适配不同装订与阅读方向。
  • 优化双页加载优先级及完整图片合成。
  • 超大图片或内存压力较高时，会回退到双分块视图，避免整图合成导致内存不足。
  • 长按操作仍会正确命中双页中的原始页面。
  • 修复双页模式下本地进度与 Komga 远端进度被错误判断为冲突的问题。
  • 新增“保存阅读页面的设置修改”开关，可选择仅在当前会话使用设置，或持久保存为默认值。
  • 重新整理漫画阅读设置的顺序和布局。

Komga 搜索

  • 默认搜索范围改为“全部”，同时搜索书籍和系列。
  • 书籍与系列搜索结果会交错展示，并保留各自的分页状态。
  • 搜索栏新增范围切换，可单独选择全部、书籍或系列。
  • 支持作者、标签、阅读状态、书库和单行本等公共筛选。
  • 优先使用 Komga 1.19+ 的新搜索接口，旧服务器会自动回退兼容接口。
  • 改进半角、全角括号和方括号处理，降低特殊字符导致整次搜索失败的概率。
  • 搜索状态下会隐藏无关工具栏按钮，并可通过返回箭头退出搜索。

书架、服务器与章节显示

  • 修复书架筛选在切换书库后丢失的问题。
  • 服务器“显示书库”范围现在会真正限制书架可见内容，而不再只是影响“全部”筛选。
  • 默认仍显示服务器中的全部书库。
  • 优化服务器删除操作：左滑显示紧凑删除按钮，点击后再次确认。
  • 服务器地址会自动清理首尾空格和末尾斜杠，避免 URL 拼接异常。
  • 新增“隐藏缺失章节提示符”设置。
  • 新增“显示文件大小”设置。
  • 文件大小恢复为跟随章节名称并使用括号显示，减少列表第二行的信息拥挤。
  • 优化网格模式中的阅读进度和已读角标。
  • 精简服务器、文件大小和阅读进度同步相关设置文案。

更新与下载稳定性

  • 更新元数据和 APK 下载优先使用 download.koharia.org，GitHub 作为备用来源。
  • 更新说明会根据系统语言自动选择中文或英文；其他语言统一显示英文说明。
  • 手动检查更新时始终打开更新页面；没有新版本时会显示当前版本公告，并明确提示暂无更新。
  • APK 下载支持 .part 临时文件和断点续传。
  • 增加下载源自动回退、指数退避重试和可重试错误分类。
  • 下载完成后会校验文件大小、SHA-256、应用包名和签名证书。
  • 修复重复触发更新下载时多个任务同时写入同一临时文件的问题。
  • 新增 FOSS 通用 APK、各架构 APK 和 SHA256SUMS.txt 校验文件。
  • 正式 Release 发布后会自动触发 Koharia 官网更新。

稳定性与崩溃修复

  • 章节磁盘缓存的外部目录不可用时，会自动回退到应用内部临时缓存目录。
  • 缓存容量会根据实际使用目录计算，内部回退缓存也会正确参与统计和清理。
  • 修复外部缓存目录被删除、无法创建或临时不可用时可能导致的启动崩溃。
  • 应用更新后会刷新桌面小组件，重建可能过期的 PendingIntent。
  • 移除当前小组件不需要的 Glance 跳板 Activity，避免旧 PendingIntent 触发崩溃。
  • 网络调试日志会隐藏认证信息、API Key 和 Cookie Header。

初次使用与品牌体验

  • 没有配置服务器时，书架不再显示加载错误，而是引导用户添加服务器。
  • 初始用户引导中新增“添加服务器”入口，可直接进入服务器配置页面。
  • 应用内官网、文档和支持链接统一更新为 koharia.org。
  • 更新 Koharia 应用图标、主题单色图标和启动页视觉。
  • 新图标进一步区分 Koharia 与 Komga 官方项目的品牌形象，减少将本应用误认为 Komga 官方客户端的情况。
  • Koharia 是面向 Komga 的独立 Android 阅读器，并非 Komga 官方客户端。
  • 优化自适应图标安全区、缩放比例和垂直对齐，避免启动页裁切或视觉偏移。
  • 更新 Android Studio 项目图标、README Logo 和中英文界面截图。

社区与问题反馈

交流、反馈 QQ 群：[625289125](https://github.com/Mister-album/Koharia/commit/625289125)

如果遇到崩溃、白屏、排版异常、字体加载失败、注释无法打开、进度错误、双页显示异常或更新下载失败，也欢迎通过 GitHub Issues 反馈：

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

反馈时请尽量附上：

  • 问题复现步骤
  • Android 版本和设备型号
  • 应用截图或录屏
  • 应用生成的崩溃日志
  • 涉及的文件类型、阅读模式和 Komga 版本
  • 字体问题所使用的字体格式及字体名称

下载

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

中国大陆用户推荐优先使用夸克网盘或百度网盘下载，通常比直接连接 GitHub 更稳定。

如果应用内更新下载失败，可以从网盘下载新版本的普通通用 APK，并直接覆盖安装现有正式版。使用相同签名的正式版本覆盖安装不会清除已有应用数据。

如果不确定应下载哪个 APK，请使用：

Koharia-v0.3.0-release.apk

本次同时提供不包含遥测组件的 FOSS 通用版本。FOSS 版使用独立应用标识，可与普通版同时安装，不能直接覆盖普通版。

Koharia v0.3.0

This release expands EPUB fonts, footnotes, and layout controls, adds double-page comic reading, improves Komga search and library management, and strengthens update delivery, malformed EPUB compatibility, and runtime stability.

EPUB fonts and layout

  • Add a unified font picker for built-in, Android system, and imported local fonts.
  • Support TTF, OTF, TTC, and OTC imports grouped by font family.
  • Add font search, family expansion, local font import, and deletion.
  • Support regular, bold, italic, collection, and variable-font metadata.
  • Fix mojibake in some Chinese font names, including common Macintosh CJK encodings and malformed name records.
  • Store imported fonts in the app-private font library without uploading them.
  • Add Start, Left, Right, and Justify alignment, with English hyphenation for justified text.
  • Apply alignment consistently to paginated reading, continuous scrolling, and pagination scanning.
  • Fix first-line indentation under physical left and right alignment.
  • Preserve chapter boundaries using EPUB navigation anchors so previous-chapter content does not appear before a chapter heading.
  • Allow publisher, language, age-rating, and volume metadata to wrap on narrow screens.

EPUB footnotes and compatibility

  • Open a compact, scrollable popup when a note reference is tapped.
  • Support standard epub:type="noteref", accessibility roles, and common non-standard footnote formats such as Duokan.
  • Match popup colors and text size to the active reader settings without leaving the current reading position.
  • Refine text, image, and SVG note-marker sizing, superscript placement, and touch targets.
  • Support footnotes in both paginated and continuous-scroll modes.
  • Repair common malformed XHTML, including valueless attributes that can fail strict parsing.
  • Move paragraph indentation, image-color handling, and compatibility policies into first-frame document preparation.
  • Prevent provisional pagination positions from overwriting restored progress when opening a local EPUB.
  • Align resource-end progress with Komga server positions to avoid rejected synchronization.
  • Isolate EPUB prefetch failures so an individual resource error does not terminate the reading session.

EPUB image colors

  • Add a default-enabled “Preserve image colors when inverted” setting.
  • Share the setting between global reader preferences and EPUB quick settings.
  • Cover paginated and continuous-scroll content, including regular images, picture, and SVG.
  • Fix page-turn flashes where images appeared inverted before returning to their original colors.
  • Disable the setting when images should follow full-page inversion.

Double-page comic reading

  • Add single-page, double-page, automatic single-page, and automatic double-page layouts to the horizontal pager.
  • Detect spreads, animated pages, unusual aspect ratios, and incompatible neighboring pages.
  • Split, pair, or isolate pages based on their content.
  • Support shifted pairing and left/right position inversion for different binding directions.
  • Improve double-page loading priority and full-resolution composition.
  • Fall back to dual tiled views for oversized images or high memory pressure.
  • Keep long-press actions mapped to the correct original source page.
  • Fix false local and Komga progress conflicts in double-page mode.
  • Add an option to keep reader-setting changes for the current session only or persist them as defaults.
  • Reorganize comic reader settings for a clearer layout.

Komga search

  • Make “All” the default search scope and search books and series together.
  • Interleave book and series results while preserving independent pagination.
  • Add a search-scope selector for All, Books, or Series.
  • Support shared author, tag, reading-state, library, and one-shot filters.
  • Prefer Komga 1.19+ search endpoints and automatically fall back for older servers.
  • Normalize half-width and full-width brackets to reduce failed searches caused by special characters.
  • Hide unrelated toolbar actions while searching and provide a clear back action.

Library, server, and chapter display

  • Preserve shelf filters when switching libraries.
  • Make the server-level “Show libraries” scope actually restrict shelf contents instead of only affecting the All filter.
  • Keep all server libraries visible by default.
  • Replace the oversized server swipe action with a compact delete button followed by confirmation.
  • Normalize surrounding whitespace and trailing slashes in server addresses.
  • Add a “Hide missing chapter indicators” setting.
  • Add a “Show file size” setting.
  • Display file sizes next to chapter titles in parentheses to keep list metadata readable.
  • Refine reading-progress and read-state badges in grid layouts.
  • Simplify server, file-size, and progress-sync setting descriptions.

Update reliability

  • Prefer download.koharia.org for release metadata and APK downloads, with GitHub as a fallback.
  • Select Chinese or English release notes from the system language; every non-Chinese language uses English.
  • Always open the update screen for manual checks. When no update is available, show the current release announcement with a clear up-to-date message.
  • Support resumable .part downloads.
  • Add source fallback, exponential backoff, and retryable-versus-terminal error handling.
  • Verify APK size, SHA-256, package name, and signing certificates before installation.
  • Prevent replaced update workers from writing the same partial file concurrently.
  • Add universal FOSS, per-ABI APKs, and an attached SHA256SUMS.txt.
  • Trigger a Koharia website rebuild after publishing a GitHub Release.

Stability and crash fixes

  • Fall back to an internal temporary directory when the external chapter disk cache is unavailable.
  • Calculate cache capacity from the directory actually in use and include the fallback directory in cache accounting.
  • Prevent startup crashes when the external cache directory is deleted, cannot be recreated, or becomes temporarily unavailable.
  • Refresh home-screen widgets after an application update to rebuild stale PendingIntents.
  • Remove the unused Glance trampoline activity that could be launched by incomplete legacy PendingIntents.
  • Redact authentication, API key, and cookie headers from verbose network logs.

Onboarding and branding

  • Replace the shelf error with server-setup guidance when no server is configured.
  • Add an “Add server” action to the initial onboarding flow.
  • Update website, documentation, and support links to koharia.org.
  • Refresh the Koharia launcher, themed monochrome icon, and splash-screen branding.
  • The new branding further distinguishes Koharia from the original Komga project and reduces confusion with an official Komga client.
  • Koharia is an independent Android reader built for Komga and is not an official Komga application.
  • Correct adaptive-icon safe zones, scaling, and vertical alignment.
  • Update the Android Studio project icon, README logo, and localized screenshots.

Community and feedback

Join the Komga Discord server and visit the Koharia channel.

Report crashes, blank screens, layout problems, font-loading failures, inaccessible footnotes, incorrect progress, double-page layout issues, or update failures through GitHub Issues:

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

When reporting an issue, please include:

  • Reproduction steps
  • Android version and device model
  • Screenshots or screen recordings
  • Crash logs generated by the app
  • Relevant file type, reader mode, and Komga version
  • Font format and font name for font-related issues

Downloads

GitHub Releases is the authoritative source for release information. Make sure the downloaded build reports version 0.3.0.

Users in mainland China are encouraged to use Quark Drive or Baidu Netdisk for more reliable downloads.

If the in-app update download fails, download the regular universal APK from either drive and install it over the existing regular release. Installing an update signed with the same key preserves existing app data.

If you are unsure which APK to download, use:

Koharia-v0.3.0-release.apk

A universal FOSS build without telemetry components is also available. It uses a separate application ID, can be installed alongside the regular build, and cannot directly replace it.

What's Changed

  • 扩展 Komga 搜索范围与容错 / Expand Komga search scope and resilience by @Mister-album in https://github.com/Mister-album/Koharia/pull/50
  • 修复 EPUB 图片反色与翻页闪烁 / Fix EPUB image inversion and page-turn flicker by @Mister-album in https://github.com/Mister-album/Koharia/pull/53
  • 修复 EPUB 非标准内容兼容与进度稳定性 / Fix EPUB compatibility and progress stability by @Mister-album in https://github.com/Mister-album/Koharia/pull/55
  • 清理不可达的即将推出功能与无效风险通知 / Remove unreachable upcoming feature and ineffective risk warnings by @Mister-album in https://github.com/Mister-album/Koharia/pull/56
  • 优化 EPUB 文本对齐与作品元数据换行 / Improve EPUB text alignment and metadata wrapping by @Mister-album in https://github.com/Mister-album/Koharia/pull/57
  • 支持 EPUB 注释弹窗与非标准脚注兼容 / Add EPUB footnote popups and compatibility by @Mister-album in https://github.com/Mister-album/Koharia/pull/58
  • 支持 EPUB 本地与系统字体 / Add local and system EPUB fonts by @Mister-album in https://github.com/Mister-album/Koharia/pull/59
  • 替换并修正 Koharia 应用图标 / Replace and fix the Koharia app icon by @Mister-album in https://github.com/Mister-album/Koharia/pull/60
  • 修复章节缓存与小组件更新崩溃 / Fix chapter cache and widget update crashes by @Mister-album in https://github.com/Mister-album/Koharia/pull/61
  • 优化应用更新下载稳定性 / Improve app update download reliability by @Mister-album in https://github.com/Mister-album/Koharia/pull/62
  • 优化书架范围、服务器管理与章节显示 / Improve shelf scope, server management, and chapter display by @Mister-album in https://github.com/Mister-album/Koharia/pull/63
  • 漫画双页阅读与会话设置 / Comic double-page reading and session settings by @Mister-album in https://github.com/Mister-album/Koharia/pull/64

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

文件校验 / File verification

所有 APK 的 SHA-256 摘要均包含在附件 SHA256SUMS.txt 中。

SHA-256 digests for every APK are available in the attached SHA256SUMS.txt.

Assets 7