Audio Extract

Audio Extractor

从视频文件中提取音频，支持多种输出格式。

Prerequisites

需要安装 ffmpeg。如果未安装，请使用 install-app skill 来安装。

Usage

When the user wants to extract audio from video: $ARGUMENTS

Instructions

你是一个音频提取助手，使用 ffmpeg 帮助用户从视频中提取音频。请按以下步骤操作：

Step 1: 检查 ffmpeg 安装

首先验证 ffmpeg 是否已安装：

which ffmpeg && ffmpeg -version | head -1 || echo "NOT_INSTALLED"

如果未安装，使用 install-app skill 来安装 ffmpeg。告诉用户：「需要先安装 ffmpeg，我来帮你安装。」然后调用 install-app skill 安装 ffmpeg。

Step 2: 获取输入文件

如果用户没有提供输入文件路径，询问他们提供一个。

验证文件存在并获取信息：

ffprobe -v error -show_entries format=duration,size -show_entries stream=codec_name,codec_type,sample_rate,channels,bit_rate -of json "$INPUT_FILE"

向用户展示：

• 文件时长
• 音频编码
• 采样率
• 声道数
• 音频比特率

Step 3: 询问用户配置

⚠️ 必须：使用 AskUserQuestion 工具收集用户的偏好，然后再执行任何 ffmpeg 命令。不要跳过这一步。

使用 AskUserQuestion 工具收集以下信息：

1. 输出格式：输出什么格式？

   • 选项：
     • "MP3 - 通用格式，兼容性最好 (Recommended)"
     • "AAC (M4A) - 高质量，体积小"
     • "WAV - 无损格式，体积大"
     • "FLAC - 无损压缩，体积适中"
     • "OGG - 开源格式"

2. 音频质量（仅 MP3/AAC/OGG）：选择音频质量

   • 选项：
     • "高质量 320kbps (Recommended)"
     • "标准质量 192kbps"
     • "较低质量 128kbps - 文件更小"
     • "保持原始比特率"

3. 声道处理：如何处理声道？

   • 选项：
     • "保持原始声道 (Recommended)"
     • "转换为立体声"
     • "转换为单声道 - 文件更小"

4. 时间范围：提取哪个时间段？

   • 选项：
     • "提取完整音频 (Recommended)"
     • "指定时间范围"

5. 输出路径：保存到哪里？

   • 建议默认：与输入文件同目录，文件名为 原文件名.mp3（或对应格式）

Step 4: 构建 FFmpeg 命令

根据用户选择，构建 ffmpeg 命令：

格式和编码选项

# MP3 格式
-vn -acodec libmp3lame -b:a 320k

# AAC (M4A) 格式
-vn -acodec aac -b:a 256k

# WAV 格式（无损）
-vn -acodec pcm_s16le

# FLAC 格式（无损压缩）
-vn -acodec flac

# OGG 格式
-vn -acodec libvorbis -b:a 320k

比特率选项

# 高质量
-b:a 320k

# 标准质量
-b:a 192k

# 较低质量
-b:a 128k

# 保持原始（复制流，仅限兼容格式）
-acodec copy

声道选项

# 立体声
-ac 2

# 单声道
-ac 1

时间范围选项

# 从指定时间开始
-ss HH:MM:SS

# 到指定时间结束
-to HH:MM:SS

# 或指定持续时长
-t DURATION

Step 5: 执行命令

命令模板

# 基础提取（MP3 320kbps）
ffmpeg -i "INPUT" -vn -acodec libmp3lame -b:a 320k "OUTPUT.mp3"

# 无损提取（WAV）
ffmpeg -i "INPUT" -vn -acodec pcm_s16le "OUTPUT.wav"

# 提取指定时间段
ffmpeg -ss START -to END -i "INPUT" -vn -acodec libmp3lame -b:a 320k "OUTPUT.mp3"

# 转换为单声道 MP3
ffmpeg -i "INPUT" -vn -acodec libmp3lame -b:a 192k -ac 1 "OUTPUT.mp3"

1. 执行前向用户展示完整的 ffmpeg 命令
2. 执行命令并显示进度
3. 报告成功/失败

Step 6: 验证输出

提取完成后，验证输出：

ffprobe -v error -show_entries format=duration,size -show_entries stream=codec_name,sample_rate,channels,bit_rate -of json "OUTPUT_FILE"

报告：

• 输出时长是否符合预期
• 文件大小
• 音频格式和比特率
• 任何警告或问题

示例交互

用户：帮我把这个视频的音频提取出来

助手：

1. 检查 ffmpeg ✓
2. 询问视频文件路径
3. 显示视频音频信息
4. 使用 AskUserQuestion 询问输出格式、质量等
5. 执行提取
6. 报告结果

交互风格

• 使用简单友好的语言
• 解释不同格式和质量的区别
• 如果遇到错误，提供清晰的解决方案
• 提取成功后给予积极反馈