拓冰网站定制 
Fork 它才是最好的贡献claude-desktop-buddy 参考实现理念与 Pi Pico W 移植实践指南【免费下载链接】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 桌面端官方的蓝牙BLE桌宠参考实现一个跑在 ESP32 上的桌面宠物固件能通过蓝牙连接 Claude Cowork 与 Claude Code实时显示会话状态、审批提示甚至直接在硬件上批准或拒绝工具调用。它想传递的核心理念只有一句话最好的贡献就是 Fork 它——这个仓库不是要被维护的产品而是一份协议合约的示范你应当 Fork 后移植到 Pi Pico W、墨水屏等自己的硬件上做出只属于你的那一只 Buddy。 claude-desktop-buddy 是什么这是一只住在 M5StickC Plus 上的数字宠物无事时打盹蓝牙桥未连接时进入sleep状态闭眼慢呼吸开工时忙碌Claude 会话正在跑时进入busy状态满头大汗等审批时警觉出现权限提示时 LED 闪烁、进入attention状态你在设备上一按 A 键即可approve、按 B 键deny升级庆祝每 5 万 tokens 升一级撒花庆祝 内置 18 种 ASCII 宠物猫、龙、水母、机器人……每种有 7 组动画还支持通过桌面窗口拖入 GIF 角色包切换成 GIF 模式示例角色 characters/bufo/ 就是一只经典的 bufo 青蛙。 为什么最好的贡献就是 Fork 它项目的 CONTRIBUTING.md 开宗明义The best contribution is a fork.这个仓库的定位是参考实现reference implementation不是一个持续维护的产品。官方明确划了边界官方接受官方拒绝请 Fork修正 REFERENCE.md 协议文档错误新特性、新宠物、新屏幕修复参考不成立的 bug无法配对、无法渲染、开机崩溃移植到其他开发板Fork!重构、风格调整、依赖升级背后的理念是协议是稳定的表面固件只是履行合约的一种方式。REFERENCE.md 描述的 BLE 线协议Nordic UART Service 换行分隔 JSON才是真正的契约。官方更希望你做出你自己想要的东西而不是把这个参考实现硬掰成别的形状。 移植实践把 Buddy 搬上 Pi Pico W官方在贡献指南里直接点名了移植方向换硬件把 M5StickC 换成Pi Pico W带 CYW43 BLE天然支持 Nordic UART Service换显示用墨水屏替换 ASCII 宠物装外壳套上 3D 打印的外壳做减法只保留 src/ble_bridge.cpp 和 JSON 解析其余全部重写移植前你需要知道的三件事1. 协议与硬件解耦。参考实现基于 platformio.ini 中的 M5StickCPlus 库驱动屏幕、IMU 和按键——这是唯一和你硬件强绑定的部分。移植时把 src/buddies/ 下的渲染、src/main.cpp 中的 UI 屏幕换成你的引脚布局即可蓝牙层几乎可以照搬。2. 广告名要带Claude前缀。桌面端靠广播名筛选设备设备名以Claude开头再拼上几字节 MAC 地址多个设备就不会冲突。3. 安全配对是推荐项。协议中会流过对话摘要和工具调用提示REFERENCE.md 建议强制 LE Secure Connections 绑定NUS 特征标记为仅加密访问首次配对显示 6 位 passkey之后自动复用密钥。参考实现的做法在 src/ble_bridge.cpp 中可以对照。快速烧录你的 Buddy如果你先想在原版 M5StickC Plus 上跑起来验证流程安装 PlatformIO Core 后一条命令上传固件pio run -t upload从旧设备升级时先擦除再写入pio run -t erase pio run -t upload烧录完成后在 Claude 桌面端开启开发者模式Help → Troubleshooting → Enable Developer Mode再通过Developer → Open Hardware Buddy…打开配对窗口点击Connect选择你的设备完成配对。之后桥接会在双方都唤醒时自动重连窗口只在首次配对、查看统计面板或拖放角色文件夹时需要打开给 Pi Pico W 开发者的小贴士 ️角色包推送是内容无关的GIF、配置块、甚至固件镜像都行整包 ≤ 1.8MB协议细节见 REFERENCE.md 的 Folder push 一节角色调试嫌 BLE 来回慢tools/flash_character.py 可直接把角色包经 USB 写进 LittleFS角色素材用 tools/prep_character.py 统一缩放到 96px 宽保证各状态下角色比例一致用 tools/test_serial.py 可以在烧录前模拟桌面端验证你的 Pico 是否正确应答 ack 项目结构与延伸阅读src/ main.cpp — 主循环、状态机、UI 屏幕 buddy.cpp — ASCII 物种分发 渲染 buddies/ — 每个物种一个文件各 7 组动画 ble_bridge.cpp — Nordic UART 服务、按行缓冲收发 character.cpp — GIF 解码与渲染 data.h — 线协议、JSON 解析 xfer.h — 文件夹推送接收 characters/ — 示例 GIF 角色包 tools/ — 素材生成与转换工具配套资料协议合约移植者必读REFERENCE.md贡献边界说明CONTRIBUTING.md官方手册页面docs/manual.html构建配置platformio.ini⚠️ 注意BLE API 仅在开发者模式下可用面向 maker 和开发者并非正式产品特性。结语claude-desktop-buddy 教会我们的比任何一只桌面宠物都多开源项目最好的形态之一不是不断加特性而是把契约写得足够清晰让每个人都能 Fork 后长成完全不同的样子。Fork 它把 Pi Pico W 焊上墨水屏让 Claude 在你桌面上多一只独一无二的伙伴吧 【免费下载链接】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），仅供参考 Fork 它才是最好的贡献！claude-desktop-buddy 参考实现理念与 Pi Pico W 移植实践指南
Fork 它才是最好的贡献claude-desktop-buddy 参考实现理念与 Pi Pico W 移植实践指南【免费下载链接】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 桌面端官方的蓝牙BLE桌宠参考实现一个跑在 ESP32 上的桌面宠物固件能通过蓝牙连接 Claude Cowork 与 Claude Code实时显示会话状态、审批提示甚至直接在硬件上批准或拒绝工具调用。它想传递的核心理念只有一句话最好的贡献就是 Fork 它——这个仓库不是要被维护的产品而是一份协议合约的示范你应当 Fork 后移植到 Pi Pico W、墨水屏等自己的硬件上做出只属于你的那一只 Buddy。 claude-desktop-buddy 是什么这是一只住在 M5StickC Plus 上的数字宠物无事时打盹蓝牙桥未连接时进入sleep状态闭眼慢呼吸开工时忙碌Claude 会话正在跑时进入busy状态满头大汗等审批时警觉出现权限提示时 LED 闪烁、进入attention状态你在设备上一按 A 键即可approve、按 B 键deny升级庆祝每 5 万 tokens 升一级撒花庆祝 内置 18 种 ASCII 宠物猫、龙、水母、机器人……每种有 7 组动画还支持通过桌面窗口拖入 GIF 角色包切换成 GIF 模式示例角色 characters/bufo/ 就是一只经典的 bufo 青蛙。 为什么最好的贡献就是 Fork 它项目的 CONTRIBUTING.md 开宗明义The best contribution is a fork.这个仓库的定位是参考实现reference implementation不是一个持续维护的产品。官方明确划了边界官方接受官方拒绝请 Fork修正 REFERENCE.md 协议文档错误新特性、新宠物、新屏幕修复参考不成立的 bug无法配对、无法渲染、开机崩溃移植到其他开发板Fork!重构、风格调整、依赖升级背后的理念是协议是稳定的表面固件只是履行合约的一种方式。REFERENCE.md 描述的 BLE 线协议Nordic UART Service 换行分隔 JSON才是真正的契约。官方更希望你做出你自己想要的东西而不是把这个参考实现硬掰成别的形状。 移植实践把 Buddy 搬上 Pi Pico W官方在贡献指南里直接点名了移植方向换硬件把 M5StickC 换成Pi Pico W带 CYW43 BLE天然支持 Nordic UART Service换显示用墨水屏替换 ASCII 宠物装外壳套上 3D 打印的外壳做减法只保留 src/ble_bridge.cpp 和 JSON 解析其余全部重写移植前你需要知道的三件事1. 协议与硬件解耦。参考实现基于 platformio.ini 中的 M5StickCPlus 库驱动屏幕、IMU 和按键——这是唯一和你硬件强绑定的部分。移植时把 src/buddies/ 下的渲染、src/main.cpp 中的 UI 屏幕换成你的引脚布局即可蓝牙层几乎可以照搬。2. 广告名要带Claude前缀。桌面端靠广播名筛选设备设备名以Claude开头再拼上几字节 MAC 地址多个设备就不会冲突。3. 安全配对是推荐项。协议中会流过对话摘要和工具调用提示REFERENCE.md 建议强制 LE Secure Connections 绑定NUS 特征标记为仅加密访问首次配对显示 6 位 passkey之后自动复用密钥。参考实现的做法在 src/ble_bridge.cpp 中可以对照。快速烧录你的 Buddy如果你先想在原版 M5StickC Plus 上跑起来验证流程安装 PlatformIO Core 后一条命令上传固件pio run -t upload从旧设备升级时先擦除再写入pio run -t erase pio run -t upload烧录完成后在 Claude 桌面端开启开发者模式Help → Troubleshooting → Enable Developer Mode再通过Developer → Open Hardware Buddy…打开配对窗口点击Connect选择你的设备完成配对。之后桥接会在双方都唤醒时自动重连窗口只在首次配对、查看统计面板或拖放角色文件夹时需要打开给 Pi Pico W 开发者的小贴士 ️角色包推送是内容无关的GIF、配置块、甚至固件镜像都行整包 ≤ 1.8MB协议细节见 REFERENCE.md 的 Folder push 一节角色调试嫌 BLE 来回慢tools/flash_character.py 可直接把角色包经 USB 写进 LittleFS角色素材用 tools/prep_character.py 统一缩放到 96px 宽保证各状态下角色比例一致用 tools/test_serial.py 可以在烧录前模拟桌面端验证你的 Pico 是否正确应答 ack 项目结构与延伸阅读src/ main.cpp — 主循环、状态机、UI 屏幕 buddy.cpp — ASCII 物种分发 渲染 buddies/ — 每个物种一个文件各 7 组动画 ble_bridge.cpp — Nordic UART 服务、按行缓冲收发 character.cpp — GIF 解码与渲染 data.h — 线协议、JSON 解析 xfer.h — 文件夹推送接收 characters/ — 示例 GIF 角色包 tools/ — 素材生成与转换工具配套资料协议合约移植者必读REFERENCE.md贡献边界说明CONTRIBUTING.md官方手册页面docs/manual.html构建配置platformio.ini⚠️ 注意BLE API 仅在开发者模式下可用面向 maker 和开发者并非正式产品特性。结语claude-desktop-buddy 教会我们的比任何一只桌面宠物都多开源项目最好的形态之一不是不断加特性而是把契约写得足够清晰让每个人都能 Fork 后长成完全不同的样子。Fork 它把 Pi Pico W 焊上墨水屏让 Claude 在你桌面上多一只独一无二的伙伴吧 【免费下载链接】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），仅供参考