# 🚀 快速开始 - 3分钟部署指南

## 📦 准备工作

### 1. 确认 Go 已安装

打开终端，输入：
```bash
go version
```

✅ 看到版本号（如 `go version go1.21.x`）- 已安装，继续下一步  
❌ 提示未找到命令 - 需要先安装Go

**安装 Go：**
- Windows: https://golang.org/dl/ (下载安装包)
- macOS: `brew install go`
- Linux: `sudo apt install golang-go`

---

## 🎯 三步部署

### Windows 用户

#### 第一步：打开项目目录
```bash
cd d:\esp32-music-server\Meow\MeowEmbeddedMusicServer
```

#### 第二步：双击启动
找到 `start.bat` 文件，双击运行

#### 第三步：访问应用
浏览器打开：http://localhost:2233/app

**就这么简单！** 🎉

---

### Linux / macOS 用户

#### 第一步：进入项目目录
```bash
cd /path/to/MeowEmbeddedMusicServer
```

#### 第二步：添加执行权限并启动
```bash
chmod +x start.sh
./start.sh
```

#### 第三步：访问应用
浏览器打开：http://localhost:2233/app

**完成！** 🎉

---

## 🎵 首次使用

1. **注册账户**
   - 访问 http://localhost:2233/app
   - 点击右侧"注册"标签
   - 填写：用户名、邮箱、密码
   - 点击"注册"按钮

2. **搜索音乐**
   - 登录后，在搜索框输入歌曲名
   - 例如："告白气球"
   - 点击"搜索"

3. **播放音乐**
   - 搜索结果出现后
   - 点击"▶ 播放"按钮

4. **添加收藏**
   - 在搜索结果页
   - 使用下拉菜单选择"我喜欢"
   - 歌曲自动添加到收藏

5. **创建歌单**
   - 左侧边栏"我的歌单"旁
   - 点击"+"号
   - 输入歌单名称
   - 确认创建

---

## 🔧 常见问题

### Q: 端口被占用怎么办？

**Windows:**
```bash
netstat -ano | findstr :2233
taskkill /PID <进程ID> /F
```

**Linux/macOS:**
```bash
lsof -i :2233
kill -9 <PID>
```

或修改端口：编辑 `.env` 文件，将 `PORT=2233` 改为 `PORT=3000`

---

### Q: 依赖下载失败？

**中国大陆用户**需要配置Go代理：

```bash
go env -w GOPROXY=https://goproxy.cn,direct
```

然后重新运行启动脚本

---

### Q: 如何停止服务器？

在启动的终端窗口中按 `Ctrl + C`

---

### Q: 如何让局域网其他设备访问？

1. 找到本机IP（Windows: `ipconfig`，Linux/Mac: `ifconfig`）
2. 修改 `.env` 文件：
   ```env
   WEBSITE_URL=http://你的IP:2233
   ```
3. 重启服务器
4. 其他设备访问：`http://你的IP:2233/app`

---

## 📚 更多文档

- **详细部署指南**: 查看 `本地部署指南.md`
- **API文档**: 查看 `USER_SYSTEM_README.md`
- **功能说明**: 查看 `新功能说明.md`

---

## 💡 使用技巧

### 快捷键
- 搜索框按 `Enter` 键可以快速搜索
- `Ctrl + C` 停止服务器

### 推荐浏览器
- Chrome / Edge
- Firefox
- Safari

### 数据备份
定期备份 `files/` 目录，保存用户数据和歌单

---

## 🎯 目录结构

```
MeowEmbeddedMusicServer/
├── start.bat              ← Windows启动（双击）
├── start.sh               ← Linux/Mac启动
├── .env                   ← 配置文件（可选）
├── theme/
│   └── music-app.html     ← 新版界面
└── files/                 ← 数据存储（自动创建）
    ├── users.json         ← 用户数据
    └── user_playlists.json ← 歌单数据
```

---

## ✅ 快速检查清单

部署前：
- [ ] Go 已安装（1.19+）
- [ ] 项目已下载到本地
- [ ] 端口 2233 未被占用

部署后：
- [ ] 启动脚本运行成功
- [ ] 浏览器可以打开 http://localhost:2233/app
- [ ] 可以注册新账户
- [ ] 可以搜索音乐

全部打勾 = 部署成功！🎉

---

## 🆘 需要帮助？

### 查看日志
启动后的终端窗口会显示所有日志信息

### 社区支持
- QQ群：865754861（喵波音律-音乐家园）
- 查看详细文档：`本地部署指南.md`

### 重新开始
如果遇到问题，可以：
1. 关闭服务器（Ctrl+C）
2. 删除 `files/` 目录
3. 重新运行启动脚本

---

## 🎉 恭喜！

你现在拥有一个属于自己的音乐服务器了！

**开始享受音乐吧！** 🎵✨

```
    ╔═══════════════════════════════════╗
    ║  新版应用地址                      ║
    ║  http://localhost:2233/app        ║
    ╚═══════════════════════════════════╝
```

**下一步：**
1. 🎵 搜索你喜欢的音乐
2. ❤️  创建你的收藏歌单
3. 📱 让朋友也来试试（局域网访问）