Lazy loaded image
技术分享
Lazy loaded image抖音【收藏+作品+点赞】同步到Obsidian 使用指南
Words 5100Read Time≈ 13 min
2026-8-4
2026-8-4
type
Post
status
Published
date
slug
douyin-obsidian-guide
summary
同步抖音（收藏、个人视频、点赞）到 Obsidian Vault 的原生插件使用指南，支持视频逐字稿、图片文字识别、AI 分类与 Bases 画廊视图
tags
工具
独立开发
obsidian
AI
知识管理
category
技术分享
icon
password

一、下载安装

官网：douyin.2obsidian.com
最终效果：
首次同步后自动生成的「🎵 抖音.base」画廊视图
首次同步后自动生成的「🎵 抖音.base」画廊视图

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

  1. 在 Obsidian 社区插件中安装 BRAT（Beta Reviewer's Auto-update Tool）并启用
  1. 打开 BRAT，选择 Add Beta plugin
  1. 输入仓库地址：
  1. 安装完成后，在 Obsidian 设置 → 第三方插件 中启用 Douyin Sync
BRAT 会跟随 GitHub Release 自动检测并更新到最新版本。

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

2.1 下载插件
下载插件安装包：https://static.2notion.com/douyin2notion/douyin2obsidian.zip
2.2 解压并安装
  1. 解压 douyin2obsidian.zip，得到 douyin2obsidian 文件夹
  1. 打开你的 Obsidian Vault 所在目录，找到 .obsidian/plugins/ 文件夹
      • macOS：你的Vault目录/.obsidian/plugins/
      • Windows：你的Vault目录\.obsidian\plugins\
      • 如果 plugins 文件夹不存在，手动创建一个
  1. 把 douyin2obsidian 文件夹整个复制到 plugins/ 目录下
最终结构：
提示：.obsidian 是隐藏文件夹。macOS 按 Cmd + Shift + . 显示隐藏文件，Windows 在文件资源管理器中勾选「显示隐藏的项目」。
2.3 启用插件
  1. 打开 Obsidian
  1. 进入 设置 → 第三方插件
  1. 如果提示「安全模式」，点击关闭安全模式
  1. 点击刷新按钮，找到 Douyin Sync
  1. 打开开关启用插件
插件需要 Obsidian 1.9 或更高版本：画廊视图用的是 Obsidian 1.9 才引入的 Bases 功能。

二、配置插件

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

1. 登录抖音

  1. 点击「登录抖音」按钮
  1. 在弹出的窗口中扫码登录你的抖音账号
  1. 看到自己的头像后，点击窗口右上角的「登录完成」按钮
  1. 看到提示「抖音登录成功」即可
登录状态保存在插件独立的浏览器分区里，不影响你的 Chrome，也无需每次重新登录。登录失效时插件会自动关闭定时同步并提示你重新登录。

2. 同步设置

设置项
说明
默认值
根目录名
同步内容存储在 Vault 中的目录名
Douyin
定时自动同步
关闭后只能手动同步；遇到风控或登录失效会自动关闭
开启
同步间隔
每隔多少分钟自动同步一次（最小 5 分钟）
10 分钟
每批同步数量
每次同步的视频数量（5-10 之间）
5
同步内容
选择同步哪种类型：收藏 / 个人视频 / 点赞
收藏
同步标签
把视频描述里的 #话题 写进笔记属性
开启
收藏夹白名单
仅在「同步内容」选为收藏时显示。点击「刷新收藏夹列表」拉取当前账号全部收藏夹，勾选要同步的子集；不勾选任何一个 = 同步全部收藏夹
不筛选
下载封面到本地
视频笔记下载封面并嵌入笔记，画廊卡片图依赖它
开启
下载视频到本地
把视频文件下载进 Vault（单条通常 5–30MB），关闭则只嵌入远程直链
关闭
改完「同步间隔」或「每批同步数量」后会立即弹出提示。如果改间隔时「定时自动同步」是关的，新间隔会保存但不启动定时器，需要先打开自动同步。打开自动同步且距上次成功同步已超过新间隔时，会立即触发一次同步，不用等下个周期。
收藏夹白名单（按需同步指定收藏夹）
抖音的收藏是按收藏夹组织的，插件会逐个收藏夹轮转同步：每次同步处理一个收藏夹的一页，该收藏夹拉完后自动切到下一个。收藏夹多的话全量同步需要跑若干轮。
如果只想同步其中几个：
  1. 把「同步内容」切到收藏
  1. 点击「刷新收藏夹列表」，插件会拉取你当前账号下的全部收藏夹
  1. 在列表里勾选要同步的收藏夹（可多选），勾选立即生效，无需保存
