当前版本：V1.0.1.20241017

Mirai-Bot帮助文档
注：该功能由翰林的小站开发完成功能实现，此为开源项目

思路借鉴了喜闻乐见的查机厅卡数功能，对接了华立 API 里的 ID 以实现跨群信息共享。

Maimai 排卡

当前快捷指令

MaiMai查卡

快捷指令菜单：

• 艾特bot 搜索机厅
• 艾特bot 添加别名
• 艾特bot 删除别名
• 查询机厅人数：别名+几卡
• 更新机厅人数：别名 +/-/= number
• 本群绑定机厅

MaiMai排卡

快捷指令菜单：

• 创建排卡 别名 排卡队伍名称
• 加入排卡 排卡队伍名称
• 加入排卡 排卡队伍名称 单刷
• 插队排卡 排卡队伍名称 序号
• 推进排卡 排卡队伍名称
• 查看当前排卡
• 拼机 排卡队伍名称 序号
• 退出排卡 别名
• 删除排卡 别名

帮助： 排卡帮助

使用示例（MaiMai查卡）

查询全部可用机厅

• 指令：艾特bot 搜索机厅
  结果：Bot将返回一个聊天记录，里面包含了它目前能搜索到的所有机厅
  

将机厅绑定为别名（仅群主管理员可用）

• 指令：艾特bot 添加别名
  结果：

机厅卡数操作

• 支持的正则集：r'^(.+)?\s?(设置|设定|＝|=|加|＋|\+|减|－|-)\s?([0-9]+|＋|\+|－|-)(人|卡)?$'
• 对应的映射：

opRepList = {
    "+": ["＋", "加"],
    "-": ["－", "减"],
    "=": ["设定", "＝"]
}

• 例如，如果你在上文中将 3000 设置为「家」，那么：
  家加1 家+1 家++ 都会将「家」的卡数增加 1。
  家减1 家-1 家-- 都会将「家」的卡数减少 1。
  家=1 家设定1 家＝1 都会将「家」的卡数设定为 1。

  另请注意：为避免含数字的别名与匹配打架，暂不支持 「家1」 这样的设卡操作，设卡请显式使用「=」等符号。另请注意：为避免含数字的别名与匹配打架，暂不支持 「家1」 这样的设卡操作，设卡请显式使用「=」等符号。

查询机厅卡数

• 本操作采用后缀匹配，支持的后缀有： ['有多少人', '有几人', '有几卡', '多少人', '多少卡', '几人', 'jr', '几卡', '几']
• 例如，使用 家有几人 家几 均可以查询「家」的卡数。

天空之城泰安泰山吾悦广场店 当前人数为 1 人
最近更新：2024-10-06 11:50:19 asfr·翰林|abc1763613206(1817532680) 设定了人数为 1 人

查询本群所有绑定机厅

本操作可使用关键词 jtj 机厅几人 ，或是命令 查询本群绑定机厅 查询，将返回本群所有绑定机厅的卡数与别名。

本群目前绑定的机厅：

天空之城泰安泰山吾悦广场店(家) 当前人数为 1 人
最近更新：2024-10-06 11:50:19 asfr·翰林|abc1763613206(1817532680) 设定了人数为 1 人

删除机厅别名（仅群主管理员可用）

• 指令：艾特bot 删除别名
  结果：删除别名成功！

使用示例（MaiMai查卡）

更多细节

MaiMai查卡

该功能具体的实现方式是基于华立公共api返回的机厅唯一标识符，而群组内的则通过 添加的别名 进行检索区分。因为每个群组之间的别名对应互相独立，进而不会影响各个群组之间的使用。
因为每天都会有服务器的定时维护，那么bot就会在每天晚上的凌晨四点将数据进行重置以方便之后的使用（这时候应该没人在上机了吧