如何参与 claude-desktop-buddy 开发CONTRIBUTING 贡献指南与上游会/不会接受的 PR 清单【免费下载链接】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 官方出品的 ESP32 桌面宠物参考固件它通过 BLE 把 Claude Cowork / Claude Code Desktop 的权限审批、会话动态实时投射到 M5StickC Plus 的小屏幕上。想参与 claude-desktop-buddy 开发或提交 PR 之前先花 2 分钟读完它的 CONTRIBUTING.md——这个项目罕见地直白明确列出了上游会接受和不会接受的贡献清单。本文帮你 5 分钟搞清楚该做什么、不该做什么避免白忙一场。先搞懂它不是常规开源项目而是参考实现CONTRIBUTING.md 的第一句话就点明了基调The best contribution is a fork.最好的贡献就是 Fork这个项目不是一个被积极维护的产品而是一个可运行的示例——它演示了如何遵守 REFERENCE.md 中定义的 BLE 协议。上游的态度是与其把这个项目扭成你想要的样子不如构建你自己想要的设备。协议wire protocol才是稳定的契约固件只是遵守它的众多方式之一。上游会接受的 PR 清单只有两类 ✅根据 CONTRIBUTING.md只有以下贡献会被合入类型说明 文档纠错REFERENCE.md 协议文档写错、写得不清楚 致命 Bug 修复让参考实现不能作为参考的问题连不上不配对、不渲染、启动即崩溃判断标准很严格这个 Bug 是否破坏了项目作为参考的定位没有的话不在受理范围内。上游不会接受的 PR 清单提交前先自查 ❌CONTRIBUTING.md 同样直白地列出了拒绝项❌新功能新宠物、新界面、新状态❌板卡移植想换 Pi Pico W请 Fork别提 PR❌代码重构、风格调整、依赖版本升级还有一句扎心但实用的总结如果你不确定某件事属于哪一类大概率属于第二类不会接受。官方推荐姿势Fork 它把它变成你的设备 想动手官方建议你 Fork 后自由改造。克隆仓库git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-buddyCONTRIBUTING 里给出的改造灵感把 M5StickC 换成Raspberry Pi Pico W把 ASCII 宠物换成电子墨水屏装进3D 打印外壳只保留 src/ble_bridge.cpp 和 JSON 解析器其余全删掉 如果你要从零开发自己的设备甚至不需要这个仓库的代码——只读 REFERENCE.md 就够了它定义了 Nordic UART Service 的 UUID、逐行 JSON 数据格式和文件夹推送协议任何能广播 Nordic UART Service 的硬件Arduino、ESP32、nRF52、树莓派都能实现。配对验证入口长这样先开启 Developer Mode再打开 Hardware Buddy 窗口提交 PR 前的最小验证流程安装 PlatformIO Core然后构建烧录pio run -t upload从旧设备升级建议先pio run -t erase清盘桌面端进入Help → Troubleshooting → Enable Developer Mode再Developer → Open Hardware Buddy…完成配对确认三个参考级行为能配对、能渲染、开机不崩把 PR 严格限定在 Bug 修复本身不夹带重构和风格改动构建配置见 platformio.iniESP32 Arduino 框架依赖m5stack/M5StickCPlus库——这也解释了为什么换板卡的 PR 不会被接受。核心文件路径速查CONTRIBUTING.md — 贡献契约会/不会接受的 PR 清单REFERENCE.md — BLE 协议契约自研设备的唯一必读src/main.cpp — 主循环、状态机、UI 屏幕src/ble_bridge.cpp — Nordic UART 服务收发缓冲区src/data.h — 线上协议与 JSON 解析src/xfer.h — 文件夹推送接收端src/buddies/ — 每个 ASCII 宠物一个文件在这里加新宠物 ❌ 不会被接受的 PRcharacters/bufo/ — GIF 角色包实例tools/prep_character.py / tools/flash_character.py — 角色素材压缩与 USB 直刷工具一句话总结claude-desktop-buddy 的贡献哲学是Fork 优先——上游只要文档纠错和致命 Bug 修复其余一切创造都欢迎你在自己的 Fork 里尽情发挥。【免费下载链接】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），仅供参考 如何参与 claude-desktop-buddy 开发？CONTRIBUTING 贡献指南与上游会/不会接受的 PR 清单
如何参与 claude-desktop-buddy 开发CONTRIBUTING 贡献指南与上游会/不会接受的 PR 清单【免费下载链接】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 官方出品的 ESP32 桌面宠物参考固件它通过 BLE 把 Claude Cowork / Claude Code Desktop 的权限审批、会话动态实时投射到 M5StickC Plus 的小屏幕上。想参与 claude-desktop-buddy 开发或提交 PR 之前先花 2 分钟读完它的 CONTRIBUTING.md——这个项目罕见地直白明确列出了上游会接受和不会接受的贡献清单。本文帮你 5 分钟搞清楚该做什么、不该做什么避免白忙一场。先搞懂它不是常规开源项目而是参考实现CONTRIBUTING.md 的第一句话就点明了基调The best contribution is a fork.最好的贡献就是 Fork这个项目不是一个被积极维护的产品而是一个可运行的示例——它演示了如何遵守 REFERENCE.md 中定义的 BLE 协议。上游的态度是与其把这个项目扭成你想要的样子不如构建你自己想要的设备。协议wire protocol才是稳定的契约固件只是遵守它的众多方式之一。上游会接受的 PR 清单只有两类 ✅根据 CONTRIBUTING.md只有以下贡献会被合入类型说明 文档纠错REFERENCE.md 协议文档写错、写得不清楚 致命 Bug 修复让参考实现不能作为参考的问题连不上不配对、不渲染、启动即崩溃判断标准很严格这个 Bug 是否破坏了项目作为参考的定位没有的话不在受理范围内。上游不会接受的 PR 清单提交前先自查 ❌CONTRIBUTING.md 同样直白地列出了拒绝项❌新功能新宠物、新界面、新状态❌板卡移植想换 Pi Pico W请 Fork别提 PR❌代码重构、风格调整、依赖版本升级还有一句扎心但实用的总结如果你不确定某件事属于哪一类大概率属于第二类不会接受。官方推荐姿势Fork 它把它变成你的设备 想动手官方建议你 Fork 后自由改造。克隆仓库git clone https://gitcode.com/gh_mirrors/cl/claude-desktop-buddyCONTRIBUTING 里给出的改造灵感把 M5StickC 换成Raspberry Pi Pico W把 ASCII 宠物换成电子墨水屏装进3D 打印外壳只保留 src/ble_bridge.cpp 和 JSON 解析器其余全删掉 如果你要从零开发自己的设备甚至不需要这个仓库的代码——只读 REFERENCE.md 就够了它定义了 Nordic UART Service 的 UUID、逐行 JSON 数据格式和文件夹推送协议任何能广播 Nordic UART Service 的硬件Arduino、ESP32、nRF52、树莓派都能实现。配对验证入口长这样先开启 Developer Mode再打开 Hardware Buddy 窗口提交 PR 前的最小验证流程安装 PlatformIO Core然后构建烧录pio run -t upload从旧设备升级建议先pio run -t erase清盘桌面端进入Help → Troubleshooting → Enable Developer Mode再Developer → Open Hardware Buddy…完成配对确认三个参考级行为能配对、能渲染、开机不崩把 PR 严格限定在 Bug 修复本身不夹带重构和风格改动构建配置见 platformio.iniESP32 Arduino 框架依赖m5stack/M5StickCPlus库——这也解释了为什么换板卡的 PR 不会被接受。核心文件路径速查CONTRIBUTING.md — 贡献契约会/不会接受的 PR 清单REFERENCE.md — BLE 协议契约自研设备的唯一必读src/main.cpp — 主循环、状态机、UI 屏幕src/ble_bridge.cpp — Nordic UART 服务收发缓冲区src/data.h — 线上协议与 JSON 解析src/xfer.h — 文件夹推送接收端src/buddies/ — 每个 ASCII 宠物一个文件在这里加新宠物 ❌ 不会被接受的 PRcharacters/bufo/ — GIF 角色包实例tools/prep_character.py / tools/flash_character.py — 角色素材压缩与 USB 直刷工具一句话总结claude-desktop-buddy 的贡献哲学是Fork 优先——上游只要文档纠错和致命 Bug 修复其余一切创造都欢迎你在自己的 Fork 里尽情发挥。【免费下载链接】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），仅供参考