Emotion Ball 表情馆

Emotion Ball 是一套面向 AI 助手打造的开源表情引擎，32 种状态表情全部由纯 SVG 与原生 JavaScript 实时驱动，零框架、零图片资源、零依赖。AI 侧只需输出一个 emotionId，小球即可切换到对应表情，可直接用作聊天机器人、桌面宠物、悬浮助手的情绪表达层。

核心能力 32 种状态表情覆盖三大分组：生命周期（睡眠/唤醒/待机）、情绪反应（开心/害羞/生气/惊讶）与代理工作状态（思考中/检索资料/出错/任务完成）。内置圆胖(blob)、三角(wedge)、菱形(gem)三种身体形态，支持主题色实例与线稿模式。

AI 对接协议 AI 只需输出一段 JSON，交给 handleAIMessage 方法即可切换表情：{"emotionId":"30","tips":"正在思考用户问题"}。未知 ID、JSON 解析失败、缺字段均自动回退待机并触发 error 事件，永不白屏。

分段式 emotionId 编码 十位数字即分组前缀：00-09 生命周期、10-29 情绪、30-49 代理状态、50+ 自定义。组间空号为新表情预留，已有编号永不重排，对接方可放心硬编码。

视觉系统 轮廓环眼睛系统：25 组 48 点轮廓眼环，逐点弹簧插值形变，眨眼带过冲关键帧。球面投影：眼睛按身体轮廓做经度换算与余弦压缩，自旋绕到背面时自动隐藏。鼠标注视全页面跟随，帧率无关指数平滑。

特效 自旋达速甩出 3D 轨道拖尾彩带（5-stop 色相渐变），思考状态头顶常驻环带，庆祝状态物理粒子撒花。

扩展与集成 每种表情均为「眼环池 + 动画原语 + 关键帧序列」的纯数据组合，支持运行时注册自定义表情、导入导出全部配置。内置 .cursor/skills/ 工程化规范文档，Cursor AI 可自动遵循设计规范。Electron 桌面宠物接入方案已包含透明窗口、鼠标穿透、IPC 转发等完整指引。

适用场景 聊天机器人情绪层、桌面宠物/悬浮助手、AI 编程助手工作状态可视化、游戏/元宇宙虚拟角色、直播/短视频虚拟主播。

来源：https://github.com/sam70361/emotion-ball