ESC
开源 2 分钟阅读

qiaomu-book-reader：中文优先的 Obsidian 电子书阅读器

开源项目 qiaomu-book-reader 让 Obsidian 变身中文优先的 EPUB、FB2 和 PDF 阅读器：进度自动保存，划线与批注沉淀为每本书一篇的 Markdown 阅读笔记，支持霞鹜文楷、思源宋体等中文字体与多种阅读主题。可选 AI 助读默认关闭，支持 DeepSeek、Kimi、通义千问等国产模型、本地模型及 CLI 账号，数据完全本地化。

来源：GitHub

Qiaomu Book Reader

中文 · English · 下载最新版 · 问题反馈

在 Obsidian 中阅读 EPUB、FB2 和 PDF，把进度、划线和批注沉淀为自己的 Markdown 阅读笔记。

中文优先、本地优先、每本书一篇阅读笔记。阅读本身完全离线，AI 能力由你选择服务并主动启用。

你会得到什么

能力实际效果
内置阅读器EPUB、FB2、PDF，支持分页、滚动、单页与双页
中文排版系统黑体、宋体、楷体、霞鹜文楷、思源宋体、思源黑体等字体
阅读主题纸白、暖纸、青瓷、夜间和电子墨水；只改变书页，工具栏跟随 Obsidian
就近批注选中文字后完成三色划线、复制、评论和创建摘录笔记
专用阅读笔记每本书自动关联一篇 Markdown 笔记，汇总划线与评论
精确返回原文笔记中的 ↩ 可跳回原书对应段落
自动进度翻页、滚动和关闭书籍时自动保存，不需要手动点击保存
可选 AI 阅读模型与思考强度独立设置、折叠思考过程、可自定义快捷提示词；支持 CLI、国产模型与本地模型

安装

使用 BRAT（推荐）

  1. 在 Obsidian 第三方插件市场安装 BRAT。
  2. 打开 BRAT → Add beta plugin。
  3. 输入 joeseesun/qiaomu-book-reader。
  4. 在“第三方插件”中启用 Qiaomu Book Reader。

之后的新版本会通过 GitHub Releases 由 BRAT 持续更新。

手动安装

从 最新版本 下载 main.js、manifest.json 和 styles.css，放入：

<你的仓库>/.obsidian/plugins/qiaomu-book-reader/

重新加载 Obsidian 后启用插件。插件 ID 为 qiaomu-book-reader。

AI 辅助阅读

AI 默认关闭。启用后，可以围绕选中的原文通俗解释、举例、提炼要点、联系实际、换角度分析或生成测试题，并继续自由追问。书内“阅读设置”新增“AI 助读”标签，可就近开关 AI、查看当前服务与模型、调节思考模式/强度、回答语言和快捷问题；API 密钥、接口地址等低频敏感配置仍留在插件系统设置。DeepSeek V4 可单独开关思考模式；模型提供思考过程时会单独显示，回答完成后自动折叠，不与正式回答混在一起。

  • 本机账号：Codex CLI、Claude Code CLI、Grok CLI。安装并登录一次后，插件可直接复用账号，无需再填 API 密钥。三个 CLI 分别记住自己的模型和思考强度。
  • 国产模型：DeepSeek、Kimi、通义千问、智谱 GLM、MiniMax。
  • 聚合服务：硅基流动、豆包/火山方舟、OpenRouter。
  • 国际服务：OpenAI。
  • 本地模型：Ollama、LM Studio。
  • 高级配置：任意 OpenAI 兼容接口。

API 密钥保存在 Obsidian 的密钥库中，不会写入插件 data.json。设置页可发送一条不含书籍内容的最短消息测试连接。

CLI 模式会自动检测可执行文件和登录状态，在独立临时目录中运行，禁用工具、文件编辑和项目规则；超时、停止生成或关闭窗口时会终止子进程并删除临时文件。Claude Code 和 Grok 按模型事件逐字显示；Codex 的稳定 exec --json 目前在一条回答完成后返回消息事件，因此设置页会明确提示，不伪装成逐字流式。CLI 模式仅支持桌面版 Obsidian。

