Qiaomu Book Reader 4.1.0

Qiaomu Book Reader 4.1.0 brings a smaller download, flexible fonts and nine interface languages.

• main.js is now 4,633,068 bytes (4.63 MB), down from 74.65 MB. Every release asset is under 5,000,000 bytes.
• Only the licensed Zhuque Fangsong reading subset is bundled. Browse installed device fonts or import TTF, OTF, WOFF and WOFF2 files; imported fonts sync with your vault. Other reading fonts have documented download links.
• Adds Japanese, Spanish, French, German, Korean and Brazilian Portuguese alongside Chinese, English and Russian.
• Standardizes reader identifiers and links on Qiaomu Reader, including obsidian://qiaomu-book-reader. Links using the retired protocol must be updated.
• Fixes localized reading-note section recognition and preserves personal sections after generated notes.
• CLI/ACP integrations use tools installed by the user. The plugin no longer includes a dependency installer.

Validation: 148 tests, localization checks, ESLint, standard/community builds and GitHub CI pass. Real Obsidian desktop checks cover EPUB, PDF, installed-font selection, imported WOFF2 and clean reload. Physical mobile-device testing remains pending.

Official Community Directory branch preview completed on d9c70b8 with no blocking errors and no vulnerable dependencies. Non-blocking CSS warnings remain for multicolumn pagination and !important theme isolation. The community listing remains a draft while upstream distribution eligibility is unresolved; this GitHub release is not a claim of marketplace approval.

安装：将下面的 main.js、manifest.json、styles.css 三个文件放入仓库的 .obsidian/plugins/qiaomu-book-reader/，重启 Obsidian 并启用插件。其他字体可通过阅读设置浏览本机字体，或导入字体文件。升级前请备份插件数据；旧协议链接需要改为 obsidian://qiaomu-book-reader。

Qiaomu Book Reader 4.0.0

这是一次围绕 PDF 阅读与 AI 助读的完整升级。

PDF 原版式阅读

• PDF 改为逐页原版式渲染，保留图片、图表、表格与页面排版。
• 文本型 PDF 叠加可选择、搜索、划线和供 AI 使用的文本层。
• 支持 50%–300% 缩放、按钮、快捷键、触控板和双指手势。
• 扫描型 PDF 保持原样阅读，可使用整本笔记与进度；不伪装成可划线或可文本问答。

AI 助读

• 每本书独立多对话线程，可新建对话、查看历史和清理上下文。
• 文本型 PDF 默认基于整份文档；选中文字后，本轮优先使用选文。
• 回答边流式生成边实时渲染 Markdown，支持常见 GFM、表格、任务列表、代码、引用、脚注、数学公式与图表语法。
• “保存 AI 回复”以 AI 回答为笔记正文，引用内容放在下方作为来源。
• 保留自定义阅读提示词和自定义快捷问题。

CLI 与 ACP

• 支持 Codex、Claude、Grok、Kimi、ZCode CLI；设置页说明 ACP 的用途、安装条件与验证方式。
• Grok、Kimi 使用原生 ACP；Codex、Claude、ZCode 使用适配器，支持相应的一键准备流程。
• 点“确定”或“测试并启用”会自动检测、验证并启用，减少遗漏。
• 区分登录、模型、会话过期与进程退出错误；无内容输出时会自动重建 ACP 并重试一次。
• 修复 Grok 自动更新进程阻塞探测和首字输出的问题。

阅读体验

• 新的沉浸式顶部/底部 HUD，不占页面排版空间。
• 内置思源宋体、思源黑体、霞鹜文楷屏幕版、霞鹜臻楷、朱雀仿宋，并随三文件安装包离线提供。
• 改进窄屏、移动端、复选框、用户消息背景和 AI 回答视觉层级。

安装

在 BRAT 中添加 joeseesun/qiaomu-book-reader，或下载本 Release 的 main.js、manifest.json、styles.css 放入 .obsidian/plugins/qiaomu-book-reader/。

