PicPlug简单易用的机器人发图插件

VatinaCharo

PicPlug

目前已使用kotlin进行了重构，老版本请前往java分支获取

一个简单的机器人发图插件

使用kotlin重新精简了代码，并优化了旧版的使用体验，
日常的管理和配置都可以通过和机器人私聊完成

使用说明

安装

去release界面下载jar包，然后放置到plugins文件下即可

说明

出于避免打扰群友的考虑，插件默认不对任何群启用功能(~~除非你的群正好命中了配置文件里默认生成的示例群号~~),
控制插件的启用可以通过机器人的私聊窗口进行白名单的管理，也可以手动修改配置文件

群员的管理机制采用黑名单机制（添加白名单确实太麻烦）

使用前请配置好管理员qq

配置管理指令

特别提醒：由于mirai的配置文件自动保存机制，
通过机器人指令完成的修改需要等待一段时间才会保存至配置文件中，
如果控制台还没自动保存就关闭了mirai-console，会导致指令修改无效。
一般配置后等待几分钟即可完成保存

指令名	作用
help	显示帮助信息
check	显示当前的配置情况
g+ <group id>	向群白名单中添加一个群
g- <group id>	从群白名单中移除一个群
m+ <member id>	向群员黑名单中添加群员
m- <member id>	从群员黑名单中移除群员
l+ <api link>	向API库中添加一个图片API链接
l- <api link>	从API库中移除一个图片API链接

图片API无法删空，而且添加API链接时不会检查链接的可用性，需要自行确保正确，
并且api链接应该是直接返回图片而非返回包含图片地址等信息的json

配置文件结构

# 默认的图片API，可依据需求自行更改，但务必保证返回的结果是一张图片，最好是jpg，其他不做可用性保证
imageAPIs:
  - 'https://imgapi.cn/cos.php?return=img'
whiteGroupList:
  - 1234567890
banQQList:
  - 123123123
adminQQ: 123123123
# 触发发图指令
# 第1个指令为随机触发设置的API
# 如果有，第2个指令固定触发第1个API
# 如果有，第3个指令固定触发第2个API
# 依次类推
# ！！！如果设定的指令数大于(API数+1)，则自动取模从头开始计算！！！
# 例如： 3个API 5个指令
#       则第5个指令触发第一个API
commands:
  - !!gkd
# 图片下载失败之后的重试次数
retryCount: 5
# 发图冷却时间
cd: 1000

更新日志

2023.02.27: [v2.1.0]
- 修复了图片格式硬编码为jpg导致的图片发送错误
- 添加对 jpg png gif bmp 格式的智能识别和支持
2023.02.11: [v2.0.0]
- 重构了权限管理逻辑，现在只有机器人管理员qq可以和机器人私戳来完成管理
- 群员的管理从白名单制修改至黑名单制，方便管理员管理
- 新增了多指令触发的功能，详细参见readme
2022.07.28: [v1.2.1] 优化了check指令的输出显示
2022.07.26: [v1.2.0]
- 使用kotlin重构了代码
- 基于mirai 2.12.0 构建
- 优化了使用体验，常规管理功能均可通过和机器人私聊实现
- 使用双白名单制实现了更细节的权限控制
2021.10.29 : [v1.1.2-beta]
- 新增了对多个api的随机选取功能支持
- 修复了指令头不等于2时对指令名的解析错误
2021.10.04 : [v1.1.1] 发图功能添加了冷却时间
2021.10.01 : [v1.1.0] 新增受控的指令注册机制和对应的配置文件属性
2021.09.30 : [v1.0.0] First Release

Contribution

欢迎任何使用者(大佬)贡献这个项目，你可以通过提起Issue、反馈 BUG、Pull Request 、在这个主题下回复、或修改文档错别字来贡献这个项目。

不吃燚龘

额，大佬，我还是不知道你这个插件怎么用。你能解释的更加的详细点吗？

RainChan

又双叒叕一个涩图插件吗

ZHJ0125

测试成功！

VatinaCharo

@不吃燚龘在 PicPlug简单易用的机器人发图插件中说：

额，大佬，我还是不知道你这个插件怎么用。你能解释的更加的详细点吗？

把插件的jar文件放到mirai-console的plugins文件夹下，启动一次mirai之后，就会自动生成配置文件了，此时关闭mirai，在配置文件的groupList下，仿造示例，添加你需要启用插件的群号，就可以开启插件功能了

