生態專案:服務端、客戶端與移植方案

生態專案:服務端、客戶端與移植方案

小智的裝置韌體、通訊協議和服務端是分開的:只要實現了WebSocket或 MQTT + UDP 協議,就可以替換其中任何一環。圍繞這套協議,社群出現了一批第三方開源專案。

本頁的名單來自上游韌體 README 的「相關開源專案」,並逐個核對了儲存庫狀態、授權條款和首頁描述(核對日期 2026-10-23)。這些專案由各自作者維護,不屬於本站,也不屬於上游韌體儲存庫;收錄不代表背書,使用前請自行評估功能、安全性和授權條款。

一、服務端

在自己的電腦或伺服器上執行後端,讓裝置改連你的伺服器。接入步驟與安全警示見自建服務端。

專案技術形態授權條款概要
xinnan-tech/xiaozhi-esp32-serverPython + Java + VueMIT支援 MQTT + UDP、WebSocket、MCP 接入點、聲紋識別、知識庫,有智控台
joey-zhou/xiaozhi-esp32-server-javaJava(Spring Boot)MIT企業級管理平台,管理後台與對話服務分為兩個行程
AnimeAIChat/xiaozhi-server-goGo修改版 Apache 2.0,含附加條件面向個人和家庭場景;附加條件包括未經書面授權不得用於多租戶,使用前請閱讀其 LICENSE
hackers365/xiaozhi-esp32-server-golangGoMIT全流式 ASR → LLM → TTS,支援 WebSocket 與 MQTT + UDP

二、客戶端與移植方案

使用小智通訊協議的非 ESP32 終端。

專案平台授權條款概要
huangjunsen0406/py-xiaozhiPython,跨平台MIT基於非同步架構的多模態互動框架,支援實時語音、視覺任務和 IoT 裝置控制
TOM88812/xiaozhi-android-clientFlutter(Android、iOS、HarmonyOS、Web、桌面)Apache-2.0基於小智的實時語音對話應用,可連線 xiaozhi-server
100askTeam/xiaozhi-linux嵌入式 Linux儲存庫未宣告授權條款Linux 小智核心程式碼,不含各單板的 BSP 驅動;已適配的單板列表見其 README
78/xiaozhi-sf32思澈 SF32 藍牙晶片MIT聯網基於藍牙 PAN 協議,採用 OPUS 編解碼,支援裝置端 MCP
QuecPython/solution-xiaozhiAI移遠 QuecPython 模組儲存庫未宣告授權條款基於 WebSocket 協議,範例開發板使用 EC800MCNLE 模組

三、選型提示

  • 先確認協議版本:這些專案各自實現通訊協議,欄位與行為可能與你手上的韌體版本不完全一致,以協議文件為準對照。
  • 先讀授權條款:多數專案為 MIT 或 Apache-2.0,也有專案附加了條件,或沒有宣告授權條款;商用前務必確認。
  • 看維護狀態:檢視儲存庫的最近提交與 Issues,而不是隻看 star 數。
  • 注意安全:第三方服務端和客戶端都會接觸裝置標識與語音資料,見自建服務端的安全警示。

四、更正與補充

名單有錯誤或需要補充時,請發郵件到 [email protected],並附上儲存庫位址和授權條款說明。韌體本身的問題請到上游 GitHub Issues 反饋。

相關文檔

對照來源:上游 78/xiaozhi-esp32 v2.5.2 的 README_zh.md「相關開源專案」,以及各儲存庫 README 與 LICENSE,核對日期 2026-10-23。