两种帮助入口

帮助 maimaidx
帮助maimaiDX

• 帮助 maimaidx：打开 PicMenu 分类菜单。
• 帮助maimaiDX / 帮助maimaidx：打开插件原有帮助图片。

本插件负责 B50、查歌、完成表、猜歌等标准舞萌查询；账号二维码、PC、票券、快捷上传等本地功能请查看 帮助 mai2help。

绑定流程

dfbind

1. Bot 返回水鱼授权链接。
2. 登录水鱼并确认绑定身份，点击同意授权。
3. 复制页面给出的确认码发给 Bot。

确认码形如 BCDF-GHJK-LMNP，当前版本的绑定会话约 20 分钟有效，确认码只能使用一次。建议在私聊中发送。

与 Mai2Help 的区别

这里取得的是用于 B50 等查询的 OAuth 授权。mai2help 快捷上传水鱼成绩还需要 Import-Token；dfbind 成功后，Mai2Help 会继续给出 Import-Token 绑定提示。

绑定流程

lxbind

1. 打开 Bot 返回的落雪授权链接。
2. 登录并允许 Bot 访问成绩。
3. 复制授权码或完整回调链接发给 Bot。

绑定会话约 10 分钟有效，授权码只能使用一次。请在落雪“账号设置 → 常规设置 → 隐私设置”中开启允许读取成绩，否则授权成功后仍可能无法查询。

管理员可以将落雪绑定限制为仅私聊；若群聊提示受限，请添加 Bot 好友后私聊发送 lxbind。

数据源

数据源
数据源 1

不填写有效编号时，Bot 会返回当前可选数据源列表。若落雪服务不可用，插件会避免切换到无法查询的来源。

图片主题

主题
主题 1

不填写有效编号时，Bot 会返回可选主题列表。主题主要影响 B50 等成绩图片的外观。

基本用法

b50
B50
ap50

命令后可以附加查分器用户名；群聊中也可以 @ 用户查询其绑定数据。

• b50：水鱼、落雪数据源均可使用。
• ap50：仅落雪数据源支持。

新用户尚未授权时，Bot 会提示使用 dfbind 或 lxbind。查询数据源可通过 数据源 命令切换。

示例

info 11514
info 系ぎて
minfo 潘多拉

支持曲目 ID、完整曲名和别名。若一个别名对应多首歌，Bot 会返回候选 ID，需要改用明确的 ID 查询。

可用别名：info、minfo、Minfo、MINFO、Info、INFO。

示例

ginfo 11514
ginfo 紫 系ぎて
ginfo 白 潘多拉

不写颜色时默认查询紫谱。结果包含游玩次数、拟合难度、平均达成率、平均 DX 分数和成绩标准差。

颜色含义：绿 Basic、黄 Advanced、红 Expert、紫 Master、白 Re:MASTER。

标题与 ID

查歌 潘多拉
查歌 Link 2
id 11514
潘多拉是什么歌

定数与 BPM

定数查歌 13.7
定数查歌 13.0 13.5 2
bpm查歌 200
bpm查歌 180 220 2

曲师与谱师

曲师查歌 sasakure.UK
谱师查歌 Jack 2

参数最后的纯数字可作为页码。别名查询使用“XXX是什么歌”；标题片段使用“查歌 XXX”。

今日推荐

今日舞萌
mai什么
mai什么推分

今日舞萌 会根据 QQ 生成今日人品、宜忌和推荐歌曲；“mai什么推分”在已授权时会结合成绩推荐。

条件随机

随个13+
来个dx紫13
给个标准红12+

类型可用 dx、sd、标准，颜色可用绿黄红紫白，等级支持 +。

示例

我要在13+上10分
我要加20分

等级和目标分数都可以按命令格式填写。插件会结合当前成绩，生成适合推分的曲目列表；未绑定查分器时无法计算。

示例

查看排名
查看排名 2
查看排名 用户名
我的排名

查看排名 的纯数字参数作为页码，其他文本作为用户名筛选；我的排名 会用当前 QQ 对应的水鱼资料查找 Rating 和名次。

示例

分数线 紫799 100
分数线 帮助

颜色可用绿、黄、红、紫、白。结果会给出 TAP GREAT 的等价容错，以及 BREAK 50 落对应的损失。发送 分数线 帮助 可查看完整判定换算表。

示例

13定数表
13+定数表
15定数表

当前实现仅支持查询 Lv.7 至 Lv.15。定数表由管理员生成和更新；若图片资源缺失，需要超级用户执行 更新定数表。

示例

13完成表
13+fc完成表
14ap完成表

当前完成表计划筛选只支持 fc 和 ap。不带计划时显示普通完成情况；未授权查分器时无法读取个人成绩。

示例

祭将完成表
祭将进度
舞舞舞完成表 2
牌子条件

版本支持真、超、檄、橙、晓、桃、樱、紫、堇、白、雪、辉、舞、霸、熊、华、爽、煌、星、宙、祭、祝、双、宴、镜、彩等。

