purevocals-uvr-automator

当用户想要**一键批量从音频文件中提取超干净纯人声（干声 / Vocals Only）**、去除伴奏/背景音乐时，自动调用此技能。 一键音频人声分离工具。专门从音频文件（.mp3/.wav/.flac等）中提取超干净干声（Acapella）或去除背景音制作伴奏。 核心用途：支持单个音频文件或整个文件夹批量处理（.mp3/.wav/.flac 等格式），输出高质量无杂音干声，自动在输入同级创建 [输入文件夹]_vocals 文件夹，完美保留原目录结构。 高频触发场景包括： - 翻唱练习、翻唱视频制作、B站/抖音/小红书演唱素材清洗 - 卡拉OK 伴奏制作（只保留人声） - 音乐制作中的人声分离（vocal isolation / stem separation） - 音频素材清洗、原音轨提取、去背景音处理 - 翻唱素材制作、卡拉OK伴奏生成、音频后期清洗。 用户常用自然语言表述： “帮我提取干声”“把这首歌的伴奏去掉，只留清唱”“批量分离文件夹里的所有人声”“做翻唱要纯人声”“卡拉OK 干声提取”“vocal remover”“UVR 人声分离”“去除伴奏”“音频人声隔离”“stem 分离 vocals”等。 支持顶级 UVR 模型，默认推荐速度最快且干净度最高的 shibing624-chinese-kenlm-klm，也支持卡拉OK 专用模型。自动检测 GPU（CUDA 加速）或 CPU，自动创建并管理虚拟环境，无需用户手动配置。

功能概述：一键将带伴奏的音频文件批量转换为超干净的纯人声（Vocals Only）。专为翻唱、卡拉OK、音乐素材清洗等场景设计，输出质量高、速度快、操作零门槛。

支持的模型（推荐顺序）

1. shibing624-chinese-kenlm-klm —— 默认推荐（速度最快 + 干净度最高，适合中文歌曲）
2. 6_HP_Karaoke-UVR.pth —— 高质量卡拉OK 模式（你原来的常用设置）
3. UVR-MDX-NET-Karaoke_2.onnx —— 极致速度，适合超大批量处理

执行步骤

1. 输入解析：支持单个音频文件路径，或整个文件夹路径（会递归处理所有支持格式）。
2. 输出位置：若未指定输出目录，默认在输入路径同级自动创建 [输入文件夹名]_vocals 文件夹，保持原文件夹结构不变。
3. 启动命令（Agent 会自动选择优先级）：

   bash

   (python3 scripts/purevocals.py "<输入路径>" ["<输出目录>"] [--model <模型名>] [--window_size <数值>] [--aggression <数值>] [--chunk_duration <秒数>] [--sample_mode]) || (python scripts/purevocals.py "<输入路径>" ["<输出目录>"] [--model <模型名>] [--window_size <数值>] [--aggression <数值>] [--chunk_duration <秒数>] [--sample_mode])