B站【收藏夹+字幕+AI总结】同步到Obsidian 使用指南

type

Post

status

Published

date

Jun 10, 2026

slug

bilibili-obsidian-guide

summary

同步 B 站收藏夹（封面、视频字幕逐字稿、AI 总结）到 Obsidian Vault，按收藏夹自动建子目录。免费体验 100 个视频。

一、下载安装

1. 安装方式一：BRAT（推荐，可自动更新）：

在 Obsidian 社区插件中安装 BRAT（Beta Reviewer's Auto-update Tool）并启用

打开 BRAT，选择 Add Beta plugin

输入仓库地址：

安装完成后，在 Obsidian 设置 → 第三方插件 中启用 BiliBili Sync

BRAT 会跟随 GitHub Release 自动检测并更新到最新版本。

2. 安装方式二：安装包方式安装

2.1 下载插件

下载插件安装包：https://static.2notion.com/bili2notion/bili2obsidian.zip

2.2 解压并安装

解压 bili2obsidian.zip，得到 bili2obsidian 文件夹

打开你的 Obsidian Vault 所在目录，找到 .obsidian/plugins/ 文件夹

macOS：你的Vault目录/.obsidian/plugins/

Windows：你的Vault目录\.obsidian\plugins\

如果 plugins 文件夹不存在，手动创建一个

把 bili2obsidian 文件夹整个复制到 plugins/ 目录下

最终结构：

提示：.obsidian 是隐藏文件夹。macOS 按 Cmd + Shift + . 显示隐藏文件，Windows 在文件资源管理器中勾选"显示隐藏的项目"。

2.3 启用插件

打开 Obsidian

进入 设置 → 第三方插件

如果提示"安全模式"，点击关闭安全模式

点击刷新按钮，找到 BiliBili Sync

打开开关启用插件

二、配置插件

启用后，在 设置 → BiliBili Sync 中进行配置。

1. 登录 B 站

点击「登录 B 站」按钮

在弹出的窗口中登录你的 B 站账号

登录成功后，点击窗口上方的「登录完成，提取 Cookie」按钮

看到登录成功提示即可

注意：Cookie 持久化在 Obsidian 的 webview 分区里，不会因为重启 Obsidian 丢失。如果登录过期，插件会自动提示你重新登录。

2. 同步设置

设置项	说明	建议值
定时自动同步	是否按设定间隔自动同步（限流或登录失效会自动关闭）	开启
自动同步间隔	每隔多少分钟自动同步一次	默认 5 分钟，建议 5 分钟以上
每批同步数量	每次同步拉取的视频条数	5–10 条
收藏夹白名单	挑选要同步的收藏夹，不选则同步全部	按需选择

间隔太短容易触发 B 站频率限制（HTTP 412/461），插件会自动关闭定时同步，需到设置页重新打开。

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），搜索「同步」相关命令即可立即触发。

同步进度

同步过程中会在右上角弹出 Notice 提示

每个收藏夹有独立同步游标 + allSync 标记，历史数据同步完成后自动转为增量同步

四、同步内容说明

目录结构

按收藏夹自动建子目录，原来 B 站怎么收的，落到 Obsidian 里就怎么放：

笔记格式

每篇笔记包含 YAML 属性区和正文：

属性（frontmatter）：bvid、标题、UP 主、收藏时间、所属收藏夹等

正文：

封面图（本地保存，不受 B 站删除/下架影响）
B 站官方 player iframe（可直接在笔记里播放）
AI 总结（如启用）：核心观点 + 要点摘要 + 金句摘录
## 逐字稿：官方字幕或 AI 字幕，按章节切分 + 时间戳分段

五、常见问题

Q：同步时提示「登录已过期」？

B 站登录态过期后，插件会自动关闭定时同步并弹出 Notice。请到设置页点「重新登录」，在弹窗里完成登录后点「登录完成，提取 Cookie」，然后把「定时自动同步」开关重新打开。Cookie 持久化在 Obsidian 的 webview 分区里，不会因为重启 Obsidian 丢失。

Q：想重新同步所有数据？

到设置页点「清除缓存并重新同步」按钮（红色）。这只会清除已同步记录，不会删除已有的笔记文件，重新同步时同名文件会被覆盖更新。

Q：同步间隔设多少合适？

