舞萌 Bot（koishi-plugin-maibot）指令说明
一、使用前须知
- 指令前缀：下文均以
/为例，与 Koishi 命令前缀配置一致即可。
二、店铺地址与「优先授权」
2.1 默认购买链接（爱发电店铺）
插件默认在冷却提示、解绑卡引导等场景使用下列链接（可在配置中修改）：
- 优先授权 / 通用店铺：https://store.awmc.cc/
2.2 「优先授权」是什么
在开启 priorityCooldown 时，普通用户使用部分功能会进入冷却；提示文案中的 {shopUrl} 即上节店铺地址。
- 个人优先：兑换个人卡密后，对应账号在全局享受更短或为零的冷却（以配置为准）。
- 群组优先：兑换群组卡密且必须在目标群内兑换；生效后该群成员在本群内使用 Bot 时免冷却（私聊不享受）。
- 管理员绕过：当用户
authority大于adminBypassAuthority（默认 4）时，会绕过冷却，并可能自动同步一条带标记的永久个人优先（权限回落时可被插件清理，与卡密兑换记录无关）。
三、如何兑换卡密
3.1 指令
/mai兑换卡密 <卡密>或先发 /mai兑换卡密，在 Bot 提示的限时内粘贴完整卡密（一般为 MAI- 开头）。
3.2 三种卡密
| 类型 | 兑换环境 | 说明 |
|---|---|---|
| 个人 | 私聊或群均可 | 该绑定账号全局享受优先冷却。 |
| 群组 | 必须在对应群聊内兑换 | 绑定到当前群；群内全体成员在群内使用指令时免冷却。 |
| 解绑 | 私聊或群均可 | 须已执行过 /mai绑定；兑换后为当前绑定增加解绑额度，用于冷却期内的 /mai解绑卡（或别名 maiunbindkey）。 |
3.3 群组优先的后续操作（兑换人）
/mai取消群组优先：在群内取消本群群组优先（仅群组卡兑换人及其跨平台关联账号可操作）。/mai群组优先换绑：在原群发起迁移。/mai群组优先换入：在目标群完成换绑（配合上一条使用）。
若历史数据无兑换人记录，可由管理员使用 /mai管理员取消群组优先 处理。
四、帮助与别名
| 指令 | 说明 |
|---|---|
/mai / /mai帮助 | 查看内置帮助；可加 --advanced 展开发票、收藏品、舞里程等高级功能说明。 |
/mai状态 | 查询绑定与优先授权状态等。 |
/mymai | 与 /mai状态 相同。 |
/mai解绑卡 | maiunbindkey 为别名。 |
/mai解锁 / /mai逃离 | 仅在源码恢复注册锁定相关指令后有效；当前默认构建中锁定类指令见下文「源码中已注释的指令」。 |
五、普通用户指令一览（非管理员）
5.1 账号与连接
| 指令 | 简述 |
|---|---|
/mai绑定 [二维码或链接] | 绑定舞萌 DX 账号（SGID 文本或公众号网页等）。 |
/mai解绑 | 解绑舞萌 DX（受换绑冷却限制时 Bot 会提示解绑卡等）。 |
/mai解绑卡 | 冷却期内凭解绑卡额度解绑（需 SGID 验证与确认）。 |
/mai状态 [目标] | 查自己；高权限可查他人。 |
/maiping | 测试机台连接。 |
/maiqueue | 查询当前队列位置（队列开启时）。 |
5.2 水鱼 B50
| 指令 | 简述 |
|---|---|
/mai绑定水鱼 <token> [目标] | 绑定水鱼 Token。 |
/mai解绑水鱼 [目标] | 解绑水鱼 Token，舞萌绑定保留。 |
/mai上传B50 [二维码或目标] | 上传 B50 到水鱼。 |
/maiua [二维码或落雪码] [目标] | 同时上传 B50 到水鱼与落雪（SGID 可走一次流程）。 |
5.3 落雪 B50
| 指令 | 简述 |
|---|---|
/mai绑定落雪 <代码> [目标] | 绑定落雪代码。 |
/mai解绑落雪 [目标] | 解绑落雪代码。 |
/mai上传落雪b50 [代码] [目标] | 上传 B50 到落雪。 |
5.4 票券、舞里程、收藏品、版本与成绩（/mai --advanced 中亦有汇总）
| 指令 | 简述 |
|---|---|
/mai发票 [倍数] [目标] | 发放功能票（如 2–6 倍，默认 2）。 |
/mai修改版本号 [二维码或目标] | 修改游戏版本号（支持缓存）。 |
5.5 其它
| 指令 | 简述 |
|---|---|
/mai查询opt <titleVer> | 查询 Mai2 选项文件下载地址。 |
/mai兑换卡密 [卡密] | 见第三节。 |
/mai取消群组优先 | 见第三节。 |
/mai群组优先换绑 / /mai群组优先换入 | 见第三节。 |
六、管理员指令
6.1 权限总览
| 类型 | 配置项 / 条件 | 默认值 | 说明 |
|---|---|---|---|
卡密与优先管理、maibypass | authLevelForCardAdmin | 4 | 生成/删除/导出卡密、直接改个人/群组优先、/maibypass 等。 |
| 冷却绕过 + 自动永久个人优先 | authority > adminBypassAuthority | 阈值默认 4 | 不是独立指令，由插件在冷却逻辑中处理。 |
可选 -bypass 的指令以插件内说明为准（用于跳过确认）。
6.2 需要 authority ≥ authLevelForCardAdmin（默认 4）
| 指令 | 简述 |
|---|---|
/mai管理员生成卡密 [时长] [数量] | 无参为交互式；支持 -g 群组卡、-u 解绑卡。快速示例：/mai管理员生成卡密 7d 5、-g 30d 3、-u -1 10。 |
/mai管理员删除卡密 [卡密] | 作废卡密；支持多行或导出 TSV 批量；无参走交互。 |
/mai管理员导出卡密 [范围] | 导出为制表符文本；快速：all / unused / redeemed，无参交互筛选。 |
/mai管理员取消群组优先 [群标识] | 取消指定群或当前群的群组优先。 |
/mai管理员取消个人优先 <目标> | 清除目标用户个人优先记录。 |
/mai管理员设置个人优先 <目标> <spec> | spec 示例：永久、7d、clear 等（与解析实现一致即可）。 |
/mai管理员设置群组优先 <spec> [-g 群标识] | 直接设置群组优先；群内可省略 -g。 |
/maibypass <目标> | 清除目标用户全部指令冷却（别名：/mai管理员清除冷却）。 |
七、交流
- 反馈 QQ 群：请前往 1072033605。
- 官方网站: https://awmc.cc