【MN 插件】Reading Space MN:选区解释 / AI 问答 / 卡片回写 / 朗读 / 浏览器 / Obsidian

【MN 插件】Reading Space MN:选区解释 / AI 问答 / 卡片回写 / 朗读 / 浏览器 / Obsidian

Reading Space MN:把 选区解释、AI 问答、卡片回写、音频朗读、资料检索和 Obsidian 输出 放回 MarginNote 的阅读现场,尽量减少在应用之间来回切换。

当前版本为 v0.1.0 测试版,适用于 MarginNote 4.2.3 及以上版本,正在准备官方插件签名。签名和下载地址确认后会更新在本帖首楼。

Reading Space MN 目前仍处于测试阶段,功能、交互及不同设备的兼容性都在持续完善,难免存在尚未覆盖的问题或不够成熟的细节。欢迎大家试用并提出意见;如果遇到异常,烦请按文末格式反馈,也请大家多多包涵。

下载与签名状态

下载:
reading-space-mn-v0.1.0.mnaddon (564.4 KB)

基本信息

项目 内容
插件名 Reading Space MN
当前版本 v0.1.0
作者 AwakerOTE
适用版本 MarginNote 4.2.3 及以上
当前状态 测试版,待官方签名
主要入口 浏览器、AI 问答、设置、选区工具栏、播放器、Obsidian 输出

平台实测状态

【在 iPad 和 Mac 平台已经完成测试,同时插件在测试适配阶段,如有 Bug 请及时反馈,请多多包涵!!】

功能 Mac Apple Silicon iPad
安装、启用与主窗口 已通过 已通过
PDF 选区工具栏、AI 快速解释与 AI 问答 已通过 已通过
卡片回写与复制栏 已通过 已通过
内置浏览器 已通过 已通过
TTS 与独立播放器 已通过 已通过
Obsidian 输出或本机文件导出 已通过 已通过
手动 iCloud 上传与导入 已通过 已通过

初衷

阅读最怕的是断流:精读 PDF 时,思路常被多个工具来回切换打断。

  1. 读到一句难理解的话,想就地解释。
  2. 解释之后还想追问机制、反例和适用边界。
  3. 得到有价值的回答,希望写回当前卡片、评论、子卡片或同级卡片。
  4. 核查资料时需要临时打开网页,但不想离开当前学习集。
  5. 遇到长段落,希望直接朗读并在播放器里控制进度。
  6. 整理完成后,希望把摘录、PDF 或结构化数据继续发送到 Obsidian。

使用流程

阅读 → 选区解释 → 继续 AI 追问 → 卡片回写 → 浏览器核查 → 朗读复核 → 输出到 Obsidian

1. 选区朗读、解释与 AI 问答

在 PDF 中选中文字后,可以直接使用【朗读】、【解释】和【AI 问答】,不用先复制文本再切换应用。

【AI 快速解释】
更适合阅读中的短问题。提示词、模型与字数可在设置中调整,解释结果也可以继续带入 AI 问答。同时可以与脑图进行互动添加卡片、子卡片等内容。

2. AI 问答与卡片回写

AI 问答支持快捷提示词、模型选择、对话历史、引用、重答、复制和朗读回复。

从 PDF 选中问题后,可通过划词工具栏进入【AI 问答】并发送。

有价值的 AI 回复可以写入当前卡片标题或评论,也可以继续建立子卡片和同级卡片。

主窗口的复制栏还提供复制、朗读、加入 AI 问答、直接发送,以及标题、评论、子卡片和同级卡片等快捷操作。

3. 内置浏览器

插件提供一个轻量浏览器,用于阅读过程中的短时资料核查。

当前包括:

  • 输入网址或搜索。
  • 回到主页或设为主页。
  • 书签与历史记录。
  • 当前标签页恢复。
  • 将网页复制内容继续交给朗读、AI 或卡片操作。

【浏览器内复制桌面端使用鼠标右键单击,iPad 端妙控键盘双击复制;触屏双击复制,部分网页可能需要后期适配。】

:warning::浏览器登录态属于本机数据。Cookie 不进入 iCloud 同步,也不进入“导出全部设置”。不同 MarginNote 和系统环境对 Cookie 持久化的支持不同,重启或更新后可能需要重新登录。

4. 音频朗读与播放器

Reading Space MN 可以把选区、摘录、卡片内容或 AI 回复生成音频,并发送到独立播放器。

当前设置入口包括:

  • 阿里云 DashScope TTS。
  • Gemini TTS。
  • MiniMax TTS。
  • 桌面端本地 Obsidian ReadingSpace 桥接。

中文朗读、英文朗读和测试播放器入口

播放器朗读界面

本地 Obsidian 桥接主要用于桌面端。MarginNote Reading Space 会把朗读文本发送给本机 Obsidian ReadingSpace,由 Obsidian 侧完成语音合成,再把音频返回给 MarginNote 播放。该桥接能力在 iPad 上不可用。

5. Obsidian 输出

Obsidian ReadingSpace 暂未上架官方市场。如有需要,可联系我获取使用。

