没有 Claude 桌面端也能调试claude-desktop-buddy demo 模式与 test_serial.py 本地模拟指南【免费下载链接】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刚拿到 ESP32 开发板想体验 claude-desktop-buddy 桌面宠物却没有 macOS / Windows 的 Claude 桌面端别急——这个项目内置了demo 模式设备菜单一键切换和 test_serial.py 串口模拟脚本让你零依赖就能在本地验证设备的每一种动画与状态切换。本文带你快速上手这两种调试方式。认识 claude-desktop-buddyESP32 桌面宠物与 BLE 蓝牙协议claude-desktop-buddy 是一个跑在M5StickC PlusESP32上的桌面宠物固件。它通过**蓝牙 BLENordic UART Service**连接 Claude 桌面端实时显示会话状态、权限审批提示和消息记录。固件定义了7 种交互状态每种状态对应独特的动画表现状态触发条件表现sleep未连接闭眼、缓慢呼吸idle已连接、空闲眨眼、张望busy会话运行中流汗、忙碌attention等待审批警觉、LED 闪烁celebrate每 50K tokens 升级撒花、弹跳dizzy摇晃设备螺旋眼、摇晃heart5 秒内审批通过漂浮爱心核心思路固件的三模式优先级为demo live asleep见 src/data.h所以即使没有桌面端demo 和串口 JSON 都能驱动完整的 UI 状态机。一键开启 demo 模式离线循环播放 5 种预设场景如何在设备上进入 demo 模式无需任何电脑配合直接在设备端操作按住 A 键正面按钮打开菜单滚动到demo选项菜单共 6 项settings → turn off → help → about →demo→ close按 A 键确认切换切换逻辑定义在 src/main.cpp 的menuItems数组中执行dataSetDemo(!dataDemo())即可开关。demo 模式的工作原理开启后固件自动循环播放 5 个预设场景每 8 秒切换一次同时忽略所有实时数据轮次场景名屏幕提示1asleep0 个会话全部归零2one idle1 个会话空闲3busy4 个会话、3 个运行中4attention1 个等待审批LED 闪烁5completed1 个会话刚完成核心实现见 src/data.h 的_FAKES数组——每个元素携带total / running / waiting / tokens等字段模拟真实桌面端心跳快照。适合场景✅ 离线展示给别人看没有电脑也能演示✅ 调试 UI 布局与动画渲染✅ 测试新角色的 GIF 显示效果test_serial.py 串口模拟3 秒验证设备 JSON 状态切换如果你想在开发电脑上验证设备对 JSON 指令的响应test_serial.py 是最佳工具。它通过USB 串口非蓝牙以 115200 波特率向设备发送模拟 JSON每 3 秒切换一次状态循环 20 轮。快速运行 test_serial.py前提条件设备已通过 USB 连接电脑已安装 Python 和 pyserialpip install pyserialpython tools/test_serial.py脚本自动寻找/dev/cu.usbserial-*串口macOS发送以下 4 条 JSON顺序发送的 JSON设备表现1{total:0,running:0,waiting:0}进入 sleep 动画2{total:2,running:1,waiting:0}进入 idle 动画3{total:4,running:3,waiting:0}进入 busy 动画4{total:2,running:1,waiting:1}进入 attentionLED 闪烁⚡提示发送格式遵循 REFERENCE.md 定义的心跳快照协议——每行一个 JSON 对象以\n结尾。你也可以用任意串口工具手动发送自定义 JSON 来测试。进阶用 test_xfer.py 测试串口角色文件传输test_xfer.py 更进一步——它通过串口完整传输一个角色文件夹默认 characters/bufo验证设备的文件接收与 GIF 重载功能python tools/test_xfer.py传输流程char_begin→ 逐文件分块传输256 字节 base64 编码→char_end并输出传输速度KB/s。如果设备成功接收屏幕会立即切换到该角色的 GIF 动画。调试工作流从 demo 到真实连接的完整路径┌─────────────────────────────────────────────┐ │ 没有 Claude 桌面端 │ │ ↓ │ │ 快速演示 → 设备菜单开启 demo 模式 │ │ ↓ │ │ 验证 JSON 响应 → 运行 test_serial.py │ │ ↓ │ │ 测试角色传输 → 运行 test_xfer.py │ │ ↓ │ │ 一切正常 → 连接 Claude 桌面端真实体验 │ └─────────────────────────────────────────────┘连接真实桌面端的步骤需要 macOS / Windows Claude 开发者模式Claude 桌面端 →Help → Troubleshooting → Enable Developer ModeDeveloper → Open Hardware Buddy…→ 点击Connect从列表中选择你的设备授予蓝牙权限常见问题 FAQQdemo 模式下连接了 Claude 桌面端会怎样Ademo 模式优先级最高会完全忽略实时数据。需再次按 demo 退出。Qtest_serial.py 提示 no stick foundA脚本默认只识别/dev/cu.usbserial-*macOS。Linux 用户可改为/dev/ttyUSB*Windows 为COM*。Q串口发送 JSON 后设备没反应A检查波特率是否为115200见 platformio.ini 中monitor_speed 115200并确保设备未处于 demo 模式demo 模式会忽略所有外部数据。Q如何退出 demo 模式A再次按住 A 打开菜单 → 选择 demo → 按 A 关闭设备立即恢复正常数据轮询。总结claude-desktop-buddy 提供了三条零依赖调试路径让你在没有 Claude 桌面端的环境下完整开发、调试和演示这个 ESP32 桌面宠物方式入口适用场景Demo 模式设备菜单离线展示、UI 动画调试test_serial.pyUSB 串口验证 JSON 协议状态响应test_xfer.pyUSB 串口测试角色文件传输完整性关键文件速查src/data.h三模式状态机、src/main.cpp主循环与菜单、tools/test_serial.py串口模拟、REFERENCE.mdBLE 协议规范。【免费下载链接】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），仅供参考