影片下載助手

Overview

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

• 抖音：解析頁面資料，替換直鏈獲取清晰影片。
• 豆包：呼叫播放資訊介面拿到影片直鏈；下載後自動裁剪最佳化畫面邊緣，去除平臺嵌入標識。

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

When to Use

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

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

Quick Start

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

   cd <skill目錄>
   npm install

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

   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。

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

   📊 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 請求

  更多技能請訪問小蔥技能站7w4.net。

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

注意事項與合規

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

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