伴奏提取器

SKILL.md

---
name: accompaniment-generator
description: 从 YouTube 或本地音频文件分离人声和伴奏，生成纯伴奏音乐。当用户需要提取伴奏、消除人声、制作卡拉OK版音频时使用。支持三种模式：(1) 歌名+歌手搜索 YouTube 下载后分离，(2) 直接提供视频 URL，(3) 处理本地音频文件。
---

# 伴奏生成器 (Accompaniment Generator)

## 概述

从歌曲中分离人声，输出纯伴奏音乐。核心流程：获取音频 → Demucs AI 分离人声/伴奏 → 输出 MP3。

> 💡 **无需手动导出 cookies！** 脚本会自动从本地 Chrome 浏览器提取登录态。
> 只需在你自己的电脑上（已登录 Google）运行即可。

## 核心脚本

**`scripts/get_accompaniment.py`**

### 使用模式

```bash
# 1. 搜索 YouTube + 下载 + 分离（自动用浏览器 cookies）
python3 scripts/get_accompaniment.py "歌名" "歌手名"

# 2. 直接提供视频 URL
python3 scripts/get_accompaniment.py --url "https://youtube.com/watch?v=xxx"

# 3. 处理本地音频文件
python3 scripts/get_accompaniment.py --file /path/to/song.mp3

# 4. 显式指定 cookies 文件（浏览器不可用时）
python3 scripts/get_accompaniment.py "歌名" "歌手" --cookies cookies.txt
```

### 输出

输出到 `~/accompaniment_output/` 目录，包含：
- `{歌名}_伴奏.mp3` — 纯伴奏（已消除人声）
- `{歌名}_人声.mp3` — 仅人声（可选）

### 参数说明

| 参数 | 说明 |
|------|------|
| `song` `artist` | 歌名和歌手（搜索用） |
| `--url` | 直接指定视频 URL |
| `--file (-f)` | 处理本地音频文件 |
| `--output (-o)` | 输出目录 |
| `--cookies` | YouTube cookies 文件路径（可选，默认用浏览器） |
| `--json` | JSON 格式输出（供 agent 解析） |

## 工作流程

### 获取音频

**YouTube 搜索 + 下载：**
1. 用网页抓取 YouTube 搜索结果（无需 cookies）
2. 选择第一个匹配结果
3. 用 `yt-dlp` 下载音频（mp3，192kbps）
4. 自动通过 `--cookies-from-browser chrome` 提取浏览器登录态

> ⚠️ 如果 Chrome 不可用或未登录，脚本会报 "NEEDS_COOKIES"。
> 此时可用 `--cookies cookies.txt` 手动指定 cookies 文件。
>
> **🔒 安全说明**：cookies 仅传递给 yt-dlp 用于 YouTube 下载认证，不会上传到其他服务。用完后建议删除 cookies 文件。

**本地文件：**
直接传入文件路径，跳过下载。

### AI 分离

使用 Demucs（htdemucs 模型）分离人声和伴奏：
- `--two-stems vocals`：分离为 vocals + no_vocals
- 输出 MP3 192kbps

## 依赖安装

```bash
# yt-dlp（YouTube 下载）
pip install yt-dlp

# Demucs（AI 人声分离，建议在虚拟环境中安装）
pip install demucs

# ffmpeg（格式转换）
# Ubuntu/Debian: sudo apt install ffmpeg
# macOS: brew install ffmpeg

# Deno（JS 运行时，可选，用于 YouTube 签名解算）
# curl -fsSL https://deno.land/install.sh | sh
```

## Agent 集成

使用 `--json` 参数获取结构化输出，便于自动化调用：

```json
{"success": true, "song": "晴天", "accompaniment": "/path/to/伴奏.mp3", "vocals": "/path/to/人声.mp3", "accompaniment_size_mb": 7.3}
```