模板: 小智AI应用MK20
来自Waveshare Wiki
小智AI应用
小智AI依赖网络,需要先配置网络。
1. 设备配网
注意:仅支持 2.4GHz WiFi,不支持 5G WiFi。
① 请先将 USB 无线网卡插入设备的 USB 接口,再给设备通电。当前 USB 无线网卡不支持热插拔,需在上电前完成插入操作。
② 打开软件,点击右上角的 ⚙ 设置。
③ 在设置中会出现一个新的选项“设备配网”。
![]()
④ 选择目标 WiFi(确保是 2.4G),输入密码,等待提示 “connected” 即可完成连接。
2. 下载并加载主题
① 在软件中进入商店,搜索并下载Secondscreen -小智AI 。
![]()
② 回到主页面,在 副屏位置 右键 → 加载,选择下载的 xiaozhiAI.theme 文件。
③ 在侧面按键栏找到 设备 → 小智AI使能切换 和 小智AI状态切换,拖到按键面板中的任意位置。
![]()
④ 点击保存并运行,主题即可生效。
⑤ 配置完成后,文字可能显示以下状态:
- `xiaozhiAI connect` :小智AI已成功连接,可以开始互动。
- `Captcha` :小智AI等待激活。
3. 连接小智AI
① 打开小智官网,使用手机号注册并登录。
② 选择添加设备,系统会提示输入验证码。
![]()
③ 在 MK20 屏幕上查看验证码,并输入完成连接。
4. 控制小智语音状态
- 小智AI使能切换:用于开启或关闭小智AI功能。
屏幕显示说明: - `xiaozhiAI enable` / `xiaozhiAI connect`:小智已连接,可开始对话。 - `xiaozhiAI disable`:小智AI已关闭。 - `Audio Device Error`:音频接口被占用,重启设备即可
- 小智AI状态切换:控制小智语音功能
屏幕显示说明: - `xiaozhiAI Listening`:小智正在聆听,可开始语音指令。 - `xiaozhiAI Pausing`:小智暂停聆听状态,暂时不能接收语音指令。
小智AI 聊天
小智AI不仅能执行设备与上位机的控制指令,还能进行简单对话与信息查询,提升交互体验。
示例问答: “今天天气怎么样?”、“放一首歌”、“讲个笑话”。
可在 控制台 → 智能体 → 配置角色 中设置对话角色的语言、音色与背景介绍。
聊天功能语言模型推荐使用 Deepseek 模型,依赖网络连接,无需上位机。
小智AI 内置指令
小智AI 已内置以下常用指令,根据处理方式不同分为上位机处理和设备处理。
| 指令 | 处理方式 | 应用示例 |
|---|---|---|
| 系统音量 | 上位机处理(需连接电脑) | 调节电脑音量,如“调到 50%” |
| 系统输入 | 上位机处理(支持中文输入) | 语音输入文字到聊天窗口、搜索框 |
| 打开网页 | 上位机处理 | “打开百度”、“访问 YouTube” |
| 打开文件 | 上位机处理 | “打开演示文档”、“打开 Excel 表” |
| 打开文件夹 | 上位机处理 | “打开下载文件夹” |
| 设备音量 | 设备处理(无需上位机) | 调节设备自带扬声器音量 |
| 设备亮度 | 设备处理(无需上位机) | 夜间自动降低亮度,白天提升亮度 |
| 设备输入 | 设备处理(不支持中文输入) | 输入英文或数字指令,例如“OK”、“1234” |
扩展命令(自定义 AI 控制)
除了以上内置命令,还可通过控件配置 AI 命令:
① 在控件的AI 命令字段中填写语音指令
② 保存主题并运行
③ 运行后即可通过语音触发
应用示例:“打开微雪官网”

