KOReader 上手指南：5 个高频场景，从“打不开“到“离不开“-平芜编程栈

KOReader 上手指南：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

三百页的扫描版 PDF 在电纸书上卡住：字小、一页只显示半张，放大又要左右横着挪——这是很多电子书阅读器的日常。KOReader 是一款免费开源的电子书阅读器，支持 PDF、EPUB、DjVu、FB2 等二十多种格式，能跑在 Kindle、Kobo 等电纸书和安卓手机上。本文只讲用法：怎么装、设置在哪、怎么调顺手，不碰任何代码。

值不值得装：和自带阅读器共存，随时能退

犹豫的人通常先问两件事：会不会弄坏设备？支持哪些东西？

先说设备，官方文档里各平台的安装位置都能查到，大白话汇总如下：

平台	安装方式	备注
安卓手机 / 平板	直接安装 APK	和普通 App 无异，最省事
Kindle（含老款机型）	USB 拷贝安装	通过 KUAL 或启动器类工具进入
Kobo / PocketBook / Cervantes	解压后拷贝到存储分区	出现在系统应用列表中
Sony 电纸书（PRS-TX）	运行随附脚本	脚本在`platform/sony-prstux/`
reMarkable	运行专用安装脚本	脚本在`platform/remarkable/`
Linux / macOS 桌面	解压后运行启动脚本	可先用模拟器预览再决定

格式方面，固定版式的 PDF、DjVu、CBT、CBZ 和流式重排类的 EPUB、FB2、Mobi、DOC、RTF、HTML、CHM、TXT 全都在支持列表里；扫描版 PDF/DjVu 还能用内置的 K2pdfopt 重新排版，部分 ZIP 压缩包也能直接读。

再说"会不会搞坏设备"：KOReader 是独立应用，不碰系统固件，自带的阅读器原封不动，想看原版随时切回去；不满意时把koreader文件夹删掉就恢复原样。它是"加装"不是"替换"，进退都不心疼。

小提示：首次启动后，设置里的"快速上手"（素材在resources/quickstart/目录下）会用图文讲清默认设置和触控分区，花两分钟看完不容易迷路。

第一次跑通：不碰固件的安装步骤

各平台差异不大，照抄即可：

安卓：从官方发布页下载 APK 安装，和普通 App 一样。
Kindle / Kobo：电脑上解压，把koreader文件夹整体拷到设备存储根目录，再用启动器进入。
PocketBook / Cervantes：同样是解压后拷贝，然后去系统应用列表里找它。
reMarkable / Sony 电纸书：按platform/对应目录里的脚本执行安装。
桌面（Linux / macOS）：解压后运行启动脚本，模拟器可以先体验一把。

装好之后不用再手动追新版本：KOReader 支持在线升级，设置里点一下检查更新即可。想回退就更简单——删掉对应文件夹，设备回到装它之前的样子。

日常会碰到的 5 个高频场景

扫描版 PDF 糊成一片

扫描书的文字其实是图片，普通阅读器只能整页缩放，放大看一行、缩小找一行。KOReader 内置的 K2pdfopt 能把扫描页重新切分、按屏幕宽度重排成正常段落，配合自动裁边，小屏也能整段阅读；页边距、行距、字号都能单独调，还自带多语言断词词典，英文不再"断得难看"。字体、裁边这些细节分别在frontend/apps/reader/modules/readerfont.lua、readercropping.lua对应的设置里。

三百页的扫描书，从今往后是"读"出来的，不是"挪"出来的。

查个生词总得跳出页面

遇到不认识的手，人下意识就要退出阅读器去搜，回来已经忘了上下文。KOReader 的做法是长按选中单词，释义窗口直接弹在当前页，看完关掉接着读。词典支持 StarDict 格式的词库，也能直接查维基百科，小语种文本还有在线翻译兜底。

释义不离开当页，上下文不断档，这是阅读节奏最值钱的体验。

翻页触控总记不住按哪

墨水屏上"按哪翻页、按哪出菜单"靠死记很费劲。KOReader 默认把屏幕分好区：顶部出菜单，底部出快捷栏，左右翻页，四个角落是预留快捷点，最底部状态栏显示页码、时间和进度。对照下面这张图摸一遍就记住了：

如果默认分区不合手，手势插件plugins/gestures.koplugin/可以把轻点、滑动、双指都绑成自己的动作；嫌状态栏信息冗余，frontend/apps/reader/modules/readerfooter.lua对应的设置能把显示项改成你真正关心的那几个。

屏幕怎么按，你说了算，分区和手势都能重排。

书一多就找不到想读的那本

设备里攒了几十本书之后，翻列表找书名是最浪费时间的动作。KOReader 的文件管理器frontend/apps/filemanager/打开就是设备目录树，每本书标注大小和阅读进度；最近读过的永远排在最前面，捡回"看到一半"的书只要一步。装上封面浏览插件plugins/coverbrowser.koplugin/后，列表还能切换成封面网格，靠"看脸"找书；再配一个bookshortcuts插件，可以把常读的书绑到一个手势上。

几十本书的设备，找书靠看封面，不靠记文件名。

换设备进度就没了？

阅读数据是本地优先的：进度、设置、笔记都存设备上的配置文件里，日常完全离线。需要跨设备时，plugins/kosync.koplugin/能把进度同步到服务器，多台设备接力阅读不丢位置；电脑上用 Calibre 管理书库的，同名插件支持通过 Wi-Fi 直接推书；plugins/cloudstorage.koplugin/还能接入 Dropbox、FTP、WebDAV 等网盘渠道。

换设备不丢位置，笔记跟着走，"搬家"只是多一步同步。

调成自己的样子：10 个最常用的插件

KOReader 的扩展都放在plugins/目录下，装好即用。挑几个日常真正用得到的：

插件	干什么的
Reading statistics（`statistics.koplugin`）	记录阅读时长和进度，看清自己实际读了多少
Vocabulary builder（`vocabbuilder.koplugin`）	收集查词记录，按间隔重复算法安排生词复习
Progress sync（`kosync.koplugin`）	多台设备间同步阅读进度
News downloader（`newsdownloader.koplugin`）	把 RSS/Atom 订阅存成本地 HTML 阅读
OPDS（`opds.koplugin`）	从在线书目目录直接下载书籍
Terminal emulator（`terminal.koplugin`）	内置终端，留给想折腾的进阶用户
Auto Standby（`autostandby.koplugin`）	闲置自动休眠，省电
Profiles（`profiles.koplugin`）	把一组设置打包成可切换的"场景"，比如白天/夜间
Cover browser（`coverbrowser.koplugin`）	文件列表切换成封面网格展示
Automatic dimmer（`autodim.koplugin`）	亮着屏幕不动时自动调暗前灯

提醒：插件不必贪多。先装阅读统计和生词本这两个"刚需"，其余按需加，菜单清爽比功能齐全重要。

卡住了怎么办：常见问题速查

症状	做法
长按选中没反应	确认是"长按"不是"滑动"，且按在正文区域
词典查不到结果	检查词库文件路径是否配置正确
翻页总误触	到触控分区设置里缩小翻页区域、挪开易碰区
阅读耗电明显偏快	启用 Auto Standby 插件，设一个合理的闲置休眠时间
设置改乱了想恢复	在设置里重置阅读器配置，或直接还原备份
装完在系统里找不到入口	确认`koreader`文件夹拷到了存储根目录