牌子计划支持极、将、舞舞、神、者等；发送 牌子条件 可查看条件图片。

进度示例

13+s+进度
14ap未完成进度 2
13+fc已完成进度

分类可用 已完成、未完成、未开始、未游玩；评价支持成绩等级、FC/AP 和 FS/FDX 系列。

分数列表示例

13+分数列表
13.7分数列表 2

定数小数只支持一位。

猜歌

猜歌

Bot 每隔约 8 秒公布一条特征，最后给出封面局部，并在约 30 秒后揭晓。可以发送歌曲 ID、标题或别名作答。

猜曲绘

猜曲绘

Bot 发送裁切曲绘，需要在约 30 秒内作答。同一群同一时间只能进行一场猜歌或猜曲绘。

示例

潘多拉有什么别名
id 799有什么别名

如果输入的别名对应多首歌曲，Bot 会分别列出候选曲目；找不到时可使用 添加别名 发起申请。

申请

添加别名 799 新别名

别名可包含空格。可用别名：申请别名、增加别名、增添别名、添加别称。

投票与查询

同意别名 ABCD
当前投票
当前投票 2

投票标签由别名查询或当前投票结果给出。

示例

添加本地别名 799 本地别名

可用别名：添加本地别名、添加本地别称。

该操作会影响当前 Bot 的所有用户，但不会提交到公共别名服务器。当前安装版本没有为此命令设置额外权限，使用前请确认确有需要。

猜歌管理

开启mai猜歌
关闭mai猜歌
重置猜歌

别名推送

开启别名推送
关闭别名推送

这些命令需要超级用户、群主或群管理员权限。重置猜歌 会结束当前群正在进行的猜歌。

用法

mai2help

该命令保留原有文字帮助体验；图片帮助使用 帮助 mai2help。

Mai2Help 只负责本地舞萌账号、PC、成绩上传、票券和机台查询。B50、查歌、定数等标准功能仍由 nonebot_plugin_maimaidx 提供。

用法

mai绑定
mai绑定 SGWCMAID...

不附二维码时，Bot 会进入等待状态。可发送文本、官方链接或二维码图片。

• 群聊发起后，可在 180 秒内转到私聊发送二维码。
• 群内提交敏感二维码时，Bot 会尝试自动撤回。
• 二维码连续验证失败 3 次后结束流程。
• 成功绑定后会同步 PC，并只向用户已经授权的平台上传。
• 发送 取消、退出、q 或 00 可以退出。

直接发送有效二维码也支持自动识别；是否启用由管理员配置决定。

查看状态

mai状态

展示用户名、Rating、游玩次数、版本、二维码缓存、水鱼/落雪上传状态及有效票券。二维码过期时可在 180 秒内补交，群聊发起后也可转私聊续办。

解除绑定

mai解绑

解除舞萌二维码和账号资料绑定；水鱼与落雪上传凭据会保留，如需删除请分别使用解绑命令。

获取 Import-Token

1. 打开水鱼查分器：https://www.diving-fish.com/maimaidx/prober/
2. 登录后进入“编辑个人资料”。
3. 找到 Import-Token，生成并复制完整 Token。

绑定

mai绑定水鱼

• 群聊发起后，可在 300 秒内私聊 Bot 发送 Token。
• 群内发送时 Bot 会尝试撤回敏感消息。
• 格式错误最多重试 3 次。

解绑

mai解绑水鱼

dfbind 用于 maimaidx 的水鱼 OAuth 查询授权；mai绑定水鱼 保存的是上传所需 Import-Token，两者不能互相替代。

推荐方式

lxbind

完成落雪 OAuth 授权后，Mai2Help 会自动复用并在需要时刷新授权。

兼容 Token

mai绑定落雪 <导入 Token>

不要发送账号密码、浏览器 Cookie 或刷新令牌。

解绑兼容 Token

mai解绑落雪

此命令只删除 Mai2Help 保存的兼容 Token；OAuth 授权由 maimaidx 管理。

命令

• 导 或 maiua：上传到全部已绑定平台。
• maiu：只上传水鱼。
• maiul：只上传落雪。

没有绑定任何上传平台时，只会给出绑定指引，不会要求先提交二维码。只绑定一个平台时，导 会上传该平台，并把另一个平台显示为未绑定而不是失败。

二维码缺失或过期时，可在 180 秒内补交；群聊发起后支持转私聊续办。二维码验证最多重试 3 次。

成绩只会发送到用户已绑定的水鱼或落雪查分器。

用法

更新pc数

别名包括 同步pc数、绑定机台、登录机台。

优先使用本地保存的二维码；缓存失效时会要求补交新二维码。群聊发起后可在 180 秒内转私聊发送，格式错误最多重试 3 次。

同步完成后，若用户绑定了上传平台且管理员开启自动上传，也会只向已授权平台同步成绩。

个人统计

我的pc数

显示总谱面数、总游玩次数和游玩最多的 15 个谱面。

全部排行

