Bilili-downloader

核心用法

bililidownloader 是一款基于 Python 的 Bilibili 视频下载工具，通过调用 yt-dlp 实现视频解析与下载。使用时必须先向用户询问视频 URL，再通过命令行脚本执行下载。支持基础单视频下载（--no-batch）和智能系列视频批量下载（--batch）两种模式，可指定视频格式与清晰度。

显著优点

• 自动化程度高：能智能检测 B 站合集/分 P 视频，自动识别系列内容总数
• 灵活可控：提供格式选择、清晰度筛选，支持批量/单视频切换
• 进度可视：实时显示下载进度，完成后主动反馈状态
• 生态成熟：基于 yt-dlp 方案，对 B 站解析兼容性较好

潜在缺点与局限性

• 前置依赖重：需要 Python ≥3.6、yt-dlp、ffmpeg 三者同时安装，环境配置门槛较高
• Cookie 依赖：VIP 专属内容、地区限制视频需提供有效 Cookie 才能下载
• 网络波动敏感：下载速度受 B 站 CDN 及本地网络双重影响，大文件易中断
• 合规边界模糊：工具本身仅作"个人学习备份"声明，但实际使用可能触及平台 ToS

适合人群

• 需要离线备份收藏 B 站教学/纪录片内容的个人用户
• 有基础命令行操作能力、能自行解决依赖安装的技术用户
• 对视频画质/格式有特定要求的二次创作者（需配合剪辑工作流）

常规风险

• 版权风险：下载受版权保护或 UP 主声明禁止转载的内容可能引发纠纷
• 账号风险：高频/大量下载可能触发 B 站反爬机制，导致 IP/账号临时封禁
• 安全风险：脚本执行路径写死为开发者本地绝对路径（/Users/dongchao/.nvm/...），若在其他环境复用需手动修改，存在路径注入或误执行风险

核心用法

Bilibili视频下载器是一款调用 yt-dlp 外部工具实现 B 站视频获取的自动化技能。用户需提供完整的 B 站视频 URL，系统将智能解析链接类型（单视频/合集），并可选择批量下载模式。通过 --batch 参数可自动识别系列视频并逐一下载，支持清晰度选择与进度实时显示。

显著优点

• 功能聚焦：专精 B 站生态，深度适配 BV 号、合集列表等链接格式
• 批量能力：一键下载系列视频，省去逐条复制链接的繁琐操作
• 成熟依赖：底层调用 yt-dlp，该项目历经多年迭代，对国内视频站点支持良好
• 轻量透明：代码仅 400 余行，无冗余功能，易于审计

潜在局限与风险

• 外部依赖强耦合：必须预装 yt-dlp 与 ffmpeg，环境配置成本较高
• 来源可信度一般：维护者为个人开发者（T3），长期维护承诺不确定
• subprocess 调用风险：虽使用参数列表避免 shell 注入，但用户输入 URL 未做严格白名单校验
• 合规灰色地带：下载受版权保护内容可能违反 B 站用户协议，存在账号风险
• 网络依赖：yt-dlp 需频繁更新以适配 B 站 API 变动，否则可能解析失败

适合人群

• 需要离线观看 B 站课程、教程的技术学习者
• 希望备份个人上传视频的 UP 主
• 具备基础 Python 环境配置能力的开发者

常规风险

• 账号封禁：频繁或大量下载可能触发 B 站反爬机制
• 版权争议：下载未经授权的影视、番剧等内容存在法律风险
• 供应链风险：yt-dlp 本身为外部二进制，若被篡改将直接影响本工具安全性
• 路径遍历：输出文件名包含视频标题，虽 yt-dlp 内置过滤，但仍建议启用 --restrict-filenames