本项目为 Mirai 的机器人插件，对接 Midjourney API，实现 QQ 机器人的AI绘画功能，当前版本 Alpha v0.1.6。
本插件基于 Mirai 2.15 版本开发，支持 2.14 版本，暂未测试其他 Mirai 版本，如有其他版本请自行测试。
本插件使用的 Midjourney API 兼容:
可用的在线 API 服务:
注意，本项目仅限于学术研究，请勿用于非法用途。不建议向公众提供服务，当然也不鼓励，不支持一切商业使用。生成的图像属于 Midjourney ，任何由于此项目导致的法律问题本人概不负责。
如果你要添加该插件，请将该插件放在 MCL 根目录下的 /plugins 文件夹中,运行 MCL。
在 Mirai 的根目录下找到 /config/top.joyer.mirai-plugin-midjourney 文件夹，在该文件夹下为本插件的配置文件。
| config.yml | help_config.yml | whilelist.yml | and More... |
|---|---|---|---|
| 插件主要配置文件 | 插件自带Help指令配置文件 | 白名单配置文件 | and More... |
| 配置项 | 类型 | 描述 |
|---|---|---|
| bot_qq | long | 被允许运行此插件的机器人企鹅号（必须是数字企鹅号），必须配置 |
| api_url | String | 通过兼容的API平台获取的API地址，必须配置 |
| api_key | String | 通过兼容的API平台获取的密钥，必须配置 |
| command_help | boolean | 插件自带Help指令的开关,默认打开 |
| retry_count | int | 获取结果失败时重试的次数,默认为5次，零次则不重试 |
| connect_timeout | int | 连接的超时时间，默认1分钟 |
| read_timeout | int | 读取的超时时间，默认10分钟 |
bot_qq: 123456
api_url: https://xxx.xxx.xxx/
api_key: 'sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
command_help: true
retry_count: 5| 配置项 | 类型 | 描述 |
|---|---|---|
| help_text | String | 用户执行/?显示的文本 |
help_text:
- 'AI绘画：'
- '◆ /image <关键词> # 新的AI绘图'
- '◆ /change v <数字1-4> <可选：绘图ID> # 从四宫格绘图中的第{数字}幅图为底生成新的绘图'
- '◆ /change u <数字1-4> <可选：绘图ID> # 放大四宫格绘图中的第{数字}幅图'
- '◆ /change r <可选：任务ID> # 重新绘制四宫格绘图'
- ''
- '在 image 指令中添加 --niji <数字1-5> 参数，数字越大二次元浓度越高'
- '在 change 指令中如果不填写绘图 ID ，默认为该用户上一次生成的四宫格绘图'| 配置项 | 类型 | 描述 |
|---|---|---|
| group_whitelist | boolean | 是否打开企鹅群白名单，默认关闭 |
| groups | List | 企鹅群白名单，当配置项 group_whitelist 被打开时，该条配置将生效 |
group_whitelist: false
groups:
- 12345678
- 87654321在MCL命令行中为用户添加命令权限 /perm permit u* top.joyer.mirai-plugin-midjourney:*
具体的/perm命令食用方式请看 Mirai Console - target 和 permission 示例
在MCL的命令行中输入命令 /mdj reload 重置插件，现在可以开始使用了。
- 由用户唤起的绘图请求，并在绘图结束后获得四宫格的图像
- 由用户唤起的绘图修改请求，并在绘图结束后获得四宫格的图像或单图像
⚠ 绘图指令受到 PG-13 分级的限制，如果关键词超出这个限制将不会生成图像，并弹出警告 （某些瑟瑟的人呐，小心机器人封号）
上图可见为四宫格图像，从左到右从上到下被定义为图1、2、3、4。
上图为单图像，经过放大四宫格图像操作得到（例如上图是/change u 1）。
| 指令用法 | 描述 |
|---|---|
| /image <关键词> | 新的AI绘图 |
| /change v <数字1-4> <可选：绘图ID> | 从四宫格绘图中的第{数字}幅图为底生成新的绘图 |
| /change u <数字1-4> <可选：绘图ID> | 放大四宫格绘图中的第{数字}幅图 |
| /change r <可选：任务ID> | 重新绘制四宫格绘图 |
在上述指令中有一个可选参数绘图ID，绘图ID在每次绘图生成时被附带生成。如果在输入指令时未输入该ID，插件会尝试使用上一次用户生成的绘图的ID，未找到时将不会执行请求。
| 指令用法 | 描述 |
|---|---|
| /mdj reload | 重新加载插件（注意：该操作会将临时储存同时清除，例如用户数据。该指令不能从文件中读取插件，仅为清除数据与重新加载配置文件设计） |
如果有任何问题、建议、Bug提交，请在 Issues 中提出。
本项目基于 AGPLv3 协议 开源。