Qiaomu Book Reader 3.9.1

本次修复

阅读笔记不再丢失手动摘录

• “追加到阅读笔记”的内容现在写入独立的“手动摘录”区。
• 后续新增划线、修改批注时，只重建自动管理的“划线与批注”区，不再覆盖手动内容。
• 首次升级会识别旧版管理区中未记录在划线数据里的摘录，并迁移保存。

港台繁体 PDF 正确解码

• 单文件插件内嵌 44 个 Adobe CNS / Big5 字符映射，保持完全离线。
• 修复缺少 ToUnicode 映射的台湾、香港 PDF 出现缺字或乱码的问题。
• 使用香港政府 146 页繁体报告和台湾中华邮政 18 页繁体 PDF 实测通过。

感谢 @aigoodman 在 #14 中反馈并给出清晰复现步骤。

安装与更新

BRAT 用户可直接检查更新。首次安装时，在 BRAT 中添加：

joeseesun/qiaomu-book-reader

手动安装请下载本 Release 的 main.js、manifest.json 和 styles.css，放入：

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

验证

• 36 项自动化测试通过
• 简体中文翻译覆盖检查通过
• 生产构建与 ESLint 检查通过
• GitHub CI 通过
• Release 三个附件已进行产物一致性校验

Qiaomu Book Reader 3.9.0

本次更新

AI 设置更容易完成

• 开启 AI 后直接进入完整配置流程，不再出现“只开了开关但没有配置模型”的假完成状态。
• 根据当前状态明确提示缺少服务、密钥、模型或连接测试。
• 只有连接测试成功后才真正启用 AI，避免在阅读时才发现不可用。

阅读设置更清晰

• 修复字号控制在窄窗口中越界的问题。
• 删除重复的自动保存说明，减少界面噪音。
• 行距支持预设与自定义调节。
• 优化弹窗滚动区域，避免滚动条遮挡设置内容。

修复 EPUB 图片不显示

• 正确解析 ../Images/...、多层相对路径和带编码的资源地址。
• 支持 EPUB 中由 SVG <image> 包裹的封面与插图。
• 已用 Rockfish 中 5 本真实 EPUB 检查 153 张图片，全部成功解析；《让时间陪你慢慢变富》21/21 成功。

感谢 @ccq623 在 #12 中独立定位 EPUB 图片路径问题并提交修复思路。

安装与更新

BRAT 用户可直接检查更新。首次安装时，在 BRAT 中添加：

joeseesun/qiaomu-book-reader

手动安装请下载本 Release 的 main.js、manifest.json 和 styles.css，放入：

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

验证

• 33 项自动化测试通过
• 简体中文翻译覆盖检查通过
• 生产构建与 ESLint 检查通过
• Release 三个附件均通过产物一致性校验

Qiaomu Book Reader 3.8.0

主要更新

• 书内“阅读设置”新增“阅读 / AI 助读”双标签：可就近开关 AI、查看当前服务与模型、调整思考模式或强度、回答语言和快捷问题。
• 强化进度、设置、划线与批注的串行保存；遇到损坏或同步未完成的 JSON 时保留可恢复原文，不再用空数据覆盖。
• 恢复书库封面显示，并统一桌面与移动端的 EPUB、FB2、PDF 加载链路。
• 图书加载失败时提供可重试错误页、返回书库入口和折叠技术详情。
• DeepSeek 增加独立思考模式；俄文界面不再混入中文源键。
• 完善键盘操作、按钮语义和发布资产校验。

安装与更新

推荐在 Obsidian 中通过 BRAT 添加：joeseesun/qiaomu-book-reader。已安装用户可由 BRAT 更新到 3.8.0。也可以下载本 Release 的 main.js、manifest.json、styles.css 手动安装。

验证

