Arknights Helper / 明日方舟助手，更新订阅的微博号配置项

cssxsh

Arknights Helper

基于 Mirai Console 的明日方舟助手插件

使用前应该查阅的相关文档或项目

指令

注意: 使用前请确保可以在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/抽卡十连
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.arknights-helper:command.*, * 是指令的第一指令名
例如 /抽卡十连 的权限ID为 xyz.cssxsh.mirai.plugin.arknights-helper:command.gacha

助手抽卡指令

指令	描述
`/<gacha 抽卡> <one 单抽> [times]?`	单抽`times`次，默认为1
`/<gacha 抽卡> <one 十连> [times]?`	十连`times`次，默认为1
`/<gacha 抽卡> <detail 详情>`	查看卡池规则
`/<gacha 抽卡> <set 设置> [name]`	设置卡池为`name`, 默认为`NORMAL`
`/<gacha 抽卡> <pool 卡池> [name] [set]? {rules}`	设置卡池`name`的规则为`rules`，当`set`为`true`时设置为当前卡池

抽卡每一抽会消耗600合成玉，合成玉可以通过答题获得，通过玩家详情查看

ArknightsGachaCommand 卡池规则`rules`参数格式

rules参数从第二行起，按行分割
每行格式为规则干员名|星级|other|...:概率或者注释#...
星级用连续的*表示，例如*****表示五星干员，需要单行设置，设置的概率不包括已设置干员名
other表示剩余的其他干员
概率用小数表示，全部行的概率加起来的概率要为100%，即1.00
例子

/抽卡 卡池 限时寻访深悼
浊心斯卡蒂|凯尔希:0.014
赤冬:0.04
******:0.006
*****:0.04
****:0.48
other:0.42

助手答题指令

指令	描述
`/<mine 挖矿答题> [type]?`	机器人会提出一个问题
`/<question 问题> <detail 详情> [name]`	查看自定义问题的详情
`/<question 问题> <list 列表>`	列出已经设置的自定义问题
`/<question 问题> <delete 删除>`	删除指定问题
`/<question 问题> <add 添加>`	与机器人互动，输入条件，设置新问题
`/<question 问题> <count 统计>`	答题情况统计

回复选项序号A~Z，即算回答问题
type是提问问题类型，默认为全部类型
回答了当前问题才会出现下一个问题
快速回答(规定时间的1/3内)会有相应奖励
群聊模式的其他群员亦可回答题目，但题目只能被回答一次，且其他人作为抢答者有相应奖励和惩罚
题目结构如下

[类型](得分) 问题
A. 选项
B. 选项
...

助手公招指令

指令	描述
`/<recruit 公招> {words}`	查看关键词`words`的公招干员

works的数量为1~5

助手材料指令

指令	描述
`/<item 材料> [name] [limit]? [now]?`	查看材料的关卡掉落率
`/<stage 关卡> [name] [limit]? [now]?`	查看关卡的材料掉落率
`/<zone 章节活动地图> [name] [limit]? [now]?`	查看地图所有关卡的材料掉落率

limit 是显示单元的最大数量
now 是是否只显示当前开启关卡，默认为 true
可以通过配置材料别名设置可选的材料索引

助手玩家指令

指令	描述
`/<player 玩家> <detail 详情>`	当前玩家(QQ号)在助手中的数据
`/<player 玩家> <reason 理智> [init]`	设置玩家(QQ号)当前理智为`init`
`/<player 玩家> <level 等级> [index]`	设置玩家(QQ号)当前等级为`index`
`/<player 玩家> <recruit 公招> [site] [hours] [minutes]`	设置公招位`site`等待时间
`/<player 玩家> <record 记录>`	列出玩家的公招记录

玩家的默认等级为120
理智的提醒时间会根据玩家等级和当前理智值init设置

助手蹲饼指令

指令	描述
`/<guard 蹲饼> <detail 详情>`	当前蹲饼的状态和轮询时间
`/<guard 蹲饼> <speed 速度>`	设置蹲饼轮询时间是`speed`分钟
`/<guard 蹲饼> <open 打开> [contact]?`	开启蹲饼状态
`/<guard 蹲饼> <close 关闭> [contact]?`	关闭蹲饼状态

contact 为群号或Q号，可选参数，可以自动从当前聊天环境中获取，比如私聊就获取好友Q号，群聊就获取群号
玩家的默认等级为120
理智的提醒时间会根据玩家等级和当前理智值init设置

助手数据指令

指令	描述
`/<data 数据> <arknights 方舟>`	更新游戏数据
`/<data 数据> <penguin 企鹅掉落>`	更新掉落数据
`/<data 数据> <name alias 别称别名>`	查看掉落别名
`/<data 数据> <reload 重载>`	重载插件配置
`/<data 数据> <recruit alias 公招>`	提交公招结果
`/<data 数据> <tag 标签分析>`	分析公招结果
`/<data 数据> <role 干员分析>`	分析公招结果

