news 2026/4/15 18:56:41

小智AI 如何自定义唤醒词+背景图:原理+流程拆解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
小智AI 如何自定义唤醒词+背景图:原理+流程拆解

小智AI 从v2.0.x版本开始,支持用户自定义唤醒词+表情包+背景图

实现效果如下:

有朋友好奇:如何实现的?

本文,将尝试拆解这部分的基本原理实现思路

1. 设备端

首先,我们要了解 ESP32 芯片中的数据是如何存储的,已了解的朋友可跳过。

以常见的ESP32s3-N16R8为例,这里的N16R8分别代表啥?

1.1 ESP32中的存储

按照是否在芯片上,存储分两种:

1. 片上存储器(On-chip Memory)

  • 内部ROM(384KB):存储启动代码和关键的系统函数
  • 内部SRAM(512KB):用于运行时变量、堆栈等,访问速度快,断电后数据丢失
  • RTC存储器(16KB):8KB快速存储器,8KB慢速存储器

可以理解为计算机的内存。

2. 片外存储器(Off-chip Memory)

  • Flash存储器:容量通常为8MB或16MB,用于存储程序代码、常量数据和文件系统
  • PSRAM(可选):伪静态随机存储器,用于扩展运行时内存,通过SPI接口连接

可以理解为计算机的硬盘、虚拟内存。

N16R8就代表 16M 的 Flash 和 8M 的 PSRAM。

硬盘空间有限,为了充分利用,有了分区的概念。

1.2 Flash中的分区

ESP32s3的 16M 为例,它的分区表如下:

# Name, Type, SubType, Offset, Size, Flags nvs, data, nvs, 0x9000, 0x4000, otadata, data, ota, 0xd000, 0x2000, phy_init, data, phy, 0xf000, 0x1000, ota_0, app, ota_0, 0x20000, 0x3f0000, ota_1, app, ota_1, , 0x3f0000, assets, data, spiffs, 0x800000, 8M

上表中,Offset代表分区的起点,Size代表分区的大小。

那为啥nvs是从0x9000开始呢?

因为,0x1000-0x9000另有他用:

  • Bootloader(0x1000-0x8000):存储启动引导程序

  • 分区表(0x8000-0x9000):描述Flash中各分区的信息

这些分区分别是干啥呢?

  • NVS分区(0x9000开始,16KB):存储配置参数和键值对数据
  • OTA数据分区(0xd000开始,8KB):存储OTA更新相关的元数据
  • PHY初始化数据(0xf000开始,4KB):存储射频校准数据
  • OTA固件分区(两个,约3.9MB):存储主应用程序代码,支持固件更新和回滚
  • Assets分区(8MB):存储资源文件(图片、音频、字体等)

上述分区,有哪些优势?

  • 充分利用 Flash 的所有空间;
  • ota_0 和 ota_1 交替使用,当前分区处于"活动"状态,另一分区接收新固件;
  • 分区分工明确,OTA固件分区Assets分区独立更新,互不干扰

而用来自定义唤醒词+表情包+背景图的,正是这里的Assets分区

问题来了,Assets分区里放的啥,设备端又如何接收更新呢?

下面来看,服务端要做哪些工作。

2. 服务端

2.1 前端交互页面

前端代码已开源:https://github.com/78/xiaozhi-assets-generator

首先,服务端会读取的设备系统信息:

然后,用户可以自定义的选项如下:

  • 唤醒词:内置 esp32 官方训好的唤醒词
  • 字体
  • 表情
  • 背景图

最后,前端否则把上述文件打包成assets.bin:

这个assets.bin就是塞进Assets分区的文件。

问题来了,放在你浏览器中的assets.bin如何送到设备中去的?

2.2 后端处理逻辑

先看流程图:

具体执行步骤如下:

step 1:前端和后端保持 websocket 长连接,将assets.bin发送到后端服务器,生成一个url

step 2:通过callMcpTool实现工具调用,本质是给后端发 POST 请求。

step 2.1:调用self.assets.set_download_urlurl送给设备端。

云端调用该工具后,设备端会将url保存到设置中。

