核心用法
yt-dlp Skill 是一个轻量级的 Bash 脚本封装器，将强大的 yt-dlp 命令行工具转化为易于调用的 Agent 技能。用户只需提供目标 URL，即可自动完成最佳质量的视频下载、音频提取或播放列表归档。核心入口为 scripts/download.sh，默认配置已优化为归档级品质：自动合并最佳视频与音频流、嵌入元数据/缩略图/多语言字幕，输出格式规范化为 标题 [ID].mp4。
支持多种使用场景：单视频下载、完整播放列表抓取、纯音频提取（MP3/AAC）、指定分辨率限制（如 1080p），以及通过浏览器 Cookie 访问年龄限制或付费内容。所有高级功能均通过原生 yt-dlp 参数透传实现，保持与上游工具的完全兼容。
显著优点
开箱即用的专业配置：默认参数经过精心调校，无需用户理解复杂的 yt-dlp 语法即可获得出版级质量的下载结果，大幅降低使用门槛。
生态兼容性极强：yt-dlp 本身支持超过 1000 个视频站点，涵盖 YouTube、Bilibili、Vimeo、Twitter/X 等主流平台，Skill 继承了这一广泛的站点支持能力。
元数据完整性：自动嵌入标题、描述、上传日期、缩略图及多语言字幕，确保归档内容的长期可检索性和信息完整性，特别适合研究者与内容创作者建立个人媒体库。
透明可控：作为纯 Bash 包装器，代码完全可读可审计，无隐藏网络请求或数据上传行为，用户可清晰了解每一步操作。
潜在缺点与局限性
外部依赖管理负担：必须预先在系统 PATH 中安装 yt-dlp 和 ffmpeg，版本不匹配或缺失会导致功能失效，对非技术用户构成门槛。
URL 安全风险：脚本直接将用户输入传递给 yt-dlp，若提供恶意构造的 URL 或参数，可能触发非预期的网络请求或文件操作，缺乏额外的输入过滤层。
Cookie 隐私隐患：--cookies-from-browser 功能虽便利，但会读取浏览器敏感会话数据，在自动化 Agent 环境中存在凭证泄露风险。
版权合规责任：工具本身中立，但用户需自行确保下载内容符合当地版权法规，Skill 未内置任何内容过滤或合规提示机制。
适合的目标群体
- 内容创作者与自媒体运营者：需要批量获取参考素材、音乐音效或研究竞品内容
- 学术研究者与教育工作者：归档公开讲座、纪录片、教育视频用于离线分析或课程备用
- 数字档案管理员：建立个人或机构的媒体资料库，注重元数据完整性与长期保存
- 技术爱好者与开发者：熟悉命令行工具，希望将 yt-dlp 集成到自动化工作流中
使用风险
依赖项安全风险：yt-dlp 和 ffmpeg 的安全性完全取决于用户的安装来源，非官方渠道可能捆绑恶意代码，需严格遵循 pip install yt-dlp 或系统包管理器安装。
网络与存储性能：高清视频下载消耗大量带宽与磁盘空间，批量操作可能触发站点速率限制或本地存储瓶颈。
法律与平台政策风险：部分站点明确禁止下载行为，频繁请求可能导致 IP 封禁或账号限制，商业用途需特别注意服务条款合规性。
自动化环境隐患：在无人值守的 Agent 环境中使用 Cookie 认证功能，可能因浏览器会话过期或异常导致认证失败，甚至暴露敏感凭证。