ESP32-S3 Buddy 0.5.0-rc.1

ESP32-S3 Buddy 固件，适用于 ESP32-S3 N16R8、ST7789V 240×320 显示屏和 XPT2046 触摸模块。

版本为 0.5.0-rc.1，本次按候选版发布。

功能

• 显示 AI 会话、运行与等待状态、Token 数据和最近活动。
• 在触摸屏上查看权限请求并选择 Allow Once 或 Deny。
• 支持角色动画、运行时角色包安装与切换。
• 支持简体中文和英文、横竖屏、四种主题、亮度设置与息屏显示。
• 通过电脑端 BLE 消息同步时间，持续通电时断线仍继续走时。

支持的 Agent

• DeepSeek Harness：通过 dsh-esp-buddy 插件连接。
• Claude Code：通过 cc-buddy-bridge桥接状态与审批。先将设备蓝牙名称改为 Claude 或 Claude-Buddy，保存后重启。

设备一次只连接一个 BLE 客户端。校时需要电脑端发送对应消息，角色包传输需要支持 Folder Push V2；桥接工具的其他功能以双方协议兼容情况为准。

下载与烧录

附件	用途	地址	数据影响
esp32s3-buddy-0.5.0-rc.1-full.bin	首次安装或完整恢复	0x0	重置设置、蓝牙绑定、触摸校准、角色包和存储字体
esp32s3-buddy-0.5.0-rc.1-app.bin	相同分区布局下更新应用	0x10000	保留存储分区；设置按固件的数据格式规则处理
SHA256SUMS.txt	核对镜像 SHA-256	—	—
release.json	镜像摘要、烧录参数与源码信息	—	—
third-party-licenses.zip	固件使用的第三方许可文件	—	—
LICENSE、THIRD_PARTY_NOTICES.md	项目许可与第三方说明	—	—

使用桌面 Chrome／Edge 打开 智工具 ESP32 在线烧录。连接串口，选择一个 .bin 并填写对应地址，再点击“开始刷写”。网页默认地址为 0x10000，选择完整镜像时必须改为 0x0；完整镜像已合并 bootloader、分区表、应用和初始存储，无须重复添加这些文件。

目标 Flash 为 16 MB，参数为 dio、80m。不要将应用镜像写入 0x0，也不要将完整镜像作为保留用户数据的升级。接线、配对、源码构建和 VS Code 使用步骤见 README。

首次启动未收到校时消息时显示 --:--。角色包不随固件附带，可安装支持的角色包；存储不足时需先清理已有包。其他屏幕、触摸芯片或存储容量需要自行适配，当前没有 OTA 更新。

欢迎复刻、学习和反馈问题。反馈时请说明硬件、固件与电脑端版本、镜像类型、复现步骤和错误日志；不要上传配对码、凭据或敏感审批正文。