71个角色与44种动画状态完全清单：Aora Bot角色阵容快速入门

Aora Bot 是一个代码绘制的网页角色引擎：71 个角色、44 种动画状态、16 种脸、三种画风，外加 7 个节日主题共 122 个角色，支持 React 组件、Web Component 与头像接口。这篇 Aora Bot 角色阵容指南把 71 个角色的 id 和 44 种动画状态全部整理成表，帮你快速挑角色、选状态，一行代码就能用。

Aora Bot 是什么：代码绘制的网页角色引擎

一句话理解：没有雪碧图，没有 Lottie 文件。每个角色的身体是代码里的一条 SVG 轮廓，每个表情是几个数字描述的曲线笔画，每一帧动画都由 requestAnimationFrame 循环直接写进 SVG 属性。

角色由几项互相独立的选择组成，可任意组合：

维度	数量	说明
角色（cast）	71 个 + 主题 122 个	每个角色 = 一个形状 + 一种墨色 + 一点性格
动画状态	44 种	分静息、处理中、情绪、提示四大组
脸	16 种	默认 cute（圆点眼、小嘴、腮红）
画风	3 种	vector（矢量）、pixel（像素）、kaomoji（颜文字）

引擎核心实现见 packages/engine/src/core/cast.ts（角色预设）和 packages/engine/src/motion/states.ts（状态清单）。

一图总览：71 个 Aora Bot 角色全家福

全部 71 个核心角色按目录顺序排成网格，第一个是奶白色小圆球「球球」（dot），也是阵容的领头角色：

角色按形状分成 13 个家族，完整清单如下（id 即组件里的 shape/preset 取值）：

家族	数量	成员（id：中文名）
圆润	6	dot：球球、mochi：糯糯、pip：团团、byte：比特、momo：桃桃、bao：包包
方圆	2	teal：青青、tato：薯薯
多边	3	hexa：六六、tri：尖尖、gemma：晶晶
花叶	5	nimbo：云宝、dew：滴滴、leafy：叶叶、bloom：仙仙、lucky：幸幸
田园	5	sprout：芽芽、shroom：菇菇、oak：橡橡、pokey：刺刺、aubie：茄茄
水果	6	nashi：梨梨、pomme：苹苹、berry：莓莓、cheri：樱樱、avo：油油、melo：瓜瓜
美食	7	pud：布布、toasty：脆脆、scoop：冰冰、cuppy：杯杯、fry：条条、candy：糖糖、patty：堡堡
造型	9	twinkle：亮亮、luv：心心、ember：焰焰、chime：叮叮、jelly：水灵、beep：哔哔、luna：露娜、boba：波波、orbi：环环
物件	4	nook：窝窝、chatty：叨叨、joy：喜喜、lumi：点点
海洋	4	finn：鱼鱼、inky：墨墨、roly：噜噜、puff：鼓鼓
小动物	12	miso：喵喵、hop：跳跳、bruno：熊熊、chirp：啾啾、waddle：摇摇、oink：哼哼、rusty：狐狐、leo：狮狮、hammy：囤囤、prickle：扎扎、koko：抱抱、flap：扑扑
人物	5	kiki：琪琪、maru：丸丸、zip：小刺、fuzz：卷卷、lulu：露露
煤球	3	cinder：红红、sooty：烟烟、ashy：灰灰

💡 每个角色预设 = { shape, color } + 名字。用 castMember('mochi') 可查出任意角色的形状、墨色与描述，未知 id 安全返回 null。角色预设的完整定义见 CharacterPreset。

44 种动画状态速查：四大分组

44 种动画状态分四组，覆盖产品里的「等待、干活、心情、提醒」四类场景：

分组	数量	状态 id
🌙 静息	6	idle、sleeping、drowsy、bored、waking、powering-down
⚙️ 处理中	19	listening、thinking、searching、reading、writing、working、loading、progress、radar、orbit、dictating、uploading、sending、receiving、messaging、waiting、spawning、composing、dragging
💖 情绪	16	happy、excited、laughing、playful、proud、celebrate、bouncing、shy、sad、angry、confused、suspicious、surprised、scared、curious、humming
📢 提示	3	alerting、notifying、refusing

场景到状态的常用映射（新手可直接照抄）：

• 加载/进度条 → loading（自带转圈特效）、progress（自带进度环）、waiting（省略号）
• AI 正在思考/生成 → thinking、composing、messaging
• 成功/庆祝 → celebrate：进入状态时自动旋转一圈并抛 16 片彩带
• 警告/拒绝 → alerting（感叹号）、refusing

两个容易踩坑的细节：spawning（入场）和 waking（苏醒）是「瞬间」而非「状态」，引擎会在 2 秒 / 1.6 秒后自动落回 idle，不用自己写定时器。

完整状态表（含每种状态的嘴型、特效与眨眼间隔）见 STATE_GROUPS 与 docs/content/zh/design/states.mdx。

7 个节日主题：122 个主题角色

核心阵容之外，还有 7 个节日与季节主题（万圣节、圣诞节、春节、中秋节、复活节、夏日、情人节），共 122 个主题角色，例如圣诞的麋鹿与拐杖糖、春节的红包与舞狮、中秋的月饼与玉兔：

主题按独立入口加载（@aora-bot/engine/themes/<id>），用到时才打包，不增加主包体积。每个主题的角色清单定义在 packages/engine/src/themes/manifest.ts。

三种快速上手方式：React、Web Component 与头像接口

方式一：React 组件（推荐）

pnpm add @aora-bot/react

import { CharacterMark } from '@aora-bot/react';
import '@aora-bot/react/styles.css';

<CharacterMark shape="mochi" state="happy" sizePx={96} />;

需要 React 19；引导页、场景模板等产品组件在 @aora-bot/surfaces 包里。

方式二：一行 script 嵌入任意网页（不依赖 React）

<script type="module" src="https://cdn.jsdelivr.net/npm/@aora-bot/element"></script>
<aora-bot character="mochi" state="happy" size="96"></aora-bot>

方式三：只要一张头像图片，把头像接口地址放进 <img>——同一个 id 永远是同一个角色，适合做用户头像：

<img src="https://aora-bot.vercel.app/avatar/alice.svg" width="64" height="64" alt="alice" />

注意：CDN 引入和头像接口在中国大陆暂不可用，用 npm 安装、随项目打包的方式不受影响。

React 包组件出口见 packages/react/src/index.ts，无框架的 Web Component 见 packages/element/src/element.ts。

换个画风试试：16 种矢量变体同步演示

同一个角色可以切换 vector、pixel、kaomoji 三种画风。下图是球球的全部画风同步动起来的演示：

更多角色与状态的组合方式，可以在官方文档的交互演示里直接试，文档入口：docs/content/zh/design/cast.mdx（角色阵容）、docs/content/zh/design/states.mdx（状态设计）、docs/content/zh/guide/getting-started.mdx（快速开始）。

总结：Aora Bot 角色阵容速记

• 71 个角色按 13 个家族组织，id 即 preset 参数，从 dot 到 ashy
• 44 种状态分静息 / 处理中 / 情绪 / 提示四组，状态 id 即 state 参数
• 7 个节日主题共 122 个主题角色，按需加载
• 三种接入方式：React 组件、Web Component、头像接口，总有一种适合你

项目总览与包结构说明见 README.md。现在打开角色表，挑一个顺眼的 id，你的页面里就能多一个会动的伙伴 🎉