Mai2Help

用法

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 完整实现、加入结果复查和登出确认后才会开放。