规则：
  • 不勾选任何一个 = 同步全部收藏夹
  • 勾选 N 个 = 只同步这 N 个，其他收藏夹跳过
  • 列表末尾的「默认收藏」是虚拟收藏夹，代表你收藏了但没放进任何收藏夹的视频，同样可以勾选
  • 白名单改动后，当前轮转位置会复位，下次同步从白名单里的第一个收藏夹重新开始
  • 切换账号后需要重新点「刷新收藏夹列表」
下载视频到本地（默认关闭）
抖音的视频直链（play_addr）有时效，过期后远程播放器就放不出来了。如果你希望长期保存，打开「下载视频到本地」开关，视频会下载到 Douyin/Media/{视频ID}/video.mp4，笔记里以 ![[…]] 本地嵌入，可在 Obsidian 内直接播放。
注意事项：
  • 抖音单条视频通常 5–30MB，开启后磁盘占用会显著上升，按需开启
  • 关闭时笔记里嵌入远程播放器；无论开关如何，笔记里始终保留「在抖音中打开」的原视频页链接，链接过期也能回源
  • 单条视频下载失败（超时 / 链接失效）会自动回退成远程链接，不阻塞笔记生成

3. AI 模型配置（可选）

AI 分类、图片转文字、逐字稿整理三个功能共用同一套凭证：
  1. 填写 API Key、API Base URL（必须带 /v1）、文本模型
  1. 点击「测试连接」确认配置可用
  1. 如果要用图片转文字，另外填写 视觉模型（需支持图片输入的多模态模型），点「测试识图」验证
支持的 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 兼容网关

4. AI 分类（可选）

开启后，AI 会把内容归入你设定的分类，笔记落到对应的子目录，同时写进 category 属性供画廊分组。
  1. 打开「启用 AI 分类」开关
  1. 逐个输入分类名并按回车添加，或点击「从收藏夹目录加载」，把 Douyin/Bookmarks/ 下已有的收藏夹目录一键读成分类列表
  1. 分类列表为空时 AI 分类不会生效
设置页的「AI 分类」与「AI 识别」区块
设置页的「AI 分类」与「AI 识别」区块
AI 只补没有归属的内容：你在抖音里自己建的收藏夹名是人工判断，比 AI 准，插件不会覆盖。真正会被 AI 分类的是「默认收藏」（收藏了但没分组）、个人视频和点赞——它们本来就没有收藏夹。

5. AI 识别（可选）

功能
作用
代价
图片转文字
把图文笔记的图片（最多前 10 张）交给视觉模型识别文字，以折叠块附在笔记末尾
每篇图文笔记多一次 AI 调用
视频逐字稿
把视频语音转成文字附在笔记末尾
异步任务，视频笔记同步耗时增加 1–5 分钟，约 0.29 元/小时音频（百炼）
逐字稿 AI 整理
用文本模型对逐字稿分段整理并生成要点总结
每条视频多一次 AI 调用
转写服务商（四选一，前三家都是把视频 URL 交给云端拉取，本地不上传文件，因此不受视频大小限制）：
服务商
需要填
说明
百炼 paraformer
DashScope API Key
推荐，申请地址
火山引擎
App ID + Access Token
控制台开通
腾讯云 ASR
SecretId + SecretKey
密钥获取
OpenAI 兼容
用上方的 Key / Base URL + 转写模型
需下载视频再上传，限 25MB
填好后点「测试转写」，插件会用一段几秒的公开示例音频跑完整链路，约需 10–60 秒。
开启逐字稿后的笔记效果：视频嵌入、「在抖音中打开」原链接，以及含「📌 要点」与整理后全文的「视频逐字稿」折叠块。
视频逐字稿折叠块
视频逐字稿折叠块
开启图片转文字后的笔记效果：「图片文字」折叠块按「图 1、图 2」分节列出识别结果。
图片文字折叠块
图片文字折叠块

三、开始同步

自动同步

