抖音【收藏+作品+点赞】同步到 Obsidian 使用指南

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

1. 登录抖音

1. 点击「登录抖音」按钮
2. 在弹出的窗口中扫码登录你的抖音账号
3. 看到自己的头像后，点击窗口右上角的「登录完成」按钮
4. 看到提示「抖音登录成功」即可

2. 同步设置

收藏夹白名单（按需同步指定收藏夹）

抖音的收藏是按收藏夹组织的，插件会逐个收藏夹轮转同步：每次同步处理一个收藏夹的一页，该收藏夹拉完后自动切到下一个。收藏夹多的话全量同步需要跑若干轮。

如果只想同步其中几个：

1. 把「同步内容」切到收藏
2. 点击「刷新收藏夹列表」，插件会拉取你当前账号下的全部收藏夹
3. 在列表里勾选要同步的收藏夹（可多选），勾选立即生效，无需保存

规则：

• 不勾选任何一个 = 同步全部收藏夹
• 勾选 N 个 = 只同步这 N 个，其他收藏夹跳过
• 列表末尾的「默认收藏」是虚拟收藏夹，代表你收藏了但没放进任何收藏夹的视频，同样可以勾选
• 白名单改动后，当前轮转位置会复位，下次同步从白名单里的第一个收藏夹重新开始
• 切换账号后需要重新点「刷新收藏夹列表」

下载视频到本地（默认关闭）

抖音的视频直链（play_addr）有时效，过期后远程播放器就放不出来了。如果你希望长期保存，打开「下载视频到本地」开关，视频会下载到 Douyin/Media/{视频ID}/video.mp4，笔记里以 ![[…]] 本地嵌入，可在 Obsidian 内直接播放。

注意事项：

• 抖音单条视频通常 5–30MB，开启后磁盘占用会显著上升，按需开启
• 关闭时笔记里嵌入远程播放器；无论开关如何，笔记里始终保留「在抖音中打开」的原视频页链接，链接过期也能回源
• 单条视频下载失败（超时 / 链接失效）会自动回退成远程链接，不阻塞笔记生成

3. AI 模型配置（可选）

AI 分类、图片转文字、逐字稿整理三个功能共用同一套凭证：

1. 填写 API Key、API Base URL（必须带 /v1）、文本模型
2. 点击「测试连接」确认配置可用
3. 如果要用图片转文字，另外填写 视觉模型（需支持图片输入的多模态模型），点「测试识图」验证

支持的 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 分类」开关
2. 逐个输入分类名并按回车添加，或点击「从收藏夹目录加载」， 把 Douyin/Bookmarks/ 下已有的收藏夹目录一键读成分类列表
3. 分类列表为空时 AI 分类不会生效

5. AI 识别（可选）

转写服务商（四选一，前三家都是把视频 URL 交给云端拉取，本地不上传文件，因此不受视频大小限制）：

自动同步

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

手动同步

两种方式触发手动同步：

1. 点击左侧栏抖音图标
2. 命令面板：按 Cmd + P（macOS）或 Ctrl + P（Windows），搜索「立即同步」

同步进度

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

目录结构

Douyin/
├── 🎵 抖音.base            ← 自动生成的画廊视图
├── Bookmarks/              ← 收藏
│   ├── 收藏夹名A/          ← 每个收藏夹一个子目录
│   │   └── 笔记.md
│   └── 默认收藏/           ← 收藏了但没分组的
│       └── 笔记.md
├── Posts/                  ← 个人视频
│   └── 笔记.md
├── Likes/                  ← 点赞
│   └── 笔记.md
└── Media/                  ← 封面 / 图片 / 视频
    └── {视频ID}/
        ├── cover.jpeg      ← 视频笔记封面
        ├── image-1.webp    ← 图文笔记的图片
        └── video.mp4       ← 仅在「下载视频到本地」打开时生成

笔记格式

每篇笔记包含：

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

画廊视图（Bases）

首次同步完成后，插件会在根目录自动生成 🎵 抖音.base，包含 5 个视图：

插件提供 免费体验 10 条（收藏、个人视频、点赞共用这一个额度），达到限额后需要在设置页填入授权码继续同步。

购买地址：永久版 ¥129（一次买断，永久维护）

购买后将授权码粘贴到「设置 → Douyin Sync → 授权码」输入框中，点击「验证」即可。 达到限额后停下的进度会从原位置接着走，已同步的不会重复也不会丢。

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

抖音同步到 Notion（授权码通用）：douyin.2notion.com