Audio Processor

SKILL.md

---
name: audio-processor
description: "音频处理工具集 - 支持音频录制、剪辑、格式转换、频谱分析、降噪、变速变调等操作。Use when: (1) 需要处理音频文件（录音、剪辑、合并、分割）, (2) 需要转换音频格式（MP3/WAV/FLAC/OGG等）, (3) 需要分析音频特征（频谱、音量、静音检测）, (4) 需要对音频进行效果处理（降噪、变速、变调、混响）, (5) 需要提取或生成音频元数据"
---

# Audio Processor

音频处理全能工具集，基于 Python + ffmpeg + librosa/pydub 实现。

## 核心能力

### 1. 音频格式转换
- 支持 MP3 / WAV / FLAC / OGG / AAC / M4A 互转
- 批量转换目录内音频
- 自定义比特率、采样率、声道数

### 2. 音频剪辑与合并
- 按时间码裁剪（hh:mm:ss 格式）
- 去除首尾静音段
- 多段音频合并拼接
- 淡入淡出效果

### 3. 音频分析
- 波形可视化（matplotlib）
- 频谱分析（FFT +  spectrogram）
- 音量检测（RMS / dBFS）
- BPM / 节奏检测
- 静音段检测与分割

### 4. 音频效果处理
- 降噪（spectral gating）
- 变速不变调 / 变调不变速
- 音量标准化（peak / RMS / LUFS）
- 混响、延迟效果

### 5. 音频信息提取
- 时长、采样率、比特率、声道数
- ID3 标签 / 元数据读写
- 音频指纹生成

## 快速开始

```bash
# 格式转换
python3 scripts/convert_format.py input.wav output.mp3 --bitrate 320k

# 剪辑音频（从30秒到2分钟）
python3 scripts/cut_audio.py input.mp3 output.mp3 --start 00:00:30 --end 00:02:00

# 分析音频特征
python3 scripts/analyze_audio.py input.mp3 --output report.json

# 降噪处理
python3 scripts/denoise.py input.mp3 output.mp3

# 批量处理目录
python3 scripts/batch_process.py ./audio_dir/ --action convert --format mp3
```

## 依赖安装

```bash
pip install -r requirements.txt
```

核心依赖：ffmpeg（系统级）、pydub、librosa、soundfile、mutagen、numpy、matplotlib、noisereduce

## 脚本说明

| 脚本 | 功能 |
|------|------|
| `convert_format.py` | 格式转换，支持所有主流格式 |
| `cut_audio.py` | 按时间码裁剪音频 |
| `merge_audio.py` | 多文件合并拼接 |
| `analyze_audio.py` | 音频特征分析（波形/频谱/BPM） |
| `denoise.py` | 降噪处理 |
| `speed_pitch.py` | 变速变调 |
| `normalize_volume.py` | 音量标准化 |
| `batch_process.py` | 批量处理目录 |
| `extract_metadata.py` | 元数据提取与编辑 |
| `detect_silence.py` | 静音检测与自动分割 |

## 详细用法

参见 `references/` 目录：
- `audio-formats.md` - 支持的音频格式详解
- `effects-guide.md` - 效果处理参数指南
- `api-reference.md` - 脚本 API 参考