ZacaFleetBot

Github

release

简介

插件功能：该插件可配置bot在不同Q群扮演不同角色，只提供指定范围的功能（一些通用功能+该角色的特色功能）。目标是同时为多个群提供差异化服务，易配置，易裁剪或拓展。

有两种使用方式，选这其中一种即可使用：

• 方式一：作为mirai-console-plugin使用
• 方式二：作为独立应用使用【暂不开放】

依赖服务：mirai框架、微博api、企鹅物流api、舰娘百科api

【最新角色和指令以github文档为准，以下介绍可能落后】

角色及其功能简介

阿米娅

《明日方舟》游戏角色。特色功能为明日方舟游戏助手。

• 推送微博： 明日方舟、朝陇山
• 企鹅物流数据查询
• 事项提醒： 预设的整点报时、用户新增定时提醒
• 闲聊： 戳一戳、提醒还不能下班……
• 快速查询： PRTS网页链接、一图流网页链接……
• 一站到底答题

欧根

《舰队收藏》游戏角色。特色功能为舰队收藏游戏助手。

• 推送微博： 艦colle鎮守府情報
• 事项提醒： 预设的整点报时、用户新增定时提醒
• 快速查询： 舰娘信息（舰娘百科网页链接、改造链、初始装备……）

ZACA娘

原创角色。实验性的通用功能一般会放在这里。

• 推送微博： 华工ZACA动漫协会
• 日文小工具： 日文汉字注音
• 一站到底答题

猫猫

实验性角色。未来可能作为二次开发新角色的模板。

功能详细介绍

如前文所述，每个角色有特定的可用指令范围。下面列出的所有指令，并非任意角色都能使用。

本章的指令示例将以如下格式给出：

-> 这是一句指令示例
<- 这是bot对该指令的回复示例

2.1 第一类指令——调用某个子指令

语法：
<角色名><子指令> <指令参数列表>
或
<角色名> <子指令> <指令参数列表>

实验性功能：为了加强角色扮演感，对于同一个子指令功能，不同的角色可能通过不同的“子指令称呼”调用。

2.1.1 微博相关指令

查看最近一条微博的发布时间

<子指令>: 查看最新微博

-> ZACA娘查看最新微博

实验性功能：

对于角色阿米娅，变为 <子指令>: 看看饼

-> 阿米娅看看饼

对于角色欧根，变为 <子指令>: 查看镇守府情报

-> 欧根查看镇守府情报

2.1.2 企鹅物流数据相关指令

查询物品掉率

查看某个物品的在所有地图里掉落率最高的几项。

<子指令>: 查掉率
<指令参数列表>: 物品名

-> 阿米娅查掉率 固源岩

查询作战

查看某个作战的理智消耗，掉落等信息。

<子指令>: 查作战
<指令参数列表>: 作战id

-> 阿米娅查作战 1-7

刷新缓存

拉取最新的企鹅物流信息数据。

<子指令>: 更新企鹅物流

-> 阿米娅更新企鹅物流

2.1.3 事项提醒相关指令

创建提醒

提醒任务指的是在满足时间条件的时候发送指定消息。

<子指令>: 创建提醒
<指令参数列表>[0]: 时间条件-月。-1表示不限制。
<指令参数列表>[1]: 时间条件-日。-1表示不限制。
<指令参数列表>[2]: 时间条件-星期数。-1表示不限制。
<指令参数列表>[3]: 时间条件-时。-1表示不限制。
<指令参数列表>[4]: 时间条件-分。-1表示不限制。
<指令参数列表>[5]: 执行次数条件。-1表示不限制。
<指令参数列表>[6]: 消息内容

-> 阿米娅创建提醒 5 1 -1 9 0 1 限时活动将于10点结束，博士请确认限时活动任务完成状态。 //这条消息将在5月1日（不论是星期几）9点0分时被bot自动发送。执行一次后失效。

-> 阿米娅创建提醒 -1 -1 7 22 30 -1 博士请确认周常任务完成状态。 //这条消息将在周日（不论是几月几日）22点30分时被bot自动发送。可执行无限次。

查看提醒

查看已创建的提醒任务。

<子指令>: 查看提醒

-> 阿米娅查看提醒

移除提醒

移除指定id的提醒任务。

<子指令>: 移除提醒
<指令参数列表>: 提醒id。由查看提醒得到。

-> 阿米娅移除提醒 29b88b93-89e2-4a3f-8ff2-b35ab13672d3

2.2 第二类指令——快速查询

语法：
<参数>.

语法尽量简短，用于每个群里最常用到的查询。

2.2.1 阿米娅的快速查询

<参数>	回复
PRTS 或 prts	PRTS首页
一图流	一图流网站
绿票一图流	绿票一图流网站
企鹅物流	企鹅物流首页

-> prts. //得到PRTS首页链接
<- http://prts.wiki/w/首页

2.2.2 欧根的快速查询

<参数>	回复
任意	舰娘信息（数据来自kcwiki）

-> 吹雪.
<- 吹雪 https://zh.kcwiki.cn/wiki/吹雪
吹雪驱逐舰
-20级->吹雪改[驱逐舰]
-70级->吹雪改二[驱逐舰]

3. 闲聊

当群员的发言不满足该角色的任意一个指令语法，即为一句闲聊。角色也会在满足条件的情况下做出回复。

3.1 复读机

当群里连续3句发言相同时（包括发送相同表情/图片），角色也会回复一次该发言。

3.2 阿米娅的闲聊

