readingspace-mn README

The project's README from github.com/Awaker-OTE/readingspace-mn. As one markdown file: README.md.

Reading Space 标志

Reading Space MN

让解释、问答、朗读与资料检索留在 MarginNote 阅读现场。

Reading Space MN 是面向 MarginNote 4 的阅读工作流插件，把 AI、浏览器、音频朗读与 Obsidian 连接带到选区、摘录和脑图卡片旁边。

简体中文 · English · 日本語 · Français · Русский · Español · 한국어

使用场景 · 核心能力 · 使用流程 · 当前状态 · 源码构建 · 隐私与安全

把阅读的下一步，放回正在阅读的内容旁边

阅读 PDF、网页或笔记时，下一步往往是解释一个概念、追问一段内容、听一遍摘录，或临时打开网页核对资料。Reading Space MN 把这些动作组织在同一条阅读工作流中，减少在阅读器、浏览器、AI 工具和笔记软件之间来回切换。

它不会替代 MarginNote，而是围绕正在阅读的内容补齐查询、理解、朗读和沉淀入口。

适合哪些阅读场景

核心能力

能力 用途
选区与卡片工具栏 在文档选区、摘录和脑图卡片旁提供朗读、解释、AI 问答、评论、子卡片和同级卡片等入口。
AI 快速解释与查词 对当前选区或卡片内容生成简短解释，并支持词典、翻译和后续提问。
AI 问答 在 MarginNote 内使用独立问答面板，连接你自己的服务商、模型、Endpoint 和提示词。
内置浏览器 在阅读流中浏览网页，并管理主页、书签、浏览历史和当前标签页。
音频朗读 通过已配置的 TTS 服务或本地 Obsidian 桥接生成音频，并交给独立播放器。
Obsidian 推送 将当前摘录或卡片内容发送到本机 Obsidian ReadingSpace 的指定目录。
设置与手动同步 管理外观、AI、浏览器、朗读和导出设置，按选择的范围手动上传或导入 iCloud 数据。

一次阅读动作如何流转

  1. 在 MarginNote 中选中文字，或点按摘录、脑图卡片。
  2. 从 Reading Space 工具栏选择朗读、解释、查词、AI 问答或卡片操作。
  3. 在独立功能面板或播放器中查看结果，并在需要时继续追问。
  4. 将值得保留的内容推送到本机 Obsidian，或在设置页手动导出、上传和导入数据。

当前可用状态

当前公开源码快照对应版本 0.1.5，运行环境要求 MarginNote 4.2.3 或更高版本。

[!IMPORTANT] GitHub Release 已提供正式的 0.1.5 .mnaddon 安装包：下载 Reading Space MN v0.1.5。源码构建产物仍只用于本地开发和验证，不能替代 Release 中经过验收的正式包。

使用前还需要了解以下边界：

从源码验证与构建

运行插件需要 MarginNote 4.2.3 或更高版本。构建公开源码还需要：

git clone https://github.com/Awaker-OTE/readingspace-mn.git
cd readingspace-mn
pnpm install --frozen-lockfile
pnpm verify
pnpm build

pnpm verify 会校验公开源码边界、源快照和功能契约。pnpm build 会在 artifacts/ 中生成固定名称与带时间戳的 .mnaddon，但不会安装插件、重启 MarginNote、写入桌面或调用内部发布服务。

公开构建用于可复现性和回归验证，不能替代经过验收的正式发布包。

公开源码的可验证性

本仓库是受管公开镜像。产品源码以一个完整的内部 Git 提交为基线，PUBLIC_SOURCE.json 记录对应的源提交、版本、受管文件和逐文件 SHA-256。

运行以下命令可以检查当前公开源码是否仍与收据一致：

pnpm verify:source-snapshot

src/、web/ 和收据列出的功能契约脚本不会在公开镜像中独立开发；公开专用 README、CI、安全策略与无本机副作用的构建外壳可以独立维护，但不改变插件运行时行为。

隐私与数据边界

授权与独立项目声明

本仓库公开源码仅供查看与安全审计，不是开源软件。除适用法律或 GitHub 服务条款明确允许的情形外，未授予复制、修改、分发、再许可、销售或创作衍生作品的权利。完整条款见 LICENSE。

Reading Space MN 是独立设计和实现的项目，不是 MarginNote、OpenAI、ChatGPT、Obsidian 或其他第三方服务的官方产品，也不代表获得这些产品的认可、合作或兼容承诺。第三方名称与商标归各自权利人所有。

readingspace-mn (Awaker-OTE/readingspace-mn)

Searching Database…

152 ·GitHub
Readingspace-mn
这是什么？Reading Space MN 是 MarginNote 4 的阅读流程插件，把 AI 解释和问答、内置浏览器、语音朗读以及 Obsidian 导出直接带到你的选区、摘录和思维导图卡片旁边。
这是独立应用，还是需要安装 MarginNote？它是一个运行在 MarginNote 4 内部的插件（.mnaddon）——它不替代 MarginNote，而是围绕你正在阅读的内容添加查询、解释、朗读和导出入口。
我需要自己的 AI 或 TTS API 密钥吗？需要——AI 解释、问答和文字转语音都要求你配置自己的服务商、端点和 API 密钥；仓库本身不带任何第三方密钥。
自动同步到 iCloud 能用吗？不能——自动同步是一项实验性功能，目前已暂停，因此设置中只支持手动上传和手动导入；本地 Obsidian 桥接也只在桌面端可用，iPad 上不行。
它需要哪个版本的 MarginNote，支持哪些平台？它要求 MarginNote 4.2.3 或更高版本；MarginNote 可在 macOS、Windows 和 iPad 上运行，但本地 Obsidian 桥接功能仅限桌面端。
对选中的文本或思维导图卡片，我能做什么？选区/卡片工具栏可以让你朗读它、获取 AI 解释、继续追问、添加评论，或者在摘录旁边直接派生子卡片和同级卡片。
我能把高亮或卡片推送到 Obsidian 吗？可以，你可以把当前摘录或卡片内容直接发送到本地 Obsidian ReadingSpace 库中的指定文件夹。
有内置网页浏览器吗？有，内置浏览器让你不用离开 MarginNote 就能查阅参考资料，还配有自己的主页、书签、历史记录和标签页管理。
为什么不把这个项目当成普通开源项目对待？维护者公开源码纯粹是为了透明度和安全审计——许可证明确不授予复制、修改或再分发代码的权利。
What are similar projects?qiaomu-book-reader-legacy, Life-Compass-Obsidian-CN, qiaomu-clipper, obsidian-git, patent-disclosure-skill, zotero-pdf-translate, vault-graph, EverRoom
Which topics is it in?dictionary, annotation, reading, obsidian, knowledge-management, note-taking, ai-tools, text-to-speech, translation, pdf, browser, plugin
Creator
Awaker-OTE
Size
0.9 MB
Stars
152
Updated
CommitAug 13Releasev0.1.5Aug 13
Age
2mo
Commits · 90 Days