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协议开发
            • MCP (Model Context Protocol) 协议文档
            • MCP 协议物联网控制用法说明
          • 动态文字 Glyph Push 扩展
          • 异步语音通知(notify)
          • 自定义开发板指南
          • 自定义 Assets 指南:唤醒词、字体、表情与聊天背景
          • BluFi 配网指南
          • 代码风格指南
          • 生态项目:服务端、客户端与移植方案
        • ESP32开发指南
          • 芯片支持与存储规格
          • 固件代码导览:目录结构、状态机与开发规则
          • 进阶扩展点:网络形态、唤醒词、MCP 与资源定制
          • ESP32 开发问题排查
      • 快速开始
      • 固件下载
      • 开发板与固件目录
      • 硬件与固件
      • 服务端与 AI
        • MCP 集成:服务端接入与智能家居
      • 开发文档
        • 开发环境
        • 源码与架构
        • 通信协议
        • 功能实现
        • 扩展定制
        • Web 客户端协议调试
      • 问题排查
        • 设备连接失败:从头诊断
      • 生态项目
      • 关于本站
      • 📝 XiaoZhi AI 开发博客
        • 小智 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协议开发
          • 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
      唤醒词、字体、表情与聊天背景打包
      由 XiaoZhi.Dev 提供支持
      © 2025 xiaozhi.dev.[email protected]