ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

MiGPT:10 分钟把小爱音箱接入大模型的完整教程

MiGPT:10 分钟把小爱音箱接入大模型的完整教程 MiGPT10 分钟把小爱音箱接入大模型的完整教程【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt你问小爱讲个笑话它只会翻来覆去那几句你问它一个复杂点的问题它开始顾左右而言他。MiGPT 就是干这件事的开源工具把小爱音箱接到 ChatGPT、豆包、通义千问等大模型上让家里现成的音箱用 AI 的声音回答你。跟着往下走10 分钟之内你能完成部署说出第一句问答。 项目速览先判断 MiGPT 适不适合你MiGPT 基于 Node.js跑 JavaScript 代码的运行时编写原理是轮询小米云端接口拿到你的语音消息转给大模型再把回答让小爱播出来。信息卡内容项目定位把小爱音箱接入 ChatGPT、豆包、通义千问等大模型改造成语音 AI 助手适合谁小爱音箱用户Pro 款体验最佳、想给家里加个语音 AI 入口的人上手难度低改两个配置文件 一条 Docker 命令前置条件小米账号、一台兼容的小爱音箱、一个大模型 API Key大概耗时10 分钟左右两句实话放前面本项目只支持小爱音箱系列小度、天猫精灵、HomePod 均不支持作者已宣布停止维护功能稳定但不指望新增特性介意的话心里有数再开始。 上手流程四步跑通小爱音箱大模型接入备齐三样东西账号、音箱、API Key小米账号里面有个数字形式的「小米 ID」注意不是手机号。小爱音箱兼容型号和对应参数见 兼容型号表Pro 款反馈最完整。大模型 API Key凡是兼容 OpenAI 接口的服务都行OpenAI、通义千问、Moonshot、DeepSeek甚至本地部署的 Ollama 模型。拿到代码并初始化两个配置文件git clone https://gitcode.com/GitHub_Trending/mi/mi-gpt cd mi-gpt cp .migpt.example.js .migpt.js cp .env.example .env分工很简单.migpt.js管音箱和 AI 人设.env管模型和密钥。填好 .migpt.js音箱账号与型号指令export default { bot: { name: 傻妞, profile: 性别女性格乖巧可爱 }, // AI 人设 speaker: { userId: 你的小米ID, // 数字ID不是手机号或邮箱 password: 账号密码, did: 小爱音箱Pro, // 米家APP里的设备名注意空格和大小写 ttsCommand: [5, 1], // 本型号的 TTS 播报指令 wakeUpCommand: [5, 3], // 本型号的唤醒指令 }, };ttsCommand和wakeUpCommand因型号而异别照抄示例按你的型号到 MIoT 指令库查一下或对照 compatibility.md 里的现成参数。按型号查指令参数照抄进配置文件接着在.env里改三处OPENAI_MODELgpt-4o-mini # 模型名 OPENAI_API_KEYsk-xxxxxx # 你的API密钥 OPENAI_BASE_URLhttps://api.openai.com/v1 # 模型服务接口Docker 启动服务并验证docker run -d --env-file $(pwd)/.env -v $(pwd)/.migpt.js:/app/.migpt.js idootop/mi-gpt:latest日志里出现 MiGPT 正常初始化、没有账号或设备报错就成功了。不想用 Docker 的话也可以npm install mi-gpt需 Node 16在代码里调MiGPT.create传入同样的配置写法见 README。跑起来后有三种叫法「小爱同学请 xxx」「小爱同学你 xxx」「小爱同学召唤 xxx」。最后一种会进入 AI 模式结束时说「退出」即可。启动成功后小爱用大模型的回答开口回应你 进阶玩法三种让音箱更像 AI 的改法切换大模型只改 .env 的三行能干什么给小爱换大脑GPT、豆包、通义千问、DeepSeek、本地 Ollama 模型随便换。关键配置.env里的OPENAI_MODEL、OPENAI_API_KEY、OPENAI_BASE_URL三个值换成对应服务的变量名保持不变。实际效果国内网络接豆包、通义千问不用配代理响应还更快接本地模型则完全不耗云端额度。人设定制 长短期记忆能干什么给小爱起名、定性格同时记住你们的聊天内容。关键配置.migpt.js里bot.name、bot.profile是 AI 的人设master.name、master.profile是你的简介systemTemplate决定这些信息怎么拼进提示词写法参考 prompt.md。记忆模块代码在 src/services/bot/memory/短期记近期上下文、长期沉淀偏好自动运行不用开关。实际效果直接说「小爱同学你是 xxx你 xxx」还能当场换人设追问时它能接住刚才的话题不用你重复前情。第三方 TTS给小爱换个声音能干什么默认用小米自带语音可以接火山 TTS豆包同款引擎或本地搭的 TTS 服务还能用语音指令换音色。关键配置.env填TTS_BASE_URL.migpt.js设tts: custom并加switchSpeakerKeywords: [把声音换成]步骤详见 tts.md。实际效果说「小爱同学把声音换成 xxx」当场切换音色自带 TTS 对个别敏感词播报受限的话走这条路也能绕开。播报或唤醒异常时按型号核对指令参数 实用场景三个用得上语音大模型的日常时刻做饭卡壳的时候手里攥着锅铲不方便掏手机「小爱同学请告诉我鸡蛋加葱还能做什么」答案直接播出来接着问「下一道呢」「要简单点的」都是连续操作全程不碰手机。孩子写作业的时候卡在数学应用题或课文理解上「小爱同学召唤傻妞」进入 AI 模式后直接念题。大模型的解释比搜索引擎的干巴巴条目耐心你还能把人设调成「老师口吻」。睡前不方便看屏幕的时候躺下之后问日程、讲概念、随便聊几句。长期记忆会把你们聊过的事存下来下次再唤醒时对话有延续感。️ 排坑指南MiGPT 五个高频问题与处理现象可能原因处理办法启动报「70016登录验证失败」userId 填成了手机号或邮箱去小米账号「个人信息」页复制数字小米 ID提示「找不到设备xxx」did 与米家中名称不一致错别字、空格、大小写从米家 APP 直接复制设备名或开enableTrace查设备 did控制台打印了回答音箱却不响ttsCommand 与型号不匹配按型号查 MIoT 指令库里的 TTS 指令改值回答说到一半戛然而止该型号查不到播放状态配置playingCommand或关闭streamResponse会失去连续对话「LLM 响应异常 Connection error」国内网络访问不了模型服务.env填HTTP_PROXY代理地址或改用国内模型接口如果卡在小米「异地登录保护」在与 MiGPT 相同的网络下用浏览器登录一次小米账号通过安全验证等约一小时再试。更多情况都写在 faq.md 里。查 playingCommand 对应的播放状态指令解决说一半问题 收尾与资源导航一句话收束小爱音箱是身体大模型是大脑MiGPT 是连接两者的那根神经。想继续深挖从下面几处入手配置参数全部字段说明常见问题绝大多数坑的现成答案兼容型号与指令参数按型号查配置第三方 TTS 教程换声音的完整步骤工作原理实现机制与已知限制核心源码音箱控制、对话、记忆三个模块官方教程 PDF图文版入门【免费下载链接】mi-gpt 将小爱音箱接入 ChatGPT 和豆包改造成你的专属语音助手。项目地址: https://gitcode.com/GitHub_Trending/mi/mi-gpt创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表