astrbot_plugin_qqimage_saver 是一个专为 AstrBot 设计的图片保存插件。
它让您只需回复一条消息,就能将图片(无论是直接发送还是转发消息中的)自动打包成 ZIP 压缩包,并上传到 QQ 群文件空间,实现群图片的快速归档。
| 特性 | 说明 | 优势 |
|---|---|---|
| 🖼️ 回复即保存 | 回复任意图片消息即可触发 | 操作简单,无需复制链接或手动下载 |
| 📦 转发消息支持 | 自动提取转发消息中的所有图片 | 一次性保存多张图片,无需逐张操作 |
| ☁️ 自动上传群文件 | 打包后直接上传到 QQ 群文件 | 永久保存,群成员随时查看 |
| 🔧 权限控制 | 支持仅限管理员使用 | 防止滥用,保护群文件空间 |
| 🎯 指定目标群 | 可配置上传到指定群 | 跨群归档,灵活管理 |
| 🧹 自动清理 | 上传后自动删除临时文件 | 节省服务器磁盘空间 |
astrbot_plugin_qqimage_saver/
├── main.py # 核心逻辑 (图片提取、打包、上传)
├── _conf_schema.json # 配置校验文件
├── __init__.py # 包标识
└── README.md # 说明文档
方式一:插件市场(推荐) 在 AstrBot 插件市场搜索 astrbot_plugin_qqimage_saver,点击安装即可。
方式二:手动安装
cd /AstrBot/data/plugins
git clone https://github.com/AliceFia/astrbot_plugin_qqimage_saver.git重启 AstrBot 即可。
启动一次 AstrBot 以生成配置文件,然后在 Web 管理面板或 config.json 中修改: 配置项 (Key) 类型 默认值 说明 target_group_id string "" 目标群号,不填写则上传到当前群 auto_delete_temp bool true 上传完成后是否自动删除临时 ZIP 文件 max_images_per_pack int 10 单次打包最大图片数量 admin_only bool false 是否只允许群管理员使用 admin_users list [] 自定义管理员 QQ 号列表
命令 说明 保存图片 回复一条包含图片的消息(直接图片或转发消息),机器人会自动打包并上传到群文件 使用示例:
用户A:[发送一张图片]
用户B:[回复用户A的图片] /保存图片
机器人:✅ 已上传 1 张图片到群文件
临时文件存储目录:
/AstrBot/data/plugin_data/astrbot_plugin_qqimage_saver/temp/
v1.0.0 (2026-06-01)
- ✨ 初始版本发布
- 🖼️ 支持直接图片保存
- 📦 支持转发消息图片提取
- 📁 自动打包 ZIP 上传
- 🔧 支持权限配置
- 🎯 支持指定目标群
- 📞 反馈与支持 GitHub Issues:提交问题
- 使用目的:本插件仅供学习交流,使用者不得用于非法或侵权行为,否则自行承担全部责任。
- 功能限制:本插件仅通过 onebot 协议获取公开信息,作者不对数据的准确性、完整性负责。
- 禁止非法修改:严禁私自魔改本插件(如接入社工库等违规操作),违者自行承担法律责任。
- 风险自担:使用者应自行评估使用风险,作者不对使用过程中产生的任何损失或风险承担责任。
- 法律适用:本声明适用中华人民共和国法律,争议由作者所在地法院管辖。
- 声明解释权:作者保留对本声明的最终解释权,并有权随时修改。
MIT License © 2026 AliceFia