koishi-plugin-meme-save

把关键词表情包存到 S3 的 Koishi 插件

功能

• 支持 个人、群聊、全局 三种作用域
• 作用域优先级为 个人 > 群聊 > 全局
• 同一个关键词允许保存多条记录，每条记录可包含多张图
• 每条记录也可以只有纯文本，或者图文混合
• 发送 关键词 时随机返回一条记录
• 发送 关键词 1 时返回第 1 条记录
• 支持直接附图、引用带图消息、文本图片链接三种收图方式
• 支持交互式添加：先下指令，再连续发图，最后发送「完成」保存
• 也支持把纯文本当备忘录存进去
• 直接引用单条纯文本消息时，会记住原消息 QQ 号，触发时按转发消息发出
• 直接引用合并转发消息时，也可以整包存下来并再次以合并转发形式发出
• 图片正式存储走 S3，避免本地路径和适配器兼容烂活

数据目录

• data/meme-save/data.json：关键词记录
• data/meme-save/images/：本地下载缓存

指令

• 添加 <关键词>：默认添加到当前群聊，私聊里自动改为个人
• 个人添加 <关键词>
• 全局添加 <关键词>
• 删除 <关键词> [序号]
• 个人删除 <关键词> [序号]
• 全局删除 <关键词> [序号]
• 查看表情 <关键词>
• 表情列表
• 表情重建链接

配置项

• globalAddAuthority：全局添加所需权限，默认 3
• globalDeleteAuthority：全局删除所需权限，默认 3
• enableAutoReply：是否启用关键词自动回复，默认 true
• maxImagesPerRecord：单条记录最多图片数，默认 20
• maxForwardImages：引用合并转发时最多保留的图片数，默认 5
• s3Endpoint：S3 兼容端点 URL
• s3Region：S3 区域，默认 auto
• s3AccessKeyId：S3 Access Key ID
• s3SecretAccessKey：S3 Secret Access Key
• s3Bucket：S3 Bucket 名称
• s3PublicBaseUrl：公开访问 URL 前缀，可填 CDN 域名
• s3ForcePathStyle：是否强制路径风格
• s3Acl：上传 ACL，默认 public-read

使用方式

添加表情

添加 猫猫

同一条记录可以带多张图

也可以只存纯文本，或者同一条记录同时存文本和图片

如果引用的是合并转发消息，插件会尝试把其中的节点内容存下来，并在触发时重新以合并转发形式发出

也可以直接引用一条带图消息再执行指令，图片会一起收进去

如果执行 添加 猫猫 时当条消息里没有图，插件会进入收集模式：

• 继续发送图片或引用带图消息
• 继续发送文本、图片或引用带图消息
• 发送 完成 保存
• 发送 取消 退出

触发表情

猫猫

随机发送一条 猫猫 记录

猫猫 1

发送第 1 条 猫猫 记录，01 也会按 1 处理

说明

• 现在不再依赖 assets-local 发图
• 如果你改了 S3 域名或桶策略，可以用 表情重建链接 批量重发 URL