1. 大佬, 大神 等等称呼并不会给开发者带来实际的收益,
   你口中的大佬一天也是只有24小时的时间，
   并且已经因为写代码消耗了不少，
   所以请尽可能详细的描述你的问题和需求，减少时间的浪费。

2. 良好的代码/日志排版 阅读会更舒服

3. 日志最好能是复制文本，而不是截图。方便把关键信息复制出来检索。

4. 使用 插件/软件 前，要通读 readme

5. 不推荐开启的功能 可能是实验性或者不可控的 所以开启之后不一定能带来更好的效果

6. 影响下载速度的原因有 网络带宽，运营商(电信、移动，联通), Dns/Hosts, 丢包率, 代理 等等，只有一句下载很慢，开发者只能对着空气分析

Pixiv Helper

基于 Mirai Console 的 Pixiv 插件

基于 Kotlin Pixiv库 PixivClient ，通过清除ServerHostName 绕过SNI审查，免代理

目前没有自动缓存清理，请使用 #删除指令 手动清理
R18图会按照Pixiv所给信息过滤
群聊模式使用默认账号，私聊模式Pixiv账号和QQ号关联，初次使用请先 /pixiv 指令登陆账号
然后使用 /cache recommended 缓存系统推荐作品，然后再使用色图相关指令
Gif图片需要由机器人自己合成，如果设备性能不足，请调整相关参数
群聊默认输出最少作品信息，需要增加请使用 /setting 指令修改
发送模式可以使用 /setting 指令修改为闪照或撤销
注意, 闪照或撤销这两种模式 并不会降低 机器人被封禁 的风险。
机器人被封禁的主要风险来自

• QQ号是新注册的
• Bot挂在服务器上，但是服务器IP被腾讯列为风险IP(腾讯通过IP确定 登录地区)
• Bot被高频使用，(另外，高频发图再高频撤销属于不打自招，正常用户有这个手速吗？)
• 发送大量违规链接，或者触发关键词

指令

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

bookmark 参数指收藏数过滤
fuzzy 参数指模糊搜索

Pixiv相关操作指令

指令	描述
/<pixiv> <login> [username] [password]	APP 不再支持 账号 密码 直接登录，指令做废
/<pixiv> <sina>	扫码登录关联了PIXIV的微博账号，以登录PIXIV
/<pixiv> <cookie>	从文件 读取 Web Cookie，登录PIXIV
/<pixiv> <refresh> [token]	登录 通过 refresh token
/<follow> <user> {uid}	为当前助手关注指定用户
/<follow> <copy> [uid]	关注指定用户的关注
/<mark bookmark> <add> [uid] {words}?	添加指定作品收藏
/<mark bookmark> <delete> [pid]	删除指定作品收藏
/<mark bookmark> <random> [tag]?	随机发送一个收藏的作品
/<mark bookmark> <list>	显示收藏列表

cookie 文件为工作目录下的 cookie.json
内容 为 浏览器插件 EditThisCookie 导出的Json
EditThisCookie 安装地址
Chrome
Firefox
Edge

色图相关指令

指令	描述
(/)<ero 色图 涩图>	缓存中随机一张色图
(/)<get 搞快点 gkd> [pid] [flush]?	获取指定ID图片
(/)<tag 标签> [word] [bookmark]? [fuzzy]?	随机指定TAG图片
(/)<illustrator 画师> <uid id user 用户> [uid]	根据画师UID随机发送画师作品
(/)<illustrator 画师> <name 名称 名字> [name]	根据画师name或者alias随机发送画师作品
(/)<illustrator 画师> <alias 别名> [name] [uid]	设置画师alias
(/)<illustrator 画师> <list 列表>	显示别名列表
(/)<illustrator 画师> <info 信息> [uid]	获取画师信息
(/)<illustrator 画师> <search 搜索> [name] [limit]?	搜索画师
(/)<search 搜索 搜图> [image]?	saucenao 搜索图片
(/)<ascii2d> [image]?	ascii2d 搜索图片

色图指令基于缓存信息，使用前请先缓存一定量的作品，推荐使用 /cache recommended 指令
使用色图指令时 指令后附带 更好, 可以使收藏数比前一张更高, 如果两次色图指令间隔小于触发时间(默认时间10s)也会触发这个效果
tag指令检索结果过少时，会自动触发缓存
tag指令可以尝试按照格式角色名(作品名)检索角色, 举例 红(明日方舟)
tag指令多keyword时，请使用 _，|，,, + 等符号将keyword连接起来，不要使用空格
[image]?为空时会从回复消息，最近图片获取
搜图使用 https://saucenao.com 的 api，无KEY时，每天限额 100次， KEY参数在设置中添加
举例:

