MiGPT跨平台部署：Windows系统安装教程
项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt 🔥 为什么选择Windows部署MiGPT？
你是否曾因复杂的Linux命令望而却步？是否想在个人电脑上快速搭建专属语音助手？本文将带你通过10个步骤，在Windows 10/11系统中从零部署MiGPT，让你的小爱音箱秒变AI语音助手。全程无需专业运维知识，普通用户也能顺利完成。
📋 读完本文你将获得
- 完整的Windows环境配置方案
- 小米账号与AI API的无缝对接
- 常见错误的可视化排查流程
- 性能优化的3个实用技巧
- 自动化启动的进阶配置
📋 准备工作清单
| 软件/工具 | 版本要求 | 作用 | 下载地址 |
|---|---|---|---|
| Node.js | ≥16.0.0 | 运行环境 | Node.js中文网 |
| Git | 最新版 | 代码管理 | GitforWindows |
| PNPM | ≥8.0.0 | 包管理器 | npm install -g pnpm |
| VS Code | 可选 | 代码编辑 | VSCode官网 |
| 小爱音箱 | 兼容型号 | 硬件设备 | 支持型号列表 |
⚠️ 注意：请确保C盘剩余空间≥10GB，全程保持网络稳定（建议连接5G WiFi）
🔧 安装步骤（10分钟完成）
1️⃣ 环境配置
# 1.安装Node.js后验证版本
node -v # 应显示v16.x.x或更高版本
# 2.安装PNPM
npm install -g pnpm
pnpm -v # 应显示8.x.x或更高版本
# 3.配置PNPM国内镜像（加速依赖下载）
pnpm config set registry https://registry.npmmirror.com
2️⃣ 获取源代码
# 克隆项目仓库
git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt.git
cd mi-gpt
# 查看项目结构（验证克隆成功）
dir
成功克隆后应看到以下核心文件：
- package.json：项目依赖配置
- prisma/schema.prisma：数据库模型定义
- .env.example：环境变量示例
- docs/：文档目录
3️⃣ 安装项目依赖
# 安装依赖（首次运行需5-10分钟）
pnpm install
# 构建项目
pnpm build
⚠️ 常见问题：若出现
node-gyp相关错误，需安装Windows构建工具：npm install --global --production windows-build-tools
4️⃣ 配置环境变量
-
复制环境变量模板：
copy .env.example .env -
用记事本打开
.env文件，配置以下必填项：
# AI服务配置（必选）
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx # 从AI服务官网获取
OPENAI_MODEL=gpt-3.5-turbo # 推荐初学者使用此模型
OPENAI_BASE_URL=https://api.openai.com/v1 # 国内用户需替换为访问地址
# 网络配置（国内用户可选）
HTTP_PROXY=http://127.0.0.1:7890 # 根据你的网络工具端口修改
5️⃣ 配置设备连接
-
复制配置文件模板：
copy .migpt.example.js .migpt.js -
编辑
.migpt.js关键配置：
export default {
speaker: {
// 小米账号信息（必选）
userId: "987654321", // 小米ID（不是手机号）
password: "your_password", // 小米账号密码
did: "小爱音箱Pro", // 设备名称或DID
// AI交互配置（必选）
callAIKeywords: ["请", "小爱同学"], // 唤醒AI的关键词
wakeUpKeywords: ["打开AI模式"], // 进入连续对话模式的指令
// 性能优化（可选）
checkInterval: 500, // 状态检测间隔（毫秒）
streamResponse: true // 启用流式响应（加快回复速度）
}
}
🔍 获取小米ID方法：登录i.mi.com → 个人信息 → 小米ID
6️⃣ 初始化数据库
# 生成数据库迁移文件
pnpm run db:gen
# 初始化数据库（首次运行必须执行）
pnpm run db:reset
成功执行后会在prisma目录生成app.db文件。
7️⃣ 启动应用
# 开发模式启动（带热重载）
pnpm dev
首次启动成功会显示：
[MiGPT] 服务已启动
[MiService] 已连接小米账号：xxx
[LLM] AI客户端初始化成功
[Speaker] 已连接设备：小爱音箱Pro (在线)
🎯 功能验证与测试
基础功能测试流程
验证步骤：
-
语音唤醒测试：
- 对音箱说："小爱同学，请今天天气如何"
- 预期结果：音箱回复当前天气信息
-
连续对话测试：
- 先说："小爱同学，打开AI模式"
- 再问："北京的天气呢"（无需重复唤醒词）
- 预期结果：直接回复北京天气
-
错误处理测试：
- 故意填写错误的API_KEY
- 预期结果：控制台显示
401 Invalid Authentication错误
🛠️ 常见问题解决
设备连接问题
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| "70016：登录验证失败" | 小米账号密码错误 | 1. 验证小米ID是否为纯数字 2. 尝试在官网登录验证密码 3. 关闭账号二次验证 |
| "找不到设备：xxx" | 设备名称不匹配 | 1. 在米家APP确认设备名称 2. 开启调试模式获取DID： speaker: { debug: true } |
| "Mi Service初始化失败" | 网络配置问题 | 1. 检查HTTP_PROXY配置 2. 尝试手机热点联网 |
AI响应问题
# 重置对话历史（当AI回复异常时）
pnpm run db:reset
# 查看详细日志（定位问题）
set DEBUG=mi-gpt:* && pnpm dev
性能优化建议
-
降低延迟：
// .migpt.js speaker: { checkInterval: 500, // 减少状态检测间隔 streamResponse: true // 启用流式回复 } -
减少内存占用：
# .env NODE_OPTIONS=--max-old-space-size=1024 # 限制内存使用为1GB
📊 兼容设备型号
| 设备型号 | 兼容性 | 特殊配置 |
|---|---|---|
| 小爱音箱Pro | ✅ 完美支持 | 无需额外配置 |
| 小爱音箱Play | ✅ 基本支持 | 需要设置playingCommand: [3,1,1] |
| 小爱音箱Art | ✅ 部分支持 | 需关闭streamResponse |
| 小米AI音箱（初代） | ⚠️ 有限支持 | 不支持连续对话 |
完整兼容列表可查看项目
docs/compatibility.md文件
🚀 进阶配置（可选）
设置开机自启动
-
创建启动脚本
start-mi-gpt.bat：@echo off cd C:\path\to\mi-gpt pnpm dev -
通过任务计划程序设置开机执行
切换国内大模型
以通义千问为例修改.env：
OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
OPENAI_MODEL=qwen-turbo
OPENAI_API_KEY=sk-xxxxxxxxxxxx # 云服务API_KEY
🔄 版本更新方法
# 获取最新代码
git pull
# 更新依赖
pnpm install
# 重新构建
pnpm build
# 重启服务
pnpm dev
📝 总结与展望
通过本文档，你已成功在Windows系统部署MiGPT，实现了小爱音箱与AI模型的对接。核心步骤包括：
- 配置Node.js开发环境
- 获取并构建项目代码
- 设置小米账号与AI服务
- 验证语音交互功能
后续功能规划：
- 智能家居控制集成
- 本地语音识别优化
- 多轮对话上下文增强
遇到新问题？查看项目
docs/faq.md或提交反馈。
🔖 收藏与分享
如果本教程对你有帮助，请：
- 收藏本文档以备后续查阅
- 分享给其他小爱音箱用户
- 关注项目更新获取新功能通知
技术支持：项目内置调试工具可收集详细日志，遇到问题时执行pnpm run debug生成报告。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
