ZeeLin Music

## 📋 隐私与透明度

**服务提供商**: MelodyLab (https://melodylab.top)  
**数据处理**: 
- 用户提交的创意描述、歌词、风格偏好将发送至 melodylab.top API
- 后端集成 Google Gemini（生成歌词）和 Suno AI（生成音乐）
- 生成的音频文件托管在 cdn.suno.ai

**数据保留**: 
- 不存储用户提交的创意/歌词到 MelodyLab 服务器
- 请求日志保留 7 天用于故障排查
- 生成的音频文件由 Suno 按其隐私政策处理

**第三方服务**:
- Google Gemini API - 歌词生成
- Suno AI - 音乐合成
- 均遵循各自平台的服务条款

**建议**: 避免在创意描述中包含敏感个人信息。

---

## 使用时机

当用户请求：
- 生成/写/创作/做一首歌、歌曲、音乐
- AI 作曲、自定义风格歌、带歌词的歌、纯音乐
- 任何带"夏天恋爱""悲伤失恋""赛博朋克""励志摇滚"等描述的音乐需求

不适合：生成图片、视频、代码、数学计算等。

## API 调用说明

**基础 URL**：https://melodylab.top

### 1. 第一步：生成歌词

**POST** `/api/generate-lyrics`

请求示例（JSON body，必填项只有 `creativeIdea`）：

```json
{
  "creativeIdea": "夏天海边浪漫的初恋回忆",
  "musicStyle": "流行 轻快",
  "emotionalStyle": "甜蜜 青春",
  "vocalMode": "人声"
}
```

成功返回示例：

```json
{
  "success": true,
  "lyrics": "[Verse 1] 阳光洒在沙滩上... ...",
  "title": "夏日心动",
  "tags": ["pop", "happy", "summer"]
}
```

### 2. 第二步：生成音乐（用户确认/编辑歌词后调用）

**POST** `/api/generate-music`

请求示例（带歌词版）：

```json
{
  "lyrics": "[Verse 1] 阳光洒在沙滩上... ...",
  "title": "夏日心动",
  "musicStyle": "流行 轻快",
  "emotionalStyle": "甜蜜 青春",
  "tags": ["pop", "happy", "summer"],
  "vocalMode": "人声"
}
```

纯音乐（无歌词，直接用创意生成）：

```json
{
  "creativeIdea": "雨夜霓虹赛博朋克城市",
  "title": "Neon Rain",
  "tags": ["synthwave", "dark", "cyberpunk"],
  "vocalMode": "纯音乐"
}
```

返回示例（同步完成时）：

```json
{
  "success": true,
  "taskId": "xxx",
  "status": "completed",
  "songs": [
    {
      "title": "夏日心动 - v1",
      "audio_url": "https://cdn.suno.ai/xxx.mp3",
      "duration": 185,
      "cover": "https://..."
    },
    {
      "title": "...

# ZeeLin Music 🎵

**用一句话创作完整歌曲** - 由 AI 驱动的音乐创作工具

[![Version](https://img.shields.io/badge/version-1.0.6-blue.svg)](https://clawhub.ai/skills/melodylab-ai-song)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![OpenClaw](https://img.shields.io/badge/OpenClaw-Skill-orange.svg)](https://openclaw.ai)

## ✨ 功能特性

### 🤖 AI 全自动模式（新功能！）
让 AI 随机为你创作惊喜歌曲：
- 自动选择主题、风格、情绪
- 完全随机，给你意想不到的创意
- 适合寻求灵感或探索新风格

### 🎨 自定义创作模式
完全控制你的音乐：
- 自定义主题和故事
- 选择音乐风格（流行/摇滚/民谣/电子等）
- 设定情绪基调（甜蜜/悲伤/激昂/平静等）
- 决定人声或纯音乐

### 🎼 生成流程
1. **Gemini AI** 生成高质量歌词
2. **可编辑确认** - 修改直到满意
3. **Suno AI** 一次性生成 2 首完整歌曲
4. **多版本选择** - 选择你最喜欢的版本

## 🚀 快速开始

### 安装

```bash
# 使用 ClawHub CLI
clawhub install melodylab-ai-song

# 或者手动克隆
git clone https://github.com/yourusername/melodylab-ai-song.git ~/.openclaw/workspace/skills/melodylab-ai-song
```

### 使用示例

**AI 全自动模式**:
```
你: 帮我生成一首歌
AI: [询问模式选择]
你: 全自动
AI: [自动创作]
```

**自定义创作**:
```
你: 写一首关于夏天海边初恋的流行歌，要甜蜜的感觉
AI: [生成歌词并等待确认]
你: 确认
AI: [生成音乐并返回两个版本]
```

## 📋 技术架构

```
用户输入
   ↓
ZeeLin Song Generator (OpenClaw Skill)
   ↓
MelodyLab API (https://melodylab.top)
   ↓
┌─────────────┬─────────────┐
│  Gemini AI  │   Suno AI   │
│  (歌词生成)  │  (音乐合成)  │
└─────────────┴─────────────┘
   ↓
返回 2 首完整歌曲 + 封面
```

## 🔒 隐私与安全

### 我们承诺

- ✅ **不存储用户输入** - 创意描述仅用于实时生成
- ✅ **HTTPS 加密传输** - 所有数据通过 TLS 1.2+ 加密
- ✅ **最小化数据收集** - 仅收集必要的创作参数
- ✅ **无第三方追踪** - 不使用 Google Analytics 等追踪工具
- ✅ **7 天日志保留** - 仅用于故障排查，之后自动删除

### 第三方服务

本技能使用以下第三方服务：

| 服务 | 用途 | 隐私政策 |
|------|------|----------|
| **Google Gemini** | 歌词生成 | [...