feat ：init

docs/WINDOWS_DEVELOPMENT.md

@@ -0,0 +1,167 @@
+# 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中央仓库