# 声音素材起步包（sound_assets）

本目录为 WeClaw 自带的声音素材起步库，供以下场景开箱即用：

1. 和用户对话时点缀音效，让输出更生动
2. 带环境音的语音合成（如英语练习时叠加机场/餐厅背景声）
3. 生成 PPT / HTML / 游戏时配背景音乐或音效
4. 作为 `audio_processor` 混流（mix）的背景素材来源

## 目录结构

```
data/sound_assets/
├── manifest.json     # 素材目录清单（被 sound_library 工具读取）
├── ambient/          # 环境音：雨声、咖啡馆、海浪、街道、键盘、机场广播…
├── sfx/              # 短音效：点击、成功、错误、掌声、转场…
└── music/            # 纯音乐 BGM：轻松、温馨、专注、紧张…
```

## 许可要求

起步包**仅收录 Pixabay CC0 资源**（免署名、可商用）。新增条目请确保许可为
CC0 或等价，并在 `manifest.json` 中登记 `license` 与 `source`。

## 如何填充音频文件

仓库提交的是目录结构与 `manifest.json`，实际音频文件通过脚本按需下载：

```bash
# 需先在环境变量中配置 PIXABAY_API_KEY
python test_scripts/voice/fetch_starter_pack.py
```

脚本会根据 `manifest.json` 中每个条目的 `query` 从 Pixabay 检索并下载 CC0
音频，保存到对应子目录。下载完成后即可被 `sound_library` 工具检索使用。

## manifest.json 字段说明

| 字段 | 说明 |
|------|------|
| `id` | 素材唯一标识 |
| `category` | 分类：ambient / sfx / music |
| `filename` | 相对本目录的文件路径 |
| `title` | 中文标题 |
| `tags` | 检索标签（中英文混合） |
| `scene` | 适用场景（如 restaurant / airport / ppt / game） |
| `license` | 许可（应为 CC0） |
| `source` | 来源（pixabay） |
| `query` | 下载脚本使用的检索关键词 |
