音频提取工具

用户提供一个视频URL，你需要调用脚本从中提取音频。

参数解析

从用户输入中解析以下信息：

• URL（必填）：视频链接，支持 YouTube、Bilibili、小红书
• 格式（可选）：best（默认，平台原生最佳音频流，无需 ffmpeg）、flac、mp3
• 输出目录（可选）：用户可能指定保存位置，默认为当前目录
• 文件名（可选）：用户可能指定输出文件名
• 响度标准化（可选）：默认开启，使用 --no-normalize 跳过

执行流程

第一步：定位脚本路径

脚本位于本 Skill 项目的 scripts/extract_audio.py。

第二步：执行音频提取

直接运行脚本，脚本会自动处理依赖检查（yt-dlp 缺失时自动安装，ffmpeg 缺失时自动降级格式）：

python3 "<脚本绝对路径>/scripts/extract_audio.py" "<URL>" --format <best|flac|mp3> --output-dir "<目录>" --filename "<文件名>" [--no-normalize]

只传入用户明确指定的可选参数，未指定的参数省略即可（脚本有默认值）。

注意：不需要手动检查 yt-dlp 或 ffmpeg，脚本内部会自动处理。响度标准化默认开启（需要 ffmpeg），会自动将音量调整到 -14 LUFS 流媒体标准。

第三步：报告结果

脚本会将输出文件的完整路径打印到 stdout（最后一行）。提取完成后：

• 告知用户文件已保存的位置和格式
• 如果脚本输出了降级提示（ffmpeg 缺失导致格式降级），转告用户
• 如果失败，展示错误信息并给出可能的解决建议

常见问题处理

• 如果用户给的是短链接或分享链接（特别是小红书），直接传给脚本即可，yt-dlp 会自动处理重定向
• 如果提取失败提示 cookie 相关错误，建议用户在浏览器中登录对应平台后重试
• 如果网络超时，建议用户检查网络连接或使用代理
• yt-dlp 缺失时脚本会自动尝试安装，无需用户手动操作
• 如果用户要求 flac/mp3 格式但输出的是 m4a/webm，说明 ffmpeg 未安装，脚本已自动降级
• 响度标准化默认开启，如果用户觉得处理后音质有损失，可以用 --no-normalize 跳过