行空板K10小智AI聊天机器人：固件烧录与配置

固件包：`xiaozhi-unihikerk10-2.1.0-CNver.zip`
核心新增：自定义唤醒词、自定义屏幕 UI 主题、OTA 在线升级，原生适配 K10 麦克风 / 喇叭 / 2.8 寸屏 / 摄像头 MCP 多模态拍照识别行空板

## 一、准备清单

1. 行空板 K10（ESP32-S3）、带数据功能 Type-C 线（不要充电线、不要拓展坞）
2. 工具：ESP32 Flash Download Tool（乐鑫官方下载工具目前版本V3.9.8）

3. 固件包：xiaozhi-unihikerk10-2.1.0-CNver.zip，解压得到 merged-binary.bin
4. 网页控制台：`xiaozhi.me`（浏览器打开，手机 / 电脑均可）

## 二、烧录步骤（Flash Download Tool）

1. 进入烧录 BOOT 模式
长按 K10 背面 BOOT 键 → 插 USB 连电脑 → 2 秒后松开 BOOT 键；设备管理器出现 COM 口即为成功。

打开flash_download_tool_3.9.8_w1烧录软件

2. 工具参数设置
- ChipType：`ESP32-S3`
- WorkMode：`Develop`
- LoadMode：`UART`
- bin 文件起始地址：0x00
- 波特率：`115200`，选中对应 COM 端口

3. 烧录流程
- 先点【ERASE】全片擦除 Flash（必做，避免旧分区残留报错、芯片同步失败）
- 擦除完成后点【START】开始烧录，等待 100%

4. 烧录结束：按背面 RST 复位按键，K10 自动启动进入 WiFi 配网热点模式

> 报错参考（你之前遇到的`ESP32S3 Chip sync error`）：大多是线非数据线、没按住 BOOT 进下载模式、没先擦除 Flash、驱动缺失。

1. 手机 WiFi 列表连接 K10 热点：`Xiaozhi-xxxx`（这里是XiaoZhi EE6D）

2. 自动弹出配网页面，填入家里 2.4G WiFi 名称 + 密码（仅支持 2.4G，5G WiFi 无法连接）

3. 提交后 K10 重启、连 WiFi，屏幕显示“ 配置成功 "，播报6 位数字验证码（用于控制台绑定设备）

## 四、行空版K10上电，自动扫描WIFI，自动连接上服务器，检查更新，进入待机模式（等待唤醒）
唤醒词为“你好小智”，唤醒后即可与小智进行聊天或控制LED和相机。

## 五、xiaozhi.me 控制台｜智能体完整配置（2.1.0 重点）

1. 浏览器打开 `xiaozhi.me`，注册 / 登录账号，进入【控制台】
2. 添加设备：输入板子上 6 位验证码，完成设备绑定；此时设备状态为在线（必须在线才能下发配置、OTA）
3. 新建 / 编辑智能体（核心面板）
- ✅ 基础角色：角色名称、角色人设提示词、音色选择、语速调节
- ✅ 模型选择：小智 Lite / DeepSeek 等（创客教学推荐 DeepSeek）
- ✅ 唤醒词配置（2.1.0 新增）：预设唤醒词 / 自定义唤醒词（拼音 + 汉字），可调唤醒灵敏度、唤醒超时
- ✅ 声纹识别：录入多个人声，区分不同使用者
- ✅ MCP 工具配置：开启摄像头拍照、板载 RGB 灯、传感器读取等本地能力（K10 专属多模态）
- ✅ 历史对话、长期记忆开关
4. 【管理设备→主题自定义】（2.1.0 特色）
自定义屏幕字体、背景、对话气泡样式、待机画面，配置完成在线 OTA 下发，不用重新串口烧录
5. 保存智能体，绑定到当前 K10 设备，板子自动拉取新配置；复位后即可语音唤醒对话

## 六、基础使用 & 恢复出厂

- 唤醒：喊你设置的唤醒词，支持语音对话、拍照识图、控制板载 LED
- 恢复 K10 出厂（退出小智固件，回到 Mind + 图形化）：Mind+V2 选中 K10，连接串口，点击【擦除 / 恢复初始化设置】，按住 BOOT 再上电执行行空板

## 七、快速排错

1. 烧录同步失败：换数据线、换电脑后置 USB 口、先 ERASE 擦除
2. 配网连不上：确认是 2.4G WiFi，关闭路由 AP 隔离
3. 控制台无法配置：设备必须显示【在线】，离线状态不能下发主题 / 唤醒词配置
4. 唤醒不灵敏：优先用官方预设唤醒词，自定义唤醒识别率更低，调高灵敏度

## 八、相关资料

小智 AI 官网

https://xiaozhi.me/

小智 AI 控制台
https://xiaozhi.me/console/agents

小智 AI 聊天机器人百科全书
https://my.feishu.cn/wiki/F5krwD16viZoF0kKkvDcrZNYnhb

小智 AI 聊天机器人文档中心
https://xiaozhi.dev/docs/

小智 AI 硬件搭建指南
https://xiaozhi.dev/docs/usage/hardware-guide/

小智 AI 基础教程
https://xiaozhi.me/xz-docs/docs/category/%E5%9F%BA%E7%A1%80%E6%95%99%E7%A8%8B/

微雪 ESP32-S3-RLCD-4.2 小智 AI 应用教程
https://docs.waveshare.net/ESP32-S3-RLCD-4.2/XiaoZhi_AI/

DF官方人工智能AI介绍
https://www.unihiker.com.cn/wiki/k10/xiaozhi_ai

烧录工具（V3.98版本）

2.1.0版本固件

1.8.5版本固件

（视频）行空板k10接入小智ai
https://www.bilibili.com/video/BV1fF9cYgEf7/?vd_source=98c6b1fc23b2787403d97f8d3cc0b7e5

（视频）行空板K10搭载小智AI对话演示
https://www.bilibili.com/video/BV1ctQDYEE8v/?vd_source=98c6b1fc23b2787403d97f8d3cc0b7e5

（视频）给接入MCP的小智AI通过行空板K10装上“眼睛”（中文互动）
https://www.bilibili.com/video/BV1LojqzoEdT/?vd_source=98c6b1fc23b2787403d97f8d3cc0b7e5

（视频）这小智AI机器人说话还怪好听的嘞…… | 小智AI接入行空板K10
https://www.bilibili.com/video/BV1Wud5YbECn/?vd_source=98c6b1fc23b2787403d97f8d3cc0b7e5

（视频）5分钟使用行空板K10快速手搓一个小智Ai助手 | DeepSeek
https://www.bilibili.com/video/BV1H3AWeeEa4/?vd_source=98c6b1fc23b2787403d97f8d3cc0b7e5

ESP32 小智AI
https://github.com/78/xiaozhi-esp32

https://github.com/tiger191/xiaozhi_AI

https://gitee.com/xiaozhi-ai/xiaozhi-esp32

K10加强版
https://github.com/du-yuxuan/xiaozhi-esp32-k10