核心用法
youtube-audio-download 是一款用于下载 YouTube 视频音频并自动转换为 MP3 格式的工具技能。用户通过提供 YouTube 视频 URL 即可触发下载，支持通过 cookies.txt 绕过年龄限制等访问控制。输出文件默认保存至 Windows 工作目录 works/audio/ 路径下。
典型调用方式为 Python 脚本执行：
python scripts/download_audio.py <URL> [--cookies cookies.txt] [--output-dir dir]
返回标准化 JSON 包含下载状态、音频路径、视频标题、时长及文件大小等元数据，便于后续自动化流程集成。
显著优点
1. Cookie 绕过机制：支持导入浏览器 cookies 突破年龄限制，扩展可访问内容范围
2. 工作流集成设计：明确嵌入 YouTube 翻译四步工作流（下载→启动翻译→播放→捕获字幕），体现场景化设计
3. 跨平台执行架构：通过 WSL 调用 Windows Python 解释器，兼顾 Linux 环境便利与 Windows GUI 自动化需求
4. 结构化输出：JSON 标准化返回便于程序解析，错误码与消息分离利于调试
潜在局限
- 法律合规风险：YouTube 服务条款明确禁止未经授权下载，可能面临账号封禁或法律追责
- DRM 与地域限制：部分音乐内容受版权保护系统（Widevine等）限制，工具可能无法处理
- Cookie 安全性：cookies.txt 包含敏感会话凭证，明文存储存在泄露风险
- 单点故障依赖：工作流强耦合 Doubao 翻译服务，任一环节失效导致全流程中断
适合人群
- 需要离线收听 YouTube 内容的个人用户
- 构建视频翻译自动化工作流的内容创作者
- 具备基础 Python/命令行操作能力的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 版权侵权 | 下载受版权保护内容可能违反 DMCA 及各地著作权法 |
| 账号安全 | 使用个人 cookies 可能因异常活动触发 Google 安全机制 |
| 恶意代码 | 第三方下载工具（如 yt-dlp）存在供应链攻击可能性 |
| 隐私泄露 | 视频观看历史、cookie 数据可能被记录或传输 |
建议仅在获取内容授权或属于合理使用范畴（如无障碍访问、教育用途）时启用本技能。