• 当群员发言里包含“下班”，根据是否是工作时间（周一至周五9点至17点），阿米娅会做不同回复。
• 当群员发言里包含“damedane”，阿米娅会播放音频。
• 戳一戳阿米娅或特定群员，阿米娅会发送特定的图片。

3.3 欧根的闲聊

• 当群员发言里包含“噗噗”，欧根会发送特定的图片。

4. 非主动功能

指的是不由用户发言触发的功能。

• 微博推送
• 预设的整点报时
• 用户创建的事项提醒满足时间条件

很多年前在舰C群里进来过一个欧根bot，和群员愉快地互动了几年。后来好像bot停止运行了变成了个普通账号，再后来连这个舰C群都被tx封了。新舰C群建起来了，但是欧根找不到了。虽然也曾在搜索引擎或github搜索，但并没有找到同一款欧根bot。群员也渐渐淡忘了。

今年，在github搜索明日方舟tag时，无意看到了使用mirai-http-api + python实现的一个阿米娅bot。本来只是想着作为用户来使用，但是该项目又要配mysql又要弄python，我都不熟悉，弄半天。最后发现可以用java直接开发mirai，不如自己动手。也因为mirai娘很可爱诶嘿嘿。

考虑到阿米娅和欧根都是我的翅膀，所以第一个项目便是直接使用mirai-core的明日方舟游戏助手+舰队收藏游戏助手+More (more==誰でも大好き) 。其中欧根的闲聊功能就是在试图还原那个曾经的欧根bot。

后来发现开发插件很香，就在原项目基础上拆分出了阿米娅插件和欧根插件。这两个插件不再有查询舰C/明日方舟的游戏数据的功能，所以甚至不应该被称为“XX助手”了，主要是凭借各自的闲聊功能，作为吉祥物一样的存在，也挺好的。

舰C群和明日方舟群因此变得更热闹了，可喜可贺。

你想要的功能对应这个issue把，还是待开发状态
https://github.com/mamoe/mirai-console/issues/352

类似帖子

某些插件用户手册会告知，该插件里写的某些功能会检查 g 权限，例如：该插件自己写的定时任务逻辑，检查bot的所有群，若该群拥有g权限则发送消息。所以此时应该授权 g权限。

例子我手上也没有。我发布过可控制开关的报时插件，但也没用我所说的g权限来控制。因为我不止要“若该群拥有g权限，则（群内所有bot）发送消息”，还需要进一步控制为“若有(bot+群)组成的m权限，则仅那一个bot发送消息”。这属于：

某些插件用户手册会告知，该插件会检查 m权限，但表示的是别的意思。

在历史消息基础上混入d-qq，构造出一条合并转发？

@N70_ Contact?涉及null-safety相关特性

我一般会对控制台执行时也给个text反馈：

if (commandSender.subject != null) {
  var image = externalResource.uploadAsImage(commandSender.subject!!)
  // send
} else {
  var plainText = PlainText("已收到指令，但该接收者暂不支持图片")
  // send
}

@dinorex @雾野良纱 README语法说明改了的。

/makeYan at geoff @Geoff
/makeYan at 1 @芙兰朵露

为了区分

/makeYan id geoff 114514810
// 方便在console环境无bot在线时执行

@dinorex @雾野良纱 0.0.9发了，指令语法也变了下，试试

类似帖子

某些插件用户手册会告知，该插件里写的某些功能会检查 g 权限，例如：该插件自己写的定时任务逻辑，检查bot的所有群，若该群拥有g权限则发送消息。所以此时应该授权 g权限。

例子我手上也没有。我发布过可控制开关的报时插件，但也没用我所说的g权限来控制。因为我不止要“若该群拥有g权限，则（群内所有bot）发送消息”，还需要进一步控制为“若有(bot+群)组成的m权限，则仅那一个bot发送消息”。这属于：

某些插件用户手册会告知，该插件会检查 m权限，但表示的是别的意思。

@雨伞雨伞 console里用/permission listPermissions看看实际在用的权限id。要授权那个实际在用的。

我说明怎么写了hundun.mirai.umamusume:command.赛马和hundun.mirai.umamusume:command.umacommand两种，只有一种是实际在用的，我晚点看看怎么回事，改改说明。

@ryumar 目前文本类不支持。未来版本可以考虑加。

目前版本无法精确到秒。未来是否能加上看情况。

@koitoyuu 无法配置随机内容是0.1.2插件bug。0.1.3已修复发布。

另外结合之前cron容易混淆含义的地方，进行了逻辑优化和文档补充。

对于cron写法，旧版* 0 9 * * ?和新版0 0 9 * * ?行为一致，均为“插件会在09:00的某一秒执行”。

@koitoyuu 直接在这说吧。发/定时提醒ReminderFunctionDebug list的结果看看你实际用的。

@koitoyuu
配置一个“9:30:任意秒 时为真”的cron，然后插件在9:30里，仅其中某一秒时进行检查，发现它为真然后执行。如果配置“9:30:00 时为真”，则插件检查不到。

别的程序（或者说主流的解读cron程序），注册了“9:30:00 时为真”的cron后，直接能正好在9:30:00检查和执行。本插件和他们不一样，未来看看怎么样优化文档说明。

日志显示random结果是 fileName = "1" 然后文件不存在，而不是 fileName = "1.png"，检查下你怎么写的，配图不是实际在用的吧。

@koitoyuu 凌晨12:00是* 0 0 * * ?，其余正确。这里有cron在线编辑器 https://www.bejson.com/othertools/cron/