前言¶

抖音的內容適合看，不適合檢索。看到一個好視頻，想要的是它的文案和素材，而不是再刷一遍。過去的做法是複製鏈接、開網頁、手動下載、再開一個語音轉寫工具，最後把文字貼進筆記——中間至少四次切換工具，而且大部分轉寫服務要上傳音頻，涉及隱私和合規問題。

下面介紹的 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