KOReader（Kobo）配置备忘

整理自站内相关记录（如 Kobo KOReader 重装、字典、Calibre 与 USB），方便以后重装或换机时一页看完。设备以 Kobo + KOReader 为主；其他机型安装路径见 官方 Wiki。

updated on 2026-03-18

重装前备份

• 备份 字典、笔记/标注 等个人数据，再执行恢复出厂或覆盖安装。
• Kobo 官方重置说明可参考：Manual reset Kobo Clara Colour & Kobo Clara BW。

安装与更新

• 官方文档：Installation on Kobo devices
• 社区常用入口：
  • One click install package（MobileRead）
  • Install script（MobileRead）
• 装好后可用 OTA 跟到当前稳定版（升级前同样建议备份）。

Calibre 与 USB 传输（易踩坑）

• 必须在 Kobo 原生首页进入 USB 传输模式，不要在 KOReader 里开 USB。否则 Calibre 可能认不出刚传的书——因为设备侧的 KoboReader.sqlite（例如 macOS 上常见为 /Volumes/KOBOeReader/.kobo/KoboReader.sqlite）需要在 Kobo 系统界面 连接时才会按预期更新；在 KOReader 下连接则不会完整更新这份库信息。
• 隐藏目录在 Finder 里可用 ⌘ + ⇧ + . 切换显示。

字典

• 词典来源示例：reader.dict（基于 Wiktionary；单语免费，双语为一次性付费）、以及社区分享的词典包（如 Reddit 讨论中的 Oxford 等，自行甄别版权与来源）。
• 安装路径（Kobo）：在 /Volumes/… 下进入 .adds/ 中 KOReader 的数据目录，将词典文件放入 data/dict/（具体层级以你设备上实际路径为准，可用终端 find 辅助定位）。
• 官方说明：Dictionary support

字体与图书元数据

• KOReader 内字体：将字体文件放入 KOReader 的 fonts 目录（与安装方式一致，通常在 .adds/koreader/ 下对应位置）。
• 更多桌面端字体列表见本站 toolbox · 字体。
• ProjectTitle：按项目/系列显示标题等（按需启用）。
• Calibre 侧（与书库质量相关，间接影响推到阅读器上的体验）：
  • Calibre 推荐配置与插件 - 雅余
  • Cirn09/calibre-do-not-translate-my-path
  • fugary/calibre-douban

用户补丁（User patches）

官方说明：User patches（koreader/patches/ 目录，文件名与优先级规则见文档）。

个人在用/曾用组合（可按发行版与兼容性自行增减）：

1. SeriousHornet/KOReader.patches：除以下两个外可按需全装：
   • 不装：2--rounded-corners.lua
   • 不装：2--disable-all-CB-widgets.lua
2. medinauta/Koreader-Patches：其中 2 个 user patch（按仓库说明选择）。
3. omer-faruq/koreader-user-patches：Book receipt shortcut and lockscreen（锁屏/收据风封面，阅读动力向）。
4. quanganhdo/koreader-user-patches：reading statistics 相关 user patch。

灵感参考：r/koreader 展示帖。

提示：大版本升级后若出现奇怪黑屏或退出卡顿，优先排查是否手滑覆盖错文件；必要时干净重装 + 按上表逐步恢复补丁。

路径速查（macOS 挂载 Kobo 时）

延伸阅读

• KOReader Releases