缓存指令

指令	描述
/<cache> <follow>	缓存关注推送
/<cache> <rank> [mode] [date]?	缓存指定排行榜信息
/<cache> <recommended>	缓存推荐作品，ERO过滤
/<cache> <bookmarks> [uid]?	缓存用户的收藏中缓存色图作品
/<cache> <following> [fluhsh]? [uid]?	缓存关注画师作品
/<cache> <fms> [jump]? [uid]?	缓存关注画师收藏的作品
/<cache> <user> [uid]	缓存指定画师作品
/<cache> <tag> [tag]	缓存搜索tag得到的作品，ERO过滤
/<cache> <search>	缓存搜索记录
/<cache> <stop>	停止当前助手缓存任务
/<cache> <reply> [open]	是否回复缓存细节，默认为否

[uid]? 会自动填充当前用户

RankMode

MONTH

WEEK
WEEK_ORIGINAL
WEEK_ROOKIE

DAY
DAY_MALE
DAY_FEMALE
DAY_MANGA

任务指令

指令	描述
/<task> <user> [uid] [duration]?	推送用户新作品
/<task> <rank> [mode]	推送排行榜新作品
/<task> <follow> [duration]?	推送关注用户作品
/<task> <recommended> [duration]?	推送推荐作品
/<task> <backup> [duration]?	数据自动备份
/<task> <web> [pattern] [link] [duration]?	推送，从url链接获取
/<task> <trending> [duration]? [times]?	推送热门标签
/<task> <detail>	查看任务详情
/<task> <delete> [name]	删除任务

备份文件优先推送到群文件，其次百度云
duration 单位分钟，默认3小时

设置指令

指令	描述
/<setting> <interval> [sec]	设置连续发送间隔时间, 单位秒
/<setting> <link> [open]	设置是否显示Pixiv Cat 原图链接
/<setting> <tag> [open]	设置是否显示TAG INFO
/<setting> <attr> [open]	设置是否显示作品属性
/<setting> <max> [num]	设置显示最大图片数
/<setting> <model> [type] [ms]?	设置发送模式

发送模式 有三种 NORMAL, FLASH, RECALL, ms 是Recall的延迟时间，单位毫秒
注意：FLASH, RECALL 这两种模式 并不会降低 机器人被封禁 的风险

备份指令

指令	描述
/<backup> <user> [uid]	备份指定用户的作品
/<backup> <alias> [mode] [date]?	备份已设定别名用户的作品
/<backup> <tag> [tag] [bookmark]? [fuzzy]?	备份指定标签的作品
/<backup> <data>	备份插件数据
/<backup> <list>	列出备份目录
/<backup> <get> [filename]	获取备份文件，发送文件消息
/<backup> <upload> [filename]	上传文件到百度云
/<backup> <auth>	百度云用户认证
/<backup> <reload> [path] [mode] [chunk]?	从 sqlite 备份中导入数据

reload 的 mode 可选 有以下几种 EXCEPTION, IGNORE, OVERWRITE, LATEST_VERSION
reload 的 chunk 为分段提交数量的大小, 默认8196
使用百度云服务需要的准备详见配置

统计信息指令

指令	描述
/<info> <helper>	获取助手信息
/<info> <user> [target]?	获取用户信息
/<info> <group> [target]?	获取群组信息
/<info> <top> [limit]?	获取TAG指令统计信息
/<info> <cache>	获取缓存信息

播放指令

指令	描述
(/)<play 播放> <interval 间隔>	设置间隔
(/)<play 播放> <ranking 排行榜> [mode] [date]?	设置间隔
(/)<play 播放> <rank 排行> {words}	根据 words 播放NaviRank
(/)<play 播放> <recommended 推荐>	根据 系统推荐 播放图集
(/)<play 播放> <mark 收藏> [tag]?	播放收藏
(/)<play 播放> <article 特辑> [aid]	播放特辑
(/)<article 特辑>	随机播放特辑
(/)<rank 排行> <year 年 年榜> {words}	随机播放NaviRank 年榜
(/)<rank 排行> <month 月 月榜> {words}	随机播放NaviRank 月榜
(/)<rank 排行> <tag标签> {words}	随机播放NaviRank 标签榜
(/)<play 播放> <stop 停止>	停止播放当前列表

