Audio-Segmenter#

功能：一键把长音频切成固定时长的片段，专为语音训练、素材整理、翻唱/Karaoke 准备、数据集制作设计。完美保持原文件夹结构 + 智能默认输出路径 + 自动处理 ffmpeg。

触发时机（Triggers）#

• 用户提到“音频切片”“切成小段”“分割音频”“切片”“分段”“每段XX秒”等词，并提供音频文件路径或文件夹。
• 用户说“帮我处理这个长音频”“制作语音数据集”“Karaoke素材准备”等场景。
• 支持单个文件或整个文件夹（可递归）。

支持的音频格式#

.mp3 / .wav / .m4a / .ogg / .flac / .aac / .wma 等（pydub 支持的所有常见格式）

参数说明（默认值）#

1. -i → 输入路径（必填，支持单个文件或文件夹）
2. -d → 每段切片时长（秒），默认 60
3. -o → 输出目录（不传则智能选择：单文件同目录，文件夹则在同级创建 [输入文件夹名]_sliced_audio）
4. -r → 文件夹模式下是否递归子文件夹（默认否）

参数提取指南#

当决定调用此技能时，请从用户上下文中提取以下参数：

1. <输入路径> (必填): 用户提供的音频文件路径或文件夹路径。
2. <切片秒数> (选填): 用户指定的每段时长（秒），未提则默认 60。
3. <输出目录> (选填): 用户指定的输出路径，未指定则使用智能默认。
4. 递归标志 ( -r): 用户提到“递归”“所有子文件夹”时添加。

执行步骤#

1. 解析路径：自动识别用户的输入是单个音频文件还是文件夹。

2. 默认输出：未指定 -o 时，单文件输出到源目录附近，文件夹则在同级创建带 _sliced_audio 的新文件夹，并保留原始目录结构。

3. 调用命令：使用以下兼容性命令启动脚本（优先 python3，失败则 python）。脚本会自动创建虚拟环境、检测并安装 ffmpeg。 bash

   (python3 scripts/audio_slicer.py -i "<输入路径>" [-d <切片秒数>] [-o "<输出目录>"] [-r]) || (python scripts/audio_slicer.py -i "<输入路径>" [-d <切片秒数>] [-o "<输出目录>"] [-r])