pc排行

按本地已同步数据展示总 PC 排行。

歌曲详情

pc数 1231
pc数 歌曲名

群聊中可以 @ 用户查询对方已经同步到本机的 PC 数据。

用法

发票
mai发票 2

不填写倍率时会询问选择，当前可选：2 / 3。

流程

1. 检查账号是否已有未使用倍率票。
2. 确认无票后执行发放。
3. 再次查询库存，确认到账后才报告成功。

通常约 40 秒，排队时可能更久。一个账号同时只能持有一张倍率票，已有票券时本次发票会自动取消。

二维码过期时可在 180 秒内补交；收到二维码后会立即反馈撤回结果和受理状态。

用法

mai清票

该操作会清空账号内票券。Bot 会要求最新二维码，登录后等待约 60 秒，再一次提交完整结算、复查票券和游玩记录，最后确认登出。

• 群聊发起后支持在 180 秒内转私聊提交二维码。
• Bot 会尝试撤回二维码消息。
• 二维码最多重试 3 次。
• 操作进行中请勿重复提交或在其他机台登录同一账号。

用法

mai查票

查询结果会分开显示倍率票与免费票，并过滤已经过期的记录。

若二维码失效，可在 180 秒内提交新二维码恢复原查询；群聊发起后也支持转私聊续办，不会顺带同步 PC 或上传成绩。

用法

mai预览

可展示用户名、Rating、友人对战等级、段位、游玩次数、上次游玩时间和区域等当前可用字段。

二维码过期时可在 180 秒内补交并继续原查询，支持群聊转私聊。

用法

mai地图

显示记录地区数、总游玩次数，以及各省级地区的游玩次数；服务端提供首次记录时间时也会一并展示。

二维码过期时可补交新二维码继续原查询，支持群聊转私聊。

用法

mai道具

按 itemKind 分组展示姓名框、称号、头像、收藏品、乐曲解锁、角色、搭档、边框和票券等可见记录。单类记录过多时只展示前若干项并标注总数。

该命令只读取数据，不会修改道具。二维码过期时可补交并续办。

用法

mai门状态

当前展示每扇门是否已发现、是否已获得钥匙、是否已经通关。

这是只读查询：不会修改门、钥匙或解锁状态。二维码过期时可补交并续办，支持群聊转私聊。

用法

mai查询opt <titleVer>

结果包括请求的机台版本、可用 OPT 代码、清单名称，以及服务端提供的配信地址。

OPT 是机台可选内容/增量资源配信，不是玩家成绩或账号资料。

示例

mai改成绩 1231 紫 100.5% 5 AP FDX
mai改成绩 歌曲名 MASTER 100.5% 2100 AP FDX 专业

也可以只发送 mai改成绩，按提示依次选择歌曲、难度和成绩。

参数

• 难度：0～4、绿/黄/红/紫/白；宴谱可使用 宴。
• 简单模式：DX 分填写 0～5 星。
• 专业模式：填写实际 DX 分，不可超过谱面理论满分。
• FC：NONE / FC / FC+ / AP / AP+。
• FS：NONE / FS / FS+ / FSDX / FSDX+ / SYNC。

确认后会清除全部票券库存，模拟约 60 秒的游玩结算，写入成绩并复查，通常需要约 1～2 分钟。二维码失效时可在 180 秒内补交，只恢复本次成绩修改。

用法

maiping

检查内容包括：

• 本机 sw-api 健康状态与服务名。
• 机台身份是否配置。
• 自动扫码与自动上传开关。
• 当前是否有机台任务正在处理。
• 服务端提供时显示本机会话缓存数量。

该命令只检查本地服务。

协议内容

二维码、账号资料、PC 记录和操作审计保存在 Bot 本机。绑定水鱼或落雪后，更新成绩只会向相应已绑定平台上传。

插件不会把数据上传到公共网关、论坛或公开数据集。

命令

用户协议
同意用户协议 我已阅读并同意 Mai2Help 本地服务协议
撤回用户协议

撤回同意不会自动删除已经保存的二维码；如需删除请继续发送 mai解绑。

以下命令目前标记为暂不可用：

mai删成绩
mai改道具

它们不会被描述为已完成功能，也不应作为日常操作使用。后续只有在本地 sw-api 完整实现、加入结果复查和登出确认后才会开放。

帮助入口

帮助 机厅
机厅help
机厅帮助
arcade help

• 帮助 机厅：打开 PicMenu 分类图片菜单。
• 其余命令：查看插件原有的文字帮助。

本插件按群保存机厅、人数、别名、地图和排卡数据。使用前需要由本群管理员执行 添加群聊 开通功能。人数数据会在每天 0 点清理，机厅和排卡配置不会随人数清理。

开通

添加群聊

开通后才可添加机厅、上报人数和使用排卡。

停用

删除群聊

该命令会从插件数据中移除当前群及其机厅配置，请确认后再执行。两项操作都需要超级用户、群主或群管理员权限。

添加机厅

