# 表情精灵 / 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. 导入精灵

  1. 进入角色编辑
  2. 点击 "表情精灵"
  3. 为每种情绪上传对应图片
  4. 保存

# 3. 批量导入

也可以一次性导入整个精灵文件夹:

  1. 准备包含所有表情图片的文件夹
  2. 选择 "导入精灵文件夹"

# ⚙️ 显示设置

# 位置设置

选项 说明
右上角 显示在聊天右上
左上角 显示在聊天左上
消息旁 显示在消息气泡旁

# 大小调整

可以调整精灵图片的显示大小:

  • 小:80px
  • 中:120px
  • 大:160px
  • 自定义

# 透明度

调整精灵图片的透明度,0-100%。


# 🎬 动画效果

# 切换动画

表情切换时支持平滑过渡动画:

  • 淡入淡出
  • 缩放过渡

# 开启/关闭动画

在设置中可以开启或关闭动画效果。


# 🎯 动作检测

除了情绪检测,还支持动作检测。

当消息中出现 *动作描述* 格式时:

*微笑着点了点头* 好的,我知道了。

系统会检测"微笑"并切换到对应表情。

# 支持的动作词

动作 对应表情
微笑、笑了 happy
哭、流泪 sad
皱眉、生气 angry
脸红、害羞 shy
... ...

# 💡 使用技巧

  • 推荐使用 PNG 格式(支持透明背景)
  • 建议尺寸:256x256 或 512x512
  • 保持各表情图片尺寸一致
  • 所有表情图片应该风格统一
  • 可以使用AI生成的一套表情包
  • 确保有 neutral.png 作为默认表情
  • 无法识别情绪时会使用中性表情

# 📦 CharX支持

CharX格式的角色卡可以包含嵌入的表情精灵。

导入CharX角色时,精灵图片会自动提取并关联。


返回功能列表
../