删除指令

指令	描述
/<delete> <artwork> [pid] [record]?	删除指定作品
/<delete> <user> [uid] [record]?	删除指定用户作品
/<delete> <bookmarks> [max] [record]?	删除小于指定收藏数作品
/<delete> <page> [min] [record]?	删除大于指定页数作品
/<delete> <manga> [record]?	删除漫画作品

第二参数 record 表明是否写入数据库，默认为否，只删除图片文件

URL 自动解析

权限 id: xyz.cssxsh.mirai.plugin.pixiv-helper:url
匹配一下正则表达式的URL将会被解析

val URL_ARTWORK_REGEX = """(?<=pixiv\.net/(i|artworks)/|illust_id=)\d+""".toRegex()
val URL_USER_REGEX = """(?<=pixiv\.net/(u/|users/|member\.php\?id=))\d+""".toRegex()
val URL_PIXIV_ME_REGEX = """(?<=pixiv\.me/)[\w-]{3,32}""".toRegex()

设置

PixivHelperSettings.yml

• cache_path 缓存目录
• backup_path 备份目录
• temp_path 临时目录
• ero_chunk 色图分块大小 和自动触发TAG缓存有关
• ero_up_expire 色图自动触发更高收藏数的最大时间，单位毫秒
• ero_work_types 涩图标准 内容类型 ILLUST, UGOIRA, MANGA, 为空则全部符合
• ero_bookmarks 涩图标准 收藏
• ero_page_count 涩图标准 页数
• ero_tag_exclude 涩图标准 排除的正则表达式
• ero_user_exclude 涩图标准 排除的UID
• pximg i.pximg.net 反向代理, 若非特殊情况不要修改这个配置，保持留空
• proxy 代理，图片下载器会对代理产生很大的负荷，请十分谨慎的开启这个功能。
• timeout_api API超时时间, 单位ms
• timeout_download DOWNLOAD超时时间, 单位ms
• block_size DOWNLOAD分块大小, 单位B, 默认 523264, 为零时, 不会分块下载
• tag_sfw tag 是否过滤r18 依旧不会放出图片
• ero_sfw ero 是否过滤r18 依旧不会放出图片

NetdiskOauthConfig.yml

插件上传文件功能需要百度网盘API支持，但这个配置(备份文件)是可选的，不影响其他功能的使用。
请到 https://pan.baidu.com/union/main/application/personal 申请应用，并将获得的APP信息填入
信息只在启动时读取，修改后需重启，并使用 /backup auth 认证百度账号

ImageSearchConfig.yml

• key KEY 不是必须的，无KEY状态下，根据IP每天可以搜索 100 次，有KEY状态下搜索次数依据于账户
  KEY 参数请到 https://saucenao.com/ 注册账号，
  在用户页面 https://saucenao.com/user.php?page=search-api 获得的KEY填入
  信息只在启动时读取，修改后需重启

• limit 显示的搜索结果数

• bovw ascii2d 检索类型，false色合検索 true特徴検索

PixivGifConfig.yml

• quantizer 编码器, com.squareup.gifencoder.ColorQuantizer 的实现
  目前可选值，图片质量和所需性能按顺序递增, 推荐使用 OctTreeQuantizer
com.squareup.gifencoder.UniformQuantizer
com.squareup.gifencoder.MedianCutQuantizer
com.squareup.gifencoder.OctTreeQuantizer
com.squareup.gifencoder.KMeansQuantizer
xyz.cssxsh.pixiv.tool.OpenCVQuantizer (需要 安装 OpenCV, 对应 jar 放进 plugins 文件夹)
• ditherer 抖动器, com.squareup.gifencoder.Ditherer 的实现
  目前可选值, 推荐使用 AtkinsonDitherer
com.squareup.gifencoder.FloydSteinbergDitherer
com.squareup.gifencoder.NearestColorDitherer
xyz.cssxsh.pixiv.tool.AtkinsonDitherer
xyz.cssxsh.pixiv.tool.JJNDitherer
xyz.cssxsh.pixiv.tool.SierraLiteDitherer
xyz.cssxsh.pixiv.tool.StuckiDitherer
• disposal 切换方法
  可选值 UNSPECIFIED, DO_NOT_DISPOSE, RESTORE_TO_BACKGROUND, RESTORE_TO_PREVIOUS