添加机厅 机厅名

Bot 会搜索 Nearcade，并给出最多 3 个候选。发送 1～3 选择机厅，4 查看更多，5 按原名称直接添加，6 取消。选择 Nearcade 机厅时会尝试自动保存详情地图链接；没有搜索结果时会直接添加输入的名称。

删除与列表

删除机厅 机厅名
删除机厅 1
机厅列表
机厅

机厅列表 会显示当前群的机厅及序号；删除机厅必须使用机厅本名或列表序号，不能直接使用别名。

今日人数总览

mai
机厅人数
jtj
机厅几人

只列出今天已有更新记录的机厅，并显示更新人和时间。

查询单个机厅

机厅名几
机厅名几人
机厅名j

机厅名可以使用已设置的机厅别名。若机厅关联了 Nearcade 地图，查询时会读取并校准云端出勤人数；结果还会根据机台数量估算排队轮数和等待时间。

命令格式

机厅名++       人数加 1
机厅名--       人数减 1
机厅名++3      人数加 3
机厅名--3      人数减 3
机厅名+3       人数加 3
机厅名-3       人数减 3
机厅名=3       直接设为 3
机厅名3        直接设为 3

机厅本名和别名均可使用。单次增减值不能超过 50，更新后的总人数必须在 0～100。

若机厅保存了 Nearcade 地图链接，插件会读取机台数量、校准现有云端人数并上传新的出勤人数，同时给出预计等待时间；未关联地图时只更新本地人数。

加入排卡

排卡 机厅名
排卡 别名

插件使用当前群昵称作为排卡身份。同一个昵称不能同时加入本群多个机厅的队列。

查看队列

排卡现状 机厅名

会按顺序显示当前排队成员。排卡和查询都支持机厅本名或别名；当前实现不支持用机厅序号排卡。

队列操作

上机
延后
退勤

• 上机：只有当前第一位可操作；将队首移到队尾，并提示下一位。队列只有一人时保持不变。
• 延后：将自己与后一位交换；已经是最后一位时无需延后。
• 退勤：将自己的群昵称从当前机厅队列移除。

这些命令会在本群所有机厅队列中查找当前昵称，因此无需再填写机厅名。

示例

闭店 机厅名
闭店 别名

闭店会直接清空指定机厅的排卡名单，但不会删除机厅、别名、地图或人数数据。当前实现支持机厅本名和别名，不支持机厅序号。

添加与查询

添加机厅别名 <机厅名/序号> <别名>
机厅别名 <机厅名/序号>

删除

删除机厅别名 <机厅名/序号> <别名/序号>
移除机厅别名 <机厅名/序号> <别名/序号>

先用 机厅列表 查看机厅序号，用 机厅别名 <机厅> 查看别名序号。添加和删除需要超级用户、群主或群管理员权限。

添加与查询

添加机厅地图 <机厅名/序号> <地图URL>
机厅地图 <机厅名/序号>
音游地图 <机厅名/序号>

删除

删除机厅地图 <机厅名/序号> <URL/序号>
移除机厅地图 <机厅名/序号> <URL/序号>

地图序号可通过查询命令获得。Nearcade 详情链接可用于人数云同步和机台数量识别。

注意：插件原版帮助将添加地图标为管理员操作，但当前源码只对“删除地图”做了管理员权限检查；此菜单按当前实际行为说明。

使用方法

直接向 Bot 发送 QQ 的位置分享消息。插件会读取经纬度，通过 Nearcade 搜索半径 10 km 内的机厅，并展示距离最近的最多 3 家、地址和详情页。

此监听器本身没有要求群聊，也不要求先执行 添加群聊。普通文字地址、截图或图片不含可解析的 QQ 位置数据，无法触发搜索。

序号来源

机厅列表          查看机厅序号
机厅别名 <机厅>   查看别名序号
机厅地图 <机厅>   查看地图 URL 序号

机厅管理、别名管理和地图管理中的多数参数支持对应序号；排卡、排卡现状和闭店当前只支持机厅本名或别名。

Nearcade

添加机厅时选择搜索候选，会尝试自动保存 Nearcade 链接。有关联链接时，人数查询和上报会访问 Nearcade，同步出勤人数并读取 maimai DX 机台数量；外部服务不可用时，云端查询或上传可能失败，但本地数据仍由插件保存。

本插件推荐文字菜品、饮品，支持群菜单、基础菜单与定时问候。另一款“今天吃喝什么呢”是图片推荐插件；两者当前都响应 今天吃什么 和 今天喝什么，同一句可能收到两次回复。

示例

今天吃什么
中午吃啥
今晚喝什么
夜宵吃点啥

插件也接受早餐、午餐、晚餐等时段的同类句式。命令末尾加“帮助”当前仍会执行推荐，不会返回旧文字帮助。若图片版吃饭插件也在运行，同一句话还可能触发图片推荐。

示例

菜单
群菜单
查看菜单
基础菜单

