KOReader 新手向指南：三步装好电纸书阅读器，把扫描 PDF 变成大字
【免费下载链接】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 是一款为电纸书屏幕优化的开源电纸书阅读器，支持 PDF、DjVu、EPUB 等多种格式，能跑在 Kindle、Kobo、PocketBook、reMarkable 等电纸书设备上。它适合两类人：想把手头的电纸书折腾出更多玩法的读者，和被扫描版 PDF 小字号折磨到读不下去的人。
下载哪个包：先核对型号与固件
下载之前，先花一分钟做适配确认。依据在 frontend/device/ 目录：每个子目录就是一个受支持的平台，包括 android、kindle、kobo、pocketbook、remarkable，你的型号能在对应子目录里找到适配代码，基本就稳了。make/ 目录下的编译目标文件（kindle.mk、kobov4.mk、pocketbook.mk 等）也能帮你确认官方为哪些具体机型做过构建。
Kindle 用户还要核对两点：旧固件与新固件对应不同的构建目标，下载发行包时别拿错；带物理键盘的旧款机型，默认按键行为见 frontend/device/kindle/event_map_keyboard.lua。
提醒一句：包拿错不只是白装。比如给 v4 代 Kobo 放上 v5 的包，KOReader 启动就会闪退，只能回头重新下载。
三步装到设备上：拿包、拷贝、启动
安装流程各平台是统一的，不用逐台记忆：
- 拿包：下载对应平台的发行包，或克隆源码仓库（地址：https://gitcode.com/GitHub_Trending/ko/koreader）自行构建。
- 把该平台的启动文件复制到设备约定目录：Kobo 一般放 /mnt/us，Kindle 放 /usr 或设备根目录，以你下载包的说明为准。
- 在设备上运行入口脚本启动 KOReader；Kobo 用户通常会在系统桌面多出一个 KOReader 启动项。
下表列出各平台的入口文件与放置位置，下单核对和启动失败排查都靠它：
| 平台 | 入口文件 | 所在位置 |
|---|---|---|
| Kindle（含 PW、Oasis） | koreader.sh | platform/kindle/ |
| Kobo（区分 v4/v5 代） | koreader.sh | platform/kobo/ |
| PocketBook | koreader.app | platform/pocketbook/ |
| reMarkable | koreader.sh + systemd 服务 | platform/remarkable/ |
| Android | 直接安装 APK | platform/android/ |
| Linux / 桌面 | 桌面包或本机模拟器 | platform/linux/ |
成功判据很简单：屏幕出现 KOReader 界面而不是回到系统菜单，就说明跑起来了。Android 直接装 APK，Linux 用发行包里的桌面版，开发者还可以按 doc/Building.md 搭一个本机模拟器。
首次进入界面，KOReader 会生成一份内置快速入门（由 frontend/ui/quickstart.lua 驱动），触摸区、快捷键、手势都有说明，照着点即可。默认触摸布局：点屏幕中央下一页，点最左侧竖条上一页，最上边弹出顶部菜单，最下边是状态栏与底部菜单，四个角还有独立的角落点按区。
这个布局对电纸书很友好：不用找按钮，手指落在哪、动作就在哪。带键盘的设备还有一套按键快捷项，翻页、跳目录都能按自己的习惯改。
扫描 PDF 字小？打开 PDF 重排就能解决
扫描文档的 PDF 字小，得把设备怼到脸上才看得清，大概是电纸书用户最头疼的一档事。
KOReader 内置 K2pdfopt 引擎，重排链路分三步：识别文档版式 → 提取文字 → 按你选的字号重新排版成流动文本。打开重排后，原本一页只能看几行的扫描件，会变成字号可调、行距可调的普通书本文本，还能顺手加上连字符断行，阅读体验接近原生 EPUB。
配套选项值得一起用：页边距任意设置，行距可以覆盖文档原值，字体可以换成你拷进设备的任意字体文件（字体加载由 frontend/ui/font.lua 负责，排版项由 frontend/apps/reader/modules/readertypography.lua 负责）。双栏、条漫这类固定版式 PDF 有专门的阅读方向选项，按双页或条漫方式翻页，不用硬掰。
在一些较旧机型上，KOReader 的翻页响应明显快于内置阅读软件，所以“装第三方阅读器会不会卡”的顾虑基本可以放下。
把电纸书变成工具箱：高频插件一览表
KOReader 的扩展全部是 Lua 插件，放在 plugins/ 目录，每个插件一个文件夹：_meta.lua声明名称和描述，main.lua是入口，放进去即自动加载。开箱自带三十来个，高频的有这几个：
| 插件 | 用途 | 目录 |
|---|---|---|
| cloudstorage | 挂载 Dropbox、WebDAV、FTP 云盘 | plugins/cloudstorage.koplugin/ |
| newsdownloader | 订阅并下载 RSS 源 | plugins/newsdownloader.koplugin/ |
| calibre | 无线收书、OPDS 浏览 Calibre 书库 | plugins/calibre.koplugin/ |
| opds | 浏览任意 OPDS 在线目录 | plugins/opds.koplugin/ |
| vocabbuilder | 阅读时自动收集生词 | plugins/vocabbuilder.koplugin/ |
| systemstat | 查看电池、内存等系统状态 | plugins/systemstat.koplugin/ |
想自己写一个，拿 plugins/hello.koplugin/ 当模板最省事：它是官方留的调试小插件，总共几十行——建好含_meta.lua和main.lua的文件夹，在addToMainMenu里注册一个菜单项，点击后弹一个 InfoMessage，整个流程就通了。加载器逻辑在 frontend/pluginloader.lua。
设置存哪三层：字号、进度、手势修改入口
改完设置想确认它落到了哪，记住这三层：
- 设备级：frontend/luasettings.lua 存全局设置，字号、语言、翻页方式都在这层。
- 文档级：frontend/docsettings.lua 记住“这本”书的字体、进度、高亮，换本书自动切回。
- 路径层：datastorage.lua 负责定位设备上的数据目录，插件数据库、缓存都挂在它下面。
触摸手势想改，从 frontend/device/gesturedetector.lua 入手；有键盘的设备在设备层按键映射里调整。想查某个行为怎么实现，看 spec/unit/ 里对应的*_spec.lua单元测试，测试名基本就是功能名，测试就是最好的活文档。
常见问题速查：四个常见现象的处理办法
- 启动即闪退、回到系统菜单— 原因：拿错了代际的包 — 处理：对照上表重新下载对应平台版本。
- 设备里找不到 KOReader / 无法启动— 原因：文件拷错目录 — 处理：核对入口文件是否放在约定目录，如 Kobo 的 /mnt/us。
- 物理键盘按键无响应或动作不对— 原因：默认映射与你的键盘不匹配 — 处理：到设备层按键映射文件里核对。
- 重排没生效— 原因：文档是固定版式，而非带文字层的扫描件 — 处理：确认文档类型，双栏、条漫文档选择对应翻页方向。
装完之后，先拿一本字最小的扫描版 PDF 开一次重排，对比前后体验——这是 KOReader 相对内置阅读器最立竿见影的一步；再从插件表里挑两个把云盘和资讯源接进来。后面若好奇某个功能的实现，打开 spec/unit/ 的单元测试读一遍，改源码、提补丁的路径就清晰了。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
