🤝 介绍
【本地图库管理器】-帮助用户组建、管理、调用本地图库,可用于表情包收集管理、图床管理、为其他插件提供动态图库等等
✨ 最近更新
支持自动收集用户的表情包,支持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重命名后加载为图库 | /下载图库 新名 |
示例图(可以直接指定图库名,也可以直接@群友)
⌨️ 配置
请前往插件配置面板进行配置
🤝 TODO
- 支持保存、删除、查看图片/图库
- 支持批量保存、批量删除图片
- 支持精准/模糊匹配模糊匹配关键词发图,并提供开关
- 支持在图库里搜索图片
- 支持解析图片信息
- 支持设置图库容量
- 自动压缩图片,并提供压缩开关
- 自动去重,并提供去重开关
- 权限控制
- 支持热重载(存图、删图实时生效)
- 支持将批量图片拖入文件夹进行加载
- LLM调用图片
- 自动收集图片
👥 贡献指南
- 🌟 Star 这个项目!(点右上角的星星,感谢支持!)
- 🐛 提交 Issue 报告问题
- 💡 提出新功能建议
- 🔧 提交 Pull Request 改进代码
📌 注意事项
由于要实现的功能繁多,目前仅确保图库的各种基本功能,后续会完善到完整体- 想第一时间得到反馈的可以来作者的插件反馈群(QQ群):460973561(不点star不给进)