外观与阅读设置

插件设置的“外观”页和书内“阅读设置”使用同一组数据。书内弹窗按任务分为“阅读”和“AI 助读”两个标签；主题、正文字体、字号和行距直接展示，分设备外观、电子墨水屏、对齐、插图和沉浸阅读等低频选项收在“更多阅读设置”中。弹窗只在竖向滚动，并为滚动条预留空间，不再遮住控件。

阅读笔记如何工作

首次打开一本书时，插件会创建或关联一份带有 type: reading-note 标记的专用 Markdown 笔记。之后的新划线和评论自动汇总到“划线与批注”章节；插件不会仅凭书名误把人物、项目或模板笔记当成阅读笔记。

评论以普通正文显示在引文下方，不使用引用样式。每条引文末尾的 ↩ 是返回原书位置的链接。

隐私与联网

书籍、进度、划线、评论和笔记均在本地工作，无需账号，没有遥测、分析或广告。

可选功能发送内容目标服务
翻译所选文字当前选中的段落Google Translate
AI 辅助阅读当前选中的段落、书名和你的问题你明确选择并配置的模型服务
本机 CLI 账号当前选中的段落、书名和你的问题Codex、Claude 或 Grok 的云端服务
本地 AI当前选中的段落、书名和你的问题本机 Ollama 或 LM Studio，不离开设备

两项联网功能均默认关闭。插件不会自动发送整本书或整章内容。

从源码构建

npm install
npm run check:i18n
npm run build
npx eslint src/

构建产物是仓库根目录的 main.js。

鸣谢与项目来源

Qiaomu Book Reader 起源于 MIT 开源项目 swayinfo/elton-reader。感谢 Elton Reader 原作者 Elton Labs 及所有贡献者打下的阅读器基础，为本项目的持续改造提供了代码基础与启发。

当前仓库是由向阳乔木独立维护的长期 fork，已使用独立的插件 ID、发布渠道和产品名称，并持续围绕中文界面、中文阅读排版、阅读笔记与 AI 辅助阅读进行开发。原始版权声明和第三方许可信息保留在 LICENSE 与 NOTICE.md 中。

作者

Qiaomu Book Reader 由 向阳乔木 维护：

第三方开源软件、上游来源和版权声明见 NOTICE.md 与 LICENSE。

English

Qiaomu Book Reader 是一款面向 Obsidian 的中文优先 EPUB、FB2 和 PDF 阅读器。它会把自动记录的阅读进度、划线、批注，以及每本书专属的一篇 Markdown 阅读笔记，全部保存在你的仓库（vault）中。

可使用 BRAT 安装（仓库为 joeseesun/qiaomu-book-reader），或从最新版本下载 main.js、manifest.json 和 styles.css。

阅读完全离线。书内设置分为“阅读”和“AI 助读”两个标签，常用 AI 控制就近提供，而 API 密钥和接口地址等仍保留在 Obsidian 插件设置中。可选的 AI 阅读辅助包括可编辑的快捷提示词，支持已登录的 Codex CLI、Claude Code CLI 和 Grok CLI 账号（无需额外配置 API 密钥），以及 DeepSeek、Kimi、Qwen、GLM、MiniMax、硅基流动、豆包、OpenRouter、OpenAI、Ollama、LM Studio 和任意 OpenAI 兼容自定义接口。CLI 提供商仅支持桌面版，且仍会把选中段落发送到其云端服务。AI 默认关闭，密钥通过 Obsidian SecretStorage 存储，且只会发送你明确操作的段落。

致谢与项目来源

Qiaomu Book Reader 最初是 MIT 许可的 swayinfo/elton-reader 项目的 fork。感谢 Elton Reader 原作者 Elton Labs 及所有贡献者，他们的工作为本项目提供了技术基础与启发。

本仓库现为独立维护的长期 fork，拥有独立的插件 ID、发布渠道和产品名称。原始版权声明与第三方许可信息保留在 LICENSE 和 NOTICE.md 中。

由 乔木（Qiaomu） 维护。第三方声明与上游署名保留在 NOTICE.md 和 LICENSE 中。

许可证

MIT