📦 Bilibili — 哔哩哔哩

功能概述

此 Skill 用于下载 Bilibili 用户个人的收藏夹视频，支持批量下载、大小过滤、最高清晰度等功能。

使用场景

• 备份收藏夹 – 将收藏的 Bilibili 视频下载到本地
• 离线观看 – 下载视频以便离线观看
• 整理收藏 – 获取收藏视频列表并导出

前置要求

• Python 3.7+
• yt-dlp（会自动检查并提示安装）
• 网络连接

Script Directory

将本 SKILL.md 所在目录记为 {baseDir}。

| Script | Purpose | | ----------------------------- | ------------------------------ | | {baseDir}/scripts/download_favorites.py | 主 Python 脚本入口 |

使用方法

基本用法

用户只需提供个人收藏夹 URL 或收藏夹 ID，工具自动完成其余工作： 请提示用户在网页登录 www.bilibili.com，进入个人收藏夹，把浏览器地址栏的收藏夹 URL 复制给 AI。

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

Run Script Examples with Params

基础使用（下载收藏夹，默认 500 MB 大小限制，推荐首次使用）

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

日常使用（推荐配置，限制 300 MB 大小，指定输出目录）

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

仅获取视频列表（不下载视频）

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

限制下载数量（只下载前 10 个视频）

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

参数说明

| 参数 | 说明 | 默认值 | | ------------------- | ------------------------------ | ------------------------------------------ | | --url | Bilibili 收藏夹页面 URL | 必需参数 | | --size-limit | 视频大小限制（MB），超过则跳过 | 500 | | --output-dir | 自定义下载输出目录 | ~/Downloads/bilibili_favorites/ | | --list-only | 仅获取视频列表，不下载视频 | False | | --max-download | 最大下载视频数量 | 无限制（下载全部） | | --skip-existing | 跳过已存在的视频文件（脚本默认行为）| True（无需指定） |

支持的 URL 格式

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

工作流程

• 解析收藏夹信息 – 从 URL 提取用户 ID 和收藏夹 ID
• 获取视频列表 – 调用 Bilibili API 获取所有收藏视频（支持分页）
• 估算视频大小 – 使用 yt-dlp 获取视频信息并估算大小
• 过滤视频 – 根据大小限制过滤视频
• 批量下载 – 使用 yt-dlp 下载视频，自动合并音视频
• 生成报告 – 输出下载统计信息

输出说明

下载的视频保存为 MP4 格式，文件名格式： ` {视频标题}_{BV号}.mp4 ``

注意事项

• 下载的视频仅供个人学习使用
• 请遵守 Bilibili 用户协议和相关法律法规
• 部分高清晰度视频需大会员才能下载
• 失效视频自动跳过并记录

故障排除

无法获取视频列表

• 检查收藏夹是否公开
• 检查网络连接
• 确认收藏夹 ID 正确

下载速度慢

• 正常现象，取决于视频大小与网络状况
• 工具支持断点续传，可随时中断并继续

视频下载失败

• 可能视频已失效或被删除
• 可能网络问题，可重新运行脚本