菜单较长时会尝试通过 OneBot 合并转发发送。这里的 菜单 是文字版插件的群菜单；图片版插件使用 查看全部菜单 查看图文菜品。

示例

添加 炒饭
移除 炒饭

添加 可以附带图片，插件会保存消息中的图片；菜品名称请使用一个不带空格的参数。操作仅影响当前群的文字菜单。

示例

加菜 饺子

这是全局基础菜单的维护命令，不是群管理员的 添加 <菜品>；可以附带菜品图片。

示例

开启小助手
关闭小助手

同义命令还有 启用小助手、禁用小助手。插件安排了早餐、午餐、下午茶、晚餐和夜宵问候任务；只有开启了小助手的群才会收到对应提醒。

示例

添加问候 早餐 早上好
删除问候 早餐

时段可选早餐、午餐、摸鱼、晚餐、夜宵。添加时若不填完参数，Bot 会逐步询问；发送“取消”结束。删除时先列出该时段文案序号，再发送数字选择，发送 0 可取消。

本插件发送本地保存的菜品或饮品图片，支持查看、添加和删除图片。项目同时加载另一款文字版“今天吃什么？”插件；双方都响应 今天吃什么/喝什么，同一句可能收到两份回复。

示例

今天吃什么
早上吃啥
今晚吃点啥

图片版优先级为 10；文字版插件同样会响应其中部分句式。命中全局冷却或个人次数限制时，Bot 会先返回对应提示。

示例

今天喝什么
晚上喝啥
夜宵喝点啥

吃与喝共享插件的全局冷却计时及用户次数统计。若文字版吃饭插件也在运行，部分句式会收到两份推荐。

示例

查看全部菜单
查看全部饮料

插件绘制所有菜品或饮品的列表图片，并用合并转发发送；群聊用群合并转发，私聊用私聊合并转发。命令中的“全部”很关键，单独发送 查看菜单 会进入单项查询并提示输入菜名。

示例

查看菜单 炒饭
查看饮料 奶茶

也可使用 查看菜品、查看饮品。省略名称时 Bot 会追问。图片必须已通过插件添加，或者存在于本地对应的图片目录中。

操作流程

添加菜单 炒饭

Bot 先确认名称，再提示发送图片；也可用 添加菜品、添加饮品。上传成功后图片会保存到插件的本地菜品或饮品目录。发送“取消”可结束等待。此菜单是本地图片文件菜单，不会同时更新文字版插件的群菜单。

示例

删除菜单 炒饭
删除饮料 奶茶

也可使用 删除菜品、删除饮品。省略名称时 Bot 会追问；发送“取消”可结束等待。删除会移除插件本地对应的 JPG 文件，请先用 查看全部菜单/饮料 确认名称。

示例

😎+😁
😂 ＋ 🥺

支持半角 + 和全角 ＋，两侧可留空格；输入应只包含两个 Emoji 与加号。不存在的组合会提示无法合成。合成结果和缓存由本地数据库与资源服务提供。

当前实例配置 emojimix_auto=false，因此直接发送 😂🥺 不会自动合成。请使用 😂+🥺。若管理员以后启用自动模式，相邻两个 Emoji 可在群聊中触发，不需要加号。

帮助入口

帮助 PixivBot
/pixivbot help

图片菜单包含随机插画、榜单、画师、书签、订阅与定时推送。/pixivbot help 返回插件自带的文字帮助。

以下 /pixivbot 命令也可在当前 Bot 的命令起始符配置允许时省略 /。成人内容和服务使用权限由 Bot 管理员控制；当前配置会过滤 AI 生成的插画。

示例

来张图
来三张图

不写数量时默认一张，数量受 Bot 的单次查询上限限制。当前实例会过滤 AI 生成作品；R18/R18G 由管理员权限设置控制。

示例

来张初音未来图
来三张风景图

关键词放在“张”和“图”之间。插件从搜索结果抽选，并应用当前配置的书签数、浏览量和 AI 作品过滤条件；搜索不到符合条件的作品时会返回失败信息。

示例

来张画师名老师的图
来两张画师名老师的图

画师处可填写 Pixiv 用户 ID 或名称。多个同名画师可能造成歧义，使用数字用户 ID 更准确。

示例

看看图12345678
https://www.pixiv.net/artworks/12345678

作品 ID 必须是正整数。链接识别要求消息内容单独匹配 Pixiv /artworks/<ID> 链接；与其他文字混发通常不会命中该监听器。多页作品的发送数量受管理员配置限制。

示例

看看榜
看看日榜 1-3
看看周榜 5
看看男性榜 1-3
看看ai榜 1-3

支持日、周、月、男性、女性、原创、新人、漫画、ai 等榜单。省略类型和名次时使用管理员配置的默认值。当前插件默认一次最多查询 10 张、榜单范围不超过前 150 名；管理员配置可调整这些上限。

示例

来张私家车
来两张私家车

优先使用当前发送者绑定的 Pixiv 用户 ID；未绑定时尝试使用管理员设置的默认书签账号。两者都不存在时会提示账号无效或未绑定。书签可见范围取决于 Pixiv 接口和账号设置。

