claude-desktop-buddy GIF 角色包压缩指南用 prep_character.py 与 gifsicle 轻松压到 1.8MB【免费下载链接】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 官方的硬件伴侣Hardware Buddy固件示例把 Claude 桌面端通过蓝牙连到 M5StickC 小屏设备上角色包以 GIF 动画呈现。角色包整个文件夹必须小于1.8MB才能通过 BLE 传输到设备而原始 GIF 往往超限。本文介绍用 prep_character.py 统一裁剪缩图 gifsicle 有损压缩的完整流程几分钟搞定。为什么 GIF 角色包传不动1.8MB 的硬门槛一个角色包 manifest.json 15 张左右 96px 宽的 GIF覆盖 7 种状态sleep、idle、busy、attention、celebrate、dizzy、heart。文件夹会通过 BLE 整包传输到 ESP32 设备所以整个文件夹要控制在 1.8MB 以内超限会直接被拒绝。此外屏幕是 135×240 竖屏GIF 宽 96px、高约 140px 以内刚好透明边距过大还会浪费屏幕空间、让角色显得更小。第一步用 prep_character.py 统一裁剪和缩图tools/prep_character.py 的作用是把任意尺寸、任意比例的角色 GIF 源文件转换成一套角色大小一致的 96px 宽 GIF直接输出到 characters/ 目录。用法就一条命令python3 tools/prep_character.py 角色包目录或zip它的核心思路是两遍处理第一遍把所有状态的每一帧都归一化到 1000px 宽计算所有帧的全局包围盒保证角色在每个状态里的比例完全一致不会出现待机时大、庆祝时小第二遍按同一裁剪框裁切 → 缩放到 96px 宽 → 用 manifest.json 里colors.bg指定的背景色填充 → 每帧量化为64 色自适应调色板从源头压掉颜色冗余。脚本跑完会自动打印每个文件的压缩前后大小如果总大小超过 1800KB会直接提示超限警告并输出一条现成的 gifsicle 命令不用自己记参数。第二步gifsicle 有损压缩再砍 40%–60%如果 prep 之后仍超 1.8MB就用 gifsicle 再压一轮。先安装# macOS brew install gifsicle # Linux (Debian/Ubuntu) apt install gifsicle # Windows winget install LCDF.Gifsicle然后对文件夹内所有 GIF 批量执行gifsicle --batch --lossy80 -O3 --colors 64 characters/name/*.gif参数含义很直白--lossy80有损压缩强度、-O3最高档优化、--colors 64限制调色板为 64 色。对 96px 的小屏 GIF 来说肉眼几乎无差别通常能再砍掉 40%–60% 的体积。压缩完用du -sh characters/name确认小于 1.8MB 即可。第三步拖进 Hardware Buddy 窗口安装把整个文件夹拖到 Hardware Buddy 窗口的放置区参考 README.md 的 GIF pets 一节应用会通过 BLE 流式传输设备即时切换到 GIF 模式。如果反复调试角色想跳过蓝牙传输可以用 tools/flash_character.py 直接走 USB 写入python3 tools/flash_character.py characters/bufo关键参数速查清单项目要求文件夹总大小 1.8MB1800KBGIF 宽度96px高度约 140px 以内裁剪紧贴角色留透明边距会浪费屏幕状态数7 种sleep / idle / busy / attention / celebrate / dizzy / heart清单文件manifest.jsonidle支持数组轮播多张 GIF照着 characters/bufo/ 这个现成示例的目录结构来做一次通过率最高先 prep 缩图再 gifsicle 压缩最后拖进窗口你的自定义 GIF 角色就能顺利上机了 【免费下载链接】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），仅供参考