默认 5 分钟，建议 5 分钟以上。间隔太短容易触发 B 站频率限制（HTTP 412/461），插件会自动关闭定时同步。每批同步数量建议 5–10 条。

Q：定时同步被自动关闭了怎么办？

遇到限流（HTTP 461 / 406 / 412）或登录失效（API code -100/-101）时，插件会主动关闭定时同步，避免继续无效请求被进一步封禁。处理完原因（重新登录 / 等一会儿）之后，到设置页手动把「定时自动同步」开关重新打开即可。

Q：提示「该授权码已绑定其他设备」？

授权码采用设备绑定（不是按账号绑定）。同一台设备上换 B 站账号、卸载重装插件都不影响绑定，只有换电脑才需要联系作者后台手动解绑。这样防止一份授权码被多人共享使用。

Q：如何更新插件？

下载新版 zip → 解压 → 覆盖旧的 .obsidian/plugins/bili2obsidian/ 目录 → 在 Obsidian 设置 → 第三方插件中点击刷新或重新启用即可。设置和已同步状态都保留在 data.json 里，更新插件不会丢。

六、购买授权码

插件提供 免费体验 100 个视频，达到限额后需要在设置页填入授权码继续同步。

购买地址：https://bilibili.2obsidian.com（永久版 ¥129.9，一次购买永久使用）

购买后将授权码粘贴到「设置 → BiliBili Sync → 授权码」输入框中，点击「验证」即可。

授权码会绑定到当前设备，同一授权码不能在多台设备上使用。换电脑后请联系开发者解绑。

一份授权码 Obsidian + Notion 双端通用：Notion 重度用户可以用同一份授权码激活 Notion 版插件（https://bili.2notion.com）。

七、安全问题

🛡️ 隐私保护声明（Privacy Policy）

我们重视您的隐私，并承诺采取一切合理措施保护您的个人数据安全。

1. 插件运行方式

本插件为 Obsidian 原生插件，所有操作均在 Obsidian 桌面端本地执行，不会将任何数据发送至我们或第三方服务器。

插件不会收集、存储或分析您的 B 站账户信息、Cookie 或视频内容。所有同步内容直接写入您本地的 Obsidian Vault。

本插件仅作为个人知识库工具使用。

2. 数据访问权限

插件通过隐藏 webview 调用 B 站 web API 拉取您的收藏夹和视频信息（含字幕），写入您本地的 Obsidian Vault。

插件不会主动抓取、储存或分发任何非您本人账号下的数据。

3. 第三方平台说明

插件使用 B 站官方 web API 拉取数据；如启用了 AI 总结，会以您配置的 OpenAI 兼容接口发送视频字幕进行摘要，该请求只发往您配置的 API 端点，不经过我们。

授权码验证使用我们的 Supabase 服务端，仅传输授权码字符串和设备指纹哈希（SHA256），不涉及任何笔记内容。

4. 本地存储说明

插件配置（同步设置、授权码、白名单等）和已同步状态保存在 Vault 内 .obsidian/plugins/bili2obsidian/data.json，B 站 Cookie 保存在 Obsidian 自身的 webview 分区内，均不会被上传或远程保存。

⚠️ 使用免责声明（Disclaimer）

1. 第三方平台责任

本插件为独立开发工具，与哔哩哔哩（bilibili）及 Obsidian 官方无任何隶属关系。所有商标与内容归各平台所有。用户在使用本插件过程中，应遵守各平台的使用条款，不得进行非法抓取、批量爬取、账号共享等违规行为。如用户行为违反平台政策或法律法规，由用户自行承担责任。

2. 功能范围说明

本插件定位为协助用户搭建个人知识库的工具，仅用于将用户本人账号下的 B 站收藏内容整理同步到本地 Obsidian Vault。

严禁将本插件用于任何形式的数据爬取、批量抓取他人内容、二次分发或商业化数据采集。

插件依赖用户在插件内登录并授权后方可使用，若平台接口发生变化导致插件无法运行，请联系开发者反馈。

3. 使用风险提示

用户使用插件过程中所产生的任何同步行为，均为用户主动触发。请用户自行评估数据内容的敏感性，合理使用插件。

八、联系与反馈

https://blog.notionedu.com/1b373415a27980b1b249eab49061527f