🚀 项目简介

这是一个专为 AstrBot 打造的 智能表情包生成插件，基于 meme-generator-rs 与 nonebot-plugin-memes 开发。插件融合了高效的图像处理与模板匹配技术，能够为用户带来多样化、灵活而有趣的表情包创作体验。

✨ 核心特性

• 🖼️ 多源图片支持 - 自动获取用户头像、支持上传图片、引用消息图片
• ⚡ 高性能渲染 - 基于 Rust 底层引擎，生成速度极快
• 🎨 丰富模板库 - 内置 200+ 精选表情包模板
• 🔧 灵活配置 - 支持黑名单管理、图片压缩、超时控制等
• 💾 智能缓存 - 头像缓存机制，提升生成速度
• ⏱️ 冷却控制 - 防止刷屏，保护服务器资源

📦 快速安装

# 进入插件目录
cd astrBot/data/plugins

# 克隆项目
git clone https://github.com/SodaSizzle/astrbot_plugin_meme_generator

# 安装依赖
pip install -r astrbot_plugin_meme_generator/requirements.txt

🚀 资源初始化

💡 重要提示: 首次启动需要下载表情包模板资源，请耐心等待。

自动下载（推荐）

插件会在首次启动时自动下载所需资源到用户目录：

• Windows: C:\Users\{用户名}\.meme_generator\
• Linux: ~/.meme_generator/

手动下载（网络较慢时使用）

如果自动下载失败或速度过慢，可以手动下载资源包：

下载地址: https://github.com/SodaSizzle/astrbot_plugin_meme_generator/releases/tag/v1.0.0

Windows 系统

# 1. 下载 resources.zip
# 2. 解压到 C:\Users\{你的用户名}\.meme_generator\ 目录下

Linux 系统

# 1. 下载 resources.tar.gz
# 2. 解压到指定目录
tar -zxvf resources.tar.gz -C ~/.meme_generator/

Docker 环境

# 1. 拷贝 resources.tar.gz 到容器内指定目录
docker cp resources.tar.gz astrbot:/root/.meme_generator/

# 2. 解压到指定目录
docker exec -it astrbot tar -zxvf /root/.meme_generator/resources.tar.gz -C /

# 3. 启动 AstrBot
docker restart astrbot 

⚠️ 字体问题解决

如果遇到表情包中文字显示异常（乱码、方块等），请按以下步骤解决：

Linux 系统(docker)

export LANG=en_US.UTF-8
# 重启 AstrBot ( docker restart astrbot )

验证安装

资源下载完成后，目录结构应该如下：

.meme_generator/
└── resources/
    ├── fonts/          # 字体文件
    └── images/         # 图片资源

🎨 添加额外资源

📖 参考文档: 加载其他表情 - meme-generator-rs Wiki

如果希望加载非本仓库内置的表情包，请按照以下步骤操作：

📋 配置步骤

1️⃣ 启用外部表情包加载

在 配置文件 中将 load_external_memes 设置为 true

2️⃣ 添加动态链接库

将其他表情仓库编译出的动态链接库放置于 $MEME_HOME/libraries 文件夹下

💾 下载地址: meme-generator-contrib-rs Actions

3️⃣ 添加资源文件

将表情需要的图片/字体放置于 $MEME_HOME/resources 文件夹下

📁 资源示例: contrib-rs/resources/images

🐛 常见问题解决

Fontconfig 错误修复

如遇 Fontconfig error: Cannot load default config file 错误，请执行以下命令并重启：

# 更新包管理器并安装字体配置
apt update && apt install -y fontconfig fonts-dejavu-core

# 重建字体缓存
fc-cache -fv

💡 提示: $MEME_HOME 即 .meme_generator 目录。Docker 用户请自行复制到容器中操作。

⚙️ 配置说明

主要配置项

缓存系统说明

• 缓存位置: data/cache/meme_avatars/
• 缓存文件: 用户头像以MD5哈希命名存储
• 元数据: metadata.json 记录缓存时间戳
• 自动清理: 每6小时自动清理过期缓存

📋 命令列表

🎮 表情帮助

🔧 表情状态

🎯 快速上手

基础使用

表情帮助          # 查看完整功能菜单
表情列表          # 浏览所有模板
摸头 @用户        # 生成表情包
举牌 你好世界      # 文字表情包

管理功能

表情状态          # 查看运行状态
单表情禁用 模板名   # 禁用指定模板
表情禁用          # 临时关闭插件

🔧 技术架构

核心依赖

• meme-generator-rs - Rust 高性能表情包生成引擎
• nonebot-plugin-memes - 模板资源和算法参考
• AstrBot - 机器人框架和平台适配

❤️ 致谢

特别感谢以下开源项目：

• meme-generator-rs - 高性能表情包生成引擎
• nonebot-plugin-memes - 模板资源和算法参考
• AstrBot - 优秀的机器人框架