• max_count OpenCVQuantizer 最大迭代数

hibernate.properties

如果不是特殊需要，使用默认的 SQLite 配置就好
配置 mysql 举例 (字符集要设置为utf8mb4_bin)，其他数据库类推
下载 mysql-connector-java
, 然后放进 plugins 文件夹
配置 文件

hibernate.connection.url=jdbc:mysql://localhost:3306/pixiv?serverTimezone=Aisa/Shanghai
hibernate.connection.driver_class=com.mysql.cj.jdbc.Driver
hibernate.connection.CharSet=utf8mb4
hibernate.connection.characterEncoding=utf8
hibernate.connection.useUnicode=true
hibernate.connection.username=username
hibernate.connection.password=password
hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
hibernate.connection.provider_class=org.hibernate.connection.C3P0ConnectionProvider
hibernate.hbm2ddl.auto=none
hibernate-connection-autocommit=true
hibernate.connection.show_sql=false
hibernate.autoReconnect=true

Rss Helper

基于 Mirai Console 的RSS订阅插件

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/rss add https://github.com/cssxsh.atom
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数 下列指令的 URL 参数可以使用 base64 编码 后的形式

RssBaseCommand

指令	描述
/<rss> <add> [url]	添加一个订阅
/<rss> <list>	列出订阅列表
/<rss> <interval> [url] [duration]	设置订阅间隔, 单位分钟
/<rss> <stop> [url]	取消一个订阅

RssGithubCommand

指令	描述
/<rss-github> <releases> [owner] [repo]	添加一个Releases订阅
/<rss-github> <commits> [owner] [repo]	添加一个Commits订阅
/<rss-github> <tags> [owner] [repo]	添加一个Tags订阅
/<rss-github> <activity> [user]	添加一个Activity订阅
/<rss-github> <private> [user] [secret]	添加一个Private订阅

RssMikanCommand

指令	描述
/<rss-mikan mikan> <my> [token]	添加一个MyBangumi订阅
/<rss-mikan mikan> <classic>	添加一个Classic订阅
/<rss-mikan mikan> <bangumi> [id] [sub]?	添加一个Bangumi订阅
/<rss-mikan mikan> <search> [word]	添加一个Search订阅

指令基于 蜜柑计划

RssMoeCommand

指令	描述
/<rss-moe> <recent>	查看当季番剧TAG
/<rss-moe> <search> [name]	搜索TAG
/<rss-moe> <tags> {ids}	添加一个Tag订阅

指令基于 萌番组

RssTestCommand

指令	描述
/<rss-test> <build> [url]	测试一个订阅
/<rss-test> <ssl>	测试SSL
/<rss-test> <clear>	清空种子文件

RssMiraiCommand

指令	描述
/<rss-mirai mirai> <category> [value]	添加标签订阅
/<rss-mirai mirai> <plugin>	添加插件发布订阅
/<rss-mirai mirai> <other>	添加其他项目发布订阅

RssHubCommand

指令	描述
/<rss-hub rsshub> <add>	交互添加RssHub订阅

交互过程举例

1748(1438159989)  23:29:58
/rsshub add

QQBot(3337342367)  23:30:02
request returned 1899 routes

QQBot(3337342367)  23:30:03
请输入路由名

1748(1438159989)  23:30:07
755

QQBot(3337342367)  23:30:07
(0, /755/user/:username)

