Claude Desktop Buddy 自定义 GIF 角色：manifest.json 配置与蓝牙拖拽推送完整指南

Claude Desktop Buddy 自定义 GIF 角色manifest.json 配置与蓝牙拖拽推送完整指南【免费下载链接】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想让 Claude 桌面上的硬件伴侣 M5StickC Plus 换上你亲手设计的角色吗claude-desktop-buddy 是 Claude Cowork / Claude Code Desktop 官方提供的蓝牙 API 桌面硬件参考示例你只需准备一个包含manifest.json和七种状态 GIF 动画的角色包文件夹通过 Hardware Buddy 窗口的拖拽目标经 BLE 蓝牙推送到设备桌面宠物就会实时切换到你的专属 GIF 角色。本指南带你从素材规格、manifest.json 配置到蓝牙推送与 USB 烧录一步步完成整个过程。角色包长什么样manifest.json 配置详解每个角色包就是一个普通文件夹包含manifest.json和对应的 GIF 文件。参考仓库里的官方示例characters/bufo/manifest.json。{ name: bufo, colors: { body: #6B8E23, bg: #000000, text: #FFFFFF, textDim: #808080, ink: #000000 }, states: { sleep: sleep.gif, idle: [idle_0.gif, idle_1.gif, idle_2.gif], busy: busy.gif, attention: attention.gif, celebrate: celebrate.gif, dizzy: dizzy.gif, heart: heart.gif } }三个字段各有用途name角色名推送时会作为设备 LittleFS 存储的目录名。colors屏幕配色方案GIF 透明区域会用bg颜色填充避免残影。states七种状态的动画映射。状态值可以是单个文件名也可以是数组——数组会在每次循环结束后轮换到下一张 GIF让主屏不断切换眨眼和眼神动画而不是永远循环同一段。七种状态分别对应不同的触发场景状态触发条件sleep蓝牙桥未连接闭眼慢呼吸idle已连接、无紧急事件眨眼环顾busy会话正在运行attention有待审批请求LED 闪烁celebrate每 5 万 token 升级庆祝dizzy摇动设备heart5 秒内快速批准GIF 素材准备96px 宽是硬性规格设备屏幕是 135×240 的竖屏GIF 素材有明确的规格要求宽度固定 96px高度控制在约 140px 以内以保证完整显示紧贴角色裁剪——透明边距只会浪费屏幕面积、让角色显得更小整个角色文件夹不超过 1.8MB超出会被桌面端拒绝安装。手动逐张处理很繁琐仓库提供了专门的工具tools/prep_character.py。把任意尺寸的原始 GIF 目录或 zip交给它python3 tools/prep_character.py my_character_dir它会把所有状态统一缩放到 96px 宽、用同一套跨状态裁剪框保证角色在每种动画里比例一致自动压到 64 色并输出到characters/角色名/同时重写manifest.json。如果产物超过 1.8MB 上限脚本会直接打印一条gifsicle --lossy80 -O3 --colors 64的压缩命令帮你瘦身通常能减掉 40–60% 体积。蓝牙拖拽推送角色包上机两种方法方法一Hardware Buddy 窗口拖拽无线先打开开发者模式Help → Troubleshooting → Enable Developer Mode然后在Developer → Open Hardware Buddy…打开窗口点击Connect配对设备后把角色文件夹直接拖进右侧的 Drop a data folder here 区域点Send to Device应用会通过 BLE 把整个文件夹流式传到设备。传输走的是 src/xfer.h 定义的文件夹推送协议char_begin报头声明总大小并做容量检查 → 每个文件逐块 base64chunk传输并逐块确认 →char_end结束设备随即加载新角色并实时切换到 GIF 模式。方法二USB 直接烧录调试迭代更快频繁调整角色时跳过蓝牙往返更省事python3 tools/flash_character.py characters/bufotools/flash_character.py 会把角色包暂存到data/分区目录然后直接执行pio run -t uploadfs经 USB 写入 LittleFS 文件系统。烧录完成后在设备上长按 A → Settings → Species → GIF即可启用。设备端如何运行你的 GIF 角色角色包落地后固件由 src/character.cpp 接管开机自动扫描/characters/加载最近安装的角色解析 manifest 中的配色与状态映射characterSetState()负责状态切换时打开对应 GIFcharacterTick()每帧推进动画解码。idle 多帧数组会在同一动画驻留约 5 秒后轮换到下一张暂停 0.8 秒再播放营造自然的环顾四周效果。想让设备退回内置的 18 种 ASCII 宠物在设备Settings → delete char删除角色即可。完整的 BLE 线协议细节UUID、JSON 模式见 REFERENCE.md动手前值得浏览一遍。现在打开你的画图工具把专属角色送上 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），仅供参考