xiaozhi-esp32：3个步骤扩展唤醒词存储，解决AI助手存储瓶颈

问题引入：唤醒词存储不足的痛点与解决方案

你是否遇到过这样的情况：刚添加了第二个自定义唤醒词，设备就提示"存储空间不足"？默认配置下的xiaozhi-esp32往往受限于基础存储分区（存储区域分配方案），无法满足多唤醒词、大模型的存储需求。本文将通过三个核心步骤，带你完成自定义分区配置，让设备存储容量提升300%，轻松支持多场景语音交互。

核心原理：认识存储分区与容量分配

存储分区的工作机制

分区表（存储区域分配方案）就像设备的"硬盘分区"，将ESP32的Flash存储空间划分为不同功能区域。xiaozhi-esp32默认采用4MB基础配置，其中唤醒词模型仅分配1MB空间，这也是多数用户遇到存储不足的根本原因。

存储分配可视化图表

分区名称	类型	大小	功能说明
nvs	数据区	16KB	存储系统配置信息
otadata	数据区	8KB	OTA升级信息
phy_init	数据区	4KB	无线射频参数
model	数据区	4MB	唤醒词模型存储（可扩展）
ota_0	应用区	6MB	主程序分区
ota_1	应用区	6MB	备份程序分区

注：以上为16MB Flash配置下的优化方案，model分区相比默认配置提升300%

操作指南：三步完成存储扩展

准备工作：选择合适的分区模板

根据你的设备Flash容量选择对应模板：

• 16MB Flash：使用partitions/v1/16m_custom_wakeword.csv模板
• 32MB Flash：使用partitions/v1/32m.csv模板
• 其他容量：复制现有模板修改Size字段自定义分配

执行步骤：配置与生成

🔧 配置修改：打开选择的CSV文件，确认model分区大小参数。例如16m_custom_wakeword.csv中应包含：

model, data, spiffs, 0x10000, 0x3f0000  # 4MB唤醒词存储区

📦 工具准备：运行项目提供的脚本工具生成分区文件：

python scripts/spiffs_assets/build_all.py --mode emoji_collections

该命令会在scripts/spiffs_assets/build/final目录生成包含唤醒词模型的assets.bin文件。

验证方法：烧录与确认

连接设备并执行烧录命令：

idf.py -p /dev/ttyUSB0 partition-table-flash

如何验证分区是否生效？通过MCP协议发送存储信息查询命令：

{
  "method": "tools/call",
  "params": {
    "name": "system.storage.info"
  }
}

返回结果中model分区大小应显示为4MB（或自定义大小）。

进阶技巧：优化与问题排查

高级容量扩展

需要存储超过4MB的唤醒词模型时，可修改分区文件：

model, data, spiffs, 0x10000, 0x7f0000  # 扩展为8MB

同时更新build_all.py中的模型打包参数，支持更大模型组合。

常见问题排查

1. 烧录失败：检查Flash容量是否匹配所选模板，16m模板需16MB以上Flash
2. 模型加载错误：确认model分区类型为spiffs，且大小足够容纳模型文件
3. OTA升级失败：确保ota_0和ota_1分区总和不超过Flash剩余空间

图：xiaozhi-esp32的MCP协议架构，展示设备与云服务的交互流程

通过以上步骤，你的xiaozhi-esp32设备将获得充足的唤醒词存储空间，为打造个性化AI助手奠定基础。配合MCP协议，还能实现唤醒词动态切换和远程更新，让语音交互体验更上一层楼。