QQBot(3337342367)  23:30:08
/755/user/:username, 输入:username (置空可以输入#)

1748(1438159989)  23:30:21
akimoto-manatsu

QQBot(3337342367)  23:30:26
1748  
/rsshub add
RSS订阅任务[秋元真夏(乃木坂46) - 755]已添加

配置文件 RssHubConfig.yml 可以配置rsshub的域名，即可以配置rsshub的源
此配置只对新的rsshub订阅订阅行为有效

配置

RssHubConfig

• domain rsshub 服务器的域名，默认为官方的 rsshub.app

HttpClientConfig

• doh Dns Over Https Url (为空时关闭Doh，使用系统DNS since 1.0.0-dev-6)
• sni 需要移除 SNI HostName 的域名的正则表达式列表
• proxy 代理列表 host: proxy, host=127.0.0.1时是全局代理
• ipv6 doh 开启ipv6 支持 (since 1.0.3)

RssContentConfig

• limit 订阅内容输出到QQ消息的最大长度，超过则只会输出 内容过长

TODO

• 翻译功能
• 代理支持
• Doh支持
• 将Html转化为Mirai的MessageChain(主要目的是显示图片)

安装

MCL 指令安装

./mcl --update-package io.github.gnuf0rce:rss-helper --channel stable --type plugin

手动安装

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

刷新设备信息（删除 device.json 文件）

Baidu Api Client

百度API的Kotlin SDK，目前实现的有 Oauth认证 和 百度网盘

Baidu Oauth

部分SDK的前置库
有三种验证方式

服务端的方式获取 Token, block 输入 认证网页 Url ，返回认证码
suspend fun authorize(block: suspend (Url) -> String)

移动端的方式获取 Token, block 输入 认证网页 Url ，返回跳转Url
suspend fun implicit(block: suspend (Url) -> Url)

设备认证的方式获取 Token, block 第一个参数是 直接网页认证的Url，第二个是 二维码认证的图片Url
suspend fun device(block: suspend (Url, Url) -> Unit)

刷新 Token
suspend fun refresh()

Baidu Netdisk

需要到 百度网盘开放中心 申请app
作为构建客户端的参数

open class BaiduNetDiskClient(
    override val appId: Long,
    override val appName: String,
    override val appKey: String,
    override val secretKey: String
)

客户端在网盘中的工作目录为/apps/${appName}

已完成的功能

1. [Oauth](#Baidu Oauth) 验证登录
2. 上传文件
3. 列出文件
4. 搜索文件
5. 秒传链接 获取和解析

Gradle引用包

到 Personal Access Tokens 申请一个token
然后添加repository

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/baidu-client")
        credentials {
            username = "${github.id}"
            password = "${github.token}"
        }
    }
}

dependencies {
    implementation("xyz.cssxsh.baidu:baidu-netdisk:${version}")
}

BiliBili Helper

基于 Mirai Console 的 哔哩哔哩 订阅插件

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/B动态 添加 692283831
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数
直播 @全体成员 详见配置

参数 uid 例如 https://space.bilibili.com/508963009/ 的数字 508963009
参数 contact 为QQ号或者群号，可以省略，会从当前聊天环境获取，比如群聊中会自动填充为当前群号

动态订阅指令

指令	描述
/<bili-dynamic B动态> <add 添加> [uid] [contact]?	添加一个b站动态订阅
/<bili-dynamic B动态> <stop 停止> [uid] [contact]?	停止一个b站动态订阅
/<bili-dynamic B动态> <list 列表> [contact]?	列出当前联系人的动态订阅

动态订阅会优先使用截图的形式推送内容，截图需要谷歌浏览器或者火狐浏览器 否则将推送文本内容

直播订阅指令

指令	描述
/<bili-live B直播> <add 添加> [uid] [contact]?	添加一个b站直播订阅
/<bili-live B直播> <stop 停止> [uid] [contact]?	停止一个b站直播订阅
/<bili-live B直播> <list 列表> [contact]?	列出当前联系人的直播订阅

视频订阅指令

指令	描述
/<bili-video B视频> <add 添加> [uid] [contact]?	添加一个b站视频订阅
/<bili-video B视频> <stop 停止> [uid] [contact]?	停止一个b站视频订阅
/<bili-video B视频> <list 列表> [contact]?	列出当前联系人的视频订阅

视频订阅不宜过多，否则会触发b站反爬策略，导致IP被锁定 动态订阅一般会包含视频内容，推荐以此代替

剧集订阅指令

指令	描述
/<bili-season B剧集> <add 添加> [sid] [contact]?	添加一个b站剧集订阅
/<bili-season B剧集> <stop 停止> [sid] [contact]?	停止一个b站剧集频订阅
/<bili-season B剧集> <list 列表> [contact]?	列出当前联系人的剧集订阅

剧集订阅需要 Season ID 例如 https://www.bilibili.com/bangumi/play/ss38353 的 38353
可以通过 搜索指令 搜索番剧 获得链接
目前剧集订阅出于实验性阶段

信息解析指令

指令	描述
/<bili-info B信息> <aid> [id]	根据 avid 获取视频信息
/<bili-info B信息> <bvid> [id]	根据 bvid 获取视频信息
/<bili-info B信息> <dynamic> [id]	根据 id 获取动态信息
/<bili-info B信息> <live> [id]	根据 id 获取直播信息