AddUserOnlyTool("self.assets.set_download_url", "Set the download url for the assets", PropertyList({ Property("url", kPropertyTypeString) }), [](const PropertyList& properties) -> ReturnValue { auto url = properties["url"].value<std::string>(); Settings settings("assets", true); settings.SetString("download_url", url); return true; });

step 2.2:调用self.reboot,设备重启。

step 2.3:设备重启后,根据url下载assets.binAssets分区

自此,设备端更新生效。

问题来了,上述工具调用,不都是 MCPTool 吗?

而要实现tool/call,底层还得通过MQTT,所以前端给后端发了 POST 请求后,后端是给MQTT broker的 topic 发了这条指令,最终这条指令,被设备端执行。

写在最后

本文分享了小智AI: 自定义唤醒词+表情包+背景图的基本原理和实现思路。

篇幅有限,关于MQTT + MCP实现设备远程控制的原理,我们下篇见。

如果对你有帮助,不妨点赞收藏备用。

小智Pro下一版本更新,也将支持设备远程控制,有任何想法,欢迎来聊👇:

https://ai.feishu.cn/wiki/IfTawES0mi0YTqk8GQ4cw4qOnD3

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/16 11:58:54

Excalidraw多语言支持现状及中文优化方案

Excalidraw多语言支持现状及中文优化方案 在远程协作成为常态的今天&#xff0c;可视化工具早已不再是设计师的专属。越来越多的技术团队开始依赖像 Excalidraw 这样的轻量级白板工具来绘制架构图、梳理业务流程&#xff0c;甚至进行敏捷回顾。其手绘风格带来的轻松感与低门槛&…

作者头像 李华
网站建设 2026/4/14 14:17:24

Excalidraw支持导出SVG/PNG/LaTeX,适配多场景

Excalidraw&#xff1a;从手绘草图到出版级输出的多模态演进 在技术团队频繁使用流程图、架构图和线框图进行沟通的今天&#xff0c;一张清晰又不失亲和力的图表&#xff0c;往往比千言万语更有效。但现实是&#xff0c;大多数工具要么过于僵硬——像传统UML工具那样机械刻板&a…

作者头像 李华
网站建设 2026/4/9 21:49:15

【Open-AutoGLM系统兼容优化指南】:破解版本冲突难题的5大核心技术

第一章&#xff1a;Open-AutoGLM系统兼容优化概述在构建和部署大规模语言模型应用时&#xff0c;Open-AutoGLM 作为一款面向自动化生成与逻辑推理的开源框架&#xff0c;其跨平台兼容性与运行效率直接影响系统的稳定性与可扩展性。为确保该系统能够在多样化的硬件环境与软件依赖…

作者头像 李华
网站建设 2026/4/14 10:09:48

Open-AutoGLM迁移学习实战:3步实现跨领域模型性能提升90%

第一章&#xff1a;Open-AutoGLM迁移学习应用优化概述Open-AutoGLM 是基于 AutoGLM 架构开发的开源迁移学习框架&#xff0c;专注于提升预训练语言模型在下游任务中的适应效率与性能表现。该框架通过动态权重分配、任务感知微调策略和轻量化适配模块设计&#xff0c;显著降低了…

作者头像 李华
网站建设 2026/4/1 4:29:44

揭秘Open-AutoGLM版本兼容性问题:3步实现跨环境无缝部署

第一章&#xff1a;Open-AutoGLM 系统版本兼容优化在部署 Open-AutoGLM 框架时&#xff0c;系统版本的兼容性直接影响模型训练与推理的稳定性。不同操作系统、Python 版本及依赖库之间的差异可能导致运行时异常或性能下降。为确保跨平台一致性&#xff0c;需对核心依赖项进行版…

作者头像 李华
网站建设 2026/4/12 20:53:31

Excalidraw在金融系统架构设计中的应用实例

Excalidraw在金融系统架构设计中的应用实例 在一次大型商业银行核心系统升级的紧急评审会上&#xff0c;几位分布在北京、上海和深圳的架构师同时接入一个共享画布。没有人打开PPT&#xff0c;也没有人翻阅厚重的文档——他们正用不同颜色的笔在一张“手绘风格”的架构图上实时…

作者头像 李华