Audio Processor

音频处理工具集 - 支持音频录制、剪辑、格式转换、频谱分析、降噪、变速变调等操作。Use when: (1) 需要处理音频文件（录音、剪辑、合并、分割）, (2) 需要转换音频格式（MP3/WAV/FLAC/OGG等）, (3) 需要分析音频特征（频谱、音量、静音检测）, (4) 需要对音频进行效果处理（降噪、变...

Security Scan

The package is internally consistent with an audio-processing toolset: the scripts, dependencies, and instructions align with the described functionality and there are no signs of credential access, network exfiltration, or unrelated capabilities.

Purpose & Capability

Name/description match the provided scripts and requirements. The included Python scripts implement format conversion, cutting/merging, analysis, denoise, metadata, silence detection, normalization, and speed/pitch — exactly what the description claims.

Instruction Scope

SKILL.md instructs running local scripts and installing requirements; the runtime instructions and quick-start examples only reference local files and directories. Minor note: SKILL.md references an 'api-reference.md' that is not present in the repository (small documentation mismatch). The scripts do not read environment secrets or call external network endpoints.

Install Mechanism

No install spec is provided (instruction-only install), and dependencies are standard Python audio packages listed in requirements.txt. The SKILL.md correctly documents a system-level dependency on ffmpeg. There are no downloads from untrusted URLs or extraction of remote archives.

Credentials

No environment variables, credentials, or config paths are requested. The required Python packages and ffmpeg are appropriate for audio processing and proportional to the toolset's purpose.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or attempt to modify other skills/config. Scripts operate on user-supplied files and directories only.

Assessment

This package appears to be a straightforward local audio-processing toolkit. Before installing or running: (1) ensure ffmpeg is installed on the host (SKILL.md assumes a system ffmpeg binary); (2) run pip install -r requirements.txt in a Python virtualenv; (3) review and run scripts in an isolated or trusted environment because they execute local file operations and call subprocesses (ffmpeg and python scripts) — avoid running them on directories containing sensitive files you don't want modified; (4) note a small documentation mismatch: SKILL.md mentions an api-reference.md that is missing; (5) if you need network isolation, run inside a sandbox/container. Overall the code is coherent with the stated purpose and contains no obvious signs of credential exfiltration or unexpected network activity.

音频处理全能工具集，基于 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 标签 / 元数据读写
• 音频指纹生成

快速开始

# 格式转换
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

依赖安装

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 参考