摘要：同源的两个 KOReader AI 插件，一个功能全栈、一个轻量克制，都还在更新。这篇用仓库数据讲清它们的关系、优缺点，以及你到底该装哪个。

KOReader 是开源阅读器，Kobo、Kindle、安卓电纸书都能跑。它本身只负责读书，AI 能力靠插件补：选中一段话，翻译、解释、总结、追问，不用切出去开别的 App。

想装这类插件，搜出来常撞见两个名字：KOAssistant 和 assistant.koplugin。名字像不是巧合，它们确实同源，而且都还在活跃更新，只是路线完全不同——一个把功能堆到全栈，一个坚持轻量直给。

这篇说清三件事：它们是什么关系、各有什么优缺点、到底该装哪个。依据是两份仓库的 README、源码和 GitHub 数据，查询时间 2026-08-19，我没有实机测试，说"没测过"的地方就是没测过。

一条血统，两种活法

两个插件都能追溯到 AskGPT 这个更早的项目。作者 zeeyado 把 AskGPT 的一支 fork 重做成今天的 KOAssistant；另一支由 omer-faruq 接手并继续维护，就是 assistant.koplugin，GitHub 上还标着它 fork 自 AskGPT，AskGPT 原作者 drewbaumann 的名字也在贡献者名单里。

两个项目互相承认对方：assistant.koplugin 的 README 专门放了一行链接，说 zeeyado 的 fork 已经公开、更新很多；KOAssistant 的 README 也写了可以和 assistant 插件并存。这种互相引用的关系，在开源插件里算少见。

顺带提醒：网上还挂着 dourofficer 的 assistant.koplugin 副本，2025 年 12 月把 v1.10 复制出来、加了个 Azure OpenAI 支持就再没动过。装的时候认准 omer-faruq 的仓库，别装成停更版。

KOAssistant：功能全栈，但重

KOAssistant 现在更新很勤，动笔前一天还在发新版（v0.21.2）。挑几个有代表性的功能：

• • 高亮即问。选中一段话，菜单里有翻译、解释、词典、ELI5、总结等动作，短答案直接弹小窗，不占整屏。
• • X-Ray。给整本书生成角色、地点、术语的索引，跟着阅读进度走，剧透保护默认开，还支持自动更新、检查点、历史版本。读到哪，它只讲到哪。
• • 书库级玩法。系列书能分组，前一本书的 X-Ray 知识带到下一本；每本书还有独立的 Book Hub 页面，聊天、笔记、设置集中在一处；另有"接下来读什么"、多书对比、阅读模式分析。
• • 笔记与 Obsidian。AI 回复一键存成书内笔记，支持写到 Obsidian 库目录，笔记直接进你的知识库。
• • 附加项还有：高亮生成图片、联网搜索、让 AI 自己翻书找答案的 Book Tools（实验功能）、识别到 DOI 自动进学术增强模式、章节测验。聊天记录能存能导出，自定义动作支持几十个模板占位符。
• • 28 家内置提供商，Anthropic、OpenAI、Gemini、DeepSeek、Kimi、豆包、通义、智谱都有，也支持本地 Ollama 以及你自己加的 OpenAI 兼容服务。没有 API key 可以走 ChatGPT 订阅登录（非官方通道），或者吃各家免费额度，Gemini Flash、Groq 都有免费档。
• • 配置基本不碰文件：设置向导、菜单里填 key，一键自动更新。

隐私方面它做了层设计：阅读数据默认不发给 AI，标注、笔记、文本提取都要手动开启才会上传。

缺点同样实在。体量摆在那：主程序两万多行，菜单和设置项很深，新用户第一周基本在翻文档。迭代太快，main 分支偶尔翻车，README 自己都提醒"可能出问题"。部分功能标着实验。中文界面现在是 AI 翻译、待人工审校的状态（翻译平台数据），简体中文用户要接受界面措辞偶尔别扭。个别的 bug 还没修，比如日志文件越攒越大、笔记写回会吞掉原标注的元数据。性能我没有实测，老电纸书上到底卡不卡，得自己试。