返回结果包含图片，需要在聊天环境执行指令
消息中包含 BV12v411G7dP av2 等等 id 信息时会自动触发解析
目前会触发的正则表达式

val VIDEO_REGEX = """((av|AV)\d+|BV[0-9A-z]{8,12})""".toRegex()
val DYNAMIC_REGEX = """(?<=t\.bilibili\.com/(h5/dynamic/detail/)?)(\d+)""".toRegex()
val ROOM_REGEX = """(?<=live\.bilibili\.com/)(\d+)""".toRegex()
val SHORT_LINK_REGEX = """(?<=b23\.tv\\?/)[0-9A-z]+""".toRegex()
val SPACE_REGEX = """(?<=space\.bilibili\.com/)(\d+)""".toRegex()
val SEASON_REGEX = """(?<=bilibili\.com/bangumi/play/ss)(\d+)""".toRegex()
val EPISODE_REGEX = """(?<=bilibili\.com/bangumi/play/ep)(\d+)""".toRegex()
val MEDIA_REGEX = """(?<=bilibili\.com/bangumi/media/md)(\d+)""".toRegex()

搜索指令

指令	描述
/<bili-search B搜索> <user 用户> [keyword]	搜索用户
/<bili-search B搜索> <bangumi 番剧> [keyword]	搜索番剧
/<bili-search B搜索> <ft 影视> [keyword]	搜索影视

返回结果包含图片，需要在聊天环境执行指令

设置

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

BiliHelperSettings.yml

• cache 图片缓存位置, 默认为 ImageCache
• api API 访问间隔时间，单位秒, 默认为 10
• video 视频 订阅 访问间隔时间，单位分钟, 默认为 10
• dynamic 动态 订阅 访问间隔时间，单位分钟, 默认为 10
• live 直播 订阅 访问间隔时间，单位分钟, 默认为 30
• season 番剧 订阅 访问间隔时间，单位分钟, 默认为 30

BiliCleanerConfig.yml

• interval 图片清理的间隔时间，单位 小时
• expires 图片缓存过期时间，单位 小时

SeleniumConfig.yml

• user_agent 截图设备UA 网页识别设备类型，进而影响截图的效果
  iPad Mozilla/5.0 (iPad; CPU OS 11_0 like Mac OS X) AppleWebKit/604.1.34 (KHTML, like Gecko) Version/11.0 Mobile/15A5341f Safari/604.1
  iPhone Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1
  Mac Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_8; en-us) AppleWebKit/534.50 (KHTML, like Gecko) Version/5.1 Safari/534.50
• width 截图宽度
• height 截图高度
• pixel_ratio 截图像素比
• headless 无头模式(后台模式)
• hide 隐藏的web组件(jQ选择器)
  添加 ".international-header", ".top-bar", ".m-navbar" 可以屏蔽顶边栏
• setup 是否启用截图，默认 true

LiveAtAll

此配置通过权限设置，权限ID为 xyz.cssxsh.mirai.plugin.bilibili-helper:live.atall
配置对象为群，即 g*, g12345
举例，perm add g12345 xyz.cssxsh.mirai.plugin.bilibili-helper:live.atall

Cookies

位于 data/bilibili-helper/cookies.json
导入 cookies文件 不是必须的，这是实验性功能，主要是防止b站反爬IP锁定
从 浏览器插件 EditThisCookie 导出Json 填入文件
EditThisCookie 安装地址
Chrome
Firefox
Edge

安装

MCL 指令安装

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

手动安装

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

TODO

• 完善剧集订阅
• 自动清理图片缓存

不需要尖括号

@xinlinyu
这是一个古怪的问题，按道理可以使用curl 正常连上的话，握手应该是莫得问题的

Arknights Helper

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

指令

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

助手抽卡指令

指令	描述
/<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

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

安装

MCL 指令安装

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

手动安装

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

TODO

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

数据来源

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

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

@enderavaritia
无法复现

@konoha
请阅读
信息解析指令
部分内容

风控

@fridayanubis
1.5.6

@smallbug
/perm add g* xyz.cssxsh.mirai.plugin.debug-helper:online.exclude

@smallbug
仔细看文档

@konoha
仔细看文档

@fridayanubis
任何是一个用起来很舒服的词，
但是你有没有想过一种可能，
那就是我真的需要图片做复现

@fridayanubis
我需要图片做测试

@fridayanubis
除非有方法屏蔽腾讯的检测，
不然不会在任何一个版本解除R18限制