基本介紹
- 外文名：MiGPT
- 最近更新時間：2024年6月6日
發展歷程,核心技術,使用方式,部署前準備,啟動方式,關鍵配置項說明,高級功能：自定義回復,常見問題與解決方案,常見問題,重要事件,需求人群,
發展歷程
MiGPT項目於2024年啟動，旨在通過開源方式將小愛音箱與ChatGPT等大語言模型結合。2025年，項目進行了架構重構，將上下文記憶與流式回響功能解耦，提升了設備兼容性。2026年3月，全新升級版本MiGPT-Next發布，支持自定義訊息回復，並宣布原MiGPT項目停止維護，建議用戶遷移。
核心技術
MiGPT通過“檢測-中斷-回響”機制實現與用戶的自然對話互動，並通過正則表達式匹配用戶語音，將自然語言轉化為對米家智慧型設備的控制命令。
其核心架構經歷了顯著的演進：在早期版本中，流式回響功能與對話上下文記憶功能耦合在一起，導致非流式設備無法有效利用歷史對話信息。在後續版本中，項目團隊進行了架構重構，將這兩個功能解耦為獨立的控制參數，並創建了專門的歷史管理模組。此外，系統實現了訊息處理與LLM回響的分離，為開發者提供了onMessage回調接口，允許完全自定義回復邏輯。
使用方式
根據項目官方信息，原MiGPT項目已停止維護，並遷移至功能更完善、穩定性更高的MiGPT-Next項目。以下使用方式主要針對MiGPT-Next版本。
部署前準備
部署前需準備小愛音箱設備，並確保設備聯網。同時需要配置小米賬號的用戶ID和密碼，以及大模型如OpenAI的API密鑰。
啟動方式
MiGPT-Next支持Docker和Node.js兩種啟動方式。Docker啟動方式需先克隆代碼倉庫，修改配置檔案config.js，然後運行Docker命令如“docker run -it --rm -v$(pwd)/config.js:/app/config.js idootop/migpt-next:latest”。Node.js啟動方式需安裝@mi-gpt/next依賴，在代碼中引入MiGPT模組並配置參數後啟動。
關鍵配置項說明
配置檔案如config.js中的核心參數包括小愛音箱的用戶ID(userId)、密碼(password)和設備ID(did)。大模型連線參數需設定模型名稱(model)、API密鑰(apiKey)和BaseURL等。提示詞(prompt)配置用於定義系統角色。
高級功能：自定義回復
MiGPT-Next支持通過實現onMessage回調函式來自定義小愛音箱的回覆內容與行為。例如，當訊息為“測試”時，可以返回固定回復“你好,很高興認識你!”。此功能是MiGPT-Next的核心特性之一。
常見問題與解決方案
登錄失敗時需檢查小米ID（非手機號或信箱）和密碼是否正確，可能是網路異常或賬號被風控。小愛音箱不調用AI回復是因為默認只回響以特定喚醒詞開頭的訊息。有文字回復但無語音播放可能是部分型號小愛音箱TTS指令不兼容，可參考示例修改onMessage函式。播放中途戛然而止可能是部分設備不支持查詢播放狀態，可嘗試關閉流式回響(streamResponse)選項或更換設備。
常見問題
登錄小米賬號失敗可能由賬號密碼錯誤導致，小米 ID 並非手機號或信箱，也可能因網路異常或當前 IP 被小米賬號風控系統攔截。MiGPT默認只回響以配置檔案中設定的特定喚醒詞（callAIKeywords）開頭的訊息，非喚醒詞開頭的指令將不會調用AI模型。
部分型號的小愛音箱（如Play增強版）可能因TTS指令不兼容導致無聲或播放中途停止。若修改參數後問題仍然存在，說明設備不支持通過開放接口查詢播放狀態，建議更換為兼容性更好的型號，如小愛音箱 Pro，或關閉配置檔案中的流式回響（streamResponse）選項。
實現自定義豆包音色功能需要豆包 TTS 接口支持，MiGPT項目本身暫不對外提供此項服務。若需要在AI回答時立即打斷小愛同學原有的語音回復，目前需要對設備進行刷機操作。MiGPT-Next版本移除了對連續對話/流式回響的支持以提升穩定性，因此也無法通過軟體配置實現即時打斷。
重要事件
MiGPT-Next版本發布，原MiGPT項目停止維護。新版本修復了一些已知問題，並支持自定義訊息回復，提升了穩定性。
需求人群
MiGPT適合追求智慧型家居生活體驗的用戶，尤其是那些希望提升家中設備智慧型化水平，享受更個性化、更人性化互動體驗的人群。
