前言¶

抖音的内容适合看，不适合检索。看到一个好视频，想要的是它的文案和素材，而不是再刷一遍。过去的做法是复制链接、开网页、手动下载、再开一个语音转写工具，最后把文字贴进笔记——中间至少四次切换工具，而且大部分转写服务要上传音频，涉及隐私和合规问题。

下面介绍的 douyin-obsidian 把这个链路压成一步：粘贴分享链接，它自己判断内容类型，无水印下载视频或图片，用 faster-whisper 在本地转写出逐字稿，最后产出 transcript.md 和媒体文件，可以直接归档到 Obsidian 之类的本地知识库。音频全程不出本机，不需要 API Key。

这是什么¶

douyin-obsidian 是一个社区来源的通用 Skill，坐标 @user_65a37cc8/douyin-obsidian，版本 1.0.0，发布者 user_65a37cc8，分类 knowledge-management。它解决的问题是：拿到抖音分享链接后，把视频/图文的内容和素材一起落到本地，形成可检索的笔记，而不是只留一个打不开的链接。

标签里有一项 requires_api_key=false，这决定了它的核心取舍：转录用本地 faster-whisper，代价是首次运行要下载模型、对机器有一定算力要求；换来的是音频不离开本机，也不依赖第三方收费接口。

核心功能¶

按官方简介和 Skill 说明，能力有四块。

1、短链和长链都能处理。v.douyin.com 短链和 www.douyin.com 长链都支持，不需要用户手动展开短链。

2、自动区分视频和图文。脚本会先尝试常规解析；如果抖音的反爬外壳把标准解析挡住了，会退化为真实浏览器抓取。这条兜底路径是它和直接写脚本的区别所在。

3、无水印下载 + 本地转录。视频下载无水印，同时抽出音频，交给 faster-whisper 本地转录，不调用任何需要 Key 的云端接口。

4、产出结构化文件。结果是一个 transcript.md 加上对应的媒体文件，可以直接放进 Obsidian 库，后续用 Obsidian 的全文搜索去查文案。

触发词覆盖了常见口语说法，包括：抖音转文字、提取抖音文案、下载这个抖音视频、保存抖音图文、转存到 Obsidian、把这个抖音存到知识库、扒一下这个抖音、批量下载抖音。

安装与启用¶

官方页面是 https://www.skillhub.cn/skills/user_65a37cc8/douyin-obsidian ，SkillHub 上归类在 knowledge-management，来源标记为 community，即社区发布而非官方维护。安装入口和安装命令需要以该页面为准——本次写作抓取的快照里没有包含安装命令和各宿主（Cursor / Codex CLI / Claude Code）的差异说明，所以这里不替官方补写命令，避免给出无法核对的内容。

拿到安装后的 Skill 后，启用方式是按它的触发词发起请求，把分享链接一起给到：

保存抖音图文 <分享链接> 到 Obsidian

运行环境需要满足两点：能访问抖音（必要时走真实浏览器兜底，意味着需要可用的浏览器环境），以及本地能跑 faster-whisper。faster-whisper 首次运行会拉取模型，建议在有网络和足够磁盘的空间下执行。

典型用法¶

以一条抖音图文分享为例，流程如下。

1、复制抖音App里的分享链接，通常是 v.douyin.com/xxx 形式。

保存抖音图文 https://v.douyin.com/xxxxxxxx/ 转存到 Obsidian

2、Skill 先解析链接，判断这是视频还是图文。图文会走图片下载路径，视频会走视频下载 + 抽音频 + 转录路径。

3、常规解析被反爬外壳挡住时，退化为真实浏览器抓取，这一步不需要用户干预。

4、转录完成后，本地生成 transcript.md 和媒体文件，媒体文件名与笔记对应，可以直接拖进 Obsidian 库或用库的附件目录管理。

视频场景的触发方式一致，换成视频的触发词即可：

下载这个抖音视频 https://www.douyin.com/video/xxxxxxx 扒一下这个抖音

批量场景按官方给出的触发词是同一句话里带「批量下载抖音」，实际批量规模取决于单次运行能拿到多少条链接，这一点官方资料没有展开，不做推断。

适用场景与注意¶

适合三类人：一是用 Obsidian 或类似本地库做素材积累的人，想要视频文案而不是再刷一遍；二是在意音频隐私、不接受把录音交给云端转写服务的人；三是希望一条命令替代多个工具来回切换的开发者。

需要注意的地方有四条。

1、算力在本地。faster-whisper 跑得动与否取决于本机 CPU/GPU，长视频会明显更慢，官方资料没有给出速度或时长上限的指标。

2、反爬是常态。抖音的反爬外壳是动态的，兜底的真实浏览器抓取意味着这条链路依赖页面当时的可访问性，不保证长期稳定。

3、合规自行判断。下载他人作品并转存到知识库，涉及版权和平台条款，用之前确认自己有相应的使用权限。

4、数据以官方页面为准。本次写作抓取的 SkillHub 快照显示评分 100000、下载 1158、安装 0；不同时间抓取的快照数值可能不同，以官方页面实时数据为准。

结尾¶

douyin-obsidian 的价值在于把「下载 + 转录 + 归档」三步合成一次请求，并且把转录留在本地。它不是通用下载器，定位很明确：抖音分享链接进，带逐字稿和媒体文件的笔记出，适合知识库场景。

官方地址：https://api.skillhub.cn/user_65a37cc8/douyin-obsidian