type
Post
status
Published
date
Apr 17, 2026
slug
xiaoyuzhou-obsidian-guide
summary
同步小宇宙(播客、收听单集、收藏评论、笔记、逐字稿、AI 总结)到 Obsidian Vault。免费体验 100 篇收听单集。
tags
小宇宙
obsidian
xiaoyuzhou2notion
category
技术分享
icon
password
同步小宇宙(播客、收听单集、收藏评论、笔记、逐字稿、AI 总结)到 Obsidian Vault。
最终效果展示:

一、下载安装
1. 安装方式一:BRAT(推荐,可自动更新):
- 在 Obsidian 社区插件中安装 BRAT(Beta Reviewer's Auto-update Tool)并启用
- 打开 BRAT,选择 Add Beta plugin
- 输入仓库地址:
- 安装完成后,在 Obsidian 设置 → 第三方插件 中启用 Xiaoyuzhou Sync
BRAT 会跟随 GitHub Release 自动检测并更新到最新版本。
2. 安装方式二:安装包方式安装
2.1 下载插件
2.2 解压并安装
- 解压
xiaoyuzhou2obsidian.zip,得到xiaoyuzhou2obsidian文件夹
- 打开你的 Obsidian Vault 所在目录,找到
.obsidian/plugins/文件夹 - macOS:
你的Vault目录/.obsidian/plugins/ - Windows:
你的Vault目录\.obsidian\plugins\ - 如果
plugins文件夹不存在,手动创建一个
- 把
xiaoyuzhou2obsidian文件夹整个复制到plugins/目录下
最终结构:
提示:.obsidian是隐藏文件夹。macOS 按Cmd + Shift + .显示隐藏文件,Windows 在文件资源管理器中勾选"显示隐藏的项目"。
2.3 启用插件
- 打开 Obsidian
- 进入 设置 → 第三方插件
- 如果提示"安全模式",点击关闭安全模式
- 点击刷新按钮,找到 Xiaoyuzhou Sync
- 打开开关启用插件
二、配置插件
启用后,在 设置 → Xiaoyuzhou Sync 中进行配置。
1. 登录小宇宙
- 点击「登录小宇宙」按钮
- 在弹出的窗口中登录你的小宇宙账号
- 登录成功后,点击窗口上方的「登录完成,提取 Token」按钮
- 看到提示"小宇宙登录成功"即可
注意:登录信息会保存在插件中,无需每次重新登录。如果登录过期,同步时会自动提示你重新登录。
2. 同步设置
设置项 | 说明 | 默认值 |
根目录名 | 同步内容存储在 Vault 中的目录名 | Xiaoyuzhou |
定时自动同步 | 是否按设定间隔自动同步(限流或登录失效会自动关闭) | 开启 |
自动同步间隔 | 每隔多少分钟自动同步一次(最小 5 分钟) | 10 分钟 |
播客订阅同步间隔 | 订阅列表多久重新同步一次 | 3 小时 |
评论/笔记同步间隔 | 收藏评论和笔记多久重新同步 | 1 小时 |
3. AI 逐字稿总结(可选)
开启后,同步单集时会自动对逐字稿进行 AI 总结。
- 打开「启用 AI 总结」开关
- 填写 API Key、API Base URL(需带
/v1)、模型名称
- 点击「测试连接」确认配置可用
支持的 AI 服务(任何 OpenAI 兼容接口均可):
- OpenAI:
https://api.openai.com/v1
- DeepSeek:
https://api.deepseek.com/v1
- Kimi(Moonshot):
https://api.moonshot.cn/v1
- 智谱 GLM:
https://open.bigmodel.cn/api/paas/v4
- 通义千问(DashScope):
https://dashscope.aliyuncs.com/compatible-mode/v1
- OpenRouter:
https://openrouter.ai/api/v1
- 硅基流动:
https://api.siliconflow.cn/v1
- 其他自建 / 第三方 OpenAI 兼容网关
三、开始同步
自动同步
插件启用后会按设定的间隔自动同步,无需手动操作。
手动同步
两种方式触发手动同步:
- 点击左侧栏播客图标
- 命令面板:按
Cmd + P(macOS)或Ctrl + P(Windows),搜索「立即同步」
同步进度
- 同步过程中会在右上角弹出提示(如"收听单集:同步了 5 条")
- 在插件设置页可以看到每种类型的已同步数量和状态:
- 历史数据同步中... — 正在拉取历史数据
- 历史数据同步完成,开始增量同步 — 历史数据已全部同步,后续只拉取新增内容
四、同步内容说明
目录结构
笔记格式
每篇笔记包含 YAML 属性区和正文:
播客示例:
- 属性:pid、标题、作者、订阅数、节目数、收听时长、收听状态等
- 正文:播客简介、主播列表
单集示例:
- 属性:eid、标题、播客名、发布时间、时长、收听状态、收听进度等
- 正文:音频链接、AI 总结(如启用)、节目简介(shownotes)、时点、逐字稿
评论/笔记示例:
- 属性:ID、作者、所属单集、创建时间等
- 正文:评论/笔记全文
五、常见问题
Q:同步时提示"登录已过期"?
小宇宙的登录信息有有效期,过期后插件会自动检测并提示。点击设置中的「登录小宇宙」重新登录即可。
Q:想重新同步所有数据?
在插件设置中点击「清除缓存并重新同步」按钮。这只会重置同步记录,不会删除已有的笔记文件(会覆盖更新)。
Q:同步间隔设多少合适?
建议自动同步间隔 10 分钟以上,播客订阅 3 小时以上。设太短容易触发接口限制,达到限制后插件会自动关闭定时同步,需要在设置中重新开启。
Q:定时同步被自动关闭了怎么办?
遇到限流或登录失效时,插件会自动关闭定时同步以避免无效请求。处理完问题后(比如重新登录、等限流解除),在设置页「定时自动同步」开关处重新打开即可。
Q:提示"该授权码已绑定其他设备"?
授权码会绑定到首次使用的设备。如果你换了电脑,请联系开发者解绑后重新验证。
Q:如何更新插件?
下载新版本的
xiaoyuzhou2obsidian.zip,解压后覆盖 .obsidian/plugins/xiaoyuzhou2obsidian/ 目录下的文件,重新加载 Obsidian 即可。六、购买授权码
插件提供 免费体验 10 篇收听单集,达到限额后需要在设置页填入授权码继续同步。
(小红书购买后好评+晒单的可以找我领取39 元返现)
购买后将授权码粘贴到「设置 → Xiaoyuzhou Sync → 授权码」输入框中,点击「验证」即可。
授权码会绑定到当前设备,同一授权码不能在多台设备上使用。换电脑后请联系开发者解绑。
七、安全问题
🛡️ 隐私保护声明(Privacy Policy)
我们重视您的隐私,并承诺采取一切合理措施保护您的个人数据安全。
1. 插件运行方式
- 本插件为纯本地工具,所有操作均在您的 Obsidian 客户端本地执行,不会将任何数据发送至第三方服务器。
- 插件不会收集、存储或分析您的小宇宙账户信息、内容数据或登录凭证。
- 本插件仅作为个人知识库工具使用。
2. 数据访问权限
- 插件运行时会读取您已登录账号下的公开内容(例如您的订阅、收听单集、收藏评论),以便将您主动选择的信息同步至 Obsidian Vault。
- 插件不会主动抓取、储存或分发任何非您本人页面或受保护数据。
3. 第三方平台说明
- 插件通过 Obsidian 官方 API 写入本地 Vault,仅在您本地设备上与 Vault 交互。
- 所有同步动作由用户发起,插件不会在未授权的情况下执行任何数据传输行为。
4. 本地存储说明
- 插件会在本地存储用户配置项(如同步偏好设置、登录 Token),这些信息仅保存在您本地 Vault 的插件目录中,不会被上传或远程保存。
⚠️ 使用免责声明(Disclaimer)
1. 第三方平台责任
本插件为独立开发工具,与小宇宙及 Obsidian 官方无任何隶属关系。所有商标与内容归各平台所有。用户在使用本插件过程中,应遵守各平台的使用条款,不得进行非法抓取、批量爬取、账号共享等违规行为。如用户行为违反平台政策或法律法规,由用户自行承担责任。
2. 功能范围说明
- 本插件定位为协助用户搭建个人知识库的工具,仅用于将用户本人账号下的小宇宙订阅、收听单集、收藏评论、笔记等内容整理同步到本地 Obsidian Vault。
- 严禁将本插件用于任何形式的数据爬取、批量抓取他人内容、二次分发或商业化数据采集。
- 插件依赖用户在插件内登录并授权后方可使用,若平台接口发生变化导致插件无法运行,请联系开发者反馈。
3. 使用风险提示
用户使用插件过程中所产生的任何同步行为,均为用户主动触发。请用户自行评估数据内容的敏感性,合理使用插件。
八、联系与反馈
- Author:自律小嘉同学
- URL:https://blog.notionedu.com/article/xiaoyuzhou-obsidian-guide
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!




