Koodo Reader：3 个场景讲透它的 AI 阅读助手

Koodo Reader：3 个场景讲透它的 AI 阅读助手

【免费下载链接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web项目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader

读到外文论文卡壳、读完长文献记不住要点，你要的往往不是再开一个翻译网站，而是一个长在读里、随用随取的 AI 阅读助手。Koodo Reader 是一款跨平台的电子书阅读器，覆盖 Windows、macOS、Linux 和 Web，它的 AI 能力恰好对应翻译、查词、总结三个入口。这篇文章按真实使用路径，讲清它们怎么用、又是怎样实现的。

阅读器 AI 插件：AI 能力都是"装"出来的 🧩

Koodo Reader 没有把 AI 功能写死在业务代码里，而是在 src/store/actions/manager.tsx 中启动时向插件列表注册三个官方阅读器 AI 插件：official-ai-dict-plugin（AI 词典）、official-ai-trans-plugin（AI 翻译）、official-ai-assistant-plugin（AI 助手与总结）。

插件化的好处是：每个 AI 功能都是独立可选的"服务商"，弹窗里随时切换，也允许自定义插件——同一文件里以同样方式拼装出 custom-ai-assistant-plugin 的自定义助手条目。三个官方插件统一受 isDisableAI 配置控制，用户关掉后它们直接不进入插件列表（该文件 L418 处）。

三个真实场景：划词翻译、章末总结、术语查词 ✍️

划词翻译：AI 翻译电子书

阅读中用鼠标选中一段外文，翻译弹窗 src/components/popups/popupTrans/component.tsx 就会接住这段文本，里面可选择 official-ai-trans-plugin 或你自己的翻译插件作为服务。请求经由 getTransStream 发出，结果在弹窗里逐句出现，边等边读下一句。

章末总结：AI 总结长文档

读完一章，点阅读器右下角的"AI"按钮（src/pages/reader/component.tsx L446）。它会先取当前章全文 chapterText()，再打开助手面板；popupAssist 调用 getAnswerStream 并携带最近 5 轮对话历史，可以连续追问。直接输入"总结本章要点"，是消化长文献最省事的路径。

术语查词：带着上下文解析

词典弹窗 src/components/popups/popupDict/component.tsx 调用 getDictionaryStream，注意它传入的不只是单词，还有所在句子的上下文；选用 official-ai-dict-plugin 时还能开启完整分析，拿到更深的术语解析。这些入口同时都能从右键菜单进入：popupOption 按启用的选项渲染"查词/翻译/助手"条目。

为什么全是流式响应：不卡阅读 💧

三个 AI 请求（getTransStream、getAnswerStream、getDictionaryStream，见 src/utils/request/reader.ts）形状一致：都接收 onMessage 回调、内容分段返回。

// 伪代码：流式请求 const res = await request({ text, mode }, (chunk) => render(chunk));

界面边收到 chunk 边写入弹窗，一章几十页的总结也不会"转圈到天荒地老"。阅读器是停留时间最长的页面，首屏反馈快，比一次拿全结果更重要。

边界与克制：不打扰的 AI 🤫

AI 功能强，不代表要一直挂在脸上，Koodo Reader 在打扰度上刻意做了三道约束：

• AI 生成标识透明：AI 结果统一显示"内容由AI生成"标记（对应 src/assets/locales/zh-CN.json 中的 Generated with AI 条目），哪部分是机器输出，一眼可辨；
• 插件按需启用：三个官方 AI 插件在弹窗的服务选择里单独开关，不用的不必打开；
• 全局一键关闭：src/constants/settingList.tsx 中 isDisableAI 配置项能关掉全部 AI 入口——右下角"AI"按钮（reader/component.tsx）与右键菜单的 AI 选项（popupOption）都会先检查这个开关再决定是否渲染。

路线图：从阅读数据到知识图谱

后续规划上，团队打算先基于本地数据做阅读行为分析（时长、标记），再支持多模型切换与轻量化离线模型，让基础功能断网也能用；更远一步是自动提取书籍关键概念、生成知识图谱并做跨书关联推荐，数据层预计继续构建在 databaseService 与 Book 模型 之上。

想要一个"帮忙但不抢戏"的 AI 阅读助手，Koodo Reader 已经用插件化和流式这两件事打好了地基，源码开放，可以边读边验。

项目仓库路径：GitHub_Trending/koo/koodo-reader README：README.md 反馈邮箱：feedback@koodoreader.com

【免费下载链接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web项目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader