KOReader 电子墨水屏阅读器：扫描 PDF 重排、Calibre 书库、手势翻页一次搞定-开发者社区

KOReader 电子墨水屏阅读器：扫描 PDF 重排、Calibre 书库、手势翻页一次搞定

【免费下载链接】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

扫描版 PDF 在电子墨水屏内置阅读器里字比芝麻还小、只能缩放拖拽？KOReader 安装后能把这类书重排成字号随便调的文本，Kobo、Kindle、Android 都能装，EPUB、FB2、漫画等格式也通吃。本文按设备给装法，再讲清开书流程与日常用法。

各设备安装 KOReader 的方式一览

设备/平台	安装方式	注意点
Kobo	把安装文件复制到设备 U 盘存储根目录	装完必须整机重启，启动器上才会出现入口
Android	直接安装 APK	装后授予文件访问权限即可用
Kindle	越狱后安装扩展包	老机型有单独构建目标 make/kindle-legacy.mk
PocketBook / reMarkable / Cervantes	使用专属安装脚本	脚本随设备放在 platform/ 对应子目录里
Linux / macOS（开发者）	克隆仓库自行编译	各设备构建目标见 make/ 目录

通用步骤：

从发布页下载与设备型号对应的安装包（也可以克隆仓库源码自己构建）：

git clone https://gitcode.com/GitHub_Trending/ko/koreader

Kobo 用户把文件放进 U 盘存储目录后重启；Android 用户装完 APK 直接授权文件权限。
不装插件也能跑，需要哪些能力再去 plugins/ 里按需开启。
启动器入口出现 KOReader 图标后，点开即进入文件管理器。

从启动到翻开第一本书

首次启动 KOReader 后直接进入文件管理器，无需任何初始化配置。
在文件列表里找到电子书所在文件夹，点书名即可打开；EPUB、PDF、DjVu 等格式自动识别。
阅读进度、高亮、书签、笔记都写在书籍旁边的<书名>.sdr伴生目录里（"sdr"是 sidecar 伴生文件的意思）。
换设备或迁移书库时，把书籍文件和.sdr目录一起拷贝，到新机器上进度、高亮、笔记原样恢复，不用重新找位置。

装完马上能用的四件事

扫描 PDF 重排：固定页也能调字号

重排 = 把扫描页的版面重新排成可调字号的文本，靠内置的 K2pdfopt 引擎完成，字号、页边距都能改。
每本书都可以单独选是否重排，两种视图随时切换，互不影响。
严重倾斜或版式特别复杂的扫描件，重排准确率会下降，这类书建议切回固定页显示。
重排参数集中在 frontend/ui/data/koptoptions.lua。

查词高亮做笔记：阅读不离开当前页

长按单词弹出词典结果，支持 StarDict 本地词典和 Wikipedia。
顺手把句子高亮、加书签、写笔记，数据同样落进.sdr伴生目录。
可用词典列表维护在 frontend/ui/data/dictionaries.lua；不想走网络就只用本地词典。

Calibre 与 OPDS 书库：书不用插线传

直接搜索 Calibre 书库元数据、无线接收电子书。
把整个 Calibre 书库当 OPDS 书柜浏览；OPDS 书柜是"通过标准协议远程浏览书源目录"的意思。
还可以加自己的 OPDS 目录和 RSS 订阅源，离线时把新内容拉下来翻；对应能力都在 plugins/ 里独立成插件，不用就关。

手势翻页：少碰按键多读书

屏幕分区使用：中间点按翻下一页，左侧区域翻上一页，顶部上下方留给菜单，四角留给快捷功能。
支持多段滑动组合，比如连划三下打开最近文档、开关 Wi-Fi。
任意一条手势都能在设置里改绑或禁用，默认映射在 plugins/gestures.koplugin/defaults.lua。

五个影响阅读体验的设置细节

对比度滑杆：黑度加深、不碰亮度就提升可读性，阳光直射或屏幕泛黄时调高最有用，参数定义在 frontend/ui/data/koptoptions.lua。
字体、行距与页边距：字号、行距、对齐方式、外部字体各自独立可调，内置多语言断字词典让行尾自动断行，选项集中在 frontend/ui/elements/font_settings.lua。
刷新模式：局部刷新快但留残影，全量刷新干净但闪一下；长文建议局部为主、隔几页手动触发一次全量，选项见 frontend/ui/elements/refresh_menu_table.lua。
插件开关：每个启用的插件都会增加加载时间和内存占用；自动翻页、亮度自适应、阅读统计这类功能按需用，不用的关掉。
老设备在线功能：关掉在线词典与云同步，把资源留给翻页，旧机器上翻页延迟可能比内置阅读器更低。

装完 KOReader 后常见问题怎么排查

问题	原因	解决办法
启动崩溃或白屏	启动过程抛出异常，细节记录在日志里	在"关于"页打开数据目录下的`crash.log`查看具体报错
高亮和阅读进度消失	迁移时只拷了书、漏了`.sdr`伴生目录	复制书籍时把同名`.sdr`目录一起带走
扫描书重排后版式乱	原件 OCR 质量低或版式太复杂	切回固定页显示，或调 K2pdfopt 重排参数
屏幕残影明显	局部刷新逐次累积	通过手势或菜单触发一次全量刷新
云同步很慢、凭据有顾虑	文件体积大、网络弱	降低同步频率；公共 Wi-Fi 下先关自动同步