# 数据填充说明文档

## 📦 礼物种类数据 (`数据填充_礼物种类.sql`)

### 数据分类
1. **经济类礼物**（10-50金币）
   - 玫瑰花、棒棒糖、咖啡、冰淇淋、小蛋糕、巧克力、奶茶、小星星、爱心气球、小礼物盒、彩虹
   - 共11种，亲密度增加值：10-50

2. **中档礼物**（50-200金币）
   - 香槟、钻石、王冠、爱心、月亮、烟花、水晶球、玫瑰花束、星星项链
   - 共9种，亲密度增加值：50-200

3. **高级礼物**（200-500金币）
   - 跑车、飞机、游艇、城堡
   - 共4种，亲密度增加值：200-500

4. **特殊礼物**（500+金币）
   - 宇宙飞船、时光机、魔法棒、永恒之心（1314金币）
   - 共4种，亲密度增加值：600-1314

5. **节日限定礼物**
   - 圣诞树、情人节巧克力、生日蛋糕、万圣节南瓜
   - 共4种，价格：150-520金币

**总计：32种礼物**

---

## 👗 换装种类数据 (`数据填充_换装种类.sql`)

### 数据分类

#### 女性上装 (top)
- **免费款**：白色T恤、粉色短袖、蓝色衬衫、灰色卫衣（4种）
- **收费款**：蕾丝吊带上衣、一字领露肩上衣、露脐短袖、雪纺衬衫、针织开衫、小香风外套（6种）
- **VIP专属**：真丝衬衫、定制礼服上衣（2种）
- **小计**：12种

#### 女性下装 (bottom)
- **免费款**：蓝色牛仔裤、黑色短裙、白色短裤、灰色运动裤（4种）
- **收费款**：A字半身裙、高腰阔腿裤、百褶短裙、包臀裙、破洞牛仔裤、西装裤（6种）
- **VIP专属**：真丝长裙、定制礼服下装（2种）
- **小计**：12种

#### 女性连衣裙/连体服 (dress)
- **免费款**：白色连衣裙、碎花连衣裙、黑色小礼服（3种）
- **日常风格**：法式复古、甜美公主裙、优雅长裙、吊带连衣裙、雪纺连衣裙（5种）
- **主题风格**：JK制服、汉服、洛丽塔、和服、魔法少女装（5种）
- **季节限定**：夏日比基尼、冬季毛衣裙、圣诞装（3种）
- **VIP专属**：定制晚礼服、高级定制婚纱（2种）
- **小计**：18种

#### 男性上装 (top)
- **免费款**：白色T恤、蓝色衬衫、黑色卫衣（3种）
- **收费款**：休闲Polo衫、商务衬衫、运动背心、牛仔外套、西装外套（5种）
- **小计**：8种

#### 男性下装 (bottom)
- **免费款**：蓝色牛仔裤、黑色休闲裤（2种）
- **收费款**：运动短裤、卡其裤、西装裤、工装裤（4种）
- **小计**：6种

#### 通用款 (unisex)
- 基础T恤、运动裤（2种）

**总计：58种服装**

---

## 🎤 音色种类数据 (`数据填充_音色种类.sql`)

### 数据分类

#### 女性音色
- **免费基础音色**（3种）
  - 温柔甜美（默认）、清纯可爱、活泼开朗

- **收费音色 - 日常风格**（5种）
  - 成熟御姐（50金币）、知性优雅（80金币）、温柔邻家（60金币）、元气少女（70金币）、清冷女神（100金币）

- **收费音色 - 特殊风格**（5种）
  - 萝莉音（120金币）、御姐音（120金币）、软萌音（100金币）、磁性低音（150金币）、空灵仙音（200金币）

- **收费音色 - 角色风格**（4种）
  - 古风女声（180金币）、日系少女（150金币）、韩系甜美（150金币）、欧美性感（200金币）

- **VIP专属音色**（2种）
  - 定制专属音色（500金币）、AI歌手音色（300金币）

- **小计**：19种女性音色

#### 男性音色
- **免费基础音色**（3种）
  - 阳光少年（默认）、温暖大叔、干净清爽

- **收费音色 - 日常风格**（5种）
  - 成熟稳重（50金币）、磁性低音（100金币）、温柔暖男（80金币）、活力青年（70金币）、睿智精英（120金币）

- **收费音色 - 特殊风格**（4种）
  - 少年音（100金币）、大叔音（120金币）、沙哑磁性（150金币）、清亮高音（100金币）

- **收费音色 - 角色风格**（3种）
  - 古风男声（180金币）、日系少年（150金币）、欧美硬汉（200金币）

- **VIP专属音色**（2种）
  - 定制专属音色（500金币）、AI歌手音色（300金币）

- **小计**：17种男性音色

**总计：36种音色**

---

## 📝 使用说明

### 1. 执行SQL文件
```sql
-- 在MySQL数据库中依次执行以下文件：
-- 1. 数据填充_礼物种类.sql
-- 2. 数据填充_换装种类.sql
-- 3. 数据填充_音色种类.sql
```

### 2. 注意事项

#### 图片路径
- 所有 `image` 和 `image_url` 字段中的路径都是示例路径
- **需要根据实际情况上传图片并更新路径**
- 建议图片命名规范：
  - 礼物：`/uploads/gifts/礼物名称.png`
  - 换装：`/uploads/outfit/分类/服装名称.jpg`
  - 音色：`/uploads/voice/avatar/音色名称.jpg`

#### 音频路径
- 音色的 `sample_audio_url` 需要上传实际的试听音频文件
- 建议路径：`/uploads/voice/sample/音色名称.mp3`

#### TTS模型配置
- `tts_model_id` 和 `voice_code` 字段需要根据实际使用的TTS服务填写
- 当前示例使用的是 `cosyvoice-v2`，请根据实际情况修改

#### 时间戳
- SQL中使用 `UNIX_TIMESTAMP()` 自动生成当前时间戳
- 如果需要指定时间，可以替换为具体的时间戳值

### 3. 数据调整建议

1. **价格调整**：根据实际运营策略调整金币价格
2. **亲密度值**：根据游戏平衡性调整亲密度增加值
3. **排序权重**：根据受欢迎程度调整 `weigh` 值（数字越大越靠前）
4. **VIP专属**：可以根据需要调整哪些物品设为VIP专属

### 4. 扩展建议

- **礼物**：可以添加更多节日限定、季节限定礼物
- **换装**：可以添加更多主题风格（如：职业装、运动装、睡衣等）
- **音色**：可以添加更多角色风格（如：机器人、小动物、精灵等）

---

## 📊 数据统计

| 类型 | 免费数量 | 收费数量 | VIP专属 | 总计 |
|------|---------|---------|---------|------|
| 礼物 | 0 | 28 | 0 | 32 |
| 换装 | 15 | 39 | 4 | 58 |
| 音色 | 6 | 28 | 4 | 36 |

---

## ⚠️ 重要提示

1. **执行前备份数据库**
2. **检查表结构是否匹配**
3. **图片和音频文件需要单独上传**
4. **TTS参数需要根据实际服务配置**
5. **建议先在测试环境执行，确认无误后再在生产环境执行**

---

生成时间：2026年2月1日