重腐蚀环境紧固件选型与耐蚀材料对比分析
2026/9/12 5:12:46
电子墨水屏阅读器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
刚把一册扫描版菜谱 PDF 拷进 Kobo，点开后满屏是模糊的图，只能不停放大缩小、上下拖动找菜名，盯得眼睛发酸。KOReader 是一款免费的开源电子墨水屏阅读器，运行在 Kobo、Kindle、PocketBook、Cervantes、Android 和 Linux 上，能把 PDF、DjVu、EPUB、FB2 等格式读起来：扫描版 PDF 还能用内置的 K2pdfopt 引擎重排成可随意调字号的文本。下面按新手最关心的几个问题，讲清楚它怎么装、能干什么、数据放哪、老设备行不行。
一、装起来麻烦吗？
1. 拿到对应设备的安装包
- 普通用户：到项目发布页下载与你设备型号对应的安装包，不需要懂代码。
- 想自己编译的开发者：克隆仓库
git clone https://gitcode.com/GitHub_Trending/ko/koreader，再按 doc/Building.md 准备工具链，make/目录下为 Kobo、Kindle、PocketBook 等每个目标备了独立构建文件（如make/kobo.mk、make/kindle-legacy.mk）。
2. Kobo 用户的最短安装路径
- 把安装文件复制到 Kobo 的存储目录，重启设备。
- 重启后官方启动器会自动识别，屏幕上多出一个 KOReader 入口，点进去就是文件管理器，找到书的文件夹打开即可。
- 这一步没有账号、没有注册，整个过程两分钟内完成。
3. 其他设备与模拟器的启动方式
- Android：直接安装 APK，授予文件访问权限就能用。
- Kindle：通过越狱扩展包安装；老机型对应单独的构建目标 make/kindle-legacy.mk。
- PocketBook、reMarkable、Cervantes：platform/ 下按设备分了子目录，各备了专属的启动与安装脚本（如 platform/kobo/koreader.sh）。
二、和原生阅读器比，它强在哪？
1. 扫描版 PDF 重排：字号边距随手调
- 内置 K2pdfopt 引擎把扫描页"拆"成可重排文本，字号、页边距、行距随你调，不用再凑近屏幕。
- 重排参数集中在 frontend/ui/data/koptoptions.lua，每本书都可以单独选要不要重排。
- 重排视图与固定页视图可随时来回切，同一本书互不影响。
2. 长按查词，顺手高亮加笔记
- 阅读中长按一个单词，弹出词典结果：StarDict 本地词典和 Wikipedia 都支持，不查网络也能离线查。
- 同一弹窗里可以直接把句子高亮、加书签或写笔记，不用退出阅读视图。
- 可用词典列表维护在 frontend/ui/data/dictionaries.lua；Google Translate 是在线选项，不想走网络就只用本地词典。
3. 排版自由度：对比度、字体、行距独立可调
- 阅读视图提供多级文字对比度滑杆，阳光直射或屏幕泛黄时加深黑度，不用动亮度。
- 外部字体、行距、页边距、对齐方式各自独立设置，字体相关选项集中在 frontend/ui/elements/font_settings.lua。
- 应用自带多语言连字（断字）词典，长单词行尾自动断行，排版更整齐。
三、阅读进度和数据存在哪里？
1. 数据跟着书走：.sdr 伴生目录
- 进度、高亮、书签、笔记统称为书籍元数据，存在该书文件旁边的
.sdr伴生目录里（.sdr即 sidecar 之意），存放逻辑见 frontend/docsettings.lua。 - 换设备时把书和
.sdr目录一起拷过去，阅读状态原样恢复，只拷书会丢状态。 - 应用级设置与插件状态单独存放在
luadata目录，与书的元数据分开管理。
2. 书库数据也能在线联动
- Calibre 集成支持搜元数据、无线接收电子书、把 Calibre 书库当 OPDS 书柜浏览。
- 自己的 OPDS 目录、RSS 源可以加进阅读器，离线时照样把新内容拉下来。
- 这些能力都做成独立插件放在 plugins/ 目录，Calibre、OPDS、新闻下载各有其一，不用就关掉。
四、老设备跑得动吗？怎么更省
1. 天生为墨水屏优化的界面
- 界面去掉动画、菜单分页显示，专为 e-ink 的低刷新率设计。
- README 实测：部分老设备上翻页延迟不到内置阅读软件的一半，设备越老差距越明显。
2. 按需开插件，给翻页留资源
- 每个启用的插件都增加加载时间和内存占用，自动翻页、亮度自适应、阅读统计这类建议按需用，不用的关掉。
- 设备越老，越值得关闭在线词典和云同步，把资源留给翻页动作本身。
3. 刷新模式按场景选
- 墨水屏分全量刷新（干净但闪一下）与局部刷新（快但有残影），刷新选项见 frontend/ui/elements/refresh_menu_table.lua。
- 正文长读可以局部刷新为主，隔几页或出现残影时触发一次全量。
- 手势也能触发全量刷新：默认长按右上角即执行，映射文件见 plugins/gestures.koplugin/defaults.lua，每条手势都能在设置里改绑或禁用。
五、哪些情况不必换？这些局限要认
- 扫描本重排不是万能的：重度倾斜、版式复杂的扫描件重排准确率会下降，这类书切回固定页显示，或调整 K2pdfopt 参数。
- 只用设备原生商店、书量不大、只读内置支持的 EPUB——内置阅读器够用，多一步安装和配置不值得。
- 漫画、需严格保留版式的文档，固定页显示（PDF、DjVu、CBT、CBZ）本来就是更合适的姿势，不要强上重排。
任务速查表
| 想做的事 | 操作入口 | 对应文件/目录 |
|---|---|---|
| 扫描 PDF 重排、调字号 | 打开书后切换重排视图，设字号边距 | frontend/ui/data/koptoptions.lua |
| 查词、高亮、写笔记 | 阅读中长按单词 | frontend/ui/data/dictionaries.lua |
| 改字体、行距、对比度 | 阅读菜单里的排版与外观项 | frontend/ui/elements/font_settings.lua |
| 管书库、无线传书 | Calibre 插件 | plugins/calibre.koplugin/ |
| OPDS 书柜、RSS 拉书 | 对应插件 | plugins/opds.koplugin/、plugins/newsdownloader.koplugin/ |
| 改手势、改刷新习惯 | 手势插件 | plugins/gestures.koplugin/defaults.lua |
出了问题先查这里
| 现象 | 常见原因 | 排查动作 |
|---|---|---|
| 启动崩溃或白屏 | 启动过程抛异常 | 打开数据目录里的crash.log看具体报错 |
| 高亮、进度消失 | 拷书时漏了伴生目录 | 把.sdr目录连同书一起重新拷贝 |
| 重排出来的文字乱 | OCR 质量低、版式复杂 | 切固定页显示，或调 K2pdfopt 参数 |
| 屏幕残影越读越重 | 局部刷新累积 | 长按右上角或菜单触发一次全量刷新 |
| 老机器变卡 | 插件、在线功能占资源 | 关闭不用的插件与在线词典、云同步 |
阅读数据全部在本机.sdr与luadata里，云同步走的是你自己的账号凭据，设备上没有内置的数据回传。
想参与？一条一个入口
- 在项目 issue 跟踪器提交 bug 报告和功能建议
- 通过官方翻译平台把界面译成你的语言，或校对已有译文
- 跑一遍 spec/unit/ 下的单元测试验证你的改动，再动手贡献代码
- 在 doc/Development_guide.md 和按设备分列的构建目标上搭好开发环境
【免费下载链接】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），仅供参考