assistant.koplugin：轻量直给，社区更大

assistant.koplugin 是另一个极端：轻，整个项目大约只有 KOAssistant 的十分之一。装好后复制 configuration.sample.lua 改名 configuration.lua，在里面填提供商和 key；日常切模型、切服务有插件内设置界面，不用反复改文件。

核心流程：高亮 → AI Assistant → 翻译、解释、总结，或者跑你自己写的 prompt。支持流式输出，长按单词直接开 AI 词典，手势能触发问答、Recap、X-Ray，回复支持 Markdown，能存笔记、能复制。内置词典、Term X-Ray、Recap、X-Ray 几组现成 prompt，X-Ray 是基础版——一次性生成，没有 KOAssistant 那种自动检查点和版本历史。近期还加了联网搜索，AI 可以带着搜索结果回答，不过要另配 Tavily、SerpAPI 这类搜索服务的 key。

它支持主流模型服务：Claude、GPT、Gemini、DeepSeek、Ollama、OpenRouter、Groq、Mistral 等，另有一套命名规则，同一个处理器可以挂多个 OpenAI 兼容服务（比如 openai 处理器同时接 Perplexity 和 Grok）。界面带简体、繁体中文翻译。

社区是它的强项：584 星，20 位贡献者，AskGPT 原作者也在其中。文档也全，安装、拿 key、写配置都有 wiki 页。更新靠 OTA 提示，同作者还维护着一个 appstore.koplugin（465 星），在 KOReader 里就能浏览、安装、更新社区插件，这两个插件都能用它装。

缺点也明摆着：功能面窄，没有图片生成、书库分析、章节测验、自动 X-Ray 这类高级玩法，追求这些还是得看 KOAssistant。配置对新手不友好，第一次要碰配置文件。免费额度它不替你整理，哪个服务有免费档得自己查。

安装与上手

第一次安装，两边都是把文件夹放进 KOReader 的 plugins 目录再重启，差别从配置开始。

KOAssistant 走的是"向导 + 菜单"：装完进 Tools 菜单，按提示一步步选提供商、填 key、设隐私选项，之后几乎所有设置都在菜单里点，不用碰代码文件。安装包 6MB 左右，目录名必须叫 koassistant.koplugin。

assistant.koplugin 是"配置文件一把梭"：装好后手动复制 configuration.sample.lua 为 configuration.lua，填提供商、模型、API key，重启生效。目录名是 assistant.koplugin。示例文件四百多行，看着长，核心要改的 provider_settings 就一块，照着抄不难。

两者都要求 KOReader 本身能联网。没有 key 的起点：KOAssistant 文档里整理了免费档清单（Gemini Flash、Groq 等），assistant.koplugin 没整理，但支持的服务一样，本地 Ollama 两个都能接。

对比

怎么选

想要功能全、愿意花时间学、打算长期用，装 KOAssistant，它的功能面和更新频率都在这个生态的第一梯队。只想要翻译、词典和问答这些核心能力，追求轻快，装 assistant.koplugin，社区更大，配置也不算难。

两个插件可以并存，KOAssistant 的 README 明确写过不冲突。装两个文件夹，先用顺手的那个，再慢慢加另一个也行。

已经在用 dourofficer 停更副本的人，迁到 omer-faruq 的正版不复杂：同一代代码，配置结构基本一致，先备份 configuration.lua 再换。这条我没实测，依据是两边文件结构的比对，动手前留个副本总没错。

最后提醒一句：API key 就是钱，别截图发群里，别提交进任何仓库。拿不准先本地跑 Ollama 试水，免费额度用完就没了。

时效声明：本文信息来自两个仓库的 README、源码和 GitHub 数据，查询时间 2026-08-19，未实机测试。插件迭代快，功能与数字以仓库当前状态为准。