server/docs/WINDOWS_DEVELOPMENT.md

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

系统要求确认

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

1. 安装Java JDK 8

1. 访问Oracle官网下载JDK 8：Oracle JDK 8下载
   备用下载地址：CSDN下载
   • 选择"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下载
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下载
   • 选择"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下载
2. 运行安装程序，按默认选项安装
3. 安装完成后验证：
   • 命令提示符输入：
     • node -v
     • npm -v
   • 应显示版本信息

5. 安装FFmpeg（必需）

1. 访问FFmpeg官网：FFmpeg下载
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密码）：

   mysql -u root -p
   

3. 创建数据库：

   CREATE DATABASE xiaozhi;
   

4. 创建用户并授权：

   CREATE USER 'xiaozhi'@'localhost' IDENTIFIED BY '123456';
   GRANT ALL PRIVILEGES ON xiaozhi.* TO 'xiaozhi'@'localhost';
   FLUSH PRIVILEGES;
   

5. 初始化数据库：
   • 确保您已经克隆了项目代码
   • 在命令提示符中导航到项目目录下的db文件夹
   • 执行：

     mysql -u root -p xiaozhi < init.sql
     

7. Vosk语音识别模型安装（Windows）

1. 下载中文模型：Vosk模型
   • 选择vosk-model-cn-0.22（或最新中文模型）
2. 解压下载的zip文件
3. 在项目根目录创建models文件夹（如果不存在）
4. 将解压后的模型文件夹重命名为vosk-model并放入models目录
5. 完整路径应为：项目目录\models\vosk-model

后端部署（Windows）

1. 克隆项目（如果尚未克隆）：

   git clone https://github.com/joey-zhou/xiaozhi-esp32-server-java
   

2. 进入项目目录：

   cd xiaozhi-esp32-server-java
   

3. 使用Maven构建：

   mvn clean package -DskipTests
   

4. 运行后端服务：

   java -jar target\xiaozhi.server-1.0.jar
   

前端部署（Windows）

1. 打开新的命令提示符窗口
2. 导航到前端目录：

   cd xiaozhi-esp32-server-java\web
   

3. 安装依赖：

   npm install
   

4. 运行开发服务器：

   npm run dev
   

访问系统

1. 确保后端服务正在运行
2. 确保前端开发服务器正在运行
3. 打开浏览器访问：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. 缺少依赖：
   • 如果构建失败，尝试：

     mvn clean install
     

   • 确保网络连接正常，能访问Maven中央仓库