KOReader 使用手册：三步换阅读器，扫描书也能重排-开发者社区

KOReader 使用手册：三步换阅读器，扫描书也能重排

【免费下载链接】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 是跑在 Kobo、Kindle、Android 和 Linux 上的开源免费电子书阅读器，能把扫描书重排成可调字号的文本。看完能装好它、打开第一本书，常用设置在哪也一次说清。

两分钟上手

KOReader 的安装路径按设备分三条，哪条都不超过三步。第一步拿安装包：从项目发布页下载对应设备型号的包，想自己编译就跑git clone https://gitcode.com/GitHub_Trending/ko/koreader拉下仓库（老款 Kindle 在make/kindle-legacy.mk有单独构建目标）。第二步装到设备上：Kobo 把安装文件复制到 U 盘存储目录后重启，启动器上直接出现 KOReader 入口；Android 直接装 APK 并授予文件访问权限；PocketBook、reMarkable、Cervantes 按platform/下对应子目录的专属脚本走。第三步打开第一本书：启动后进入文件管理器，找到电子书所在文件夹点开即可，阅读进度、高亮、笔记都会写进书籍旁边的.sdr伴生目录。

功能地图：按场景走一遍

扫描书不缩放也能读

扫描版 PDF 在内置阅读器里只有缩放和拖拽两个动作。KOReader 用内置的 K2pdfopt 引擎把扫描页"重排"成可重排文本，字号、页边距、行距随你调，重排与固定页两种视图可随时切换，互不影响同一本书。重度倾斜或版式复杂的扫描本重排准确率会下降，这类书切回固定页显示更稳。重排参数集中在frontend/ui/data/koptoptions.lua，同一本书可以单独开关重排。

版面理顺之后，读到生词的下一个动作就是查词典。

查词、高亮、做笔记一条龙

长按单词会弹出词典结果，StarDict 本地词典和 Wikipedia 任选，不想走网络就只用本地词典；内置的 Google Translate 是在线选项。高亮、书签、进度都写进书旁的.sdr伴生目录，换设备时把书和.sdr一起拷过去，阅读状态原样恢复。可用词典在frontend/ui/data/dictionaries.lua中维护。

内容读得进去之后，接下来会想折腾的就是排版本身。

换字体、调行距，排版自己说了算

外部字体、行距、页边距、对齐方式各自独立可调，应用还内置多语言连字（断字）词典，行尾自动断行，排版更整齐。字体相关选项集中在frontend/ui/elements/font_settings.lua。

单本书的排版满意了，书库大的人马上会遇到下一个头疼点：书的管理。

用 Calibre 管书库，用 OPDS 找新书

书全放在 Calibre 里时，KOReader 可以直接搜 Calibre 元数据、无线接收电子书、把 Calibre 书库当 OPDS 书柜浏览；再加自己的 OPDS 目录和 RSS 源，离线也能把新内容拉下来。Calibre 集成、OPDS 浏览、新闻下载各有独立插件，不用就关掉，入口都在 plugins/。

管理搞定，剩下的就是阅读里最高频的动作——翻页。

少按键，靠手势翻页

墨水屏设备按键少，KOReader 默认把触摸面切成分区：中间区域下一页、左侧上一页、上下边缘出菜单、四角留给快捷功能，还支持多段滑动组合，比如连划三下打开最近文档。

默认映射在plugins/gestures.koplugin/defaults.lua，任意一条手势都能在设置里改绑或禁用。

一张表看懂支持范围

格式与设备的覆盖范围，一张表装完：

能力 / 平台	覆盖范围	说明
固定页显示	PDF、DjVu、CBT、CBZ	扫描书、漫画保留原版式
文本重排	EPUB、FB2、Mobi、DOC、RTF、HTML、CHM、TXT	字号、行距、页边距独立可调
扫描书重排	扫描版 PDF、DjVu	内置 K2pdfopt，可按书开关
Kobo	复制安装文件到 U 盘存储、重启	启动器直接出现入口
Kindle	越狱扩展包安装	老机型有单独构建目标
Android / Linux	装 APK；Linux、macOS 可跑模拟器	开发者可本地编译调试
PocketBook / reMarkable / Cervantes	专属安装脚本	脚本在`platform/`对应子目录

调优与避坑

调高文本对比度，别动亮度。屏幕泛黄或阳光直射时，黑度加深比拉高背光更可读，也不产生残影。
局部刷新为主，隔几页手动触发一次全量刷新。局部刷新快但有残影，全量刷新干净但闪一下，长读交替使用最舒服，刷新选项见frontend/ui/elements/refresh_menu_table.lua。
不用的插件关掉。每个启用插件都增加加载时间和内存占用，默认配置已覆盖阅读主流程。
复制书籍时把.sdr目录一起拷。高亮和进度都存在伴生目录里，只拷书会全部丢失。
老设备优先关云同步、在线词典这类在线集成。设备越老，把资源留给翻页越值。
启动崩溃或白屏，先查数据目录下的crash.log。启动过程抛的异常都记录在日志里，没有它很难定位原因。

如果只改一个设置，改它：把文本对比度调高两档，屏幕泛黄或阳光直射时立刻看得更清。