name: bilibili-favorites-downloader description: | 下載 Bilibili 使用者個人收藏夾影片的工具。當用戶提到以下任何場景時必須使用此 Skill： - "下載 Bilibili 收藏"、"bilibili 收藏下載"、"備份 bilibili 收藏夾" - "下載 B 站收藏"、"B站收藏夾下載" - "獲取收藏影片列表"、"匯出 bilibili 收藏" - "download bilibili favorites"、"backup bilibili"

此 Skill 提供完整的 Bilibili 使用者收藏夾影片下載解決方案，包括： - 自動獲取收藏夾所有影片列表（支援分頁） - 智慧估算影片大小，支援按大小過濾 - 使用 yt-dlp 下載最高可用清晰度 - 斷點續傳，跳過已存在的檔案 - 批次下載，自動處理失效影片

Bilibili 收藏影片下載工具

功能概述

此 Skill 用於下載 Bilibili 使用者個人的收藏夾影片，支援批次下載、大小過濾、最高畫質晰度等功能。

使用場景

1. 備份收藏夾 - 將收藏的 Bilibili 影片下載到本地
2. 離線觀看 - 下載影片以便離線觀看
3. 整理收藏 - 獲取收藏影片列表並匯出

前置要求

• Python 3.7+
• yt-dlp (會自動檢查並提示安裝)
• 網路連線

Script Directory

Determine this SKILL.md directory as {baseDir}.

使用方法

基本用法

使用者只需要提供使用者個人收藏夾 URL 或收藏夾 ID，工具會自動完成其餘工作： 請提示使用者在網頁上登陸 www.bilibili.com, 進入使用者個人收藏夾， 把瀏覽器位址列收藏夾URL複製告訴AI

來源於7w4.net。

  Bilibili 收藏夾URL示例：https://space.bilibili.com/123456/favlist?fid=7890123

Run Script Examples with Params

基礎使用（下載收藏夾，預設500MB大小限制，推薦首次使用）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123"

日常使用（推薦配置，限制300MB大小，指定輸出目錄）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --size-limit 300 \
  --output-dir ~/Downloads/bilibili_favorites/

僅獲取影片列表（不下載影片）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --list-only

限制下載數量（只下載前10個影片）

python {baseDir}/scripts/download_favorites.py \
  --url "https://space.bilibili.com/123456/favlist?fid=7890123" \
  --max-download 10

引數說明

支援的 URL 格式

• https://space.bilibili.com/{user_id}/favlist?fid={fav_id}

工作流程

1. 解析收藏夾資訊 - 從 URL 中提取使用者 ID 和收藏夾 ID
2. 獲取影片列表 - 呼叫 Bilibili API 獲取所有收藏影片（支援分頁）
3. 估算影片大小 - 使用 yt-dlp 獲取影片資訊並估算大小
4. 過濾影片 - 根據大小限制過濾影片
5. 批次下載 - 使用 yt-dlp 下載影片，自動合併音影片
6. 生成報告 - 輸出下載統計資訊

輸出說明

下載的影片將儲存為 MP4 格式，檔名格式為：

{影片標題}_{BV號}.mp4

注意事項

• 下載的影片僅供個人學習使用
• 請遵守 Bilibili 使用者協議和相關法律法規
• 部分高畫質晰度影片需要大會員才能下載
• 失效影片會自動跳過並記錄

故障排除

無法獲取影片列表

• 檢查收藏夾是否為公開狀態
• 檢查網路連線
• 確認收藏夾 ID 正確

下載速度慢

• 這是正常現象，取決於影片大小和網路狀況
• 工具支援斷點續傳，可以隨時中斷並繼續

影片下載失敗

• 可能是影片已失效或被刪除
• 可能是網路問題，可以重新執行指令碼