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、PocketBook、Android 和 Linux 的开源电子书读者，能把扫描版 PDF 重排成字号随便调的文本。
📥 KOReader 安装三步走：从下载到打开第一本书
第一步，拿安装包：到项目发布页下载对应设备型号的包即可；开发者也可以克隆源码自己编译：
git clone https://gitcode.com/GitHub_Trending/ko/koreader第二步，按设备装好：
| 设备 | 装法 | 说明 |
|---|---|---|
| Kobo | 把安装文件复制到设备 U 盘存储目录，重启 | 路径最短，启动器直接出现 KOReader 入口 |
| Android | 直接装 APK | 各渠道都有，授权文件权限即可 |
| Kindle | 通过越狱扩展包安装 | 老机型有单独构建目标（make/kindle-legacy.mk） |
| PocketBook / reMarkable / Cervantes | 跑专属安装脚本 | platform/ 对应子目录内含启动脚本 |
各设备的详细步骤见仓库 README 中按设备分列的安装条目。
第三步，打开第一本书：启动后进入文件管理器，找到电子书所在文件夹，点开书就能读了。
📖 读起来：扫描版 PDF 重排、查词、高亮做笔记
先认识阅读器支持的两种页面类型：
| 页面类型 | 支持的格式 | 典型用途 |
|---|---|---|
| 固定页 | PDF、DjVu、CBT、CBZ | 扫描书、漫画、需保留版式的文档 |
| 重排 | EPUB、FB2、Mobi、DOC、RTF、HTML、CHM、TXT | 普通电子书，可自由换字体排版 |
扫描书：不用缩放，直接重排
多数设备的内置阅读器对扫描的 PDF、DjVu 只能缩放拖拽。KOReader 用内置的 K2pdfopt（把扫描页重排成文本的引擎）把页面"重排"成文本，字号、页边距随你调，眼睛不用再凑近屏幕。重度倾斜或版式复杂的扫描本重排准确率会下降，这类书建议切回固定页显示。
- 重排参数在
frontend/ui/data/koptoptions.lua，可按书选择是否重排 - 重排与固定页两种视图可随时切换，不影响同一本书
查词：长按单词，词典弹出
阅读中长按单词，弹出词典结果（StarDict 本地词典和 Wikipedia），顺手把句子高亮或加笔记。
- 可用词典在
frontend/ui/data/dictionaries.lua中维护 - 内置 Google Translate 是在线选项；不想走网络就只用本地词典
阅读状态带到新设备
高亮、书签、进度都写进书籍旁边的.sdr伴生目录。换设备时把书和.sdr一起拷过去，阅读状态原样恢复。
🗄️ 书库：Calibre 无线传书，OPDS 和 RSS 找新书
书全放在 Calibre（桌面电子书管理工具）里时，KOReader 可以直接搜书库元数据、无线接收电子书，还能把 Calibre 书库当 OPDS（一种把书像网页一样列出来的书柜协议）书柜浏览。
再加自己的 OPDS 目录和 RSS（定期更新内容的订阅源），离线也能把新内容拉下来。这些能力都在 plugins/ 目录里，各自是独立插件，不用就关掉。
- Calibre 插件：元数据搜索、无线传书、OPDS 浏览
- RSS 插件（新闻下载）：定时拉取订阅源，生成可离线翻读的文档
🎛️ 调优：五个最影响阅读体验的细节
- 靠手势翻页，少按键：墨水屏按键少，手势插件自带默认分区——点中间翻页、左侧上一页、四角留给菜单与快捷功能；还支持多段滑动组合，比如连划三下打开最近文档或切换 Wi-Fi。
- 默认映射在
plugins/gestures.koplugin/的defaults.lua，任意一条手势都能在设置里改绑或禁用
- 换字体、调行距：外部字体、行距、页边距、对齐方式都独立可调，内置多语言连字（断字）词典会让行尾自动断行，排版更整齐；字体选项集中在
frontend/ui/elements/font_settings.lua。 - 调高对比度：阅读视图提供多级对比度滑杆，阳光直射或屏幕泛黄时把对比度调高，黑度加深，不碰亮度也能提高可读性。
- 选刷新模式：墨水屏分全量刷新与局部刷新——局部快但有残影，全量干净但闪一下；正文长读以局部为主，隔几页手动触发一次全量。刷新选项见
frontend/ui/elements/refresh_menu_table.lua。 - 按需开插件：每个启用插件都增加加载时间和内存占用，默认配置已覆盖阅读主流程，自动翻页、亮度自适应、阅读统计这类按需用。设备越老，越值得关掉在线词典、云同步——README 实测部分老设备翻页延迟不到内置软件的一半。
🔧 排障：五个常见现象与处理办法
| 现象 | 原因 | 处理 |
|---|---|---|
| 启动崩溃或白屏 | 启动过程抛异常，细节在日志里 | 在"关于"页打开数据目录下的crash.log查看报错 |
| 高亮和进度丢了 | 只拷了书没拷.sdr伴生目录 | 复制书籍时连同.sdr目录一起拷 |
| 扫描书重排效果差 | OCR 质量低、版式复杂 | 切固定页显示，或调整 K2pdfopt 参数 |
| 屏幕残影明显 | 局部刷新累积 | 用手势或菜单触发一次全量刷新 |
| 云同步慢、凭据有顾虑 | 文件大、网络弱 | 降低同步频率；公共 Wi-Fi 下关闭自动同步 |
阅读数据（进度、高亮、笔记）全部存在本机.sdr目录，云同步走的是你自己的账号凭据，设备上没有内置的数据回传；把凭据留在可信网络环境里即可。
结论：什么时候值得装 KOReader
- 主力读物是重排电子书、手里还有扫描 PDF 或漫画，你用 Kobo/Kindle 或 Android，或者书全在 Calibre 里——值得装：格式更全、翻页更快、排版自由度更高，书库还能无线管理。
- 只用设备原生商店、书量不大、只读内置支持格式的 EPUB——内置阅读器够用，多一步安装和配置不值得。
- 想改阅读器 UI 或移植新硬件的开发者，doc/Development_guide.md 和按设备分列的构建目标是现成的起点。
社区参与入口，每行一条：
- 在项目 issue 跟踪器提交 bug 报告和功能建议
- 通过官方翻译平台把界面译成你的语言或校对已有译文
- 跑一遍 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），仅供参考
