
claude-desktop-buddy 按键操作全清单8种交互从摇晃晕眩、趴下睡觉到一键批准权限【免费下载链接】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 是一款基于 ESP32 的蓝牙桌宠固件可连接 Claude Cowork 与 Claude Code 桌面端让 M5StickC Plus 变成会睡觉、会晕眩、还能一键批准权限的桌面小宠物。本文用一张操作表讲清楚它的 8 种交互方式从摇晃晕眩、趴下睡觉到审批权限全部覆盖。认识你的设备3 个物理按键 1 套 IMU硬件基于 ESP32 M5StickC Plus屏幕、IMU、按键驱动均来自 M5 官方库交互输入一共就三类位置按键备注正面A 键短按 / 长按 600ms 功能不同右侧B 键短按翻页与确认左侧电源键短按息屏长按约 6s 硬关机机身IMU 加速度计检测摇晃和正面朝下两种姿态 屏幕在 30 秒无交互后自动息屏审批弹窗出现时会保持常亮任意按键都可唤醒唤醒的那次按键不会触发额外功能。8 种按键交互完整操作清单下面是官方 README.md 中 Controls 一节的完整整理。同一个按键在不同界面下含义不同这是理解全部交互的关键#交互普通界面宠物界面信息界面审批界面1A 键短按正面切换下一个屏幕切换下一个屏幕切换下一个屏幕⭐批准权限2B 键短按右侧滚动对话记录翻页翻页⭐拒绝权限3长按 A约 600ms打开菜单打开菜单打开菜单打开菜单4电源键短按左侧关闭屏幕———5电源键长按 ~6s硬件强制关机———6摇晃设备触发 dizzy 晕眩动画———7正面朝下放置进入 nap 小睡恢复能量———8任意键唤醒息屏后点亮屏幕本次按键被吞掉———按键逻辑的完整实现集中在 main.cpp 的主循环里想逐行验证行为可以看源码。一键批准权限A/B 键速配这是整个项目最核心的交互。当 Claude 会话卡在权限请求比如要执行一条 Bash 命令时设备自动切换到审批屏幕LED 闪烁提醒attention 状态按 A 批准发送decision: once按 B 拒绝发送decision: deny每次按键都有不同音高的蜂鸣声反馈——批准是清脆的高音拒绝是低沉的短音。 隐藏彩蛋如果权限请求到达后5 秒内按下 A小宠物会进入 heart 状态屏幕飘起爱心。审批速度越快它越开心。审批通过的数量、拒绝次数都会写入设备统计面板approved / denied 计数。权限协议细节cmd: permission的 JSON 格式在 REFERENCE.md 中有完整说明。摇晃晕眩 趴下睡觉两个物理外挂这两种交互不靠按键靠的是 M5 的 IMU 摇晃 → dizzy 晕眩快速摇晃设备主循环每 50ms 检测一次加速度宠物立即进入 dizzy 状态约 2 秒螺旋眼 左右摇晃。注意菜单打开或息屏时摇晃无效审批等待期间摇晃会被忽略避免误触打断审批。 正面朝下 → nap 小睡把设备正面朝下趴在桌上倾斜角持续约 15 帧宠物立刻闭眼小睡屏幕变暗、动画暂停开始累计小睡时长。翻回来即醒来。小睡不是纯装饰——它会回满能量条。能量满格后每 2 小时掉 1 格所以让它趴一会儿相当于给桌宠充电回血。累计小睡时长会显示在信息界面的napped XhXXm统计里。两种姿态检测与状态切换的源码在 main.cpp 的 shake 检测与 face-down nap 段落能量规则见 stats.h。电源键与息屏30 秒自动断电的正确姿势短按电源键左侧立即息屏省电再按一下或按 A/B 任意键唤醒。长按电源键约 6 秒绕过固件直接硬件关机。长按 A 键打开主菜单可切换宠物、调整设置甚至settings → reset → factory reset从设备端完成恢复出厂连电脑都不用。息屏期间设备依然保持 BLE 连接权限请求到达会直接亮屏提醒不会漏掉审批。7 个动画状态你的操作如何反馈每次按键或姿态变化宠物都会切换到对应的 ASCII/GIF 动画状态7 种状态定义见 character.h状态触发方式观感sleep未连接桌面端闭眼慢呼吸idle已连接、无事发生眨眼、四处张望busy会话正在运行流汗干活attention等待审批警觉 LED 闪烁celebrate每 5 万 token 升级撒花弹跳dizzy你摇晃了设备螺旋眼摇晃heart5 秒内批准飘爱心玩之前先完成蓝牙配对按键交互的前提是设备已与 Claude 桌面端配对BLE 桥默认关闭需开发者模式Claude 桌面端Help → Troubleshooting → Enable Developer ModeDeveloper → Open Hardware Buddy…打开配对窗口点Connect从扫描列表选中设备首次连接在 macOS 上会弹出蓝牙权限请求允许即可。配对一次后双方都醒着时会自动重连之后就不用再打开这个窗口了。找设备时的排障技巧按一下任意键唤醒它并确认设备设置菜单里 bluetooth 已开启。相关文件速查想了解看哪里全部按键/姿态交互表README.mdControls 小节BLE 协议与审批 JSON 格式REFERENCE.md按键处理与状态机源码main.cpp能量/统计nap、level逻辑stats.h自定义 GIF 角色含 dizzy/heart 帧characters/bufo/ 与 tools/prep_character.py烧录配置ESP32 Arduinoplatformio.ini⚠️ 提示BLE API 仅在桌面端开启开发者模式后可用面向创客与开发者并非官方正式支持的产品功能。掌握了这 8 种交互你的 M5StickC 桌宠就从摆件升级成了 Claude 的随身审批员——摇晃逗它晕、趴下让它睡、A 键一键放行桌面体验立刻有了灵魂。【免费下载链接】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),仅供参考