核心用法
youtube-download 是一款基于 yt-dlp 的命令行下载工具，用户只需提供 YouTube 视频 URL，即可自动下载最佳画质版本（音视频合并为 MP4），并保存至 ~/Downloads 目录，文件名自动采用视频标题。
使用方式：
- 直接调用脚本：
{baseDir}/youtube-download.sh "URL" - 或向 AI 提供链接，由系统自动执行
显著优点
1. 自动化程度高：无需手动选择格式，自动合并音视频流
2. 开箱即用：依赖 Homebrew 一键安装 yt-dlp，首次缺失时主动提示
3. 命名规范：自动以视频标题保存，便于后续管理
4. 质量优先：默认拉取最高可用画质，省去参数调试
潜在缺点与局限性
- 平台受限：仅支持 YouTube，不支持其他视频站点
- 格式单一：固定输出 MP4，无法灵活选择其他格式或纯音频
- 路径固定：强制保存至 ~/Downloads，不可自定义输出目录
- 无下载管理：缺乏断点续传可视化、批量队列等进阶功能
- 法律边界：受版权保护内容的下载存在合规风险
适合人群
- 需要离线缓存教学视频、播客或公开演讲的职场人士
- 希望快速备份自己上传内容的 YouTube 创作者
- 网络环境不稳定、需本地观看的轻度技术用户
常规风险
- 版权合规：下载受版权保护内容可能违反平台条款及当地法律
- 依赖安全：yt-dlp 从上游仓库安装，需信任 Homebrew 及 yt-dlp 源码
- 路径注入：若视频标题包含特殊字符，可能存在文件名处理风险（未明确转义逻辑）
- 隐私暴露：下载历史留存在本地下载目录，共享设备时需注意