插件启用后会按设定的间隔自动同步，无需手动操作。

手动同步

两种方式触发手动同步：
  1. 点击左侧栏抖音图标
  1. 命令面板：按 Cmd + P（macOS）或 Ctrl + P（Windows），搜索「立即同步」

同步进度

  • 同步过程中会在右上角弹出提示（如「收藏：同步了 5 条」）
  • 在插件设置页可以看到每种类型的已同步数量和状态：
    • 历史数据同步中... — 正在拉取历史数据
    • 历史数据同步完成，开始增量同步 — 历史数据已全部同步，后续只拉取新增内容
  • 同步收藏时，设置页还会显示「当前收藏夹」，告诉你轮转到了哪一个、已完成几个
设置页不会自动刷新，同步完成后关掉再打开才能看到最新数字。

四、同步内容说明

目录结构

笔记格式

每篇笔记包含：
  • YAML 属性：resourceId、类型、作者、链接、点赞/收藏/评论数、时长、形式（图文/视频）、标签、分类、发布时间、收藏时间、同步时间
  • 正文：视频描述全文
  • 配图：图文笔记嵌入全部图片；视频笔记嵌入封面（画廊卡片图依赖它）
  • 视频：默认嵌入远程播放器；打开「下载视频到本地」后改为本地嵌入
  • 原链接：始终保留「在抖音中打开」
  • AI 区块：图片文字 / 视频逐字稿以折叠 callout 附在末尾

画廊视图（Bases）

首次同步完成后，插件会在根目录自动生成 🎵 抖音.base，包含 5 个视图：
视图
用途
🖼 画廊
按同步时间倒序的封面墙
🗂 分类画廊
按分类分组的封面墙
🔥 爆款画廊
按点赞数排序，取前 60 条
📋 全部
表格视图，含类型/分类/作者/形式/点赞/时长
📅 最近 7 天
最近一周同步的内容
视图已存在时不会被覆盖，你可以放心按自己的习惯修改。如果改坏了或者改了根目录名，用命令面板搜索「重建抖音画廊视图」恢复默认模板。

五、常见问题

Q：提示「抖音签名不可用」或「登录已失效」？
插件是借抖音网页版自己的安全模块完成接口签名的，所以必须处于已登录状态。点击设置中的「登录抖音」重新扫码登录即可。登录失效时插件会自动关闭定时同步，重新登录后记得回设置页把「定时自动同步」打开。
Q：提示「抖音风控拦截」，同步停了？
请求太频繁会触发抖音风控，插件检测到后会自动关闭定时同步，避免继续无效请求把账号拖进更严的风控。建议隔一段时间再在设置页打开「定时自动同步」，并把间隔调大、每批数量调小。
Q：画廊视图里没有缩略图？
画廊卡片图取自笔记里嵌入的第一张图片。确认「下载封面到本地」是开启的，且 Douyin/Media/{视频ID}/ 下有 cover.* 或 image-* 文件。另外需要 Obsidian 1.9 及以上版本才有 Bases 功能。
Q：收藏同步很慢，好久才轮到某个收藏夹？
抖音的收藏按收藏夹逐个轮转同步，每次同步只处理一个收藏夹的一页。收藏夹多的话确实需要跑若干轮。只关心其中几个的话，用「收藏夹白名单」勾选，其他的会被跳过。
Q：「点赞」同步不到内容？
抖音默认把喜欢列表设为私密。需要在抖音 App 里进入「设置 → 隐私设置 → 喜欢列表」，改为公开，插件才拿得到。
Q：想重新同步所有数据？
在插件设置中点击「清除缓存并重新同步」按钮。这只会重置同步记录（含收藏夹轮转进度），不会删除已有的笔记文件，重新同步时会覆盖更新。
Q：切换了抖音账号怎么办？
插件会自动检测账号切换：旧账号的同步进度会被保存起来，切回去时自动恢复；全新账号则从头开始同步。无需手动操作。切换后记得重新点「刷新收藏夹列表」。
Q：同步间隔设多少合适？
建议 10 分钟以上，每批 5 条。设太短或太多容易触发抖音风控。
Q：视频链接点开是坏的？
抖音的视频直链有时效，过期后就播不了了。想长期保存请打开「下载视频到本地」。笔记里的「在抖音中打开」链接指向原视频页，永远有效。
Q：AI 分类没生效？
检查三件事：① 分类列表不能为空；② API Key / Base URL / 文本模型填全并「测试连接」通过；③ 该内容本来就有收藏夹归属的话，插件不会用 AI 覆盖人工分类——这是设计如此。
Q：如何更新插件？
用 BRAT 安装的会跟随 GitHub Release 自动更新。安装包方式安装的，下载新版本的 douyin2obsidian.zip，解压后覆盖 .obsidian/plugins/douyin2obsidian/ 目录下的文件，重新加载 Obsidian 即可。

