10分钟搞定 claude-desktop-buddyM5StickC Plus 固件烧录与 BLE 配对快速入门【免费下载链接】claude-desktop-buddyReference and an example for the Bluetooth API for makers in Claude Cowork Claude Code Desktop项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-buddyclaude-desktop-buddy是 Claude 官方出品的蓝牙硬件参考示例教你把M5StickC Plus这块 ESP32 小硬件变成 Claude 桌面端的桌面宠物烧录固件、BLE 配对成功后它会实时显示 Claude 正在做什么还能直接在设备上批准或拒绝权限请求。全文按固件烧录 → BLE 配对 → 日常使用 → 进阶玩法四步展开新手照着做10 分钟就能点亮自己的硬件宠物。一、它能做什么先认识一下这只电子宠物固件烧录到 M5StickC Plus 后它会进入 7 种状态用表情演出 Claude 的实时动态状态触发条件表现 sleep未连接闭眼慢呼吸 idle已连接、无任务眨眼、东张西望 busy有会话在跑流汗干活⚡ attention等待你批准权限警觉 LED 闪烁 celebrate每 50K tokens 升级放彩带 dizzy你晃了晃设备螺旋眼❤️ heart5 秒内快速批准冒爱心 本项目是参考实现如果你只想自研设备连这个仓库的代码都不用看直接读 REFERENCE.md 里的 BLE 通信协议Nordic UART 服务 按行分隔的 JSON即可。二、准备工作硬件与软件清单烧录前确认你手边有这些东西硬件M5StickC Plus × 1固件依赖 M5StickCPlus 库驱动屏幕/IMU/按键USB 数据线电脑macOS 或 Windows已安装 Claude 桌面端烧录工具PlatformIO Core命令行版按官方说明安装即可固件工程platformio.ini 已配好 ESP32 Arduino 框架依赖库M5StickCPlus、AnimatedGIF、ArduinoJson会在首次编译时自动下载拉取仓库git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy三、固件烧录一条命令搞定进入项目目录后烧录只需一条命令pio run -t upload如果是从其他固件切换过来的设备先擦除再烧录更稳妥pio run -t erase pio run -t upload 烧录完成后想清空设备数据不用连电脑长按 A 键 → settings → reset → factory reset → 连点两下即可恢复出厂。详见 README.md 烧录章节。四、BLE 配对三步连上 Claude 桌面端⚠️ 前置条件BLE API 仅在开发者模式下可用面向 maker 的可选功能。第 1 步开启开发者模式菜单Help → Troubleshooting → Enable Developer Mode菜单栏会多出一个Developer菜单。第 2 步打开 Hardware Buddy 配对窗口菜单Developer → Open Hardware Buddy…第 3 步点击 Connect 完成配对在弹窗里点击Connect从扫描列表中选择你的 M5StickC Plus首次连接时 macOS/Windows 会弹出蓝牙权限请求允许即可。配对成功后桥接bridge会在双方都唤醒时自动重连窗口平时可以关掉。找不到设备两条排查建议确认设备是醒着的随便按一下任意按键唤醒检查设备设置菜单长按 A → settings里bluetooth 已开启五、配对成功后按键操作速查表按键普通界面宠物界面信息界面审批界面A正面下一页下一页下一页✅批准B右侧滚动查看对话翻页翻页❌拒绝长按 A打开菜单打开菜单打开菜单打开菜单Power短按息屏———Power约 6 秒强制关机———摇一摇触发 dizzy 状态———脸朝下放小睡回血———屏幕 30 秒无操作自动息屏审批等待期间保持点亮任意按键唤醒。完整说明见 README.md 控制章节。六、进阶玩法给它换一套 GIF 皮肤除了内置的 18 只 ASCII 宠物还可以给设备换上自定义 GIF 角色把角色包文件夹直接拖到 Hardware Buddy 窗口的拖放区App 会通过 BLE 流式传输设备实时切换到 GIF 模式Settings → delete char 可切回 ASCII。角色包 manifest.json 96px 宽的 GIF 集仓库自带示例 characters/bufo/。两个工具帮你快速出包tools/prep_character.py自动把任意尺寸 GIF 缩放到 96px 宽并保证各动画状态下角色比例一致tools/flash_character.py调试角色时跳过 BLE直接走 USB 烧录pio run -t uploadfs⚡ 注意整个文件夹总大小须 1.8MB通常用gifsicle --lossy80 -O3 --colors 64可压缩 40–60%。七、项目结构速览想改代码再看src/ main.cpp — 主循环、状态机、UI 界面 buddy.cpp — ASCII 宠物分发与渲染 buddies/ — 每种宠物一个文件各含 7 个动画 ble_bridge.cpp — Nordic UART 服务、收发缓冲 character.cpp — GIF 解码与渲染 data.h — 通信协议、JSON 解析 xfer.h — 文件夹推送接收 stats.h — NVS 统计、设置、宠物选择 characters/ — GIF 角色包示例 tools/ — 图片处理与烧录脚本想自研设备协议契约就在 REFERENCE.md服务/特征 UUID、心跳快照 JSON 字段、权限回传命令、安全配对要求LE Secure Connections 绑定一应俱全任何能跑 Nordic UART JSON 解析的板子Arduino、nRF52、树莓派 BLE 蓝牙模块都能接入。总结git clone→pio run -t upload烧录固件 → 开启开发者模式 → Hardware Buddy 窗口点 Connect四步完成 M5StickC Plus 与 Claude 的 BLE 配对。接下来看着你的硬件宠物为了每一次批准发光发热吧【免费下载链接】claude-desktop-buddyReference and an example for the Bluetooth API for makers in Claude Cowork Claude Code Desktop项目地址: https://gitcode.com/gh_mirrors/cl/claude-desktop-buddy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考