一个功能强大的 AstrBot 表情包管理插件，支持 🤖 AI 智能发送与自动收集表情、🖥️ WebUI 管理界面、☁️ 云端同步等特性。
v5.0.1 提供新版提示词，请按需重置默认模板。 升级并重载插件后，进入 设置中心 → 提示词模板 → 恢复默认模板 → 保存并应用，载入新版前缀、后缀及附加模板。已有自定义内容请先复制备份，再按需合并回新版模板。
- 安装插件后，进入 AstrBot WebUI → 插件页面 → 表情包管理器。
- 打开资源广场，下载一个官方或社区表情包；也可以使用
/表情管理 恢复默认表情包安装官方包。 - 进入设置中心 → 使用规则，将下载的包设为默认，或绑定到指定会话、人格，然后保存规则。
- 开始聊天。插件会自动提供当前表情包的分类提示，无需修改人格；有合适的表情时，模型可以配合文字发送，也可以只发表情。
首次使用没有内置图片，需要先安装表情包。管理页的选包用于浏览和编辑，聊天实际使用哪个包由使用规则决定。
必须配置图床吗？ 不需要。图床用于云端同步，本地管理与表情发送可独立使用。
下载了新包，为什么聊天还用原来的？ 请在设置中心保存使用规则。下载或切换管理页的表情包，不会自动修改聊天选包规则。
可以流式回复吗？ 可以。经过 AstrBot 流式消息管线的标签会在发送前解析，有歧义的片段会暂时缓冲，图片在回复结束后发送。
必须进行语义化吗？ 不需要。普通分类模式即可使用；希望按图片描述检索时，再配置语义化。
图床仅用于云端同步，可在设置中心 → 存储与下载中选择并配置：
- 兰空图床（Lsky Pro 开源版 2.x）
- Cloudflare R2
- WebDAV
- StarDots
- 前往索引仓库 README 阅读完整提交指引： anka-afk/astrbot-meme-pack-index
- 按协议准备你的表情包仓库结构（manifest、memes、previews），并确保仓库可访问。
- 如果你会编辑索引文件：
- 直接在索引仓库提交 PR
- 如果你不会编辑索引文件：
- 在索引仓库提 Issue，按模板填写信息
- 你也可以先参考示例仓库模板： anka-afk/astrbot-meme-pack-example
建议：先在本地或测试环境通过“资源广场安装”验证一次，确保索引条目可安装、可预览、分类描述清晰。
浏览和安装官方、社区表情包，也支持通过 GitHub 仓库地址安装索引之外的表情包。
按分类预览图片，上传、删除、拖拽移动或批量整理表情，编辑分类描述，并切换不同表情包进行管理。
普通模式按分类选择表情；语义模式会先为图片生成描述和检索向量，再根据对话寻找更贴切的图片。使用前需在设置中心配置图片描述模型与向量模型，并在“语义化”页面完成处理。生成描述和向量会调用对应模型，费用取决于所用服务。
语义化页面可以查看处理进度、继续任务和重试失败图片。自动收集的图片统一在表情包管理页审核接收后，再按需生成语义索引。
在模式页选择原生分类、辅助模型分类或两种语义检索模式，再沿流程图查看使用规则、选图、回退与发送设置。点击流程中的配置项可在弹窗内修改；也可以从使用规则、表情发送、自动收集、存储与下载、提示词模板、标签与匹配、导入与备份等分类进入。配置修改后点击“保存并应用”，使用规则单独保存。
在设置中心 → 自动收集开启，并选择支持图片输入的视觉模型。插件会识别收到的图片，从目标表情包的现有分类中选择合适的分类，并进行去重。
平台明确标记为表情的图片直接进入抽样与识别流程；普通图片或缺少平台分类的图片首次仅记录，第二次出现时有 45% 的识别采样概率，之后逐次提高，第八次必定触发。同一发送者在不同消息中重复发送也会计数；连续 7 天未出现的记录会过期。单条消息最多处理的图片数可设置为 1–10 张，默认 1 张；同一来源最短识别间隔限制的是不同消息的入队时间，不影响重复次数记录。
自动收集默认关闭，识图需要调用视觉模型；
- 进入表情包管理，切换到收集目标包。
- 有待审核图片时，选包框右侧显示待审核表情按钮，点击查看图片、建议分类和两项置信度。
- 默认按分类置信度从高到低排列，低把握度排在后面；可筛选分类、调整排序和修改接收分类，然后接收选中的图片。
- 不需要的图片可以丢弃；勾选“不再收集”后，相同内容不会再次进入该包的候选列表。
关闭人工审核后，新收集的图片自动入包，已有待审核图片仍需处理。无论审核开关是否开启，语义索引都由用户手动生成。符合当前语义描述标准且接收分类未改变的收集结果可直接复用描述。
其他插件自行请求模型或发送消息时，可通过本插件的公开接口接入表情处理。接口说明与示例见 开发指南 → 插件联动接口，流式处理方式与边界见 解析与消息发送。
页面预览默认同时加载 2 张图片，可在 AstrBot 插件配置的「页面预览」或插件设置中心的「存储与下载 → 页面预览」调整为 1–8 张，保存后刷新页面生效。并发限制按每个打开的插件页面计算。
已浏览的图片会使用浏览器私有缓存，文件未变化时重新进入页面可减少重复下载。替换文件后重新加载图库会使用新的图片版本；浏览器清理缓存或强制刷新时可能重新下载。此功能控制加载并发和重复流量，不限制服务器总带宽。
当前大部分功能都可以通过 AstrBot WebUI 管理界面操作，无需使用指令。以下为指令列表，供 CLI 用户参考：
| 指令 | 描述 |
|---|---|
/表情管理 查看图库 |
📚 列出所有可用表情类别 |
/表情管理 添加分类 [类别名称] [描述] |
➕ 创建新的表情包分类，可只输入名称后按提示补充描述 |
/表情管理 添加表情 [类别] |
➕ 通过聊天上传表情到指定类别 |
/表情管理 恢复默认表情包 |
♻️ 从官方仓库一键安装首个官方表情包并设为默认 |
/表情管理 清空指定类型 [类别] |
|
/表情管理 清空全部 |
|
/表情管理 删除类型本身 [类别] |
|
/表情管理 同步状态 |
🔄 检查同步状态 |
/表情管理 同步到云端 |
☁️ 将本地表情同步到云端 |
/表情管理 从云端同步 |
⬇️ 从云端同步表情到本地 |
/表情管理 覆盖到云端 |
|
/表情管理 从云端覆盖 |
当前版本：v5.1.0
- 设置中心新增四种模式的完整流程图；点击配置项可在弹窗中直接修改，原有分类入口保留。
- 资源广场按上游版本显示可更新表情包，支持逐张预览并选择新增、修改和删除内容，以及多种更新策略。
- 优化表情包管理的拖拽与批量操作，支持跨表情包移动并处理目标分类冲突。
完整版本记录请查看 CHANGELOG.md。
如果遇到问题或有功能建议，欢迎在 GitHub 提交 Issue。
本项目基于 MIT 许可证开源。