---
url: https://wiki.awmc.team/guide/bot/advanced.md
---
# AWMC BOT 指令帮助

::: tip 提示
善用搜索快捷键 /（电脑端）或顶部搜索按钮（手机端）进行查询。
:::
::: tip 查分 QQ 绑定（qbind）
发送 `qbind 你的QQ号`，把 QQ 邮箱收到的 6 位验证码发回 Bot 即可，无需先注册论坛；已有论坛账号也可发送 `论坛绑定` 使用 OAuth。完整流程与发送限制见 [使用说明 · qbind](/guide/bot/intro#八、论坛账号绑定-qbind)。
:::

账号绑定、B50 上传、票券、PC 同步、成绩查询与群互动现已合并到同一个 QueryBot。
指令前缀由平台配置决定；下文以不带前缀为例。

::: info 版本与可用性
本页按当前源码整理，未核验生产部署；不代表所有功能均已上线。命令开放状态、价格与限制以实际部署配置及 Bot 提示为准，下文价格为源码默认值。
:::

::: tip 还有 Phigros
Phigros（`phi`）系列指令绑定 TapTap 云存档，可查 B30、资料卡、单曲信息与进步对比，
单独成页：[Phigros 查分（phi）](/guide/bot/phigros)。
:::

***

## 一、账号、上传与 BREAK

开始前请先发送 `用户协议`，打开网页阅读并完整复制确认词。二维码相关指令支持
`SGWCMAID...`、Wahlap `img/MAID...png` 与 `req/MAID...html` 官方链接。

### 1.1 帮助与信息

| 命令 | 说明 |
|------|------|
| `mai账号` | 查看账号功能帮助 |
| `mai状态` / `mymai` | 查看完整账号状态；二维码缓存失效时交互刷新 |
| `舞萌状态` / `mais` | 「服务器失败率」折线图（账号操作全量：发票、maiu 上传、绑定等；`returnCode=0` 计失败；无数据时段省略）+ 服务器实时状态 |
| `maiping` | 测试 AWMC API 连接 |
| `状态页` / `服务状态` / `系统状态` | 查看 AWMC 服务状态页（[up.wmc.pub](https://up.wmc.pub)）上的整体状态、进行中的维护与故障；状态页发布 Bot 维护时，Bot 会自动进入维护模式 |
| `botstatus` / `bot状态` / `机器人状态` / `自检` | 生成 Bot 运行状态图：网络自检（数据库、AWMC API、论坛、水鱼、落雪、别名服务器等）、进程性能、今日收发消息量与时段分布，并附 up.wmc.pub 状态页摘要（详见 [运行状态自检](/guide/bot/botstatus)） |
| `mai上报 <类型>` | 手动向 isMaiDown 上报机台状态：`断网` / `无法登录` / `NET打不开` / `二维码` / `上传失败` / `小黑屋` / `恢复正常` |
| `mai配额` / `配额` / `限额` | 查看 AWMC API 团队配额用量（读取 / 写入、各时间窗） |
| `mai地图` | 查询账号游玩过的省份/地区（服务支持时） |
| `mai查询opt <版本号>` | 查询 Mai2 选项文件下载地址，如 `mai查询opt 1.40` |
| `成绩趋势 [天数]` | 查看 AWMC NET. 服务端 Rating 趋势，默认 30 天（别名 `rating趋势` / `mai趋势` / `awmc趋势`） |
| `公告列表` | 查看最近 10 条公告（普通用户不显示内部公告 ID） |
| `确认阅读公告` | 确认当前必读公告，确认同一版本后不再重复提示 |
| `门攻略 [门名]` / `哪些门` | 列出或获取 Kaleidx 门攻略链接（`kaleidxscope.awmc.team`，含「乱码门」）；直接发送 `蓝色之门` / `白色之门` / … / `最终相` 等门名也会触发 |
| `怎么用` | 消息中包含"怎么用"时自动返回本指令帮助（与帮助入口等效） |

### 1.2 账号绑定

| 命令 | 说明 |
|------|------|
| `mai绑定` / `maibind` | 绑定或认领舞萌 DX 账号；无参数时交互式引导 |
| `mai解绑` | 解绑舞萌账号，保留水鱼/落雪上传配置 |
| `qunbind` / `qunbind 确认` | 查分 QQ / 论坛身份解绑：先查看报价，再确认扣费；按旧查分 QQ 计首次 100、后续每次 200 BREAK，不享 FREEDOM。换绑须先解绑，详见 [qbind](/guide/bot/intro#八、论坛账号绑定-qbind) |
| `nickname [新名字]` | 查看论坛用户名与可改时间，或修改用户名；别名 `论坛改名` / `修改论坛用户名` / `改论坛用户名` / `论坛用户名`。需已关联论坛身份；OneBot 用户请到论坛账户设置修改 |
| `更新pc数` | 使用有效缓存或最新二维码同步 PC 数据 |
| `不同意共享我的数据` | 关闭脱敏成绩 / Rating / 趋势的公开共享（默认开启） |
| `同意共享我的数据` | 重新开启数据共享 |
| `数据共享状态` | 查看当前是否共享脱敏数据 |

### 1.3 水鱼 B50

| 命令 | 说明 |
|------|------|
| `mai绑定水鱼 <Token>` / `maibindfish <Token>` | 绑定水鱼 Token |
| `mai解绑水鱼` | 解绑水鱼 Token，舞萌账号绑定保留 |
| `maiu [二维码或链接]` | 上传 B50 到水鱼 |
| `maiua [二维码或链接]` | 同时上传 B50 到水鱼和落雪 |
| `dfbind` / `绑定水鱼` | 通过 OAuth 绑定水鱼（无需 Import Token） |
| `dfstatus` | 查看水鱼 OAuth 授权状态 |
| `dfunbind` | 解除水鱼 OAuth 授权 |

### 1.4 落雪 B50

| 命令 | 说明 |
|------|------|
| `lxbind` | 通过 OAuth 绑定落雪（推荐，无需提交导入 Token） |
| `lxunbind` | 解绑落雪 OAuth |
| `mai绑定落雪 <导入Token>` / `maibindlx <导入Token>` | 兼容方式绑定落雪导入 Token |
| `mai解绑落雪` | 解绑落雪兼容 Token |
| `maiul [二维码或链接]` | 上传 B50 到落雪，优先使用 OAuth |

### 1.5 BREAK 与票券

::: danger 警告
发票有风险，操作需谨慎。AWMC TEAM 对发票可能造成的负面影响概不负责。

参见 [AWMC BOT 服务协议与隐私政策](/guide/bot/terms#十、免责声明) 第十条。
:::

| 命令 | 说明 |
|------|------|
| `AWMC签到` / `签到` | 签到获取 BREAK；距上次**成功签到满 24 小时**即可再签，不再按 00:00 重置 |
| `AWMC补签` / `补签` | 补昨天签到；每月最多 3 次，依次消耗 30 / 60 / 90 BREAK，不补发奖励 |
| `AWMC帮助` / `BREAK帮助` | 查看 BREAK 系统说明 |
| `我的AWMC` | 查看 BREAK、连续签到和使用统计；含发票成功/失败率与 `returnCode=0`、null/未返回次数；群内自动附带本群猜歌数据图 |
| `BREAK统计` / `BREAK收支` | 查看所有用户今日、近 7 天、近 30 天 BREAK 收入、支出与净变化 |
| `转账BREAK @用户 数量` | 向其他用户转账 BREAK |
| `BREAK抽奖 [1-1000]` | 默认每次消耗 2 BREAK |
| `BREAK抽奖 帮助` | 查看奖池、概率、消耗和示例 |
| `发红包 [总额] [份数]` | 群内发送 BREAK 手气红包（别名 `BREAK红包`）；也可只发 `发红包` 按提示输入 |
| `抢红包` | 领取本群当前红包，每人限一次（别名 `领红包`） |
| `红包状态` | 查看红包领取明细（别名 `红包记录` / `查看红包`） |
| `收回红包` | 发出满 90 秒可主动收回，未领余额退回（别名 `重置红包`） |
| `兑换卡密 [码]` | 兑换 BREAK / 双倍 / FREEDOM / PASS 卡密，支持群内与私聊自动兑换（别名 `redeem` / `兑换码`） |
| `我的卡密` | 查看当前生效的卡密加成（别名 `卡密状态` / `我的加成`） |
| `卡密商店` | 查看管理员配置的外部卡密商店链接；未配置时提示暂未开放 |
| `商店` / `BREAK商店` | 查看内置 BREAK 商店与当前价格 |
| `商店购买 <双倍/FREEDOM/PASS> [数量]` | 用 BREAK 购买加成，别名 `BREAK购买` / `购买`；需先完成 `qbind`。数量默认 1，范围 1～720；双倍 / FREEDOM 按小时、PASS 按次数 |
| `使用PASS` / `用PASS` | 仅查看自动使用说明，不会手动扣卡 |
| `小游戏上限` | 查看小游戏 BREAK 每日上限；已绑定用户同时显示今日进度 |
| `查看加成` / `加成总览` / `加成列表` | 查看当前生效的签到加成（含管理员配置的周期 / 群 / 日期 / 连签活动） |
| `mai发票` / `发票` / `fp <2/3/5>` | 请求 2、3 或 5 倍票；成功按倍率 × 10 BREAK 扣费（20 / 30 / 50）；提交后失败默认罚 100 BREAK，详见下方 |
| `mai查票` / `查票` | 查询有效票券；成功查询 1 BREAK，失败不扣费；按票种、库存及有效期展示，不显示账号 UID |

::: warning 票券计费与处罚
发票提交后失败默认收取 **100 BREAK** 固定罚金；提交前的二维码验证 / 余额检查失败，以及本地 API 配额拒绝，不收该罚金。发现账号仍有未使用倍率票时会拦截发票，另按未使用票券处罚规则收取 **20 BREAK**（`one_time_qrcode` 一次性二维码模式会跳过该库存检查）；上述处罚仅在余额足够时扣除，不扣成负数。不要囤票，已发票券需上机使用。
:::

::: info 商店与下线功能
商店默认单价为双倍 BREAK 卡 **300 BREAK/小时**、FREEDOM **1000 BREAK/小时**、PASS **150 BREAK/次**，管理员可调整，实际以 `商店` 显示为准；购买本身不享受 FREEDOM 免单。PASS 在 AWMC **team 本地 API 配额**耗尽时自动消耗一次放行一个请求，不适用于 public 服务端配额，也不突破小游戏奖励上限。

福利池相关的 `抽奖池` / `贡献榜`、`领取福利` / `领福利`、`贡献总榜` / `首富榜` 已临时下线；与仍可使用的 `BREAK抽奖` 不同。
:::

### 1.6 账号高级操作（计费 / 高风险）

::: danger 警告
`mai改成绩`、`mai删成绩`、`mai改道具` 会直接改动舞萌账号数据，其中
`mai改道具` 未经实际账号测试、可能造成不可逆数据异常，风险由用户自行承担。
参见 [AWMC BOT 服务协议与隐私政策](/guide/bot/terms#十、免责声明) 第十条。
:::

| 命令 | 说明 |
|------|------|
| `mai预览` | 查询账号预览信息（成功查询 5 BREAK，失败不扣费） |
| `mai道具` | 查询账号道具列表（成功查询 5 BREAK） |
| `mai门状态` / `mai查门` / `查门` | 只读展示 Kaleidx Gate 的发现、钥匙与通关状态（成功查询 5 BREAK）。⚠️ 上游 v2-3 已移除该读接口，切换后会提示已移除 |
| `maievent` / `mai活动` / `舞萌活动` | 查询舞萌账号当前活动事件。⚠️ 上游 v2-3 已移除该读接口 |
| `mai改成绩 [歌曲 难度 达成率 DX分 FC FS]` | 交互或一步编辑成绩；DX 分填 0～5 为星级简单模式，填实际分自动切专业模式；支持换行/分号分隔一次最多 20 条；成功 258 BREAK / 谱面 |
| `mai删成绩 [歌曲 难度]` | 交互或一步删除成绩；同样支持批量；成功 50 BREAK / 谱面 |
| `mai改道具 [itemKind itemId add/del]` | 高风险道具修改；成功扣 100 BREAK；Bot 不开放批量 upsert-all |
| `mai改资料` / `资料修改` / `改资料` | **账号编辑集合**：一键全解歌、批量编辑、14 项资料修改与上传会话查询的总入口（详见[指令调用说明](/guide/bot/commands#八、账号编辑与批量操作-v2-3)） |
| `mai批量编辑` / `批量编辑` / `批量改` | 一次对话收集多项修改（可跨类型），串行执行；整批默认 1500 BREAK，至少一项确认成功扣一次，已扣费续跑不重复收费；未经测试，非常不推荐 |
| `mai全解锁 [music/master/remaster] [版本ID]` | 一键解锁乐曲 / MASTER / Re:MASTER（已拥有自动跳过）；默认成功 1500 BREAK / 次；未经测试，非常不推荐 |
| `mai改门` / `mai改rating` / `mai改里程` / `mai改地图库存` / `mai改游玩次数` | v2-3 资料修改；每项成功 50 BREAK（参数可直接输名称） |
| `mai改段位` / `mai改阶级` / `mai改搭档` / `mai改角色` / `mai改亲密度` | v2-3 资料修改；每项成功 50 BREAK |
| `mai重置版本` | v2-3 版本重置；成功 50 BREAK |
| `mai完成地图` / `mai推进地图` / `mai改登录奖励` | 因上游保存验证持续失败（5006）临时停用，单独命令与批量编辑均不可用 |
| `查进度` / `查任务` | 免费查询自己的上传、批量任务与后台同步进度；别名 `mai查任务` / `查上传任务` / `查会话`。管理员可附 `<session_id>` 精确查询 |

::: danger 批量功能风险
`mai批量编辑` / `mai全解锁` 未经测试，非常不推荐使用：上游最长可能处理约 **30 分钟**，很有可能卡死。超时或结果未确认时请先 `查进度`，确认未生效前不要重复提交。详情见[账号编辑与批量操作](/guide/bot/commands#八、账号编辑与批量操作-v2-3)。多谱面成绩编辑 / 删除仍按谱面计费，不适用整批一口价。
:::

::: tip 快速更新与自动更新
`导` / `u` / `更` / `更新`（或 `mai对手同步`）无需扫码快速同步成绩；`mai自动更新 [小时]` 默认开启 3 小时，默认每小时 30 BREAK、每 15 分钟同步一次，最多 12 小时，确认后预扣。`查自动更新` 查看状态，`自动更新关闭` 提前关闭且不退款。

需先 `mai绑定`；水鱼 / 落雪仅支持 OAuth 授权。快速 / 自动更新不补 FC/FS 与 PC 数据，完整更新仍需扫码。价格、间隔及开放状态以 Bot 实际配置为准，详见[快速更新与自动更新](/guide/bot/commands#quick-update)。
:::

### 1.7 AI 生图

| 命令 | 说明 |
|------|------|
| `画图 <描述>` | 根据文字生成图片；默认消耗 358 BREAK，失败会退回预扣 BREAK |
| `画图 <描述> -p` / `--reference` | 图生图模式，先发送命令，再按提示发送参考图 |
| `画图 <描述> -q auto` | 指定图片质量；当前仅支持 `auto` |

* 也可以在同一条官方 QQ 消息中 `@机器人`、附上图片并发送 `画图 <描述>`。
* 提示词最长 4000 字符；参考图默认不超过 8 MB，支持 PNG、JPEG、WebP。
* 生图前会先进行内容审核和本地敏感内容拦截；违法违规、敏感政治、未成年人色情等请求会直接拒绝，不扣 BREAK。模型服务仍会执行上游安全审核。
* 官方 QQ 图片附件会校验实际图片内容；即使 QQ CDN 返回异常的 `Content-Type`，只要图片数据有效仍可读取，图片地址安全检查仍然生效。

***

## 二、查询与群互动

> 以下收录查询 Bot 普通用户指令；不含管理员指令。高级变体、数据分析与群管功能见 [2.12 高级功能](#_2-12-高级功能)。

### 2.1 基础

| 指令 | 说明 |
|------|------|
| `帮助maimaiDX` | 查看帮助图 |
| `项目地址maimaiDX` | 查看项目信息 |
| `今日mai` | 今日运势与推荐曲目 |
| `主题` | 查看或切换成绩图主题 |
| `查看排名` | 查看全服 Rating 排行 |
| `我的排名` | 查看自己的 Rating 排名 |
| `赞助` / `赞助榜` / `本月赞助` | 查看本月赞助榜（金额默认隐藏，详见 [赞助支持](/sponsor)） |

**选哪个**：群里直接说「`吃拉面还是米饭`」「`是去 A 还是 B`」「`吃 A 还是 B 还是 C 呢？`」
（2～4 个选项），Bot 会随机替你定一个，回复带抽中的结果与候选清单。`还是` 表示
「仍然 / 依旧」的句子不会误触发（如 `我还是不去了吧`、`天还是那么蓝`）。选项里出现
敏感词时改发不含选项原文的版本：`# 🎲 🎯 就决定是你了：第 N 个`。

### 2.2 曲目查询

| 指令 | 说明 |
|------|------|
| `查歌 <关键词>` | 按曲名 / 别名搜索 |
| `查图` | 从机台照片、截图或曲绘识别曲目；别名 `识图查歌` / `图片查歌` / `截图查歌`。同条附图、回复图片或按提示补图均可 |
| `下载曲目 <歌曲ID>` | 返回下载站收录的 ZIP / ADX / 谱面 / 音源链接；别名 `下载谱面` / `search download`。未收录或连接失败会提示 |
| `定数查歌 <定数>` | 按定数搜索 |
| `等级查歌 <等级>` | 按等级搜索，如 `等级查歌 13+` |
| `谱式查歌 <SD/DX>` | 按谱式搜索；`标准`、`dx` 等写法都认 |
| `分类查歌 <分类>` | 按分类子串搜索；没命中时会列出全部可选分类 |
| `版本查歌 <版本>` | 按版本搜索，如 `版本查歌 舞萌DX 2024` |
| `拟合定数查歌 <值/范围>` | 按展示精度（2 位小数）匹配拟合定数，别名 `拟合查歌` |
| `bpm查歌 <bpm>` | 按 BPM 搜索 |
| `曲师查歌 <曲师>` | 按曲师搜索 |
| `谱师查歌 <谱师>` | 按谱师搜索 |
| `试听 <歌曲ID>` | 试听片段（约 60 秒，从约 20% 处切入；首次现裁并缓存） |
| `<别名>是什么歌` | 通过别名查曲目 |
| `id <歌曲ID>` | 查看歌曲详情 |
| `谱面<ID><难度>` | 谱面预览，难度：绿 / 黄 / 红 / 紫 / 白 |
| `提取曲绘 <歌曲ID>` | 提取曲绘图片 |
| `mai什么` | 随机推荐一首曲目 |
| `mai什么推分` | 随机推荐适合上分的曲目 |
| `来个<等级>` | 随机推荐指定等级曲目 |
| `来个dx<等级>` / `来个sd<等级>` | 随机 DX / 标准曲 |
| `来个<难度><等级>` | 随机指定难度与等级，如 `来个紫14+` |

::: warning 查图与下载限制
查图支持 PNG / JPEG / WebP，图片最大 12 MiB，同一用户冷却 8 秒；识别不确定时返回候选。高置信结果直接生成歌曲详情，按搜索计费：默认功能费 **1 BREAK + 出图费 1 BREAK**，每日首查、FREEDOM 等减免以 Bot 实际结算为准，不是无条件免费。

查图与下载均受本群搜索开关限制，猜歌期间禁止使用；下载入口当前没有单独扣费逻辑。识别结果仅供参考。
:::

::: tip 查歌速查行
`查歌` 的介绍图后面会跟一条**速查行**：曲师 / 谱师 / 分类 / 版本 / 谱式 / BPM /
等级 / 定数 / 拟合定数逐项列出，按难度展开的行带难度色块。在官方 QQ 群里，
速查行里的每个值都是**可点蓝字**——点一下就把对应的查询指令（`曲师查歌`、
`版本查歌`、`等级查歌`……）填进输入框；同时附一个「🎵 试听」按钮。
OneBot 与兼容模式降级为纯文本（信息保留、不可点），试听可用 `试听 <歌曲ID>`。
:::

### 2.3 别名

| 指令 | 说明 |
|------|------|
| `<曲名>有什么别名` | 查看曲目别名 |
| `id<歌曲ID>有什么别名` | 按 ID 查看别名 |
| `添加别名 <ID> <别名>` | 申请为曲目添加别名 |
| `添加本地别名 <ID> <别名>` | 添加仅本 Bot 生效的本地别名 |
| `同意别名 <Tag>` | 对别名申请投票 |
| `当前投票` | 查看进行中的别名投票 |

### 2.4 成绩查询

| 指令 | 说明 |
|------|------|
| `b50` | 查询 B50 成绩图 |
| `ab50` | 查询全部最佳 50 首 |
| `刷新b50` | 强制刷新成绩缓存 |
| `同步b50` | 将水鱼/落雪成绩明确同步写入 AWMC NET.（需确认） |
| `合作b50` | 两人合作 B50 对比 |
| `合作a50` | 两人合作全部最佳 50 对比 |
| `我有多菜` | Rating 对比图 |
| `我在群里有多菜` | 群内 Rating 对比 |
| `minfo <歌曲ID/曲名/别名> [@用户]` | 查询自己或指定用户的单曲成绩信息 |
| `ginfo [绿/黄/红/紫/白]<歌曲ID/曲名/别名>` | 查询谱面的全局样本统计（不是群组统计），默认紫谱 MASTER |
| `分数线 <绿/黄/红/紫/白><歌曲ID> <目标达成率>` | 例如 `分数线 紫799 100`；目标填大于 0、小于 101 的数字，不带 `%`；`分数线 帮助` 查看说明 |
| `友人对战` | 群内随机友人对战（可加数字收紧 Rating 差，如 `友人对战 300`） |
| `友人对战排行` | 群内友人对战战绩排行（别名 `友人排行` / `友人对战排名`） |
| `b50鸟加率` / `B50鸟加率` / `b50鳥加率` / `b50鸟+率` | 查看 B50 鸟加率统计（文字列表） |

#### 群单曲排名

| 指令 | 说明 |
|------|------|
| `<曲名>排名` | 群内该曲成绩排名 |
| `我的<曲名>排名` | 自己在群内的该曲排名 |
| `<曲名>排名 <N>` | 查看前 N 名 |

支持在曲名前加难度，如 `白潘排名`、`我的白潘排名`。

### 2.5 定数表 / 完成表 / 进度

| 指令 | 说明 |
|------|------|
| `<等级>定数表` | 等级定数表，如 `13+定数表` |
| `<等级>完成表` | 等级完成表，如 `13+ap完成表` |
| `<牌子>完成表` | 牌子完成表，如 `晓极完成表` |
| `<牌子>进度` | 牌子进度，如 `晓极进度` |
| `<等级><达成>进度` | 等级进度，如 `13+sss进度` |
| `<等级><牌子>进度` | 等级牌子进度，如 `13将进度`、`14+极进度` |
| `段位表 [段位]` | 段位认定课题图；默认 PRiSM PLUS，如 `段位表 真二段`，可 @ 用户 |
| `<段位>段位表` | 段位认定课题图的反向写法，如 `真二段段位表` |
| `我要上<分数>分` | 吃分推荐（多路线版，见 2.12 的「吃分推荐（多路线）」） |
| `我要在<等级>上<分数>分` | 指定等级的吃分推荐 |
| `<等级>分数列表` | 该等级分数列表 |
| `新歌列表` | 当前版本新曲列表：按难度 / 等级 / 谱面类型 / 游玩状态筛选，可 @ 他人（别名 `新曲列表` / `B15列表`） |
| `新曲统计` | 新曲完成度、平均 RA 与可推分曲目（别名 `新歌完成度` / `B15统计` / `b15统计`） |

达成标记支持：`ap` `fc` `fcp` `fs` `fsp` `ss` `sss` `sync` 等。

::: tip 用法示例（新曲）
`新歌列表 紫 13+`、`新歌列表 DX 未游玩`、`新歌列表 13.5`；同一功能按「当前版本」口径
（即 B15 口径）统计，与历史版本筛选（`镜代b50` 等）不同。
:::

::: tip 段位表样本
段位认定图会展示 LIFE 规则、课题曲等级/定数、个人最高达成率、匿名样本量、均值、中位数、P25-P75 分布和 SSS 率。样本来自服务器近期已同步且未关闭数据共享的成绩；低样本、冷启动或聚合失败时会回退到内置样本。页脚会标明数据来源，段位通过与否仍以机台结算为准。
:::

### 2.6 猜歌

::: info 私聊触发小游戏
如需游玩猜歌、猜谱面等群游戏，请在私聊中按提示加入 [2 群（游戏群）993795066](https://qm.qq.com/q/PF5t1VXPi0) 后再发起（1 群为保证交流体验不解锁小游戏）。
:::

| 指令 | 说明 |
|------|------|
| `猜歌` | 文字猜歌 |
| `猜曲绘` / `猜曲绘1`～`猜曲绘4` | 曲绘猜歌，可指定 1～4 级难度 |
| `猜曲子` | 音频猜歌 |
| `猜铺面` / `猜谱面` | 谱面视频猜歌（前段静音、曲末带 BGM；带正解音与倒计时） |
| `猜Rating` | 随机选择 1～4 级难度，60 秒内猜匿名 B50 的总 Rating |
| `猜Rating1`～`猜Rating5` | 指定难度；数字越大，展示卡片和辅助信息越少 |
| `猜Rating3 90` | 指定 3 级难度，并把作答时间改为 90 秒（可设 30～300 秒） |
| `重置猜rating` | 强制结束当前猜 Rating 对局 |
| `找内鬼` / `找假卡` | 从 5 张卡片中找出不属于题主 B50、来自另一位群友的一张 |
| `重置找内鬼` | 强制结束当前 B50 找内鬼对局 |
| `舞萌极限二选一` / `极限二选一` / `二选一` | 参加 5 轮左右曲目比较的极限二选一；每轮发送 `左` 或 `右` 作答 |
| `加入` / `参赛` | 加入当前极限二选一对局 |
| `重置二选一` | 强制结束当前极限二选一对局 |
| `你想我猜` / `20问猜曲` | Milk 心里想一首曲目，群友用「是/否」提问缩小范围并猜曲名；问得越少分越高，可叠加连击与加倍卡 |
| `重置你想我猜` / `重置20问` | 强制结束当前你想我猜对局 |
| `maidle` / `舞萌dle` | 舞萌 Dle：全群一起猜一首歌，每次作答回一张七项对比提示板；`maidle 困难` 不给曲名首字 / 曲绘提示 |
| `猜 <曲名/别名/#ID>` / `dle <曲名>` | maidle 对局中作答（全群共 10 次机会） |
| `重置maidle` / `结束maidle` | 结束当前 maidle 并揭晓答案；`maidle帮助` 查看规则 |
| `猜群友` | 题面给三位群友，猜谁在这张谱面上达成率最高；15 秒内每人限一注，答案对错都静默，到点统一开牌 |
| `重置猜群友` | 强制结束当前猜群友对局 |
| `重置猜歌` | 强制结束当前文字猜歌对局（群内） |
| `查看已有信息` / `查看提问列表` / `20问进度` / `提问列表` | 查看本局你想我猜的问答记录 |
| `舞萌开字母` / `开字母` | 多曲标题开字母看板（默认 8 首）；对局中直接发字母或别名，也可用 `开歌`；通关后计时结算 |
| `开字母排行` / `开字母积分榜` | 本群开字母结算积分榜（图片） |
| `开字母贡献榜` | 本群开字母贡献权重榜（图片） |
| `开字母时间榜` | 本群最佳通关用时榜（图片，含头像） |
| `开字母文字模式` / `文字模式` | 当前或下一局开字母使用纯文字看板 |
| `开字母图片模式` / `图片模式` | 当前或下一局开字母使用图片看板 |
| `开字母自动模式` / `自动模式` | 恢复按人数和负载自动选择开字母看板模式 |
| `查加倍卡` | 查看自己的加倍卡 |
| `猜歌积分排行` | 本群总积分排行 |
| `本群猜歌排行` | 查看本群猜歌参与与积分排行 |
| `猜歌积分日榜` / `猜歌积分周榜` / `猜歌积分月榜` / `猜歌积分年榜` / `猜歌积分赛季榜` | 本群各周期积分榜 |
| `猜歌历史日榜` / `猜歌历史周榜` / `猜歌历史月榜` / `猜歌历史年榜` / `猜歌历史赛季榜` | 本群历史周期榜 |
| `全服猜歌排行` / `全服猜歌总榜` | 全服猜歌总积分榜（文字） |
| `全服猜歌日榜` / `全服猜歌周榜` / `全服猜歌月榜` / `全服猜歌年榜` / `全服猜歌赛季榜` | 全服各周期积分榜（文字） |
| `我的猜歌` / `猜歌数据` / `猜歌统计` | 个人猜歌数据图：玩法近 30 日趋势 + 积分/次数占比环图 + 各玩法卡片与近期明细；可 `我的猜歌 @某人` 查对方 |

::: tip BREAK获取
小游戏每日 BREAK 上限：全局合计 **50** / 天；单游戏 猜歌/猜曲绘/猜曲子/猜铺面/你想我猜 各 20，
开字母/猜Rating/找内鬼 各 15，maidle 20，极限二选一 10，猜群友 50。单游戏到顶后该游戏不再发，
全局到顶后所有小游戏不再发，次日 0 点重置；双倍BREAK卡生效期间翻倍发放并豁免上述上限。发送 `小游戏上限` 查看当前配置与个人进度。
:::

::: tip 我的猜歌数据

* 玩法：猜歌 / 猜曲绘 / 猜曲子 / 猜铺面 / 开字母 / 猜 Rating / 找内鬼 / 二选一 / 你想我猜 / 猜群友
* 图内含：近 30 日趋势、自适应玩法卡片、积分/次数占比环图、近期明细；结算后实时更新
* `@某人` 可看对方本群数据，例如 `我的猜歌 @张三`；无 at 仍查自己
* 群内发送 `我的AWMC` 会自动附带本群猜歌数据图（失败不影响账号状态主流程）
  :::

::: tip 舞萌开字母
需先由群管发送 `开启mai猜歌`；与猜歌 / 曲绘 / 曲子 / 铺面**同群互斥**。

* 对局中直接发单个字母（如 `m`）开字符，或发曲名/别名猜中；也可 `开字母 m`、`开歌 xxx`
* 字母补齐完整标题时记入补齐者贡献（✅ 字母补齐）
* **局内不计分、不发 BREAK**；全部解开后按**用时星级 + 个人贡献**统一结算
* 用时精确到毫秒，展示为 `xx.xxx秒`
* **星级（自适应）**：默认 ≤30 / 45 / 60 / 90 / 180 秒对应 5～1 星；群内最近通关变快后，按历史用时 P35 收紧五星上限（最低 15 秒、最高仍 30 秒），其它星按 1 : 1.5 : 2 : 3 : 6 相对五星缩放；更慢为 0 星最低奖池。结算文案会显示本局生效阈值
* **贡献权重**：有效开字母 ×1、补齐曲 ×3、开歌 ×4；无贡献不得分；奖池按权重分配
* **限时×3**：活动一周内结算分数与 BREAK 三倍，文案/榜图标注「限时×3」；过期自动恢复 1 倍
* 通关结算顺序：① 猜中/补齐文案 + 用时星级 + 奖池 ② 本局榜单·贡献分成图 ③ 全开看板图；亦可随时查 `开字母排行` / `开字母贡献榜` / `开字母时间榜`
* **人多文字模式**：贡献人数或短时突发达阈值时，局中看板降级为纯文字；通关结算仍强制出图
* 非高峰另有 **2.5 秒/人**冷却（与下方猜歌全局限频独立）；进入文字模式后跳过
* `不玩了` / `结束开字母`：结束并揭晓剩余，**不发**速度奖与贡献奖（不用通关奖池文案）
  :::

::: warning 答题限流
同一用户全局 **2.5 秒**只能提交一次答案（猜歌 / 曲绘 / 曲子 / 铺面 / 猜 Rating / 找内鬼 / 猜群友）；
具体间隔以 Bot 提示为准。超限时提示：

`嘿嘿，你的答案被我吃掉啦！(x.x秒后才能发送新的答案）`
:::

::: tip 猜 Rating
需先由群管发送 `开启mai猜歌`；与其它猜歌玩法及开字母 **同群互斥**。

* 随机选一位群友 → 按难度隐藏其 B50 身份和成绩 → 60 秒内发数字猜 Rating → 可修改答案 → 最接近者获胜
* `猜Rating` 随机难度（1～4）；`猜Rating1`～`猜Rating5` 指定难度；可在后面附加 30～300 秒作答时间，例如 `猜Rating3 90`
* 被抽中的题主不能提交有效答案，也不会进入排名或获得奖励
* 结算：倒计时结束 → 揭晓真实 Rating + 昵称 → 发放积分 / BREAK → 展示完整 B50 图

**分级条件与前三名奖励**：

| 难度 | 展示/隐藏 | 🥇 | 🥈 | 🥉 |
|------|-----------|----|----|----|
| 1 | 20 张；保留成绩等级、FC/FS | 15分 + 2 BREAK | 5分 + 1 BREAK | 3分 |
| 2 | 16 张；隐藏 FC/FS | 18分 + 2 BREAK | 6分 + 1 BREAK | 4分 |
| 3 | 12 张；再隐藏成绩等级 | 21分 + 2 BREAK | 7分 + 1 BREAK | 5分 |
| 4 | 8 张；仅保留最少识别信息 | 24分 + 2 BREAK | 8分 + 1 BREAK | 6分 |
| 5 | 4 张；几乎无辅助信息 | 30分 + 2 BREAK | 10分 + 1 BREAK | 7分 |

其余有效参与者固定获得 1 积分。BREAK 奖励与难度无关：冠/亚固定 2 / 1 BREAK，季军仅得积分；有效参与（不含题主）满 3 人且冠军误差 ≤ 200 时才发放。
:::

::: tip B50 找内鬼
需先由群管发送 `开启mai猜歌`；与其它猜歌玩法及开字母 **同群互斥**。

* 题面混入题主的 4 张 B50 卡片和另一位群友的 1 张卡片；内鬼歌曲不在题主 B50 中，并非篡改 RA
* 45 秒内发送 `1`～`5` 作答，可以修改；速度排名按最终答案的提交时间计算
* 题主和内鬼卡片的原主人均不能提交有效答案，也不会进入奖励名单
* 答对第一名获得 10 积分 + 2 BREAK，第二名 6 积分 + 1 BREAK，第三名及后续答对者 3 积分
* 有效提交人数（排除题主和内鬼本人）至少 3 人才发 BREAK；不足时仍按规则发积分
* 结算时标出内鬼卡片并揭晓题主与内鬼身份
  :::

::: tip 极限二选一
需先由群管发送 `开启mai猜歌`；发 `极限二选一` 开局后，发送 `加入` 或 `参赛` 报名。

* 共 5 轮，每轮比较左右两首歌曲的随机指标，参赛者发送 `左` 或 `右` 作答
* 每轮按正确与否累计分数，结束时统一结算并展示揭晓图
* 揭晓图会在谱面定数旁明确标注：绿 Basic、黄 Advanced、红 Expert、紫 Master、白 Re:MASTER
* `重置二选一` 可由管理员或发起者强制结束当前对局
  :::

::: tip 你想我猜（20 问猜曲）
需先由群管发送 `开启mai猜歌`；与其它猜歌玩法及开字母 **同群互斥**。

* 发送 `你想我猜` / `20问猜曲` 开局，Milk 心里想一首舞萌曲目
* 群友直接发送「是/否」类问题（如「是不是紫谱」「定数大于 14 吗」），由 LLM 理解并回答；也支持比较词、区间与分类/谱师/版本等条件
* 可随时直接猜曲名；输入 `查看已有信息` / `20问进度` 查看本局问答记录，`重置你想我猜` 强制结束
* 猜错不结束、超时公布答案；问得越少分越高，积分可叠加连击与加倍卡
  :::

::: tip 猜群友
需先由群管发送 `开启mai猜歌`；与其它猜歌玩法 **同群互斥**。

* 发 `猜群友` 开局：题面给出**三位群友**和一张谱面，猜谁在这张谱面上的达成率最高
* **每人只能交一注**：作答期间题板不会透露对错，重复作答只回一句提示；15 秒后**统一开牌**
* 结算：按选项归并所有作答者，答案选项标 ✅；押对者逐人入账（最早押中的一注按首答 ×2，
  连击口径与其它玩法一致），每押中一胜固定 +1 BREAK（`groupmate_break_per_win` 可调；
  积分倍率与加倍卡**不放大** BREAK）
* 未完成 qbind 的游客也可参与并计入榜单，只是不发 BREAK
* 出题会避开本群最近出过的谱面，且只出 Expert 及以上难度；`重置猜群友` 强制结束本局
  :::

::: tip 舞萌 Dle（maidle）
需先由群管发送 `开启mai猜歌`；与其它猜歌玩法及开字母 **同群互斥**。玩法类似 Wordle：

* 发 `maidle` 开局，从全曲库（不含宴会场）出一首歌；对局中再发一次 `maidle` = 重发提示板
* 发 `猜 曲名`（也可 `猜 别名`、`猜 #ID`）作答，每次作答对比 **7 项**：版本 / 分类 / BPM / 曲师 / 紫谱定数 / 类型 / 谱师
  * 🟩 绿 = 一致；🟨 黄 = 接近（版本相邻、BPM ±10、定数 ±0.5、曲师 / 谱师有人重合）
  * ▲ / ▼ = 答案比你猜的更新 / 更高，或更旧 / 更低
* **全群共 10 次机会**，同一人两次作答至少间隔 6 秒；找不到的曲名、多义别名、已经猜过的歌不消耗次数
* 普通模式：错 6 次后提示曲名首字，只剩最后一猜时再给模糊曲绘；`maidle 困难` 没有这些提示
* 越早猜中分越高：第 1 猜 12 分 → 第 10 猜 2 分，困难模式每档 +3；猜中者另得猜对 BREAK
* 有人猜中时，其他有效作答过的玩家各得**协助奖励** 2 分 + 1 BREAK；没人猜中则不发
* 约 4 分钟无人作答自动结束并揭晓；`重置maidle` 可提前结束
  :::

### 2.7 PC 数

| 指令 | 说明 |
|------|------|
| `更新pc数` | 绑定机台二维码并同步 PC 数；完成后会提示可用指令 |
| `我的pc数` | 查看个人 PC 数统计（总次数 + 游玩最多的 15 首） |
| `pc排行` / `pc全部排行` / `PC全部排行` | 全部已同步用户的 PC 总量排行（文字列表，标题为「PC全部排行（共 N 人）」） |
| `pc数 <歌曲>` | 查看指定曲目 PC 数 |
| `pc50` | 已同步机台全量 PC 记录中游玩最多的 50 张谱面，不限于 Rating B50；图中 B35/B15 仅为排版分区 |
| `<分类>pc50` | 按曲风筛选 PC 前 50：`术力口pc50` / `东方pc50` / `舞萌pc50` / `其他pc50` / `中二pc50` / `流行pc50` / `宴谱pc50` |
| `<等级>pc50` | 按当前等级筛选 PC 排行，例如 `13pc50` / `14+pc50`；可 @ 用户 |
| `pc等级 [等级]` | 只看指定等级（1～15，可带 `+`，需曲库存在）的谱面 PC 排行；不带参数时给出用法与快捷按钮（别名 `等级pc` / `PC等级`） |
| `pca50` | B50 内按 PC 排序（Rating B50 的 50 首重排，输出图片） |
| `游玩排行50` / `游玩PC50` / `PC游玩50` / `pc游玩50` | 全库游玩最多的 50 首谱面（不限于 Rating B50，输出图片） |

#### 命令对比

| 命令 | 作用 |
|------|------|
| `游玩排行50` | 全库游玩最多的 50 首（输出图片） |
| `pca50` | 你 Rating B50 内的 50 首，按 PC 重排（输出图片） |
| `pc排行` | 全用户 PC 总量排行（输出文字） |

::: info 说明
`游玩排行50` 为避免与 `pc排行` 前缀冲突，未命名为 `pc排行50`。例如 `sølips`（137 次）、`Believe the Rainbow`（120 次）等高频曲目会出现在游玩排行图中，即使不在你的 B50 内。
:::

### 2.8 数据源与落雪查分器

| 指令 | 说明 |
|------|------|
| `数据源` | 查看当前数据源（新用户默认为 AWMCNET） |
| `数据源 AWMCNET` / `数据源 水鱼` / `数据源 落雪` | 切换个人数据源 |
| `成绩趋势 [天数]` | 查看 AWMC NET. 服务端 Rating 趋势（别名 `rating趋势` / `mai趋势` / `awmc趋势`） |
| `lxbind` | 绑定落雪查分器（OAuth） |
| `lxunbind` | 解绑落雪查分器 |
| `lxb50` | 使用落雪数据源查询 B50 |

::: info 说明
AWMC NET. 是默认成绩库，发送一次 `SGWCMAID` 即可查分，无需绑定水鱼/落雪。
B50 系列按用户偏好自动走 AWMCNET/水鱼/落雪；部分功能（拟合、含金量等）落雪不支持时会回退水鱼。
:::

### 2.9 谱面印象

| 指令 | 说明 |
|------|------|
| `谱面印象 <曲目>` | 查看谱面印象 |
| `写谱面印象 <曲目> ` | 上传谱面印象 |
| `谱面排行` / `谱面热度` | 查看谱面印象热度排行 |

::: tip 提示
使用 `查歌`（ID 或别名）查询时，会**自动附带**谱面印象、标签、定数变化、预览链接等合并转发。
:::

### 2.10 AWMC BREAK

| 指令 | 说明 |
|------|------|
| `AWMC签到` | 签到获取 BREAK；距上次成功签到满 24 小时即可再签 |
| `我的AWMC` | 查看账号状态与使用统计（含发票 returnCode 统计）；群内附带猜歌数据图 |
| `AWMC帮助` | 查看 BREAK 系统说明 |
| `转账BREAK @用户 数量` | 向其他用户转账 BREAK |
| `BREAK抽奖 [1-1000]` | 默认每次消耗 2 BREAK，可一次抽 1～1000 次 |

::: tip BREAK 食用说明

有修改建议请前往 [AWMC 论坛](https://bbs.wmc.pub/forums/awmc.19/) 提出。接入 AI 后会自动修改机器人并更新。

1. 签到可以获得 BREAK（距上次**成功签到满 24 小时**即可再签），连续签到可以获得更多 BREAK。
2. 锐评按实际 Token 用量计费（基础价最低 3、最高 30 BREAK；LLM 峰时 ×2），调用前预扣 14 BREAK，成功后多退少补，失败全退。
3. 可以使用 BREAK 抽奖，最多支持 1000 连抽。
4. 普通猜歌成功默认获得 1 BREAK；猜 Rating / 找内鬼按本局排名与难度结算。
5. 「今日舞萌」会根据人品值增加 BREAK。
6. 和群主谈情说爱，可能会获得一些 BREAK。

:::

> 查分指令每日首次实际请求查分器 API 免费，之后每次扣 1 BREAK（缓存命中不扣）。
> 普通猜歌每次猜对默认获得 1 BREAK；猜 Rating / 找内鬼按玩法规则结算。成绩上传在外部操作成功后结算，每日首次成功免费。
> 发票成功按价收费，实际提交后失败默认罚 100 BREAK；未用票券拦截等特殊情况见[票券计费与处罚](#_1-5-break-与票券)。

### 2.11 课表

课表功能支持导入课程 JSON、查看个人或群组课表，并可导出当前课表。

| 命令 | 说明 |
|------|------|
| `课表帮助` | 查看课表功能帮助（别名：`classtable帮助` / `ct帮助` / `课表菜单`） |
| `导入课表` | 上传课表 JSON 文件并导入（别名：`ct导入` / `导入我的课表`） |
| `今天课表` / `明天课表` / `后天课表` / `昨天课表` | 查看对应日期课表 |
| `本周课表` | 查看本周个人课表（别名：`本周课程` / `ct周`） |
| `群课表` / `明天群课表` | 查看群内成员汇总课表或明日群课表 |
| `我的课表` | 查看课表状态（别名：`ct状态` / `课表状态`） |
| `查课表` | 按日期或关键词查询课表（别名：`ct查`） |
| `删除我的课表` | 删除已导入的个人课表（别名：`ct删除` / `课表删除`） |
| `导出我的课表` | 导出个人课表（别名：`课表导出` / `ct导出`） |
| `<YYYY-MM-DD>课表` | 查询指定日期课表，例如 `2026-09-08课表` |

### 2.12 高级功能

以下为查询 Bot 的进阶指令与变体，日常使用可跳过。

#### 成绩图变体

| 命令 | 说明 |
|------|------|
| `紫b50` / `白b50` / `Master b50` 等 | 按谱面难度筛选 B50（紫=Master，白=Re:MASTER） |
| `三星b50` / `四星b50` | 按成绩 DX 星数筛选 B50（分别为 3 星、4 星） |
| `3b50` / `4b50` / `13+b50` | 按等级/定数筛选 B50；数字等级与“三星/四星”星数筛选不是同一条件 |
| `紫13+b50` / `14.0b50` / `13-14b50` | 组合筛选谱面难度与等级/定数；也支持 `Basic`、`Master`、`Re:MASTER` 等英文难度名 |
| `<筛选条件>ab50`（如 `13+ab50`） | 与 `<筛选条件>b50` 相同，但不按 B35/B15 分组，直接从筛选结果中取 Rating 最高的 50 首 |
| `紫ab50` 等 | 按难度筛选 ab50 |
| `镜代b50` 等 | 按版本代筛选 B50 |
| `l镜代b50` / `l爽代b35` 等 | 历代版本定数重算 B50/B35 |
| `dx2026b35` | 彩代 B35 |
| `dx2025b50` | 使用 2026-06-09 本地存档和 PRiSM 定数重算 2025 版 B35/B15 |
| `fcb50` / `fcallb50` | FC 向 B50 |
| `apb50` / `apallb50` | AP 向 B50 |
| `拟合b50` / `拟合b50全部` | 按拟合定数排序 |
| `寸b50` / `寸ab50` | 寸止（踩评级线）成绩 |
| `锁血b50` / `锁血ab50` | 锁血（踩评级下限）成绩 |
| `越级b50` / `越级ab50` | 越级成绩 |
| `理想b50` / `理想ab50` | 评级升一档后的理想 B50 |
| `含金量` / `含水量` | 成绩含金量/含水量分析图 |
| `锐评风格 查看` | 查看当前保存的 B50 锐评风格 |
| `锐评风格 设置 <描述>` | 保存自定义 B50 锐评口吻 |
| `锐评风格 重置` | 清除自定义锐评风格 |

#### 分析 / 推分 / 对战

| 主命令 | 别名 | 用法示例 | 说明 |
|--------|------|----------|------|
| `弱项处方` | `弱项处方单` `底力处方` `练习推荐` | `弱项处方` / `弱项处方@某人` | 按你的实际成绩找出弱项，生成八张练习卡的训练面板；练习区间锚定 B50 定数 |
| `b50风险` | `B50风险` `b50风险预警` `风险预警` | `b50风险` / `b50风险@某人` | B50 风险预警图片 |
| `对战战绩` | `headtohead` `h2h` `对决战绩` | `对战战绩@群友` | Head-to-Head 对比图 |
| `目标rating` | `rating沙盘` `目标分` `推分沙盘` | `目标rating 16000` / `目标rating 15500@某人` | 推分沙盘文字方案 |
| `底力分析` | — | `底力分析` / `底力分析@某人` | 单张「全景成绩统计」图：按谱面标签对比你在同段定数下的达成率，强弱项相对你的整体水平着色；样本不足的标签标「证据不足」，仅供参考 |
| `锐评一下` | `分析b50` `B50分析` | `锐评一下` | 调用 LLM 对 B50 进行锐评；按实际 Token 计费，调用前预扣 14 BREAK，成功多退少补、失败全退 |

#### 地板

| 命令 | 说明 |
|------|------|
| `地板` | 查看整体 B35/B15 地板 |
| `地板 14+` | 查看 B50 中 14+ 谱面的地板 |
| `地板 紫13` / `地板 master` | 按难度等级 + 定数筛选 |
| `b50地板` / `rating地板` | 同上（别名） |
| `地板 @某人` | 查他人地板 |

#### 中文简称进度

| 指令示例 | 等价于 | 完成条件 |
|----------|--------|----------|
| `13将` / `13将进度` | `13 sss进度` | 达成率 ≥100% |
| `14+极` | `14+ fc进度` | FC 及以上 |
| `13神` | `13 ap进度` | AP 及以上 |
| `13舞舞` | `13 fsd进度` | FSD 及以上 |
| `13者` | `13 bbb进度` | 达成率 ≥80% |

也支持 `13将 未完成`、`13将 2` 等分页筛选，以及 `13将 @某人` 查询他人。

#### 数据存储与报告

::: warning 注意
需先 **开启存储数据**。
:::

| 命令 | 说明 |
|------|------|
| `开启存储数据` / `开启数据存储` | 开启自动存储，并尝试立即同步一次完整数据 |
| `立即存储数据` | 手动存一份快照 |
| `关闭存储数据` | 关闭自动存储 |
| `存储历史` | 查看历史存档 ID |
| `查看存档 <ID>` | 查看某次快照详情 |
| `日报` / `周报` / `月报` | 近 1/7/30 天成绩报告图 |
| `年报` | 近一年成绩报告图 |
| `对比存档 <旧ID> <新ID>` | 两次存档对比报告 |
| `牌子统计` / `统计牌子` | 实时拉取查分器全量成绩，生成各代姓名框获取条件与个人进度长图；曲绘标注未打 / 已打 / 已鸟，附图例；渲染失败回退文字。需查分器已有成绩且绑定 / Token 可用 |

#### 吃分推荐（多路线）

`今日吃分推荐`（别名 `吃分推荐` / `今日推分推荐`）与 `我要上<分数>分` 现在都由**多路线版**
生成：把候选谱面分成**稳妥吃分 / 挑战突破 / 探索**三条路线，每条给**独立净收益**
（不是可以相加的总和），并用一张图给出「当前 → 目标」的达成率与理由。

| 命令 | 说明 |
|------|------|
| `今日吃分推荐` / `吃分推荐` | 生成多路线吃分推荐（需先开启存储数据，计入 `today_gain_recommend` 计费） |
| `吃分换批` | 在同一个会话里换一批（已见过的谱面不重复展示，**不重复扣生成费**） |
| `吃分反馈 <编号> <不喜欢/卡住/跳过>` | 按图上的编号反馈，影响后续推荐的筛选 |
| `吃分撤销` | 撤销本会话的反馈（同谱面的其它类别不受影响） |
| `吃分重看` | 显式重开会话（保留长期反馈） |
| `吃分练习` | 打开「瓶颈练习」页，与直接吃分分开 |
| `我要上<分数>分` / `我要在<等级>上<分数>分` | 目标分推分（旧入口，已委托多路线实现，支持私聊） |

::: tip 群体辅助
推荐默认叠加**群体辅助**（依据已开启数据共享的群体数据做基线），可提升冷门谱面的排序质量；
未共享或样本不足时自动退回个人基线。
:::

#### 群聊互动扩展

| 命令 | 说明 |
|------|------|
| `群聊rating排行榜` | 群内 Rating 排行 |
| `群吃分榜` / `群寸止榜` / `群锁血榜` | 群内各类榜单 |
| `我的群吃分榜 [天数]` | 群内查看自己的 Rating 增量排名及前后各 5 名；别名 `我的吃分榜` / `我的群内吃分榜`。默认近 7 天，范围 1～90（如 `我的群吃分榜 30`）；需本群查分 QQ 映射、成绩功能已开启，并开启存储且周期内至少有 2 次存档 |
| `boss` / `Boss` / `BOSS` / `全服boss` / `全服Boss` / `全服BOSS` | 群内无参数查看全服猜歌 Boss 概览；普通用户可用，但源码默认关闭，不代表已上线 |
| `开启mai猜歌` / `关闭mai猜歌` | **群管**：开关猜歌 |
| `开启狼人杀` / `关闭狼人杀` | **群管**：开关狼人杀（与猜歌共用群开关） |
| `开启phi` / `关闭phi` | **群管**：开关 Phigros 查分（详见 [Phigros 查分](/guide/bot/phigros)） |
| `开启别名推送` / `关闭别名推送` | **群管**：本群别名推送 |
| `排卡帮助` / `排卡教程` | 查看机厅排卡功能用法（详见下方「机厅排卡」） |
| `排卡列表` | 查看已配置的机厅排卡列表 |
| `小游戏权限不再提醒 <版本号>` | **群主 / 群管**：按最近一次提醒里的版本号关闭本群「小游戏权限」提醒（别名 `游戏权限不再提醒`） |

::: info 全服 Boss 可用性
源码中 Boss 总开关与自动结算默认均为关闭（`raid_enabled=0`、`raid_auto_settle=0`），未开放时回复「全服 Boss 暂未开放」。该查询入口无单独扣费逻辑；奖励是否开放、是否结算以实际 Bot 公告与提示为准，不能据此视为自动发奖已启用。
:::

::: tip 官方 QQ 的「小游戏权限」
官方 QQ 群要在群内开小游戏（猜歌、猜群友、狼人杀等），需要群主为机器人开启
「允许主动消息 / 接收消息」权限。缺失时 Bot 会在开局时贴图提醒，群主核对设置后按提醒里的
版本号发送 `小游戏权限不再提醒 <版本号>`（或点提醒上的「不再提醒」按钮）即可停止同一版本的
重复提醒；权限状态发生变化后提醒会自动恢复。
:::

#### 机厅排卡

排卡需要群管理先在 [群管理后台](/guide/bot/group-console) 开启，并在「机厅排卡」里添加机厅与别名。之后群友直接发送 **机厅别名 + 后缀** 即可，例如机厅别名是 `xjj`：

| 写法 | 说明 |
|------|------|
| `xjj几` / `xjjj` | 查询当前人数、机台数、上报时间和预计等待时间 |
| `xjj3` | 上报当前人数为 3 人 |
| `xjj+1` / `xjj-1` | 在当前人数上加减 |
| `predict xjj` | 按近期上报预测接下来的人数趋势（样本不足时提示） |
| `weather xjj` | 查看机厅所在地天气（需要后台填写经纬度） |
| `subweather xjj` / `unsubweather xjj` | **群管**：订阅 / 取消每日天气摘要推送；`subweather list` 查看已订阅机厅 |
| `排卡列表` | 列出本群所有机厅及当前人数 |

* 等待时间按「每台机每轮约 17 分钟」估算，仅供参考；
* 上报人数超过 99 或与上次相差 50 以上会被视为误输入并忽略；
* 后台填写 Nearcade 店铺 / 机种 ID 后，上报会同步到 [Nearcade](https://nearcade.cn)，查询时优先读取 Nearcade 数据。

#### 管理员渲染与预制状态

| 命令 | 说明 |
|------|------|
| `猜歌预制状态` / `猜歌预制` / `预制状态` | **管理员**：查看猜曲/猜铺面预制任务状态 |
| `渲染状态` / `查询渲染` / `渲染任务` | **管理员**：查看图片与视频渲染任务进度 |
| `发加倍卡 @用户 [数量] [有效小时]` | **群管**：默认 1 张、24 小时；也可 `发加倍卡 全体 [数量] [有效小时]`。猜对消耗 1 张使积分 ×2，不是商店的双倍 BREAK 卡；官方 QQ「全体」仅覆盖已记录的群成员 |
| `迁移数据` | **管理员**：迁移猜歌数据 |

#### 管理员与平台配置

以下指令需要插件管理员或群管理权限，普通用户无需使用。

| 命令 | 说明 |
|------|------|
| `设置入群欢迎词 <文本>` / `开启入群欢迎` / `关闭入群欢迎` / `查看入群欢迎` | **插件管理员**：管理入群欢迎语 |
| `群绑定QQ <QQ号>` / `解绑群QQ` / `群绑定状态` | 管理官方 QQ 群与历史 QQ 群号映射 |
| `强制绑定QQ <QQ号>` | 管理员协助绑定用户 QQ |
| `设置QQ菜单` / `QQ菜单` | 推送或查询官方 QQ 菜单 |
| `设置QQ面板` / `QQ面板列表` / `QQ面板详情` / `删除QQ面板` | 管理官方 QQ 指令面板 |
| `我的id` / `platformid` | 查询当前平台用户 ID（普通用户可用） |
| `锐评风格 设置 <描述>` / `锐评风格 重置` | 保存或清除个人锐评风格；查看可用 `锐评风格 查看` |
| `更新maimai数据` / `更新别名库` | 更新曲库或别名库 |
| `更新定数表` / `更新完成表` | **插件管理员**：更新定数 / 完成表预制资源 |
| `发布公告` / `编辑公告` / `删除公告` | 管理 Bot 公告 |
| `创建卡密` / `查询卡密` / `作废卡密` / `卡密列表` / `卡密统计` | 管理 BREAK 卡密 |
| `锐评模型配置` | 查看或调整 LLM 锐评运行配置 |
| `向量检索配置` | 查看或调整曲名向量检索（embedding）配置：`开` / `关` / `URL <地址>` / `模型 <名称>`（别名 `曲名向量配置` / `embedding配置`） |
| `命令排行 [命令]` | 查看近 7 天全服命令使用排行（Top 20）；带命令名时给出该命令的 7 天使用明细（图片） |
| `关闭BREAK计费` / `开启BREAK计费` | 临时切换 BREAK 计费状态 |
| `群成员记录` | 查看官方 QQ 群成员映射记录 |
| `后台身份` | 查看群管理后台识别到的当前身份 |
| `群管理` / `管理后台` / `群后台` | 获取本群群管理后台的一次性登录链接（详见 [群管理后台](/guide/bot/group-console)） |
| `设置全局签到加成 <百分比> [开始日期] [结束日期]` | 设置全局签到加成；`0` / `off` / `关闭` 立即停止 |
| `加成设置` / `加成管理` / `加成配置` | 管理签到加成规则：`添加` / `编辑` / `开关` / `删除`（周期 / 群 / 日期 / 连签） |
| `维护模式 [开/关]` | 开启或关闭全局维护模式 |
| `维护消息 <文本>` | 设置维护期间对用户的提示文案 |

#### 附：关于「拍一拍」

BOT 对 QQ 的拍一拍会做出反馈。若 BOT 是管理，可能触发随机时长的**禁言**（最高 1 天），拍之前请三思。

### 2.13 狼人杀

群内开局、群内 / 私聊双通道操作的多人狼人杀。状态只存在内存里（**Bot 重启即解散本局**），
玩法细节以 `狼人杀帮助` 的实时文案为准。

| 指令 | 说明 |
|------|------|
| `狼人杀` | 发起一局，返回游戏 ID |
| `狼人杀加入` / `狼人杀报名` | 报名（也可私聊 `加入 <游戏ID>`） |
| `狼人杀开始` / `狼人杀开局` | **发起者 / 管理员**：人数达标时提前开局 |
| `狼人杀延长` / `延长报名` / `延长` | 报名阶段延长加入窗口 30 秒（全局最多 2 次） |
| `退出狼人杀` / `退出报名` | 报名阶段退出（开局后要打完本局，别名 `不玩了`） |
| `狼人杀状态` / `狼人杀战况` | 查看阶段、存活情况与倒计时 |
| `狼人杀名单` / `狼人杀玩家` | 查看本局玩家名单 |
| `结束狼人杀` / `解散狼人杀` | **发起者 / 管理员**：强制结束本局 |
| `狼人杀帮助` / `狼人杀说明` | 查看实时玩法说明 |
| `开启狼人杀` / `关闭狼人杀` | **群管**：本群开关（与猜歌共用同一个群开关） |

**私聊动作**：`身份`（重发身份牌）、`刀 <编号>`、`查验 <编号>`、`救` / `毒 <编号>` / `不用`、
`守 <编号>`、`开枪 <编号>` / `不开枪`、`投票 <编号>` / `弃权`、`说 <内容>`；9 人以上还有警长
玩法（`上警` / `退水` / `投警 <编号>` / `警徽流 <编号>` / `撕警徽`）。

::: tip 对局规则速览

* 人数 4～16；身份按「狼 ≈ ⌊人数 / 3⌋、预言家 1、女巫 1、其余平民」推导，人数多时加入守卫、
  白痴、猎人等角色（以实时播报为准）。
* 白天分三段：**轮流发言**（每位发言人固定时长，只有当前发言人能在群里说话，`结束发言`
  可提前交棒）→ **互通交流** → **投票窗口**（群里禁言、私信投票，从进入白天起随时可投）。
* 夜间默认两段：🛡️守卫 / 🐺狼人 / 🔮预言家 同时行动，之后 🧪女巫 用药。
* 每个阶段开场有 5 秒宽容期；非当前发言人、已出局玩家在群里发言会被**撤回并扣 BREAK**
  （存活 10 / 出局 100，可通过配置调整）。
* 结算按奖池瓜分：基础奖池随人数线性增长（4 人 100，上限 600），狼人获胜整体 ×1.2，
  另有存活加成与 MVP 加成；奖励开关与参数由管理员热配置。
  :::

### 2.14 投票

群管理员可在群内发起投票，结果在群管理后台的「投票结果」页查看（含条形图 / 饼图与明细）。

| 指令 | 说明 |
|------|------|
| `创建投票 <标题> <选项A/选项B/...>` | **群管**：本群多选项投票（至少 2 个选项） |
| `创建曲目投票 <标题> [候选1/候选2/...]` | **群管**：曲目投票；候选可留空 = 开放提交（回复曲名参与） |
| `创建范围投票 <标题> 难度13~14 [时长]` | **群管**：限定定数区间的选歌投票（别名 `创建定数投票`） |
| `投票 <编号> [内容]` | 参与 / 改票；不带内容时展示详情与按钮（别名 `参与投票`） |
| `投票结果 <编号>` | 查看该投票的匿名票数榜单 |
| `投票列表` | 列出进行中的投票（别名 `进行中的投票`） |
| `关闭投票 <编号>` | 提前结算（别名 `结束投票`） |

* 时长可写 `30分钟` / `2小时`，缺省 60 分钟；到点自动结算并播报结果。
* 创建 / 关闭需要**群主或群管理员**权限；插件管理员还可以把标题带上「全服」来创建**全服投票**
  （所有群可见、票数全局聚合，结算播报只发创建时所在的群）。
* 群管理后台的「投票结果」页可查看投票列表、票数图表与**管理端可见的投票明细**。

### 2.15 入群验证、自动审批与踢人（群管） {#group-moderation}

以下指令只能在群里使用，需要**群主 / 群管理员**（或在群管理后台被授权的管理）才能执行；Bot 需要先被设为本群管理员，才能审批、踢人或禁言。

#### 入群人机验证

开启后，新成员入群时 Bot 会在群里出一道题，新成员**直接在群里回复答案**即可通过；超时或答错次数用完会被移出群聊。

| 指令 | 说明 |
|------|------|
| `入群验证` / `入群验证 状态` | 查看本群验证配置（别名 `群验证` / `人机验证`） |
| `入群验证 开启` / `入群验证 关闭` | 开关本群入群验证 |
| `入群验证 题目 算术` / `入群验证 题目 验证码` | 切换题目类型：加减乘算术题，或 4 位英数验证码 |
| `入群验证 兼容模式 开启` / `关闭` | 兼容模式（默认开启）下所有平台都发纯文本题目；关闭后部分客户端可能无法答题 |

* 默认 90 秒内作答，最多 3 次机会；验证期间该成员发的其它指令不会被执行。
* 未通过时优先踢出群聊；如果 Bot 没有开通官方踢人权限（错误码 11253），会改为**禁言 30 天**，并提示管理员手动处理。

#### 入群自动审批

按关键词自动处理入群申请（匹配申请人填写的验证信息）。开启后 Bot 会在后台定时扫描待审批列表。

| 指令 | 说明 |
|------|------|
| `自动审批` / `自动审批 查看` | 查看本群自动审批配置（别名 `加群自动审批` / `入群审批设置`） |
| `自动审批 开启` / `自动审批 关闭` | 开关自动审批 |
| `自动审批 关键词 添加 <词>` | 添加放行关键词，例如 `自动审批 关键词 添加 舞萌` |
| `自动审批 关键词 删除 <词>` / `清空` / `查看` | 管理关键词列表 |
| `自动审批 严格模式 开启` / `关闭` | 严格模式：没匹配关键词的申请**自动拒绝**；温和模式（默认）：保留给管理员人工审核 |
| `自动审批 频率 <秒>` | 后台扫描间隔，默认 30 秒，可设 15～600 秒 |
| `自动审批 播报 开启` / `关闭` | 自动通过时是否在群里播报新成员 |
| `群审批` | 立即拉取一次待审批列表并按规则处理，回报通过 / 拒绝 / 挂起人数（别名 `执行群审批` / `处理入群申请`） |

#### 踢人与群黑名单

| 指令 | 说明 |
|------|------|
| `mai踢 @某人` | 把成员移出群聊（别名 `踢人` / `移出成员`；带 @ 时也可直接发 `踢 @某人`） |
| `mai踢 @某人 -b` | 移出群聊并同时加入群黑名单，之后无法再申请入群 |
| `mai拉黑 <OpenID>` | 把**已不在群里**的成员加入黑名单（别名 `拉黑` / `群黑名单`）；还在群里的请用 `mai踢 @某人 -b` |
| `mai解封 @某人` / `mai解封 <OpenID>` | 移出群黑名单（别名 `解封` / `移出黑名单`） |

::: info 不会误伤聊天
`踢` 只有在后面 @ 了成员，或写成 `踢 <OpenID>` 时才会触发；「踢我」「踢球」之类的日常聊天不会被当成指令。
官方 QQ 群的踢人 / 黑名单接口需要腾讯开通权限，未开通时踢人会自动降级为禁言 30 天。
:::

***

## 交流与反馈

* **QQ 群**：[1 群 1072033605](https://qm.qq.com/q/Gj3QmfEyY0)（主群）· [2 群 993795066](https://qm.qq.com/q/PF5t1VXPi0)（游戏）· [群规](/guide/group-rules)
* **官网**：https://awmc.cc