# xiaozhi-plus-firmware

**Repository Path**: wt512/xiaozhi-plus-firmware

## Basic Information

- **Project Name**: xiaozhi-plus-firmware
- **Description**: 基于虾哥的小智AI开源固件项目（https://github.com/78/xiaozhi-esp32）扩展了部分功能，目前支持音乐播放。后期计划升级更多实用功能...比如闹钟提醒、倒计时提醒
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 45
- **Forks**: 8
- **Created**: 2025-04-25
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xiaozhi-plus-firmware

## 固件下载中心:
[小智AI终端最新版本固件下载地址（免费）](http://156.226.179.68/xiaozhi-plus-firmware/releases/)

 **S3\C3芯片，4G版本均已支持音乐播放** 

#### 介绍
本固件基于虾哥的小智AI开源固件项目扩展了部分功能（https://github.com/78/xiaozhi-esp32）。
目前支持音乐播放，闹钟提醒、倒计时提醒、待机壁纸、天气预报、对讲机、联网搜索、api远程控制设备等

#### 安装教程

1.  下载自己小智对应的固件包
2.  通过烧录工具烧录下载好的固件（解压后里面的后缀为.bin文件）
3.  重启

#### 使用方法
1.  安装成功后就可以通过小智AI控制播放器了。
2.  如果之前用的虾哥后台，什么都不用管，直接用。
3.  如果之前用的第三方后台服务，那么请在小智AI虾哥后台绑定设备正常使用。 虾哥后台：https://xiaozhi.me/console/agents

#### 更新日志：
**2025-12-03**  
更新固件（基于官方2.0.4），【小智AI音乐闹钟】固件升级公告 V2.0.4.4

- ✅ 支持官方2.0后的自定义功能，比如自定义唤醒词、表情包、字体、背景等
- ✅ 增加倒计时功能，日程提醒，后台地址：http://101.35.234.159
- ✅ 优化了系统的稳定性
- ✅ 面包板方案的设备支持屏幕参数远程推送，解决了之前用户无法调整屏幕方向和大小的问题

![倒计时功能界面](%E5%80%92%E8%AE%A1%E6%97%B6%E5%8A%9F%E8%83%BD%E7%95%8C%E9%9D%A2.jpg)

#### 更新日志：
**2025-08-27**  
更新固件（基于官方1.8.8），【小智AI音乐闹钟】固件升级公告 V1.8.8.2

- ✅ 新增后台管理系统，后台地址：http://101.35.234.159
- ✅ 新增AI直播功能，自动回复直播间弹幕（s3芯片wifi版支持）
- ✅ 新增对讲机功能，多个设备可以通过对讲机号交流（s3芯片wifi版支持）
- ✅ 新增联网搜索功能，查询新闻、咨询、股票等实时信息
- ✅ 新增远程设备控制API，文档地址：http://101.35.234.159/doc.html
- ✅ 优化歌曲搜索时间，播放歌曲更迅速，反应更快
- ✅ 待机时间、字体颜色更换，时间位置增加中央显示，底部显示
- ✅ 待机壁纸唤醒时提高隐藏壁纸的灵敏度
- ✅ 壁纸设置后台可预览壁纸显示效果
- ✅ 音乐播放、闹钟可以通过后台设置开启或关闭
- ✅ 上传图片根据当前设备要求在线裁剪

**2025-07-27**  
更新固件（基于官方1.8.3），【小智AI音乐闹钟】固件升级公告 V1.8.3.1

🔥 基于官方1.8.3版本深度开发，已完成150+开发板适配，持续扩展中！

#### 优化项
- ✅ 修复播放音乐前和闹钟音乐前的小智说话卡顿问题  
- ✅ 修复部分歌曲不显示歌词的问题  
- ✅ 优化歌曲搜索时间，提升播放速度和响应速度  
- ✅ 优化待机壁纸唤醒时的隐藏壁纸灵敏度  
- ✅ 优化壁纸设置，后台可预览壁纸显示效果  

#### 新增功能
- 🎵 新增"我的歌单"功能：
  - 可在网页端自由搜索添加歌曲并排序  
  - 🎤 语音控制添加/删除歌曲  
  - ▶️ 语音播放我的歌单  
  - 🔀 歌单歌曲自由排序  
  - ⬆️ 上传MP3文件到歌单  
- 🔁 新增播放器语音控制播放模式：  
  - 🔄 列表循环播放  
  - 🔂 单曲循环  
  - 🎲 随机播放  
  - ⏩ 顺序播放  
- 🕒 新增待机显示选项：  
  - 🎨 可更换字体颜色  
  - ⬆️⬇️ 时间显示位置可选中央或底部  
- 🌐 新增自建服务器配置功能，可设置websocket地址（需申请）

🚀 即将开放重磅功能：

- 开发者接口开放
- （更多惊喜正在路上...）

无需操作，OTA自动升级 

**2025-06-26**  
更新固件（基于官方1.7.6），【小智AI音乐闹钟】固件升级公告 V1.7.6.1

🔥 基于官方1.7.6版本深度开发，已完成120+开发板适配，持续扩展中！

🎯 核心升级亮点：

✔ 智能音乐点播升级

- 精准歌名识别播放
- 歌手专属推荐（只听TA的代表作）
- 播放列表实时查询
- 支持切歌/续播/断点恢复

比如：播放上一曲，下一曲，恢复播放，播放周杰伦的歌，播放晴天，查看播放列表，播放列表中的指定歌曲

⏰ 闹钟管家系统

- 语音闹钟管理（增/删/查）
- 设置指定音乐闹铃更准确

🎨 个性化体验

- 动态壁纸库（默认关闭，联系作者免费开启）
- 联网搜索实时信息功能（默认关闭，部分用户推送内测）
- 全程支持自然语音交互，动动嘴就能轻松操控壁纸切换！支持定时播放壁纸

**2025-05-29**    
更新固件（基于官方1.6.6），所有固件采用MCP播放音乐，优化播放音质，MCP闹钟实现，音乐闹钟固件适配了5月28日前官方新增的开发板。同步更新官方部分硬件摄像头支持。查询天气预报定位错误问题已修复。新增联网搜索（内测）

无需操作，OTA自动升级 

**2025-05-15**
更新固件，升级lcd屏幕全新播放界面，新增连续播放音乐，优化播放卡顿问题，增强AI音乐闹钟提醒详细事件，修复若干bug。

无需操作，OTA自动升级

**2025-05-08**
更新固件，优化播放速度，增加闹钟、倒计时提醒。例如：可以对小智说``` “10分钟后提醒我开会，铃声为稻香”，“帮我定明天早上7点半的闹钟” ... ```

需重新烧录固件

#### 常见问题
- 问题：让小智播放音乐时，小智回复曲库找不到或者不执行播放动作
- 解决办法：小智后台智能体角色介绍里面加上这句
```所有用户播放音乐的请求，你必须调用【在线音乐播放器】。并提醒用户请稍等，马上为你播放！```
- 问题：面包板lcd屏幕240*320颜色显示反色的问题通常是烧录错固件

![错误的固件显示异常](image.png)
- 解决办法：请烧录x.x.x.x_bread-compact-wifi-lcd.zip（本身就是240X320屏幕），而不是x.x.x.x_bread-compact-wifi-lcd_ST7789_240X320_NO_IPS.zip

使用中有问题反馈，请联系V：wtony123，备注小智