六、购买授权码

插件提供 免费体验 10 条（收藏、个人视频、点赞共用这一个额度），达到限额后需要在设置页填入授权码继续同步。
购买地址：https://douyin.2obsidian.com
  • 永久版 ¥129（一次买断，永久使用 + 永久维护）
购买后将授权码粘贴到「设置 → Douyin Sync → 授权码」输入框中，点击「验证」即可。进度会从停下的位置接着走，已同步的不会重复也不会丢。
授权码会绑定到你当前这台设备。同一台电脑上换抖音账号、卸载重装插件都不受影响；换电脑需要联系客服解绑。

七、安全问题

🛡️ 隐私保护声明（Privacy Policy）
我们重视您的隐私，并承诺采取一切合理措施保护您的个人数据安全。请您仔细阅读以下内容，了解我们的隐私保护政策：
1. 插件运行方式
  • 本插件为纯本地工具，所有操作均在您的 Obsidian 客户端本地执行，不会将任何数据发送至第三方服务器。
  • 插件不会收集、存储或分析您的抖音账户信息、内容数据或登录凭证。
  • 本插件仅作为个人知识库工具使用。
2. 数据访问权限
  • 插件运行时会读取您已登录账号下的内容（例如您的收藏、发布的作品或点赞），以便将您主动选择的信息同步至 Obsidian Vault。
  • 插件不会主动抓取、储存或分发任何非您本人页面或受保护数据。
3. 第三方平台说明
  • 插件通过 Obsidian 官方 API 写入本地 Vault，仅在您本地设备上与 Vault 交互。
  • 若您启用了 AI 分类 / 图片转文字 / 视频逐字稿，相应内容会发送到您自己配置的 AI 服务商，这部分由您自行选择与授权，插件不经手也不留存。
  • 所有同步动作由用户发起，插件不会在未授权的情况下执行任何数据传输行为。
4. 本地存储说明
  • 插件会在本地存储用户配置项（如同步偏好设置、AI 凭证），这些信息仅保存在您本地 Vault 的插件目录中，不会被上传或远程保存。
  • 抖音登录态保存在插件独立的浏览器分区中，与您的系统浏览器隔离。
⚠️ 使用免责声明（Disclaimer）
1. 第三方平台责任
本插件为独立开发工具，与抖音及 Obsidian 官方无任何隶属关系。所有商标与内容归各平台所有。
用户在使用本插件过程中，应遵守各平台的使用条款，不得进行非法抓取、批量爬取、账号共享等违规行为。如用户行为违反平台政策或法律法规，由用户自行承担责任。
2. 功能范围说明
  • 本插件定位为协助用户搭建个人知识库的工具，仅用于将用户本人账号下的抖音收藏、作品、点赞等内容整理同步到本地 Obsidian Vault，方便用户在自己的知识体系中检索与回顾。
  • 严禁将本插件用于任何形式的数据爬取、批量抓取他人内容、二次分发或商业化数据采集。若用户将插件用于上述用途，由用户自行承担全部法律与平台责任，开发者不提供任何支持。
  • 插件依赖用户在插件内登录并授权后方可使用，若平台接口或页面结构发生变化导致插件无法运行，请联系开发者反馈，由开发者进行后期的跟进维护。
3. 使用风险提示
用户使用插件过程中所产生的任何同步行为，均为用户主动触发。请用户自行评估数据内容的敏感性，合理使用插件。

八、联系与反馈

https://blog.notionedu.com/1b373415a27980b1b249eab49061527f
抖音同步到 Notion（授权码通用）：douyin.2notion.com
上一篇
小红书【个人帖子+点赞+收藏】同步到Obsidian 使用指南
下一篇
X/Twitter【推文+书签+AI分类】同步到Obsidian 使用指南
Catalog