示例

/pixivbot bind 12345678
/pixivbot bind
/pixivbot unbind

bind 带数字 ID 时绑定用户，不带 ID 时查看当前绑定状态和命令格式；unbind 解除绑定。这是记录 Pixiv 数字用户 ID，没有网页登录或授权 Token 流程。

示例

来张风景图
还要
还要两张
不够色

还要 按上一次记录的请求再查一次；不够色 根据上一次记录的作品寻找相关推荐。插件默认把最近请求保留约 10 分钟，过期或没有历史请求时会提示尚未发送过请求。

示例

/pixivbot watch user_illusts --user 12345678
/pixivbot watch

--user 可以填画师 ID 或名称。无完整参数时，插件会列出当前会话的订阅及编号；更新监听默认按约 10 分钟的间隔检查。订阅范围由发起命令的会话决定，群聊和私聊的订阅相互独立。

示例

/pixivbot watch following_illusts --user 12345678
/pixivbot watch fetch ABCD

第一条命令订阅指定 Pixiv 用户的关注画师新作。fetch 后填 /pixivbot watch 列出的订阅编号，可立即执行一次当前会话的监听任务。

请明确填写 --user：当前安装版在省略该参数时没有把发送者绑定的 Pixiv ID 传给监听任务，若管理员也未配置默认账号，后续不会推送。

示例

/pixivbot schedule random_recommended_illust 18:00
/pixivbot schedule random_illust 20:00 --word 风景
/pixivbot schedule random_user_illust 21:00 --user 12345678
/pixivbot schedule random_bookmark 22:00 --user 12345678
/pixivbot schedule ranking 06:00 --mode day --range 1-5
/pixivbot schedule

类型包括 random_recommended_illust、random_illust、random_user_illust、random_bookmark、ranking。时间 HH:mm 表示每日定点；HH:mm*x 表示每隔指定小时和分钟；也支持六段 cron 表达式。无完整参数时会列出当前会话的定时任务及编号。

示例

/pixivbot watch
/pixivbot unwatch ABCD
/pixivbot unwatch all
/pixivbot schedule
/pixivbot unschedule EFGH
/pixivbot unschedule all

先执行 watch 或 schedule 查看本会话的任务编号。unwatch 对应作品更新监听，unschedule 对应定时推送；all 只清空当前会话同类任务。

示例

capoo
咖波
猫猫虫
图库列表

当前实例启用 keyword 模式，只要文字中包含图库名或别名就可能触发；无全局冷却。同一句匹配多个图库时，会按最早出现的关键词选择。所有图库以 图库列表 实时结果为准，若图库还没有图片会提示“当前还没有图片”。

示例

图库列表
图库别名 capoo
图库别名 1

图库列表按名称排序并编号。查询别名时可填图库本名、已有别名或对应序号。图库配置可能由管理员动态调整，因此实际触发词请以 Bot 列表为准。

示例

添加capoo [附图片]
添加capoo

不附图时 Bot 会提示“请发送图片”；也支持回复一条已有图片并发送添加命令。图库可以用本名、别名或序号。插件校验重复图片后，将内容保存到该图库的本地目录。

示例

添加图库 企鹅
添加图库 企鹅 小企鹅 penguin

名称不得与现有图库或别名冲突；创建后可用 添加企鹅 导入图片。新图库配置保存在插件数据目录中，对使用此 Bot 的群全局生效。

示例

添加图库别名 capoo 咖波儿
删除图库别名 capoo 咖波儿
图库别名 capoo

一次可添加或删除多个以空格隔开的别名，图库名和别名序号可通过列表命令查询。图库本名不能当作普通别名删除。

流程

删除图库 企鹅
确认

同一用户在同一群中发送 取消 可放弃删除。.env 中预配置的图库不能用该命令删除。删除后图片文件夹中的实际图片文件会保留，只移除动态图库配置与索引。

示例

龙图
龙图 3
龙龙 2

默认一张；请求数量会被管理员设置的上限截断，未另设时上限为 5。插件从远程图源获取，网络失败时可能少于所请求的数量。

示例

ottohzys 大家好啊
otto活字印刷 大家好啊
电棍鬼叫 今天来点大家想看的

ottohzys 是已注册别名；还支持 otto鬼叫、大电老师活字印刷、活字印刷 等组合。命令后必须填写文字；不带文本时当前代码直接返回。

示例

otto活字印刷 -r 倒放测试
otto活字印刷 -s 0.8 -p 1.2 大家好

-r 倒放，-Y 不使用特定句子的原声大碟，-N 关闭音量归一化，-s 设置语速，-p 设置音调，-P 设置停顿秒数。

示例

占卜
抽签
运势
占卜帮助

每天再次抽签会展示当天已抽到的结果。占卜帮助 返回插件的文字说明。插件使用本群当前主题，未指定时由主题配置决定。

示例

