【保姆级教程】小爱同学+AI！魔改小爱音箱，接入本地AI大模型，打造你的专属语音助手！
内容提要
mi-gpt是一个开源项目，可以将小爱音箱改造成个人专属语音助手，支持ChatGPT和豆包接入。mi-gpt具有设备自动化、问答、角色扮演、流式响应、长短期记忆和自定义TTS等功能。项目适用于小爱音箱Pro，需要安装Docker和Ollama，并进行相应配置。
延伸解读
本地部署的硬件门槛与模型选择
文章以macOS为例，建议硬盘100G以上，并推荐安装Ollama来运行本地模型。实际体验中，模型参数量越大对硬件要求越高，如llama3:70b约40G，多数电脑难以流畅运行。因此作者选择微软Phi-3小模型（3.8B-14B），在性能与资源消耗间取得平衡。读者需根据自身设备配置选择合适模型，避免盲目追求大参数导致运行卡顿。
配置中的关键参数与常见陷阱
配置文件.env和.migpt.js是核心。.env中OPENAI_BASE_URL需指向Ollama地址（http://host.docker.internal:11434/v1），OPENAI_MODEL填写模型名如phi3:latest。.migpt.js中userId、password、did必须准确，did需与米家中设备名称完全一致，注意空格和错别字。修改后需重启Docker容器生效。常见错误如登录失败、找不到设备，多因信息填写错误或账号安全验证导致。
唤醒模式与连续对话的交互逻辑
MiGPT提供两种唤醒方式：直接说“小爱同学，请xxx”可单次调用AI；说“小爱同学，召唤傻妞”则进入唤醒模式，支持连续对话，无需每次重复唤醒词。但需注意，在AI回答完毕提示“我说完了”后，需在几秒内继续提问，否则可能自动退出。若小爱正在播放音乐或讲笑话，需先暂停才能正常对话。这些细节影响实际使用流畅度。
项目限制与风险提示
MiGPT仅支持小爱音箱系列，暂不适配小度、天猫精灵等。且仅支持单实例运行，多设备需创建多个容器。项目通过云端接口轮询实现，存在1-2秒延迟，可能导致原小爱抢话。此外，作者声明仅供学习研究，不得商用，使用风险自负，包括账号封禁等。用户需遵守法律法规，并注意网络环境，如国内访问OpenAI需代理。
Q&A
mi-gpt项目的主要功能是什么？
mi-gpt项目可以将小爱音箱改造成个人专属语音助手，支持设备自动化、问答、角色扮演等功能。
如何安装mi-gpt？
安装mi-gpt需要准备小爱音箱Pro、电脑、Docker和Ollama，并按照项目提供的详细指南进行配置。
mi-gpt支持哪些智能家居设备？
mi-gpt支持多种智能家居设备的控制，具体支持的设备可以参考项目的兼容性文档。
使用mi-gpt需要注意哪些风险？
mi-gpt仅供学习和研究目的，不得用于商业活动，用户需自行承担使用风险，包括设备损坏和账号封禁等。
mi-gpt如何接入其他AI模型？
mi-gpt理论上兼容OpenAI SDK的模型，只需修改环境变量即可接入其他模型，如通义千问等。
mi-gpt的唤醒模式是什么？
唤醒模式允许用户在与小爱音箱互动时无需每句话都以“小爱同学”开头，可以通过特定唤醒词进入该模式。