• 28 项自动测试通过
• 954 个英文界面键具备简体中文覆盖
• GitHub PR 与合并后 CI 均通过
• Rockfish 真实 Obsidian 安装资产哈希与 Release 一致
• 桌面端真实检查书库封面、EPUB 阅读、返回原文、选文工具条、AI 对话与双标签阅读设置

已知边界

真实 FB2、手机和电子墨水设备仍需要更多样本与真机专项验证。

Qiaomu Book Reader 3.7.0

CLI AI 更快、更可控

• Codex、Claude Code、Grok CLI 分别记住自己的模型和思考强度。
• Claude Code 与 Grok 接入真实流式事件，思考过程和正式回答分开显示。
• Codex 使用稳定 exec --json 结构化事件；当前稳定 CLI 在回答完成后返回消息，可通过更快模型或更低思考强度缩短等待。

阅读与外观

• 移除复制摘录默认格式中遗留的俄文 из，并自动修复旧默认模板片段。
• “阅读设置”不再出现横向滚动条，竖向滚动条也不会遮住内容。
• 插件“外观”页新增主题、字体、字号和行距，并与书内设置同步。
• 分设备外观、电子墨水屏、对齐、插图等低频设置收进“更多外观选项”。
• 顺手修正书内阅读笔记、分类和本书摘录模板的中文说明。

安装与更新

BRAT 用户会自动获取本版本；也可下载本 Release 中的 main.js、manifest.json 与 styles.css 手动安装。

Qiaomu Book Reader 3.6.0

新功能

• “追加到阅读笔记”仅在首次询问是否打开，之后不再打断阅读。
• AI 快捷提示词支持新增、修改、删除与恢复默认。
• 内置六个中文阅读问题：解释、举例、总结、联系实际、换个角度、出题检验。
• AI 对话框右上角新增设置入口，可直达提示词管理。

安装与更新

BRAT 用户会自动获取本版本；也可下载本 Release 中的 main.js、manifest.json 与 styles.css 手动安装。

Qiaomu Book Reader 3.5.1

更新内容\n\n- 选中文本工具条新增“更多”菜单，新建摘录笔记、添加到阅读笔记、翻译和删除划线统一收纳。\n- 批注改为就近输入：显示三行可展开原文，Enter 发送、Shift+Enter 换行、Esc 取消。\n- AI 设置默认只显示必要项；推荐模型和接口地址自动使用默认值，需要覆盖时再展开“高级设置”。\n- Georgia、Lora、Inter 不再附加中文解释；设置提示和确认文案更自然。\n\n已通过自动测试、中文覆盖检查、生产构建与 GitHub CI。

Qiaomu Book Reader 3.5.0

主要更新

• AI 回答改为流式显示；思考过程与正式回答分开，完成后自动折叠
• 新增通俗解释、提炼要点、补充背景、分析论证、联系全书、生成思考题六个快捷提示词
• 修复 Obsidian 钥匙串密钥未随请求发送的问题；401 与 403 现在给出准确提示
• AI 入口改用更清晰的魔法棒图标
• 阅读主题只改变书页；顶部工具栏和底部页码继续跟随 Obsidian
• 设置页重新分组、简化中文文案，并同步英文翻译

安装与更新

BRAT 用户会从本次 GitHub Release 获取 main.js、manifest.json 和 styles.css。

Qiaomu Book Reader 3.4.0

新增

• 支持复用本机已登录的 Codex CLI、Claude Code CLI 和 Grok CLI，无需在插件中填写 API 密钥。
• 自动检测常见 CLI 安装位置，并提供登录状态检查、连接测试和可选模型。
• CLI 生成时可随时停止。

隐私与兼容性

• CLI 模式仅支持桌面版 Obsidian。
• 每次请求都在独立临时目录运行，并关闭文件工具、命令工具、网页搜索、子代理、持久记忆和会话保存。
• AI 请求仍会发送到所选 CLI 对应的云服务，并消耗该账号的用量。

安装与更新

已安装 BRAT 的用户可直接更新；也可以在 BRAT 中添加 joeseesun/qiaomu-book-reader。