原神抽签
方舟抽签
东方抽签

主题名可用 主题列表 中列出的名称或别名。若主题未启用，Bot 会给出提示；同一天重复抽签只会展示已抽取的签图。

示例

主题列表
查看主题
查看抽签主题

先查看支持的主题与别名，再使用 <主题>抽签 自选主题；管理员也可通过 设置<主题>签 修改本群的默认主题。

示例

设置原神签
重置主题
重置抽签主题

主题必须属于已启用的资源。设置仅作用于当前群；重置后恢复随机主题。

示例

指定随机签
指定角色名签

指定签底依赖插件资源目录中的图片。当前源码明确提示此功能计划在后续版本弃用，找不到签底时会直接返回失败提示。

示例

今日老婆
每日老婆

当天已抽取过时展示同一位；次日可重新抽取。插件会过滤自己及已被其他人抽中的群友；候选用完时可能抽到 Bot。

示例

今日老婆
换老婆

未抽过时不能换；达到本群次数上限或关闭换人功能时会给出提示。默认次数上限为 2，群管理员可另设。

示例

开启换老婆
关闭换老婆
设置换老婆次数 3

设置仅针对本群；次数参数必须是非负整数。

示例

刷新今日老婆
重置今日老婆

这会清除当前群的今日抽取记录，群成员再次发送 今日老婆 时可以重抽。

示例

发病 小明
发病

不写对象时 Bot 会追问“你要对哪个人发病呢？”。回复需包含文字；插件从内置语录中随机选一条并回复消息。

示例

我的超能力
随机超能力

Bot 从本地“超能力”和“但是”两个资源目录各随机挑选一张图片，拼在一起回复当前消息。

示例

日麻手牌分析 23445633p777s 0990m 立直 一发 dora3
牌理 123m456p789s11z

m/p/s/z 分别表示万、筒、索、字；手牌后可加副露、自风、场风、宝牌与其他役。和牌时最后一张牌视为和牌张。若 Bot 配置为嗅探模式，可直接发送牌型，不必加命令。

示例

番符 3番40符
日麻番符算点 2番30符

参数须写成 x番y符 且都为正整数。若 Bot 配置为嗅探模式，可直接发送 3番40符。

示例

牌理 123m456p789s11z

普通手牌为数字加花色后缀的组合，暗杠可写作 0990m。副露判定还支持以 ^、<、> 连接鸣牌的格式。具体格式以插件实际牌型校验为准，格式不合法时会提示“请输入正确的牌型”。

示例

银趴帮助
impart介绍
开启银趴
关闭银趴

文本帮助还支持 银趴介绍、impart帮助；开关支持 开始银趴、禁止银趴、开始impart、开启impart、关闭impart、禁止impart。开关仅限管理员、群主或 Bot 超级用户。游戏数据与 Mai2Help 无关。

示例

pk @群友
对决 @群友

必须 @ 一名其他用户，不能与自己 PK。首次参与时会创建初始长度 10 cm 的个人数据，之后再发一次即可对决。基础胜率为 50%，胜者胜率减少 1 个百分点，败者增加 1 个百分点；胜方增加随机数的一半长度，败方减少该随机数。默认 PK 冷却为 60 秒，挑战期间仍可使用 PK。

示例

打胶
开导
嗦牛子
嗦 @群友
suo @群友

打胶/开导 增加自己的长度；嗦牛子、嗦、suo 有 @ 时增加目标的长度，否则增加自己的长度。目标首次参与时会创建初始长度 10 cm 的数据。默认打胶、嗦牛子各有 300 秒冷却；挑战期间本人不能打胶或嗦，也不能被嗦。

示例

查询
查询 @群友
jj排行榜
牛牛排名

查询 无 @ 时查看自己，有 @ 时查看对方；新用户首次查询会创建 10 cm 的数据。长度在 0～5 cm 会显示 xnn 等提示，长度不大于 0 会显示女孩子，达到 30 cm 显示“牛々の神”。排行榜需要数据库中至少 5 位用户，展示前五、后五及自己的排名。支持 jj/牛牛 加 排行榜/排名/榜单/rank 的组合，例如 牛牛榜单、jjrank。排行榜按全库数据排列，并非仅按当前群。

示例

透群友
透群友 @群友
日群主
透管理

支持 日/透 加 群友/群主/管理 六种组合。群友可用 @ 指定目标；不 @ 时随机抽取，群主和管理按身份选取。默认有互动冷却，Bot 超级用户可以跳过这一冷却。自身长度不大于 0 时会被反透；长度在 0～5 cm 时有 50% 概率被反透。随机抽取时会优先避开配置在白名单中的用户；目标不足时存在回退选择。

示例

注入查询
注入查询 历史
摄入查询 @群友
射入查询 全部

查询自己或 @ 对象的被注入量；默认查询当日。参数含 历史 或 全部 时查询累计量；有至少两天记录时附历史折线图，记录不足时只发文字。

规则

