表情精灵 / Expression Sprites
表情精灵功能可以根据角色消息内容自动切换角色表情图片。
🎭 功能介绍
当AI角色发送消息时，系统会自动检测消息中的情绪，并切换对应的表情图片，让对话更加生动。
支持的表情
NativeTavern 支持15种标准表情：
| 情绪 | 英文 | 触发示例 |
|---|---|---|
| 😊 开心 | happy | 微笑、大笑 |
| 😢 悲伤 | sad | 哭泣、难过 |
| 😠 愤怒 | angry | 生气、愤怒 |
| 😲 惊讶 | surprised | 惊讶、吃惊 |
| 😨 害怕 | scared | 恐惧、害怕 |
| 😍 喜爱 | love | 心动、喜欢 |
| 😊 满足 | satisfied | 满意、舒适 |
| 😔 失望 | disappointed | 失望、沮丧 |
| 🤔 思考 | thinking | 思考、疑惑 |
| 😌 害羞 | shy | 害羞、脸红 |
| 😐 中性 | neutral | 平静、无表情 |
| 😏 调皮 | smug | 得意、坏笑 |
| 😴 困倦 | tired | 疲惫、困 |
| 😤 不满 | annoyed | 烦躁、不耐烦 |
| 🥰 感动 | touched | 感动、温暖 |
📁 设置表情图片
1. 准备图片
为角色准备表情图片，命名规则：
happy.png
sad.png
angry.png
surprised.png
...2. 导入精灵
- 进入角色编辑
- 点击 "表情精灵"
- 为每种情绪上传对应图片
- 保存
3. 批量导入
也可以一次性导入整个精灵文件夹：
- 准备包含所有表情图片的文件夹
- 选择 "导入精灵文件夹"
⚙️ 显示设置
位置设置
| 选项 | 说明 |
|---|---|
| 右上角 | 显示在聊天右上 |
| 左上角 | 显示在聊天左上 |
| 消息旁 | 显示在消息气泡旁 |
大小调整
可以调整精灵图片的显示大小：
- 小：80px
- 中：120px
- 大：160px
- 自定义
透明度
调整精灵图片的透明度，0-100%。
🎬 动画效果
切换动画
表情切换时支持平滑过渡动画：
- 淡入淡出
- 缩放过渡
开启/关闭动画
在设置中可以开启或关闭动画效果。
🎯 动作检测
除了情绪检测，还支持动作检测。
当消息中出现 *动作描述* 格式时：
*微笑着点了点头* 好的，我知道了。系统会检测"微笑"并切换到对应表情。
支持的动作词
| 动作 | 对应表情 |
|---|---|
| 微笑、笑了 | happy |
| 哭、流泪 | sad |
| 皱眉、生气 | angry |
| 脸红、害羞 | shy |
| ... | ... |
💡 使用技巧
图片格式
- 推荐使用 PNG 格式（支持透明背景）
- 建议尺寸：256x256 或 512x512
- 保持各表情图片尺寸一致
风格统一
- 所有表情图片应该风格统一
- 可以使用AI生成的一套表情包
默认表情
- 确保有 neutral.png 作为默认表情
- 无法识别情绪时会使用中性表情
---
📦 CharX支持
CharX格式的角色卡可以包含嵌入的表情精灵。
导入CharX角色时，精灵图片会自动提取并关联。