將小愛音箱接入 ChatGPT 和豆包，改造成你的專屬語音助手。
文 | Yuki
編輯 | Yuki
家的概念已經(jīng)遠(yuǎn)遠(yuǎn)超出了傳統(tǒng)的居住空間，變成了我們數(shù)字生活的一個延伸。通過技術(shù)的力量，家成為了一個充滿智慧和溫度的生活環(huán)境。MiGPT正是在這樣的背景下應(yīng)運(yùn)而生，它通過將小愛音箱和米家智能設(shè)備與ChatGPT的強(qiáng)大理解能力結(jié)合起來，使得智能家居變得更加貼近用戶的需求。
MiGPT的核心不僅僅在于實(shí)現(xiàn)設(shè)備的自動化控制，更在于創(chuàng)造一個能夠理解你、陪伴你成長的智能家庭環(huán)境。每一個智能設(shè)備，無論是簡單的燈泡插座還是復(fù)雜的掃地機(jī)器人和電視，都變成了一個有情感、能夠理解指令的智能體。這些智能體不僅能夠獨(dú)立響應(yīng)用戶的需求，還能夠相互協(xié)作，形成一個強(qiáng)大的智能網(wǎng)絡(luò)，共同為家庭成員提供更加個性化、更加舒適的生活體驗(yàn)。
在這個智能家居系統(tǒng)中，小愛音箱扮演著至關(guān)重要的角色。它不僅是用戶與智能家居系統(tǒng)交互的橋梁，更像是一個貼心的家庭管家，始終傾聽用戶的需求，用它的智慧和溫度為用戶提供服務(wù)，釋放智能家居的真正潛力。隨著技術(shù)的不斷進(jìn)步，我們有理由相信，智能家居將會成為我們生活中不可或缺的一部分，為我們帶來更多的便利和舒適。
項目亮點(diǎn)
Astera Labs：AI芯片公司Astera Labs成功登陸美股IPO，僅通過2.323億美元的風(fēng)險投資實(shí)現(xiàn)了55億美元的市值飆升，得益于與英特爾和英偉達(dá)的合作。
1. LLM 回答：小愛音箱升級為會話專家，利用ChatGPT等大型語言模型回答你的各種問題，讓交流變得更加智能和有趣。
2. 角色扮演：小愛音箱能夠根據(jù)你的需求變身為不同角色，無論是完美的生活伴侶還是傾聽你心事的知己，小愛都能做到。
3. 流式響應(yīng)：小愛音箱實(shí)現(xiàn)即時反饋，快速響應(yīng)你的指令和問題，就如同愛情的迅疾，不讓你等待。
4. 長短期記憶：小愛音箱擁有了記憶功能，能夠記住與你的對話歷史，隨著時間的積累，對話交流變得更加自然和默契。
5. 自定義 TTS：如果你想要更多樣化的語音體驗(yàn)，小愛音箱還支持自定義文本到語音（TTS）功能，可以選擇不同的音色，讓交流更加生動。
6. 智能家居 Agent：小愛音箱不僅僅是一個對話設(shè)備，它還能作為智能家居的控制中心，根據(jù)你的情緒自動播放音樂、調(diào)節(jié)燈光，營造舒適的居家氛圍。
這些特點(diǎn)展示了智能家居設(shè)備如何通過人工智能技術(shù)變得更加人性化，提升了用戶的居家體驗(yàn)。
啟動項目
準(zhǔn)備配置文件：首先，你需要根據(jù)「配置參數(shù)」章節(jié)的指引，準(zhǔn)備好.env和.migpt.js這兩個配置文件。這兩個文件包含了啟動MiGPT所需的各種參數(shù)，比如設(shè)備的ID、密碼等信息。
安裝Docker：如果你的電腦上還沒有安裝Docker，需要先進(jìn)行安裝。Docker是一個開源的應(yīng)用容器引擎，允許開發(fā)者打包他們的應(yīng)用以及依賴包到一個可移植的容器中，然后發(fā)布到任何流行的Linux機(jī)器上，也可以實(shí)現(xiàn)虛擬化。安裝方法可以參考Docker官方網(wǎng)站的指南。
啟動Docker容器：配置好文件后，打開命令行工具，切換到包含.env和.migpt.js文件的目錄下，然后運(yùn)行以下Docker命令來啟動MiGPT：
docker run -d--env-file $(pwd)/.env \-v $(pwd)/.migpt.js:/app/.migpt.js \idootop/mi-gpt:latest
這條命令的作用是使用idootop/mi-gpt:latest這個Docker鏡像來啟動一個容器，-d參數(shù)表示后臺運(yùn)行，--env-file指定了環(huán)境變量文件，-v參數(shù)用于掛載.migpt.js配置文件到容器內(nèi)的指定位置。
注意：在Windows系統(tǒng)的命令行工具中（比如PowerShell或CMD），$(pwd)這種方式可能無法正確獲取當(dāng)前目錄路徑，你可能需要手動指定絕對路徑。
以上就是使用Docker啟動MiGPT的基本步驟。這種方式的好處是不需要自己配置復(fù)雜的運(yùn)行環(huán)境，只需準(zhǔn)備好配置文件并運(yùn)行相應(yīng)的Docker命令即可快速啟動。
Node.js
如果你是一名前端 (Node) 開發(fā)者，也可以通過 NPM 安裝 mi-gpt 啟動 MiGPT。
npm install mi-gpt # 安裝依賴
然后，創(chuàng)建并啟動 MiGPT 實(shí)例。初始化參數(shù)請看下面的「配置參數(shù)」章節(jié)。
import { MiGPT } from 'mi-gpt';
async function main() {const client = MiGPT.create({speaker: {userId: '944123456', // 注意：不是手機(jī)號或郵箱，請在「個人信息」-「小米 ID」查看password: '123456', // 賬號密碼did: '小愛音箱Pro', // 小愛音箱 ID 或在米家中設(shè)置的名稱},});await client.start();}
main();
配置參數(shù)
.migpt.js
重命名本項目根目錄下的 .migpt.example.js 文件為 .migpt.js。
然后，將里面的配置參數(shù)修改成你自己的，參數(shù)含義如下：
參數(shù)名稱描述示例
bot
name對方名稱（小愛音箱）'傻妞'
profile對方的個人簡介/人設(shè)'性別女，性格乖巧可愛，喜歡搞怪，愛吃醋。'
master
name主人名稱（我自己）'陸小千'
profile主人的個人簡介/人設(shè)'性別男，善良正直，總是舍己為人，是傻妞的主人。'
room
name會話群名稱'魔幻手機(jī)'
description會話群簡介'傻妞和陸小千的私聊'
speaker
userId小米 ID（注意：不是手機(jī)號或郵箱）'944123456'
password賬戶密碼'123456'
did小愛音箱 ID 或名稱'小愛音箱 Pro'
ttsCommand小愛音箱 TTS 指令（可在此查詢）[5, 1]
wakeUpCommand小愛音箱喚醒指令（可在此查詢）[5, 3]
playingCommand小愛音箱是否在播放中指令（可在此查詢）[3, 1, 1]
speaker 其他參數(shù)（可選）
callAIKeywords當(dāng)消息以關(guān)鍵詞開頭時，會調(diào)用 AI 來響應(yīng)用戶消息['請', '傻妞']
wakeUpKeywords當(dāng)消息以關(guān)鍵詞開頭時，會進(jìn)入 AI 喚醒狀態(tài)['召喚傻妞', '打開傻妞']
exitKeywords當(dāng)消息以關(guān)鍵詞開頭時，會退出 AI 喚醒狀態(tài)['退出傻妞', '關(guān)閉傻妞']
onEnterAI進(jìn)入 AI 模式的歡迎語['你好，我是傻妞，很高興認(rèn)識你']
onExitAI退出 AI 模式的提示語['傻妞已退出']
onAIAskingAI 開始回答時的提示語['讓我先想想', '請稍等']
onAIRepliedAI 結(jié)束回答時的提示語['我說完了', '還有其他問題嗎']
onAIErrorAI 回答異常時的提示語['出錯了，請稍后再試吧！']
exitKeepAliveAfter無響應(yīng)一段時間后，多久自動退出喚醒模式（單位秒，默認(rèn) 30 秒）30
環(huán)境變量
重命名本項目根目錄下的 .env.example 文件為 .env。
然后，將里面的環(huán)境變量修改成你自己的，參數(shù)含義如下：
環(huán)境變量名稱描述示例
OpenAI
OPENAI_API_KEYOpenAI API 密鑰abc123
OPENAI_MODEL使用的 OpenAI 模型gpt-4o
AZURE_OPENAI_API_KEY可選，Microsoft Azure OpenAIabc123
OPENAI_BASE_URL可選，OpenAI API BaseURLhttps://api.openai.com/v1
提示音效（可選）
AUDIO_SILENT靜音音頻鏈接'https://example.com/slient.wav'
AUDIO_BEEP默認(rèn)提示音鏈接'https://example.com/beep.wav'
AUDIO_ACTIVE喚醒提示音鏈接'https://example.com/active.wav'
AUDIO_ERROR出錯提示音鏈接'https://example.com/error.wav'
豆包 TTS（可選）
TTS_DOUBAO豆包 TTS 接口'https://example.com/tts.wav'
SPEAKERS_DOUBAO豆包 TTS 音色列表接口'https://example.com/tts-speakers'
常見問題
Q：支持哪些型號的小愛音箱？
大部分型號的小愛音箱都支持，推薦小愛音箱 Pro（完美運(yùn)行）。部分機(jī)型的 MioT 接口開放能力并不完整，比如小米音箱 Play 增強(qiáng)版（L05C），將會導(dǎo)致 MiGPT 部分功能異常，相關(guān) issue。
Q：除了 OpenAI 還支持哪些模型，如何設(shè)置？
理論上兼容 OpenAI SDK 的模型都支持，只需修改環(huán)境變量即可接入到 MiGPT。
比如：通義千問、零一萬物、Moonshot、DeepSeek 等，以 Moonshot 為例：
OPENAI_BASE_URL=https://api.moonshot.cn/v1OPENAI_MODEL=moonshot-v1-8kOPENAI_API_KEY=$MOONSHOT_API_KEY
Q：登錄小米賬號失敗，提示 401
賬號密碼不正確：小米 ID 并非手機(jī)號或郵箱，請在「個人信息」-「小米 ID」查看。
網(wǎng)絡(luò)異常：如果你的賬號密碼確認(rèn)配置正確，出現(xiàn) 401 登錄異常大概率是因?yàn)榫W(wǎng)絡(luò)異常，或當(dāng)前 IP 小米賬號登錄被風(fēng)控。請嘗試切換代理或等待一段時間（2-24 小時）后再試。issue#10
Q：小愛音箱收到消息后，沒有調(diào)用 AI 進(jìn)行回復(fù)
MiGPT 收到消息默認(rèn)不會調(diào)用 AI 進(jìn)行回復(fù)，只會回復(fù)以喚醒詞（callAIKeywords）開頭的消息，比如：“請問 xxx”、“你 xxx” 等，你也可以自定義喚醒詞列表。
Q：小愛音箱沒有播放 AI 的回答，但控制臺有打印 AI 的回復(fù)
不同型號的小愛音箱 TTS 指令不同: https://github.com/idootop/mi-gpt/issues/5
請到 https://home.miot-spec.com 查詢具體指令，并修改配置文件中的 ttsCommand 參數(shù)。
