来提交你的插件吧!
有疑问?来看看呗!

插件详情

图库管理器 logo

图库管理器

帮助用户组建、管理、调用本地图库,可用于表情包收集管理、图床管理、为其他插件提供动态图库等等

图库
版本v2.1.0
作者Zhalslar
Star23
更新2025/12/18

插件说明

:name

astrbot_plugin_gallery

✨ astrbot 图库管理器 ✨

License
Python 3.10+
AstrBot
GitHub

🤝 介绍

【本地图库管理器】-帮助用户组建、管理、调用本地图库,可用于表情包收集管理、图床管理、为其他插件提供动态图库等等

✨ 最近更新

支持自动收集用户的表情包,支持LLM调用表情包

📦 安装

直接在astrbot的插件市场搜索astrbot_plugin_gallery,点击安装,等待完成即可

  • 或者可以直接克隆源码到插件文件夹:
# 克隆仓库到插件目录
cd /AstrBot/data/plugins
git clone https://github.com/Zhalslar/astrbot_plugin_gallery
# 控制台重启AstrBot

⚙️ 配置

插件配置

请在astrbot面板配置,插件管理 -> astrbot_plugin_gallery -> 操作 -> 插件配置

Docker 部署配置

如果您是 Docker 部署,请务必将消息平台容器和AstrBot挂载容器到同一个文件夹,否则消息平台将无法解析文件路径。

示例挂载方式(NapCat):

  • 对 AstrBot:/vol3/1000/dockerSharedFolder -> /app/sharedFolder
  • 对 NapCat:/vol3/1000/dockerSharedFolder -> /app/sharedFolder

⌨️ 使用说明

技巧

  • 图片存储目录:data\plugins_data\astrbot_plugin_gallery

  • 你可以自行创建子文件夹后将你的图片拖入,插件初始化时会自动加载这个子文件作为一个图库,子文件夹名作为这个图库的触发词,文件里的图片名也会自动格式化成插件需要的格式。

  • 可以在配置中打开自动收集图片功能,这在插件前期是非常好用的功能,能帮你快速组建图库

  • 每个用户都对应着一个专属图库,专属图库在用户存入第一张图片时会自动创建,密码为用户对应的ID(如Q号),你可以鼓励、引导用户使用自己的专属图库。

  • 专属图库只有图库主人或者bot管理员可以访问,公共图库的权限可在插件配置面板中配置

  • 新建的图库会默认打开去重开关,去重机制可以保证不会往同一个图库中添加重复的图片

  • 新建的图库会默认打开压缩开关,可有效减少图库的存储占用大小,也能让表情包在QQ中以小图显示,但对于一些图库压缩可能并不是一件好事(比如壁纸图库),此时你可以用命令关掉压缩

命令表

/图库帮助 - 查看以下的帮助菜单(标有s表示可输入多个,空格隔开参数,图库名皆可用@某人代替)

命令 描述 示例用法
/精准匹配词 查看精准匹配词 /精准匹配词
/模糊匹配词 查看模糊匹配词 /模糊匹配词
/模糊匹配 <图库名s> 将指定图库切换到模糊匹配模式 /模糊匹配 图库A 图库B
/精准匹配 <图库名s> 将指定图库切换到精准匹配模式 /精准匹配 图库A 图库B
/添加匹配词 <图库名> <匹配词s> 为指定图库添加匹配词 /添加匹配词 图库A 关键词1 关键词2
/删除匹配词 <图库名> <匹配词s> 为指定图库删除匹配词 /删除匹配词 图库A 关键词1 关键词2
/设置容量 <图库名> <容量> 设置指定图库的容量上限 /设置容量 图库A 100
/设置容量 <图库名> <密码> 设置指定图库的密码 /设置密码 图库A 114514
/开启压缩 <图库名s> 打开指定图库的压缩开关 /开启压缩 图库A 图库B
/关闭压缩 <图库名s> 关闭指定图库的压缩开关 /关闭压缩 图库A 图库B
/开启去重 <图库名s> 打开指定图库的去重开关 /开启去重 图库A 图库B
/关闭去重 <图库名s> 关闭指定图库的去重开关 /关闭去重 图库A 图库B
/去重 <图库名s> 去除图库里重复的图片 /去重 图库A 图库B
/存图 <图库名> <序号> 存图到指定图库,序号指定时会替换掉原图,图库名不填则默认自己昵称,也可 @他人作为图库名 /存图 图库A 或 /存图 图库A 1
/删图 <图库名> <序号s> 删除指定图库中的图片,序号不指定表示删除整个图库 /删图 图库A 1 2 或 /删图 图库A
/查看 <序号s/图库名> 查看指定图库中的图片或图库详情,序号指定时查看单张图片 /查看 图库A 或 /查看 1
/图库列表 查看所有图库 /图库列表
/图库详情 <图库名s> 查看指定图库的详细信息 /图库详情 图库A
/(引用图片)/路径 <图库名s> 查看指定图片的路径,需指定在哪个图库查找 /(引用图片)/路径 图库A
/(引用图片)/解析 解析图片的信息 /(引用图片)/解析
/上传图库 <图库名s> 将图库打包成ZIP上传(仅aiocqhttp) /上传图库 图库A
(引用ZIP)/下载图库 <图库名> 下载ZIP重命名后加载为图库 /下载图库 新名

示例图(可以直接指定图库名,也可以直接@群友)

b00a0155936cbee94980aaf7b6a4de4

⌨️ 配置

请前往插件配置面板进行配置

🤝 TODO

  • 支持保存、删除、查看图片/图库
  • 支持批量保存、批量删除图片
  • 支持精准/模糊匹配模糊匹配关键词发图,并提供开关
  • 支持在图库里搜索图片
  • 支持解析图片信息
  • 支持设置图库容量
  • 自动压缩图片,并提供压缩开关
  • 自动去重,并提供去重开关
  • 权限控制
  • 支持热重载(存图、删图实时生效)
  • 支持将批量图片拖入文件夹进行加载
  • LLM调用图片
  • 自动收集图片

👥 贡献指南

  • 🌟 Star 这个项目!(点右上角的星星,感谢支持!)
  • 🐛 提交 Issue 报告问题
  • 💡 提出新功能建议
  • 🔧 提交 Pull Request 改进代码

📌 注意事项

  • 由于要实现的功能繁多,目前仅确保图库的各种基本功能,后续会完善到完整体
  • 想第一时间得到反馈的可以来作者的插件反馈群(QQ群):460973561(不点star不给进)
AstrBot LogoAstrBot 插件市场社区

AstrBot 插件市场 是一个开放的插件分享平台,欢迎开发者们贡献优质插件。本站致力于为 AstrBot 用户提供高质量扩展,帮助您快速找到喜欢的插件,并鼓励社区伙伴分享使用心得、提出改进建议。

相关链接

官方项目主站 官方插件市场 官方项目仓库 侧边展示主站

开发相关

插件开发文档 快速提交插件 官方项目文档

© 2026 AstrBot 插件市场 Made with by Community