holocube-emotes

Holocube Emotes 是一项专为 GeekMagic HelloCubic-Lite 全息立方体显示器设计的 AI 表情集成方案，旨在将数字助手的情绪状态实体化为物理光影反馈。

核心用法：该技能通过三步工作流实现硬件联动。首先，利用 Gemini API 生成包含 7 种情绪（neutral、happy、thinking、surprised、concerned、laughing、sleeping）的全息精灵图；其次，通过本地网络将图片上传至设备的 3MB 存储空间；最后，建立 Agent 状态与表情的映射规则（如 working→thinking、complete→happy），支持根据时间自动切换（夜间自动进入 sleeping 模式）或手动触发特定表情。

显著优点：相比纯软件交互，该方案为 AI 助手提供了物理层面的"面容"，显著增强人机交互的临场感。支持深色背景优化设计，使玻璃显示器在展示霓虹光效时呈现悬浮全息视觉效果。自动化状态映射减少了人工干预，而自定义角色功能允许用户打造独特的 AI 视觉形象。

潜在缺点：硬性功能门槛较高，必须拥有 GeekMagic HelloCubic-Lite 硬件才能使用。设备存储空间有限（约 3MB），6 个动画 GIF 即占用 1.5MB，严重限制了自定义内容的数量。功能依赖 Gemini API 和 nano-banana-pro 技能，增加了配置复杂度。此外，所有操作仅限于本地局域网环境，无法远程控制。

适合人群：主要面向已持有 HelloCubic-Lite 设备的极客用户、智能家居爱好者，以及希望为 AI 助手构建物理形象的专业开发者。适合用于打造具有视觉反馈的桌面 AI 工作站、智能家居控制中枢等场景。

使用风险：需特别注意避免发送 /set?reset=1 指令，该命令会触发工厂重置并清除 WiFi 配置。设备存储管理不当可能导致上传失败，建议首次使用前通过 --backup-dir 备份现有内容。由于依赖本地网络发现机制，在公共网络环境下存在设备欺骗的潜在风险，建议在可信的家庭网络中使用。

核心用法

holocube-emotes 是一套将 GeekMagic HelloCubic-Lite 全息显示设备转化为 AI 助手"物理面孔"的完整方案。核心流程三步走：

1. 设备发现：自动扫描本地子网（192.168.x.x）定位设备，或通过屏幕/Router 获取 IP
2. 精灵生成：依赖 nano-banana-pro skill 调用 Gemini API，一次性生成 7 套表情（neutral/happy/thinking/surprised/concerned/laughing/sleeping）的静态 JPG + 动画 GIF，针对 240×240 玻璃屏优化，采用黑底霓虹光效以隐藏边框
3. 状态映射：支持直接命令（happy/thinking）、语义映射（working→thinking、complete→happy）、模型感知（opus→thinking、haiku→neutral）、时间自动（夜间 sleeping/晨间 happy）四种模式

日常集成推荐加入 HEARTBEAT.md 实现自动时间感知表情切换，或绑定 agent 状态机实现实时情感反馈。

显著优点

• 物理存在感：将抽象的 AI 对话转化为可注视的实体反应，显著降低人机交互的认知距离
• 零云服务依赖：设备控制完全本地 HTTP，仅图像生成需一次外部 API 调用
• 低代码集成：单命令状态切换，支持 custom 保留槽位实现临时动画
• 存储优化：6 个动画 GIF 仅占用 1.5MB/3MB，预留 500KB 自定义空间

潜在局限

• 硬件门槛：需专门购买 GeekMagic 设备（~$30-50），非纯软件方案
• 依赖耦合：精灵生成强依赖 nano-banana-pro skill 及 Gemini API，无网络时无法新建角色
• 协议限制：设备仅支持明文 HTTP（TLS warn），且存在工厂重置指令 /set?reset=1 的误操作风险
• 子网束缚：扫描范围限定 192.168.x.x，跨 VLAN 或企业网络需手动指定 IP

适合人群

• 追求"AI 具身化"体验的个人开发者与极客用户
• 已拥有 GeekMagic 设备、希望赋予其对话感知能力的现有持有者
• 构建桌面 AI 助手的硬件集成场景（需 Raspberry Pi/PC 常驻运行状态脚本）

常规风险

| 风险 | 等级 | 说明 |

|------|------|------|

| 子进程调用 | medium | `generate_sprites.py` 通过 `uv run` 调用外部脚本，需验证路径防遍历 |

| API 密钥暴露 | low | 从 `~/.openclaw/openclaw.json` 读取，需确保 600/644 权限 |

| 网络扫描 | low | 自动扫描 1-255 地址，企业环境可能触发 NIDS 告警 |

| 明文传输 | warn | HTTP 无加密，同一局域网内可被嗅探控制指令 |

关键禁忌：文档明确警示 NEVER 发送 `/set?reset=1`，该端点会抹除 WiFi 配置导致设备变砖需重配。

整体而言，这是一套设计精巧、边界清晰的 IoT 桥接方案，将 LLM 的"内心活动"外化为可触摸的光影表情，适合愿意投入硬件的个性化 AI 场景。