B站与视频网站下载器（yt-dlp）

解决什么问题

工程师在自动化流程、内容存档或离线回放场景中，经常需要从 B 站或其他支持站点抓取单个视频文件。直接把网页链接交给脚本不够，因为视频通常拆成音视频流，画质选择、登录态、分 P 逻辑都会影响最终产物。本技能把 yt-dlp 的下载、选流和 ffmpeg 合并封装成明确流程，减少手动拼参数的成本。

技能如何工作

技能通过 scripts/download_video.py 执行下载，核心步骤包括：

• 确认保存目录：目录不存在时自动创建，最终文件按视频标题命名。
• 选择画质：默认取最高可用，也可指定 1080、720、480 或 audio。
• 下载并合并：脚本自动安装 yt-dlp，选择格式并调用 ffmpeg 合并为 .mp4。
• 校验结果：完成后检查目标目录是否生成以标题命名的 MP4 文件，并返回完整路径。

对于 b23.tv 短链、带 ?t= 的 B 站链接，可直接传入，不必截取播放进度参数。需要大会员或高码率时，可传入 cookies 文件路径解锁更高画质。

适用边界

该技能默认只下载当前单个视频，分 P 整组需要调整 noplaylist 设置。番剧、会员专享、强鉴权或受版权限制的内容可能失败。环境需要 Python 3.10+ 和 ffmpeg；缺少 ffmpeg 时合并阶段会报错。遇到无法下载的情况，应如实说明限制，而不是虚构已保存文件。