核心用法
Holocube Emotes 是一套将 GeekMagic HelloCubic-Lite 全息立方体显示器转化为 AI 实体化"面孔"的完整工作流。系统包含三大模块：
1. 精灵图生成：利用 Gemini（通过 nano-banana-pro skill）自动生成 7 套表情（neutral/happy/thinking/surprised/concerned/laughing/sleeping）的静态 JPG 与动画 GIF，针对 240x240 像素玻璃显示屏优化，默认采用霓虹紫线框全息风格，支持自定义角色描述。
2. 设备管理：提供自动发现、批量上传、备份清理功能。设备存储仅 3MB，需定期清理；支持保留 adam-custom.gif 槽位用于即时自定义内容。
3. 状态映射：建立 agent 状态到表情的语义桥梁——working/thinking 映射为处理中状态，complete/happy 表示任务成功，error/concerned 反馈异常，支持时间自动切换（夜间休眠模式）及心跳集成。
显著优点
- 物理具身化：将抽象 AI 对话状态转化为可见、可感知的全息投影，显著增强人机交互临场感
- 零设计门槛：自然语言描述角色，Gemini 自动生成全套规格化素材
- 协议轻量：纯 HTTP 控制，本地网络直连，无需云端依赖
- 可扩展架构：预留自定义槽位，支持事件驱动的一次性动画注入
潜在局限
- 硬件锁定：仅兼容 GeekMagic HelloCubic-Lite 系列（240x240 分辨率），其他品牌/型号需适配
- 存储瓶颈：3MB 总容量严重限制素材丰富度，动画 GIF 压缩损耗明显
- 生成依赖：精灵生成硬依赖 Gemini API，断网或额度耗尽时无法创建新角色
- 无双向反馈：设备仅接收指令，无法向 AI 回传传感器数据（如用户接近检测）
- 网络单点：设备基于局域网 IP 通信，跨网段或 DHCP 变动需手动重配置
适合人群
桌面 AI 助手重度用户、直播/演示场景开发者、智能硬件爱好者、追求"具身智能"体验的前沿技术采用者。特别适合已拥有 Holocube 设备且希望将 Claude/ChatGPT 等对话状态可视化的极客用户。
常规风险
- 误操作风险：文档明确警告
/set?reset=1会触发工厂重置导致 WiFi 配置丢失 - 存储覆盖：
--clear操作不可逆，虽提供--backup-dir但用户可能忽略 - API 密钥暴露：
GEMINI_API_KEY需配置在环境或 skill 中，存在泄漏风险 - 网络暴露：设备 HTTP 端点无认证，同一局域网内任意主机可控制显示内容