VatinaCharo

@rainchan 在 PicPlug简单易用的机器人发图插件中说：

又双叒叕一个涩图插件吗

年轻人的第一款试手插件永远都是涩图姬（大雾

~~归根结底还是这类机器人的参考样例多，容易写~~

RainChan

@vatinacharo 也可以来看看我的反涩图插件哦

luis

@vatinacharo 请问可以定义多个imageurl吗？随机从一个url进行发图或者指定该URL发图、

ASIMOV

同求多个关键词触发不同imageurl的功能！┭┮﹏┭┮

lord

想让群友们节制，一天有个上限，怎么搞？

不吃燚龘

请问是否能将prefix设置为null，达到直说gkd就能发送图片
请问是否能加入管理员权限，比如说只允许特定的人能够运用此程序？

VatinaCharo

@asimov 在 PicPlug简单易用的机器人发图插件中说：

同求多个关键词触发不同imageurl的功能！┭┮﹏┭┮

会尽量更新此功能，可以前去提个issue以防止我忘记

因为临近毕设，不一定有时间去更新，so，coming sooooooooon

VatinaCharo

@不吃燚龘在 PicPlug简单易用的机器人发图插件中说：

请问是否能将prefix设置为null，达到直说gkd就能发送图片

请问是否能加入管理员权限，比如说只允许特定的人能够运用此程序？

你可以尝试设置为空，不保证能达到你的要求，因为我希望机器人只回应特定的请求而不是自动插入到群友们的对话中，所以设定了对应的prefix
可以考虑此功能，但我并不是很愿意对机器人的各项功能做出“等级制”划分（个人癖好，XD

VatinaCharo

@vatinacharo 在 PicPlug简单易用的机器人发图插件中说：

@asimov 在 PicPlug简单易用的机器人发图插件中说：

同求多个关键词触发不同imageurl的功能！┭┮﹏┭┮

会尽量更新此功能，可以前去提个issue以防止我忘记

因为临近毕设，不一定有时间去更新，so，coming sooooooooon

如果比较急的话，可以自己尝试包装一个imageurl的api来接入到机器人里

VatinaCharo

@lord 在 PicPlug简单易用的机器人发图插件中说：

想让群友们节制，一天有个上限，怎么搞？

已经做了频率限制，应该问题不大？

VatinaCharo

@vatinacharo 在 PicPlug简单易用的机器人发图插件中说：

@vatinacharo 在 PicPlug简单易用的机器人发图插件中说：

@asimov 在 PicPlug简单易用的机器人发图插件中说：

同求多个关键词触发不同imageurl的功能！┭┮﹏┭┮

会尽量更新此功能，可以前去提个issue以防止我忘记

因为临近毕设，不一定有时间去更新，so，coming sooooooooon

如果比较急的话，可以自己尝试包装一个imageurl的api来接入到机器人里

已经赶工了一个beta版本去实现此功能，因为时间比较紧，所以暂未做测试就发布了，可能有bug（X

不吃燚龘

@vatinacharo 收到，已经测试“”不能起到prefix作用，设置成null将会变成一段不知道的英文字母
目的是让所有人员享受到，但是目前机器人还是会有权限控制，只有在permission里面有权限且是*:*的人才能调用!!gkd，否则其他人不能调用!!gkd

VatinaCharo

@不吃燚龘在 PicPlug简单易用的机器人发图插件中说：

@vatinacharo 收到，已经测试“”不能起到prefix作用，设置成null将会变成一段不知道的英文字母
目的是让所有人员享受到，但是目前机器人还是会有权限控制，只有在permission里面有权限且是*:*的人才能调用!!gkd，否则其他人不能调用!!gkd

正常来说并不会涉及到权限问题，因为我的指令系统是自己做的，没有走mirai-console的内建指令，你可以多发点信息我看看。

VatinaCharo

@不吃燚龘指令是直接解析的聊天信息，应该不会出现权限问题才是

sakiken

萌新求教，我将机器人置于操作系统为Linux的服务器端。按照此插件教程，修改完PicPlugConfig.yml 并能正常运行。然后当我想使用nohup命令，使程序一直保持运行时，结果我在 PicPlugConfig.yml 文件下所修改的数据全部被重置（群号和api均被还原）。我使用的命令为 nohup ./mcl & 。求大佬解惑