koreader 中文文档 下载 App

插件系统 —— 功能按需启用，不捆绑不臃肿

为什么 KOReader 用插件架构

KOReader 内置了很多功能，但不是所有用户都需要全部——有人只读书不查词典，有人只看漫画不用 calibre。插件系统让 KOReader 做到：

什么是插件

KOReader 插件（又称 KOReader Plugin 或 koplugin）是独立的 Lua 脚本包，为 KOReader 增加特定功能。

每个插件：

内置插件一览（部分）

插件功能推荐度
calibre 连接无线收书、OPDS 浏览 calibre 书库⭐⭐⭐⭐⭐
Kosync 进度同步多设备阅读进度同步⭐⭐⭐⭐⭐
Wallabag稍后阅读文章拉取⭐⭐⭐⭐
StarDict 词典离线词典（需词典文件）⭐⭐⭐⭐
阅读统计进度、时长、日历视图⭐⭐⭐⭐
K2pdfoptPDF 重排引擎⭐⭐⭐⭐
OCR 识别扫描书文字提取⭐⭐⭐
SSH 服务器SFTP 传书⭐⭐⭐
终端模拟器在 KOReader 里跑 shell⭐⭐
RSS 新闻下载 RSS 文章离线阅读⭐⭐⭐
AI 助手讨论与 AI 讨论书中内容⭐⭐

启用/禁用插件

  1. 进入「设置 → 插件」
  2. 浏览插件列表
  3. 点击插件 → 启用/禁用
  4. 某些插件需要重启 KOReader 才能生效

插件设置

每个启用的插件在主菜单中会出现对应入口。进入设置 → 插件 → 点击某插件 → 可以配置该插件的参数。

例如 Kosync 插件：需要填服务器地址、用户名、密码。

插件可以自动更新吗

是的。KOReader OTA 更新时会一并更新所有插件。如果插件有单独的更新机制，也可以在插件设置中手动检查。

第三方插件（社区插件）

除了 KOReader 主仓库的内置插件，社区还维护了一批第三方插件：

安装第三方插件：

  1. 下载插件目录（包含 plugin.lua 等文件）
  2. 放到 KOReader 配置目录下的 plugins/ 子目录
  3. 重启 KOReader 后在插件列表中看到新插件

常见问题

禁用插件会丢数据吗？

不会。禁用只是不加载插件，插件相关的配置和数据（如 Kosync 同步的进度）不会被删除。再次启用即可恢复。

插件太多会让 KOReader 变慢？

会，但影响不大。每个插件只在你调用时才加载——不调用就是一段代码躺在磁盘上。如果觉得慢，禁用不需要的插件即可。

插件崩溃了？

KOReader 有插件崩溃保护——单个插件崩溃不会导致整个 KOReader 崩溃。重启 KOReader 后可以正常进入，禁用问题插件。

继续阅读