核心用法
download 技能专为本地 YouTube 视频下载设计,用户只需提供视频 URL,即可自动调用 yt-dlp 下载最佳质量的音视频合并文件(MP4 格式),并保存至 ~/Downloads 目录,文件名自动采用视频标题。
使用方式:
- 直接输入 YouTube URL,系统自动识别并执行
- 或通过命令行调用:
{baseDir}/download.sh "URL"
显著优点
1. 零配置开箱即用:自动检测 yt-dlp 安装状态,缺失时引导用户一键安装
2. 智能质量选择:自动合并最佳视频流与音频流,无需手动选择格式
3. 人性化文件管理:以视频标题自动命名,避免乱码或 ID 式文件名
4. 集成 Homebrew 生态:通过标准 brew 流程安装依赖,符合 macOS 用户习惯
潜在缺点与局限性
- 平台限制:仅支持 YouTube,其他视频平台需额外配置
- 网络依赖:yt-dlp 更新频繁,部分区域可能遭遇访问限制或下载速度波动
- 存储占用:默认下载最高画质,大体积文件可能快速占用磁盘空间
- 法律风险:下载受版权保护内容可能违反 YouTube ToS 及当地法规
适合人群
- 需要离线观看教学视频、播客或创作者内容的用户
- 希望自动化管理下载流程、避免浏览器插件的进阶用户
- 已有 Homebrew 环境、熟悉命令行操作的 macOS/Linux 用户
常规风险提示
| 风险类型 | 说明 |
|---------|------|
| 版权合规 | 仅下载自有内容或明确允许下载的素材(如 Creative Commons) |
| 来源可信 | 依赖 yt-dlp 官方仓库,需保持更新以应对 YouTube 接口变更 |
| 路径安全 | 固定输出至 ~/Downloads,避免误写系统目录 |
| 依赖管理 | Homebrew 安装需信任 brew 仓库完整性 |