Skip to content
Samarium edited this page Aug 31, 2022 · 5 revisions

Manual/使用说明

Prerequisites/前置条件

  • Java 11 及以上
  • mirai-console
    本插件最新版目前只在 2.12.2 做了测试(只在最新版测试的屑)
  • 启动器
    应该没人想手动启动mirai-console, 如果想, 请看 这里
    启动器推荐官方的 MCL,使用方法参见官方 用户手册
  • chat-command
    允许在聊天环境执行命令, 下载release中的jar文件并放入plugins文件夹中

Load/加载

直接将Release中的mirai-console-lolicon.\*.mirai2.jar放到plugins中, 重新启动控制台即可

如果MCL文件夹里没有plugins这个文件夹, 就先启动一次

Configuration/配置

手动修改配置文件请在console关闭的情况下进行

修改配置后重启console即可生效

General/通常

完整的配置文件应当和如下类似:

# 是否保存图片
save: false
# 是否使用已保存的图片作为缓存
cache: false
# 是否提示Get和Adv命令已受理
notify: true
# 是否发送图片信息
verbose: true
# 图片发送模式: Simple/Flash/Forward
messageType: Forward
# 图片大小: Original/Regular/Small/Thumb/Mini
size: Regular
# 获取Pixiv图片的反向代理
proxy: 'https://i.pixiv.re'
# 默认的撤回时间(单位:s)
recall: 30
# 是否撤回图片信息
recallImgInfo: false
# 是否撤回图片
recallImg: true
# 默认的冷却时间(单位:s)
cooldown: 60
# 标签过滤模式: None/Whitelist/Blacklist
tagFilterMode: None
# 标签过滤器,白名单模式只发送包含指定标签的图片,黑名单模式只发送不包含指定标签的图片。(仅Get命令,Adv命令中不生效)
tagFilter: []

其中只有recall, cooldown可以在控制台使用set命令修改, 其余只能手动改文件

在聊天中执行的set命令进行修改,修改会被记录到data/io.github.samarium150.mirai.plugin.mirai-console-lolicon/Data.yaml中, 而不是配置文件中。配置文件仅用于设定默认数值

保存的图片在data/io.github.samarium150.mirai.plugin.mirai-console-lolicon/download

启用cache选项需要先启用save选项 启用后如果获取到相同图片则会从本地读取而不是再次从网络下载

闪照在桌面不可见

如果获取图片经常超时,请考虑更换图片代理或者为i.pixiv.cat添加自定义代理 i.pixiv.cat被墙,默认代理改为i.pixiv.re 自定义网络代理的配置在后面

标签过滤为白名单模式时,只要图片的所有标签中有名单中的标签就会被发送 为黑名单模式时,只要图片的所有标签中有名单中的标签就不会被发送

Reply/回复

回复语句的配置在config/io.github.samarium150.mirai.plugin.mirai-console-lolicon/ReplyConfig.yml

关闭console后修改配置再重启console即可生效

完整的配置文件应当和如下类似:

# API返回了错误
invokeException: API调用错误,请检查日志
# 没有找到相关图片
emptyImageData: 没有找到相关图片, 换个关键词试试吧
# 指令未冷却
inCooldown: 你怎么冲得到处都是
# 标签被过滤
filteredTag: 该图片标签已被过滤,请换个标签再试
# 获取图片失败
networkError: '网络连接失败/超时或图片已被删除,之后再试试吧'
# JSON格式错误
invalidJson: JSON格式错误
# 没有群主和管理员权限
nonAdminPermissionDenied: 该命令仅限群主和管理员使用
# 非受信任的用户
untrusted: 非受信任的用户不能设置该属性, 让Bot所有者添加到受信任用户名单后才能使用
# set命令执行成功
setSucceeded: 设置成功
# 非法值
illegalValue: 不是有效的数字
# 提示Get和Adv命令已受理
notify: 正在获取图片...

Proxy/网络代理

代理的配置在config/io.github.samarium150.mirai.plugin.mirai-console-lolicon/ProxyConfig.yml

完整的配置文件应当和如下类似:

# 可选:DIRECT/HTTP/SOCKS
type: DIRECT
# 地址
hostname: localhost
# 端口
port: 1080

这里的配置与通常配置中的proxy没有关系

错误的配置不会使代理生效

Command/命令

config/io.github.samarium150.mirai.plugin.mirai-console-lolicon/CommandConfig.yml中提供了自定义/lolicon别名的可能性

# 复合命令的别名
lolicon: 
  - 涩图
  - llc

目前复合命令的子命令并不能自定义(已在官方日程,详见 #1813 ),但是每个子命令都有中文的别名

get -> 来一张
adv -> 高级
set -> 设置
reload -> 重载
trust -> 信任
distrust -> 不信任
help -> 帮助

Usage/使用

命令的权限均由mirai-console本身来管理(除非你加了权限管理插件)。特别的,在私聊模式下,使用set命令除了需要io.github.samarium150.mirai.plugin.mirai-console-lolicon:command.lolicon,还需要io.github.samarium150.mirai.plugin.mirai-console-lolicon:trusted这个权限(证明该用户被信任)

以下所有命令前缀/都可以被省略

可以在CommandConfig.yml中给lolicon增加别名

可以用之前提到的中文替换子命令

详情参见最后的 示例

  • /lolicon help
    获取帮助信息
  • /lolicon get [tag]
    根据标签发送涩图, 不提供则随机发送一张
    标签可以用“&”和“|”来连接多个,如“萝莉|少女&黑丝|白丝” -> (萝莉 OR 少女) AND (白丝 OR 黑丝)
    默认的冷却时间和撤回时间由配置文件决定
  • /lolicon adv <json>
    (实验性)根据json发送图片,json格式参考 Lolicon API v2,注意mirai-console自带的文本参数转义
    默认的冷却时间和撤回时间由配置文件决定
  • /lolicon set <property> <value>
    设置属性和对应的值
    群聊模式仅限群主和管理员使用
    私聊模式仅限拥有io.github.samarium150.mirai.plugin.mirai-console-lolicon:trusted权限的用户使用
    可设置的属性和值:
    • r18
      对应值: 0/1/2
      效果: 将模式设置为non-R18/R18/mixed
    • recall
      对应值: 以秒为单位的小于120的非负整数
      效果: 设置自动撤回的时间, 0则不撤回
    • cooldown
      对应值: 以秒为单位的小于120的非负整数
      效果: 设置get命令的冷却时间, 0则无冷却

Examples/示例

通用

  • /lolicon get 東方Project
  • /lolicon adv {"num":2}
  • /lolicon set r18 1

自定义

  • 涩图 来一张
  • 发图 来一张 FGO
  • 涩图 高级 {"num":2}
  • 涩图 设置 r18 2