提交公招结果之前，可以设置干员别名方便输入

助手表情指令

指令	描述
`/<arkface 方舟表情> <random 随机> [id]?`	随机发送一个表情, id是表情包id, 默认为任意表情包
`/<arkface 方舟表情> <list 列表>`	表情商店链接列表
`/<arkface 方舟表情> <detail 详情>`	查看表情详情

表情详情指令使用时, 先发送指令，然后发送一个表情，机器人会回复表情的商店链接和原图

配置文件

位于Mirai-Console运行目录下的config/arknights-helper文件夹下的config文件

roles

干员别名

roles:
  小羊: 艾雅法拉
  鳄鱼: 艾丝黛尔

items

材料别名

items:
  绿管: 晶体元件

auto_add_guard

自动开启蹲饼功能在机器人添加新好友和新群时自动开启蹲饼功能

video

开启订阅的b站视频类型 ANIME, MUSIC, GAME, ENTERTAINMENT

blog

开启订阅的微博号 BYPRODUCT(朝陇山), MOUNTEN(一拾山), HISTORICUS(泰拉记事社)

安装

MCL 指令安装

./mcl --update-package xyz.cssxsh:arknights-helper --channel stable --type plugin

手动安装

运行 Mirai Console 生成plugins文件夹
从 Releases 下载jar并将其放入plugins文件夹中

TODO

配置问题类型出现的概率
记录答题正确率 21/06/10
明日方舟官方QQ表情，下载、发送更新提醒等 21/05/14
自定义材料掉落别名(目前由企鹅物流数据提供支持) 21/05/14
关卡规划
剿灭和周常提醒
游戏公告

数据来源

游戏数据 Kengxxiao/ArknightsGameData
掉落数据企鹅物流数据统计
其他数据相关API

StageGuard

建议添加更多信息

洛绫华酱

This post is deleted!

cssxsh

#1修复缓存文件时创建文件的BUG，同时改用正则表达式获取URL，以获得正确的文件后缀
添加新指令ArknightsFaceCommand获取方舟官方QQ表情
添加公招记录的功能
为材料掉落指令添加自定义别名配置
蹲饼功能添加新的微博账号明日方舟朝陇山,一拾山,泰拉记事社

VantHoff

@cssxsh 请求适配miraiAndroid

cssxsh

@vanthoff
你可以先去GitHub开个 issue
我用的基本上都是mirai+jvm+ktor的库，应该很容易就能适配
我有空就看看

cssxsh

@vanthoff
转换了一份出来，但是没有测试过
arknights-helper-1.2.0.mirai.dex.jar

洛绫华酱

合成玉的获得途径太少了，有意向加多一点吗（萌新，不会改代码）

cssxsh

@洛绫华酱
目前可以考虑高多一点自定义题目
以后会考虑增加倍率系统

mojizooo

请问为何它只在一个群里生效了
（改config？似乎无用

cssxsh

@mojizooo
请问是什么生效？
指令还是蹲饼功能？
指令的话请注意用户是否有权限授予用户执行的权限

蹲饼功能的话告诉我一下插件版本和 config 文件内容

mojizooo

@cssxsh 后来发现是权限没给没事了没事了

hundun000

@cssxsh 我看到你还发布了B站订阅插件和Weibo Helper，然后我稍微看了下Arknights Helper代码，似乎并不是简单地把Weibo Helper包和B站订阅插件包复制进来，而是专门为Arknights Helper重新写的？

有没有一种组织方式，能使微博、b站功能在这3个项目间方便地复用，甚至发布出来给更多插件复用？

cssxsh

@hundun000 在 Arknights Helper 中说：

目间方便地复用

weibo-helper 使用 pc web api 需要登录，以便拿到更多的订阅信息，
但是arknights-helper则指针对某几个微博号，所以用的是 mobile web api 免登录

如果简单的复制过去的话，不同版本的 arknights-helper 和 weibo-helper 会因为共用一套package 下的代码，但是如果两个插件的代码不一致，有可能会导致bug

共用代码最好是处理成插件依赖，但是目前没有这个想法

hundun000

@cssxsh
我自己正准备开发两个插件，我也实现了微博模块。因为两个插件都是同样地使用微博模块，所以简单的复制肯定可行。初步改进的话就是通过共用子项目之类的来复用。如果再进一步改进的目标就是“发布出来给更多插件复用”了，因为放眼到整个社区好像都在各自插件里重复开发微博和B站功能？

Chi-Tan-Da-Eru

聊天时，前缀”/“无法省略啊，省略就无法识别了

cssxsh

@chi-tan-da-eru
带括号的/才能省略 (/)

Chi-Tan-Da-Eru

@cssxsh 啊这，我还以为指的是尖括号

Narumi

抓取企鹅物流数据统计的活动图掉落数据无法正常抓取

cssxsh

@narumi
你是指数据无法更新吗

Arknights Helper / 明日方舟 助手，更新订阅的微博号配置项