• 长度达到 25 cm、尚未达到 30 cm 时进入“登神长阶”；当前胜率乘以 0.8，只能靠 PK 增长，不能打胶、嗦牛子或被嗦。
• 挑战期间达到 30 cm，完成挑战并获得“牛々の神”称号；胜率乘以 1.25 恢复原先乘数，重新开放打胶和嗦。
• 挑战期间跌破 25 cm，挑战失败；额外减少 5 cm，胜率乘以 1.25，解除限制。
• 完成后再次跌破 25 cm，会额外减少 5 cm 并失去完成状态，之后可以重新挑战。

首次参与会创建 10 cm 的基础数据。状态由 PK、打胶和嗦等操作更新，具体提示会随操作结果出现。

配置项

DJ_CD_TIME     打胶冷却，默认 300 秒
PK_CD_TIME     PK 冷却，默认 60 秒
SUO_CD_TIME    嗦牛子冷却，默认 300 秒
FUCK_CD_TIME   群友互动冷却，源码默认 3600 秒
BAN_ID_LIST    随机互动目标的排除列表
ISALIVE        不活跃惩罚，默认关闭

当前项目的环境配置可以覆盖以上默认值。白名单只影响随机抽取，不保证指定 @ 时屏蔽目标；候选不足时还可能回退。不活跃惩罚启用后，对超过一天未打胶且长度大于 1 cm 的用户施加随机扣减。配置项需要在 Bot 环境文件中修改，不能在聊天窗口发送来生效。

示例

加入 [同时发送图片]
加入

没附图片时 Bot 会询问继续发送。也可回复已有图片再发送加入指令。当前配置默认输出静态效果；加入 -r 可生成旋转 GIF。

示例

加入我
加入自己
加入 @群友

插件会从自己或被 @ 成员的 QQ 头像下载素材；如果消息里已经提供图片，会优先处理图片。

示例

加入 -r [附图片]
加入帮助
join help

当前配置 static_image=True，默认生成静态效果；-r、r、rotate 可改为旋转 GIF。原帮助提到 -s、s、stop，但当前静态默认设置下它们不会触发旋转。加入帮助 由群聊消息触发。

示例

@Bot 我喜欢你

此命令带 to_me() 限制；单独在群里说“我喜欢你”通常不会触发。当前处理器要求群消息事件，并返回一句固定的文字回应。

这项功能没有手动命令。插件逐群记录上一条消息及连续次数，达到配置阈值时发送原消息；图片消息也会按插件自己的匹配规则处理。不同群的计数互不影响。

[│/]help [plugin: str] [function: str]

注释

plugin: 插件序号或名称 function: 插件功能序号或名称 新一代的图片帮助插件

可用的选项有:

• 显示隐藏的插件 -H│--show-hidden

快捷命令: '[│/]帮助 ...args' => [│/]help '[│/]菜单 ...args' => [│/]help

插件监听戳一戳、群荣誉、群文件上传、入群/退群、管理员变动及红包运气王七类事件。大部分无须输入命令，具体是否发送由本群开关决定。

在群里对 Bot 使用 QQ“戳一戳”，插件会按当前群功能状态决定是否回复。管理员可以使用 关闭戳一戳 临时禁用。

示例

event状态
event配置
开启群文件检测
关闭群成员增加检测
开启运气王检测

可切换功能名：戳一戳、群荣誉检测、群文件检测、群成员减少检测、群成员增加检测、管理员变动检测、运气王检测。状态会写入插件的群配置文件。

示例

/yuuzuki
/yuuzuki fortune

旧帮助内容是静态文本，部分舞萌命令已停用或改名，不能作为当前功能的准确说明。发送 /help 会打开 PicMenu 图片菜单；也可发送 帮助 mai2help、帮助 maimaidx、帮助 机厅 等命令打开对应的图片菜单。

示例

/ac help
/ac service ls

ac 命令会解析权限、限流、服务层级及主体。仅超级用户可用；必须写成 ac <子命令>，单独发送 ac 没有子命令。

示例

/ac permission allow --sbj <主体> --srv <服务>
/ac permission deny --sbj <主体> --srv <服务>
/ac permission rm --sbj <主体> --srv <服务>
/ac permission ls

rm 删除一项显式权限，ls 列出已配置权限；ls 可选择添加 --sbj 和 --srv 过滤。服务名可为 nonebot、插件名或 <插件>.<子服务>。建议先通过 service ls 和 subject 查到准确名称。

示例

/ac limit add --sbj <主体> --srv <服务> --limit 5 --span 1h
/ac limit ls
/ac limit rm <规则ID>
/ac limit reset

新规则可带 --overwrite 覆盖冲突配置；ls 可用 --sbj 或 --srv 筛选。reset 会重置当前限流计数，请谨慎使用。

示例

/ac service ls
/ac service ls --srv nonebot_plugin_pixivbot
/ac subject

service ls 列出服务及子服务层级；subject 列出本次发送者的主体标识。将查询结果用于权限或限流规则的 --srv、--sbj 参数。