🖼️ 表情包管理器
插件名称： AstrBot 表情包管理器
当前版本： v4.03
让 AI 根据对话场景自动选择并发送表情包，同时提供完整的 WebUI 管理、资源广场、多包管理和云端同步功能。
普通用户通常无需发送固定命令。正常聊天时，AI 会根据管理员配置和当前语境，自动选择合适的表情。
🚀 普通用户如何使用？
正常聊天即可，例如：
@bot 今天终于把项目做完了！
AI 可能在文字回复中附带一个符合语境的表情包。
是否发送、发送几张、使用哪个表情包，取决于：
- 当前人格和会话绑定的表情包；
- 表情分类和描述；
- AI 对语境的判断；
- 管理员设置的发送概率和数量；
- 当前回复模式是否兼容图片。
⚠️ 首次安装默认没有表情包
从 4.0 版本开始，插件第一次启动时是“空表情包”状态，不再自动导入内置资源。
管理员必须先完成以下任一操作：
- 在 WebUI 的资源广场安装官方或社区表情包；
- 从 GitHub 仓库安装表情包；
- 自己上传和分类图片；
- 使用
@bot 表情管理 恢复默认表情包安装官方包。
没有安装任何资源时，AI 无法正常发送表情包。
✨ 主要功能
| 功能 | 说明 |
|---|---|
| AI 自动选图 | 根据聊天场景自动选择合适表情 |
| WebUI 管理 | 直接在 AstrBot 插件页面管理，无需单独端口 |
| 资源广场 | 安装官方或社区表情包 |
| 多包管理 | 同时安装、导入、导出和卸载多个表情包 |
| 会话与人格选包 | 不同群聊、私聊或人格可以使用不同表情包 |
| 分类与描述 | 为表情分类并写使用场景，帮助 AI 正确选图 |
| 批量操作 | 支持拖拽、移动、复制、粘贴和批量删除 |
| 自动 Prompt | 表情分类变化后自动维护提示词 |
| 云端同步 | 支持图床备份和多设备同步 |
| 实时生效 | WebUI 修改后通常不需要重启 |
🖥️ WebUI 管理
进入：
AstrBot WebUI → 插件 → 表情包管理器
可以进行：
- 浏览资源广场；
- 安装官方和社区表情包；
- 从 GitHub 仓库地址安装资源；
- 新建、修改和删除分类；
- 上传、下载和删除图片；
- 编辑每个分类的描述；
- 切换不同表情包组；
- 为默认、会话和人格配置不同的表情包；
- 导入或导出完整备份；
- 查看图床服务商及云端占用情况。
所有修改会实时生效。
👑 管理命令
大部分功能建议直接在 WebUI 中完成。以下命令主要供管理员或不方便访问 WebUI 时使用。
查看和添加
| 命令 | 说明 |
|---|---|
@bot 表情管理 查看图库 | 列出全部可用表情类别 |
@bot 表情管理 添加分类 类别名称 描述 | 创建新分类 |
@bot 表情管理 添加表情 类别 | 通过聊天向指定类别上传表情 |
@bot 表情管理 恢复默认表情包 | 从官方仓库安装首个官方包并设为默认 |
清理操作
| 命令 | 说明 |
|---|---|
@bot 表情管理 清空指定类型 类别 | 清空该类别中的图片，但保留分类 |
@bot 表情管理 清空全部 | 清空全部表情图片，但保留分类和描述 |
@bot 表情管理 删除类型本身 类别 | 删除分类及其描述 |
这些危险操作需要在 30 秒内二次确认。
云端同步
| 命令 | 说明 |
|---|---|
@bot 表情管理 同步状态 | 查看本地和云端同步状态 |
@bot 表情管理 同步到云端 | 将本地表情上传到云端 |
@bot 表情管理 从云端同步 | 从云端下载表情 |
@bot 表情管理 覆盖到云端 | 使云端内容与本地完全一致 |
@bot 表情管理 从云端覆盖 | 使本地内容与云端完全一致 |
“覆盖”会删除目标端多余内容，操作前应确认已经备份。
☁️ 云端存储
插件支持：
| 服务 | 说明 |
|---|---|
| Cloudflare R2 | 适合公开图片访问和 CDN 加速 |
| WebDAV | 适合 NAS、Alist、Nextcloud、坚果云、群晖等 |
| Stardots | 仓库 README 认为容量和 API 限额较小，不推荐优先使用 |
图床不是必需功能。不配置图床时，本地管理和 AI 自动发表情仍可正常工作；只有云端同步不可用。
🎭 会话与人格选包
表情包选择规则分为：
default
session
persona
default：默认表情包；session：为某个群聊或私聊单独指定；persona：为某个人格单独指定。
会话或人格配置可以覆盖默认配置，使不同 bot、群聊或角色使用不同风格的表情包。
⚠️ 兼容性与注意事项
- 开启 AstrBot 分段回复后，带图回复可能失效。
- 开启流式传输兼容模式后，带图回复也可能失效。
- 想获得完整的文字加表情体验，可能需要管理员关闭分段回复。
- AI 不一定每次都会发送表情。
- 分类描述不准确时，AI 可能选错图片。
- 首次启动为空包，必须先安装或导入资源。
- 云端凭证、WebDAV 密码和 R2 密钥都属于敏感信息，不能在群聊中发送。
清空全部、删除分类和双向覆盖都有数据丢失风险。- 表情图片仍应遵守群规、平台规则和版权要求。
❓ 常见问题
Q：为什么 bot 从来不发表情？
可能没有安装表情包、当前人格没有绑定表情包、分段回复不兼容，或 AI 没有判断出适合发送的场景。
Q：为什么安装后图库是空的？
这是 v4.0 起的正常行为。请到资源广场安装一个官方包，或发送：
@bot 表情管理 恢复默认表情包
Q：必须配置图床吗？
不需要。只有云端同步需要图床，本地表情管理和自动发送不受影响。
Q：为什么 WebUI 修改后没看到变化？
通常实时生效。对话中仍保留旧上下文时，可以使用 AstrBot 的重置对话功能，再重新测试。
Q：为什么回复有文字但没有图片？
可能开启了分段回复或流式兼容模式，也可能当前平台发送图片失败。
📎 项目信息
- 显示名称：表情包管理器
- 当前版本：v4.03
- 作者：anka
- 开源协议：MIT
- 项目地址：https://github.com/anka-afk/astrbot_plugin_meme_manager
