Logo Dark Logo 小智AI.Dev – ESP32 語音機器人 快速開始 硬體與韌體 伺服器與 AI 開發文件 問題排查 生態專案 部落格 關於
CTRL K
    CTRL K
      • 小智 AI 聊天機器人文檔中心 | 小智AI.Dev
        • AI 能力與分工:裝置端做什麼,服務端做什麼
        • 使用指南
          • 小智AI硬體搭建指南
          • 小智AI韌體下載
          • 支援的開發板
          • 首次啟動:配網、啟用與綁定
          • 網路設定說明
          • 自建服務端:讓小智裝置連線你自己的伺服器
          • 功能使用教學
          • 小智AI丐版 - ESP32開發板實現方案
          • 小智AI常見問題解答
        • 開發說明
          • ESP-IDF 開發環境搭建及編譯小智
          • WebSocket 通訊協議
          • MQTT + UDP 混合通訊協議文件
          • Emoji 心情顯示
          • 概覽
            • MCP (Model Context Protocol) 協議文件
            • MCP 協議物聯網控制用法說明
          • 動態文字 Glyph Push 擴充
          • 非同步語音通知(notify)
          • 自定義開發板指南
          • 自訂 Assets 指南:喚醒詞、字型、表情與聊天背景
          • BluFi 配網指南
          • 程式碼風格指南
          • 生態專案:服務端、客戶端與移植方案
        • ESP32開發指南
          • 晶片支援與儲存規格
          • 韌體程式碼導覽:目錄結構、狀態機與開發規則
          • 進階擴充點:網路形態、喚醒詞、MCP 與資源定製
          • ESP32 開發問題排查
      • 快速開始
      • 硬體與韌體
      • 開發板與韌體目錄
      • 韌體下載
      • 伺服器與 AI
        • MCP 整合:伺服器接入與智慧家庭
      • 開發文件
        • 開發環境
        • 原始碼與架構
        • 通訊協定
        • 功能實作
        • 擴展客製
        • Web 用戶端協定除錯
      • 問題排查
        • 設備連線失敗:從頭診斷
      • 生態專案
      • 關於本站
      • 部落格
        • 小智 ESP32 韌體 v2.5 解讀:ESP-IDF 6、全矩陣發布與安全加固
        • 自訂開發板遷移到 ESP-IDF 6:從上游遷移提交學到的改法
        • 選哪塊板子跑小智?按晶片、網路和成品板三步選型
        • 小智 AI 語音機器人能做什麼、不能做什麼:一頁讀懂 xiaozhi-esp32
        • 小智 AI 與 DeepSeek:裝置與大模型如何分工
        • 用麵包板做一個小智 AI 語音助手:從零件到第一次對話
      • AI 能力與分工:裝置端做什麼,服務端做什麼
      • 使用指南
        • 小智AI硬體搭建指南
        • 小智AI韌體下載
        • 支援的開發板
        • 首次啟動:配網、啟用與綁定
        • 網路設定說明
        • 自建服務端:讓小智裝置連線你自己的伺服器
        • 功能使用教學
        • 小智AI丐版 - ESP32開發板實現方案
        • 小智AI常見問題解答
      • 開發說明
        • ESP-IDF 開發環境搭建及編譯小智
        • WebSocket 通訊協議
        • MQTT + UDP 混合通訊協議文件
        • Emoji 心情顯示
        • 概覽
          • MCP (Model Context Protocol) 協議文件
          • MCP 協議物聯網控制用法說明
        • 動態文字 Glyph Push 擴充
        • 非同步語音通知(notify)
        • 自定義開發板指南
        • 自訂 Assets 指南:喚醒詞、字型、表情與聊天背景
        • BluFi 配網指南
        • 程式碼風格指南
        • 生態專案:服務端、客戶端與移植方案
      • ESP32開發指南
        • 晶片支援與儲存規格
        • 韌體程式碼導覽:目錄結構、狀態機與開發規則
        • 進階擴充點:網路形態、喚醒詞、MCP 與資源定製
        • ESP32 開發問題排查
      • 中文
      • English
      • 日本語
      • Русский
      • 繁體中文
      • 淺色

      • 深色

      • 跟随系统

      此頁上

      • 開發環境
      • 原始碼與架構
      • 通訊協定
      • 功能實作
      • 擴展客製

      開發文件

      修改、擴展或向小智韌體貢獻程式碼所需的資料:從 ESP-IDF 環境建置、原始碼結構,到 WebSocket / MQTT+UDP / MCP 協定與各功能模組的實作。

      開發環境

      ESP-IDF 環境建置
      工具鏈安裝、相依套件設定與首次編譯
      程式碼風格指南
      clang-format、C++23 基線與錯誤處理約定

      原始碼與架構

      韌體程式碼導覽
      目錄結構、應用狀態機與開發規則
      進階擴展點
      網路形態、喚醒詞、MCP 與資源客製

      通訊協定

      WebSocket 協定
      連線建立、hello 握手與訊息類型
      Web 用戶端協定除錯
      open-xiaozhi-client:連線、幀日誌、手動 JSON 與 MCP 工具呼叫
      MQTT + UDP 混合協定
      控制通道與音訊通道分離的通訊方式
      MCP 協定
      設備工具呼叫:協定規範與使用指南

      功能實作

      BluFi 配網
      透過 BLE 設定 Wi-Fi
      Emoji 情感顯示
      emotion 訊息與表情切換協定
      Glyph Push 擴展
      伺服器下發本地字庫缺失的字形
      非同步語音通知
      notify 訊息與 Ogg Opus 串流播放

      擴展客製

      自訂開發板指南
      新增板級目錄與編譯打包
      自訂 Assets
      喚醒詞、字型、表情與聊天背景打包
      由 Hextra 驅動
      © 2025 Hextra Project.[email protected]