name: swx-video-download-assistant description: 下載抖音和豆包短影片到本地的工具。當用戶輸入抖音或豆包的分享連結、或包含連結的分享文字時使用：從抖音/豆包複製分享連結發給助手，或貼上含連結的聊天文字，助手呼叫本 skill 解析影片直鏈並下載到本地（預設 ~/Downloads/影片下載）。抖音獲取清晰原畫版本；豆包下載後自動裁剪最佳化畫面邊緣、去除平臺嵌入標識。適用於把短影片儲存到本地收藏、剪輯素材、離線觀看。觸發詞：下載抖音影片、下載豆包影片、儲存這個影片、影片下載助手、抖音連結儲存、豆包影片儲存、影片儲存到本地。

影片下載助手

Overview

把抖音、豆包平臺的短影片解析並下載到使用者本地，便於收藏、二次創作與離線觀看。 純 Node 實現，自帶依賴，不依賴任何外部專案。

• 抖音：解析頁面資料，替換直鏈獲取清晰影片。

  小蔥技能有更好的技能skills外掛。

• 豆包：呼叫播放資訊介面拿到影片直鏈；下載後自動裁剪最佳化畫面邊緣，去除平臺嵌入標識。

兩平臺均無需登入態 / Cookie。

When to Use

• 使用者發來抖音或豆包的分享連結（或含連結的文字），要求儲存/下載影片
• 使用者提到「影片下載助手」「下載抖音/豆包影片」「儲存這個影片」
• 需要把短影片存到本地做素材、收藏、離線觀看

不支援：小紅書、影片號、B站、快手等其它平臺（detection 會明確報錯）。

Quick Start

1. 首次使用先安裝依賴（僅需一次）：

bash cd <skill目錄> npm install

1. 下載影片（把連結作為唯一引數傳入）：

bash node scripts/download-video.js "https://v.douyin.com/xxxxxxxx/" # 或豆包： node scripts/download-video.js "https://www.doubao.com/share/video?video_id=xxxxx" # 指定輸出目錄： node scripts/download-video.js "連結" -o /path/to/save

也可直接貼上含連結的分享文字，指令碼會自動提取第一條 URL。

1. 讀取結果：指令碼末尾會列印一行

📊 RESULT_JSON: {"type":"video","author":"...","file":"...","size":"... MB","platform":"douyin"}

解析該 JSON 即可拿到本地檔案路徑，再交付或繼續處理。

平臺細節

• 抖音解析鏈路與兜底策略見 references/douyin.md
• 豆包介面與畫面裁剪去標識見 references/doubao.md

輸出位置

預設儲存到：

~/Downloads/影片下載/抖音/...
~/Downloads/影片下載/豆包/...

可通過 -o 目錄 引數臨時指定，或用環境變數 VIDEO_OUT_DIR 自定義根目錄。

依賴說明

• axios：HTTP 請求
• ffmpeg-static：豆包畫面裁剪所需（隨包內建）。若系統安全策略攔截內建二進位制，指令碼會自動回退到 PATH 中已簽名的系統 ffmpeg，無需手動干預。

注意事項與合規

• 僅用於個人學習、收藏與合法二次創作，請尊重原作者版權與平臺服務條款，勿用於侵權傳播。
• 抖音解析依賴頁面結構，若平臺改版可能導致臨時失效，屆時需要更新解析邏輯。
• 下載失敗多為連結失效、網路限制或平臺風控，指令碼會給出明確錯誤資訊。

質量較好，操作簡單，文件清晰。主要優點是下載快、無需登入、多平臺支援；豆包去水印效果一般，畫面會損失約 8%。部分影片可能因平臺更新暫時無法下載，需要等待作者更新修復。