Skip to content

About

一个专为 AstrBot 设计的图片保存插件

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

Repository files navigation

:name

QQ群图片保存插件

✨ QQ 群图片保存插件 · 回复即打包上传 ✨

License Python 3.10+ AstrBot GitHub

📖 简介

astrbot_plugin_qqimage_saver 是一个专为 AstrBot 设计的图片保存插件。

它让您只需回复一条消息,就能将图片(无论是直接发送还是转发消息中的)自动打包成 ZIP 压缩包,并上传到 QQ 群文件空间,实现群图片的快速归档。

✨ 核心特性

特性 说明 优势
🖼️ 回复即保存 回复任意图片消息即可触发 操作简单,无需复制链接或手动下载
📦 转发消息支持 自动提取转发消息中的所有图片 一次性保存多张图片,无需逐张操作
☁️ 自动上传群文件 打包后直接上传到 QQ 群文件 永久保存,群成员随时查看
🔧 权限控制 支持仅限管理员使用 防止滥用,保护群文件空间
🎯 指定目标群 可配置上传到指定群 跨群归档,灵活管理
🧹 自动清理 上传后自动删除临时文件 节省服务器磁盘空间

📂 目录结构

astrbot_plugin_qqimage_saver/
├── main.py             # 核心逻辑 (图片提取、打包、上传)
├── _conf_schema.json   # 配置校验文件
├── __init__.py         # 包标识
└── README.md           # 说明文档

🛠️ 快速开始

1. 安装插件

方式一:插件市场(推荐) 在 AstrBot 插件市场搜索 astrbot_plugin_qqimage_saver,点击安装即可。

方式二:手动安装

cd /AstrBot/data/plugins
git clone https://github.com/AliceFia/astrbot_plugin_qqimage_saver.git

重启 AstrBot 即可。

2. 配置插件

启动一次 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 号列表

3. 使用命令

命令 说明 保存图片 回复一条包含图片的消息(直接图片或转发消息),机器人会自动打包并上传到群文件 使用示例:

用户A:[发送一张图片]
用户B:[回复用户A的图片] /保存图片
机器人:✅ 已上传 1 张图片到群文件

💾 存储路径

临时文件存储目录:

/AstrBot/data/plugin_data/astrbot_plugin_qqimage_saver/temp/

📄 更新日志

v1.0.0 (2026-06-01)

  • ✨ 初始版本发布
  • 🖼️ 支持直接图片保存
  • 📦 支持转发消息图片提取
  • 📁 自动打包 ZIP 上传
  • 🔧 支持权限配置
  • 🎯 支持指定目标群
  • 📞 反馈与支持 GitHub Issues:提交问题

🚫 免责声明

  1. 使用目的:本插件仅供学习交流,使用者不得用于非法或侵权行为,否则自行承担全部责任。
  2. 功能限制:本插件仅通过 onebot 协议获取公开信息,作者不对数据的准确性、完整性负责。
  3. 禁止非法修改:严禁私自魔改本插件(如接入社工库等违规操作),违者自行承担法律责任。
  4. 风险自担:使用者应自行评估使用风险,作者不对使用过程中产生的任何损失或风险承担责任。
  5. 法律适用:本声明适用中华人民共和国法律,争议由作者所在地法院管辖。
  6. 声明解释权:作者保留对本声明的最终解释权,并有权随时修改。

📄 License

MIT License © 2026 AliceFia

About

一个专为 AstrBot 设计的图片保存插件

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages