KOReader 2025.04 更新详解：值得了解的 5 个变化-开发者社区

KOReader 2025.04 更新详解：值得了解的 5 个变化

【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader

KOReader 是一款为电子墨水屏打造的开源电子书阅读器应用，支持 EPUB、PDF、DjVu、FB2 等常见格式，可运行在 Kindle、Kobo、PocketBook、Android 以及 Linux 平台上。2025.04 这个版本（代号 Full Moon）主要解决了日常使用中的几类具体问题：Markdown 文档排版杂乱、书库文件排序混乱、自定义字典图片加载不稳定，以及一批长期闲置插件带来的维护负担。下文按使用场景逐个说明，并附上升级前的检查建议。项目背景可参阅官方文档。

一、先弄懂 KOReader 能替你做什么

在谈更新之前，先说清楚它和阅读器自带阅读器的差别。大多数墨水屏设备自带的阅读器只支持自家格式，且排版选项有限；KOReader 的思路是把"排版权"交还给用户：同一本书可以调整字距、行距、对比度、字体粗细，扫描版 PDF 和 DjVu 还能做重排，双栏 PDF 与漫画类文档有专门的阅读方向。阅读界面的默认触屏分区如下图所示：点按左右侧翻页、点按上下边缘呼出菜单，新手第一次启动时也会看到同样的引导说明。

这张图展示的是默认触屏分区：中间区域翻下一页、左侧翻上一页，上下边缘呼出菜单，角落是快捷操作区，可在设置中自定义。

二、技术文档阅读：Markdown 与 TXT 排版升级

如果你经常用阅读器看技术手册、项目 README 或自己记的笔记，这一节最相关。

Markdown 文件的显示逻辑被重新梳理，代码块、表格、列表的排版向出版物水准看齐，长文档里嵌套结构不再错位。
纯文本 TXT 文件现在默认使用与 FB2 相同的排版样式，打开未带样式的长篇小说时，段落缩进和分页会比过去规整。
新增"点按即跳转链接"的开关：阅读 EPUB 时点按正文中的超链接可以直接跳转，如果某个版本里点按反而误触发翻页，可以关掉这项功能。

这几项改动合在一起的效果是：把 Kindle 或 Kobo 里"只能看不能看明白"的技术文档，换成接近电脑浏览器里的阅读体验。

三、书库管理：文件浏览器学会按元数据排序

文件浏览器这次加上了按元数据排序的能力。以前书库里几百本书只能按文件名或修改时间排列，现在可以按书名、作者等元数据字段排序；同时新增了按阅读状态过滤，比如只看"在读"或"未读"的书。文件浏览器默认切换为扁平视图（不再显示文件夹层级），配合按字母跳转，翻找特定文件更快。

此外，"集合"（Collections）功能支持文件夹关联与排序：把同一系列的书放进一个集合后，浏览和排序都集中在一个地方。对书库超过两百本书的用户来说，这一节的改动是日常收益最大的部分。

四、字典与批注：路径规范化和跨设备同步

字典加载这次统一了资源路径：凡是带图片的字典，图片资源统一以包内的res文件夹作为标准起点解析。对普通用户意味着查词时配图更稳定、不容易出现"有词没图"的情况；如果你写过自定义字典脚本，升级时需要确认图片路径符合新的res约定。

批注方面有两处实用改进：

高亮、笔记等批注跨设备同步，在一台机器上做的标记，另一台跑 KOReader 的设备上打开同一本书即可看到。
PDF 里的高亮支持手动调整边界，选词不准时可以手动拖正，导出笔记时区域更干净。

五、插件瘦身：这 3 个插件被移除了

本次版本清理了一批长期未维护的插件，升级后如果习惯里用到它们，需要换成替代方案：

exporter（导出高亮）：移除了 memos 和 flamo 两个导出目标，这两个目标的功能转移到了社区维护的 contrib 仓库中，Joplin 等核心导出方式不受影响。
autofrontlight（自动调节前光）：整体移除，相关能力已并入系统自带的自动前光与 autowarmth 等插件。
backgroundrunner（后台任务运行器）：移除，依赖它的第三方插件需要改用新机制，短期内这类插件可能暂时不可用。

完整的插件列表可以在 plugins/ 目录下查看，每个插件目录里的_meta.lua都写明了功能说明。

六、设备支持：新增 KindleHF 构建目标

设备这一端的主要变化是新增KindleHF构建目标：它面向固件版本 5.16.3 及以上的 Kindles，用kodev脚本构建时选择 kindlehf 目标即可，老版本构建目标（kindle、kindlepw2 等）保持不变。

底层还有两项不太显眼但影响打开速度的改动：缓存数据改用 SQLite 存储（CacheSQLite），设置与缓存的序列化引入了 zstd 压缩。官方口径是大型文档的打开速度可提升约三成，实际感受就是几百章的长文档翻到陌生章节时，等待白屏的时间明显变短；同时压缩后的设置文件更小，写入存储更省。

七、升级检查清单

按你的使用习惯对号入座：

用自定义字典脚本的用户：检查脚本里图片引用的路径是否已改为以res文件夹为起点，改完重启 KOReader 再查一个带图词条验证。
依赖旧插件的用户：确认 exporter 的导出目标是否还在使用 memos/flamo；用到 backgroundrunner 的第三方插件暂时停用，等社区适配后再启用。
Kindle 用户：如果你的设备固件 ≥ 5.16.3，升级时直接选用 kindlehf 目标构建；老固件继续用原有目标。
书库较大（>200 本）的用户：升级后在文件浏览器里尝试元数据排序和状态过滤，把常用过滤条件设成默认。
普通用户：直接升级到 2025.04 即可，重点体验 Markdown/TXT 排版和批注同步，配置文件会自动迁移，无需手动处理。

需要源码编译的话，仓库地址为 https://gitcode.com/GitHub_Trending/ko/koreader ，构建说明见 doc/Building.md；只想看设备适配细节可参考 make/ 目录里各平台的构建文件。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考