# Windows 部署小智ESP32服务器的详细步骤

## 系统要求确认
- 确保您的Windows系统满足以下要求：
  - Windows 10或更高版本（建议使用最新版本）
  - 管理员权限

## 1. 安装Java JDK 8
1. 访问Oracle官网下载JDK 8：[Oracle JDK 8下载](https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html)  
   备用下载地址：[CSDN下载](https://download.csdn.net/download/weixin_55629186/89045298)
   - 选择"Windows x64"版本下载（如`jdk-8u381-windows-x64.exe`）
2. 运行安装程序，按向导完成安装
3. 配置环境变量：
   - 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
   - 在"系统变量"中新建：
     - 变量名：`JAVA_HOME`
     - 变量值：`C:\Program Files\Java\jdk1.8.0_381`（具体路径取决于您的安装版本）
   - 编辑"Path"变量，添加：`%JAVA_HOME%\bin`
4. 验证安装：
   - 打开命令提示符（Win+R，输入`cmd`）
   - 输入：`java -version`
   - 应显示类似：`java version "1.8.0_381"`

## 2. 安装MySQL数据库
1. 下载MySQL社区版：[MySQL下载](https://dev.mysql.com/downloads/installer/)
2. 运行安装程序，选择"Custom"安装
3. 选择安装：
   - MySQL Server
   - MySQL Workbench（可选，图形界面工具）
4. 在配置步骤：
   - 设置root密码（建议使用复杂密码）
   - 记住您设置的密码
5. 完成安装后，启动MySQL服务
6. 配置变量
   - 找到MySQL的安装路径，默认路径通常是：`C:\Program Files\MySQL\MySQL Server 5.7\bin`
   - 如果不确定，可以在文件资源管理器中搜索 `mysql.exe` 的路径。
7. 添加到环境变量
   - 右键 此电脑 → 属性 → 高级系统设置 → 环境变量。
   - 在 系统变量 中找到 Path，点击 编辑 → 新建，粘贴MySQL的bin路径（如上述路径）。
   - 保存后关闭所有窗口。
8. 验证是否生效
   - 重新打开命令提示符（CMD），输入`mysql --version`
   - 如果显示版本信息（如 `mysql Ver 14.14 Distrib 5.7.43`），则配置成功。

## 3. 安装Maven
1. 下载Maven：[Maven下载](https://maven.apache.org/download.cgi)
   - 选择"Binary zip archive"下载
2. 解压到`C:\Program Files\apache-maven-3.9.4`（版本号可能不同）
3. 配置环境变量：
   - 新建系统变量：
     - 变量名：`MAVEN_HOME`
     - 变量值：`C:\Program Files\apache-maven-3.9.4`
   - 编辑"Path"变量，添加：`%MAVEN_HOME%\bin`
4. 验证安装：
   - 命令提示符输入：`mvn -v`
   - 应显示Maven版本信息

## 4. 安装Node.js和npm
1. 下载Node.js LTS版本：[Node.js下载](https://nodejs.org/)
2. 运行安装程序，按默认选项安装
3. 安装完成后验证：
   - 命令提示符输入：
     - `node -v`
     - `npm -v`
   - 应显示版本信息

## 5. 安装FFmpeg（必需）
1. 访问FFmpeg官网：[FFmpeg下载](https://ffmpeg.org/download.html)
2. 选择"Windows builds from gyan.dev"链接
3. 下载最新完整版（如`ffmpeg-git-full.7z`）
4. 解压到`C:\Program Files\ffmpeg`（可以自定义路径）
5. 配置环境变量：
   - 编辑"Path"变量，添加：`C:\Program Files\ffmpeg\bin`
6. 验证安装：
   - 命令提示符输入：`ffmpeg -version`
   - 应显示FFmpeg版本信息

## 6. 数据库配置（详细Windows步骤）
1. 打开命令提示符
2. 登录MySQL（使用安装时设置的root密码）：
   ```bash
   mysql -u root -p
   ```
3. 创建数据库：
   ```sql
   CREATE DATABASE xiaozhi;
   ```
4. 创建用户并授权：
   ```sql
   CREATE USER 'xiaozhi'@'localhost' IDENTIFIED BY '123456';
   GRANT ALL PRIVILEGES ON xiaozhi.* TO 'xiaozhi'@'localhost';
   FLUSH PRIVILEGES;
   ```
5. 初始化数据库：
   - 确保您已经克隆了项目代码
   - 在命令提示符中导航到项目目录下的`db`文件夹
   - 执行：
     ```bash
     mysql -u root -p xiaozhi < init.sql
     ```

## 7. Vosk语音识别模型安装（Windows）
1. 下载中文模型：[Vosk模型](https://alphacephei.com/vosk/models)
   - 选择`vosk-model-cn-0.22`（或最新中文模型）
2. 解压下载的zip文件
3. 在项目根目录创建`models`文件夹（如果不存在）
4. 将解压后的模型文件夹重命名为`vosk-model`并放入`models`目录
5. 完整路径应为：`项目目录\models\vosk-model`

## 后端部署（Windows）
1. 克隆项目（如果尚未克隆）：
   ```bash
   git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
   ```
2. 进入项目目录：
   ```bash
   cd xiaozhi-esp32-server-java
   ```
3. 使用Maven构建：
   ```bash
   mvn clean package -DskipTests
   ```
4. 运行后端服务：
   ```bash
   java -jar target\xiaozhi.server-1.0.jar
   ```

## 前端部署（Windows）
1. 打开新的命令提示符窗口
2. 导航到前端目录：
   ```bash
   cd xiaozhi-esp32-server-java\web
   ```
3. 安装依赖：
   ```bash
   npm install
   ```
4. 运行开发服务器：
   ```bash
   npm run dev
   ```

## 访问系统
1. 确保后端服务正在运行
2. 确保前端开发服务器正在运行
3. 打开浏览器访问：[http://localhost:8084](http://localhost:8084)
4. 使用默认凭据登录：
   - 用户名：`admin`
   - 密码：`123456`

## Windows常见问题解决
1. 端口冲突：
   - 如果8084端口被占用，可以：
     - 编辑`src\main\resources\application.properties`，修改`server.port`
     - 编辑前端`web`目录下的配置文件相应修改API地址
2. FFmpeg找不到：
   - 确保已正确添加FFmpeg到PATH
   - 重启命令提示符窗口后重试
3. MySQL连接问题：
   - 确保MySQL服务已启动（可在服务管理器中检查）
   - 检查`application.properties`中的数据库配置
4. 缺少依赖：
   - 如果构建失败，尝试：
     ```bash
     mvn clean install
     ```
   - 确保网络连接正常，能访问Maven中央仓库