MiGPT跨平台部署：Windows系统安装教程

🔥 为什么选择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️⃣ 配置环境变量

1. 复制环境变量模板：

   copy .env.example .env
   

2. 用记事本打开.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️⃣ 配置设备连接

1. 复制配置文件模板：

   copy .migpt.example.js .migpt.js
   

2. 编辑.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 (在线)

🎯 功能验证与测试

基础功能测试流程

sequenceDiagram
    participant 用户
    participant 小爱音箱
    participant MiGPT服务
    participant AI API
    
    用户->>小爱音箱: 小爱同学，请讲个笑话
    小爱音箱->>MiGPT服务: 转发语音指令
    MiGPT服务->>AI API: 请求生成笑话
    AI API-->>MiGPT服务: 返回笑话内容
    MiGPT服务-->>小爱音箱: 播放AI回复
    小爱音箱-->>用户: 播放笑话

验证步骤：

1. 语音唤醒测试：

   • 对音箱说："小爱同学，请今天天气如何"
   • 预期结果：音箱回复当前天气信息

2. 连续对话测试：

   • 先说："小爱同学，打开AI模式"
   • 再问："北京的天气呢"（无需重复唤醒词）
   • 预期结果：直接回复北京天气

3. 错误处理测试：

   • 故意填写错误的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

性能优化建议

1. 降低延迟：

   // .migpt.js
   speaker: {
     checkInterval: 500,  // 减少状态检测间隔
     streamResponse: true  // 启用流式回复
   }
   

2. 减少内存占用：

   # .env
   NODE_OPTIONS=--max-old-space-size=1024  # 限制内存使用为1GB
   

📊 兼容设备型号

设备型号	兼容性	特殊配置
小爱音箱Pro	✅ 完美支持	无需额外配置
小爱音箱Play	✅ 基本支持	需要设置playingCommand: [3,1,1]
小爱音箱Art	✅ 部分支持	需关闭streamResponse
小米AI音箱（初代）	⚠️ 有限支持	不支持连续对话

完整兼容列表可查看项目docs/compatibility.md文件

🚀 进阶配置（可选）

设置开机自启动

1. 创建启动脚本start-mi-gpt.bat：

   @echo off
   cd C:\path\to\mi-gpt
   pnpm dev
   

2. 通过任务计划程序设置开机执行

切换国内大模型

以通义千问为例修改.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模型的对接。核心步骤包括：

1. 配置Node.js开发环境
2. 获取并构建项目代码
3. 设置小米账号与AI服务
4. 验证语音交互功能

后续功能规划：

• 智能家居控制集成
• 本地语音识别优化
• 多轮对话上下文增强

遇到新问题？查看项目docs/faq.md或提交反馈。

🔖 收藏与分享

如果本教程对你有帮助，请：

• 收藏本文档以备后续查阅
• 分享给其他小爱音箱用户
• 关注项目更新获取新功能通知

---

技术支持：项目内置调试工具可收集详细日志，遇到问题时执行pnpm run debug生成报告。