在阅读或整理卡片时,可以按 R → 发送到 Obsidian 打开输出子菜单:

  • 发送当前摘录。
  • 发送当前 PDF。
  • 复制导出 JSON。

Obsidian 对接

Obsidian ReadingSpace 插件已经支持 PDF 高亮、高亮空间等功能,
同名文件在 Obsidian 接收 MN 的摘录和卡片会同步高亮和卡片显示。

效果如上

6. 设置、外观和同步边界

设置页目前包含:

  • AI 核心。
  • AI 智能问答。
  • AI 快速解释。
  • 浏览器。
  • Obsidian 推送。
  • 音频朗读。
  • 外观入口。
  • 同步备份。
  • 关于。

同步采用保守策略:自动同步实验功能目前已暂停,只保留用户明确触发的手动上传和手动导入。

浏览器当前标签页、浏览历史、API Key、Bridge token 和 AI 问答历史都可以作为独立范围处理,并在高风险项目旁给出提示,避免因为整包同步而覆盖另一台设备的数据。

安装与配置

当前阶段是测试版,下载地址会在测试包和签名状态确认后补充。

预计安装流程:

  1. 下载本帖提供的文件。
  2. 使用 MarginNote 打开并安装插件。
  3. 进入设置页,按需配置 AI 服务、TTS 服务和浏览器选项。
  4. 回到阅读场景,选中文字或点按卡片开始使用。

快速开始

  1. 下载并安装本帖提供的.mnaddon文件。
  2. 打开 【R → 主窗口 → 设置 → AI 核心】。
  3. 选择自己的 AI 服务商和模型,填写对应 API Key,并先完成连接测试。
  4. 回到 PDF,选中文字后点击【解释】或【AI 问答】。
  5. 需要朗读时,再进入【设置 → 音频朗读】配置 TTS;需要 Obsidian 输出或手动同步时,再分别进入对应设置页配置。

AI 和 TTS 功能需要使用你自己的服务配置。
Reading Space MN 暂时不提供、不内置任何第三方 API Key。

隐私与数据说明

  • AI 和 TTS 请求会发送到你主动配置的第三方服务商。
  • API Key、Bridge token、浏览器历史和 AI 问答历史属于敏感数据。
  • 浏览器 Cookie 只作为本机登录态处理,不进入 iCloud 同步和全部设置导出。
  • 自动同步目前已暂停;涉及高风险数据时,只建议确认范围后手动上传或导入。
  • 全部设置导出可能包含密钥和历史,请只保存到可信位置。
  • 插件不会内置第三方 API Key。

已知限制

  • 当前是 v0.1.0 测试版,正在准备官方签名。
  • 当前部分功能入口仍以文字按钮为主,图标化和视觉一致性还在持续完善;后续版本会在保证识别清晰和操作易懂的前提下,进一步优化图标、间距与布局。
  • 自动同步实验功能已暂停,当前只建议使用手动上传和手动导入。
  • Obsidian 本地桥接主要用于桌面端,iPad 上不可用。
  • 浏览器 Cookie 持久化受 MarginNote 与系统环境限制,重启或更新后可能需要重新登录。
  • AI 与 TTS 的稳定性取决于服务商、模型、网络环境和用户配置。

适合哪些用户

如果你经常在 MarginNote 中进行下面这些工作,可能会适合试用:

  • 精读 PDF 时频繁划词解释。
  • 使用脑图卡片整理知识结构。
  • 希望把摘录快速带入 AI 继续追问。
  • 需要把 AI 回答写回标题、评论、子卡片或同级卡片。
  • 希望朗读长摘录、卡片或 AI 回复。
  • 阅读时经常需要临时核查公开网页。
  • 同时使用 MarginNote 与 Obsidian 整理知识。

反馈格式

如果遇到问题,可以按下面的格式回复,方便定位:

MarginNote 版本:
设备:Mac Apple Silicon / iPad
系统版本:
Reading Space MN 版本:
问题位置:浏览器 / AI 问答 / AI 快速解释 / 朗读 / 设置 / 工具栏 / Obsidian 输出
复现步骤:
预期结果:
实际结果:
是否能稳定复现:
截图或录屏:

更新记录

v0.1.0

  • 提供浏览器、AI 问答和设置三个主窗口 Tab。
  • 提供 PDF 选区、摘录和脑图卡片相关的朗读、解释与 AI 问答入口。
  • 提供 AI 问答、AI 快速解释、模型和提示词配置。
  • 提供 AI 回复到标题、评论、子卡片和同级卡片的回写操作。
  • 提供内置浏览器、主页、书签、历史和标签页恢复。
  • 提供多服务商 TTS、独立播放器和 Obsidian 本地桥接。
  • 提供当前摘录、当前 PDF 和结构化 JSON 的 Obsidian 输出入口。
  • 提供设置导出、导入和手动 iCloud 同步范围配置。
  • 暂停自动同步实验功能,避免跨设备旧数据覆盖。

感谢

特别感谢 沈士超Randa 的支持与帮助。

感谢试用和反馈。正式签名版本完成后,我会继续在本帖首楼更新下载地址和版本记录。

2 个赞