AWMC BOT 指令帮助
提示
善用搜索快捷键 /（电脑端）或顶部搜索按钮（手机端）进行查询。
查分 QQ 绑定（qbind）
发送 qbind 你的QQ号，把 QQ 邮箱收到的 6 位验证码发回 Bot 即可，无需先注册论坛；已有论坛账号也可发送 论坛绑定 使用 OAuth。完整流程与发送限制见 使用说明 · qbind。
账号绑定、B50 上传、票券、PC 同步、成绩查询与群互动现已合并到同一个 QueryBot。 指令前缀由平台配置决定；下文以不带前缀为例。
版本与可用性
本页按当前源码整理，未核验生产部署；不代表所有功能均已上线。命令开放状态、价格与限制以实际部署配置及 Bot 提示为准，下文价格为源码默认值。
还有 Phigros
Phigros（phi）系列指令绑定 TapTap 云存档，可查 B30、资料卡、单曲信息与进步对比， 单独成页：Phigros 查分（phi）。
一、账号、上传与 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）上的整体状态、进行中的维护与故障；状态页发布 Bot 维护时，Bot 会自动进入维护模式 |
botstatus / bot状态 / 机器人状态 / 自检 | 生成 Bot 运行状态图：网络自检（数据库、AWMC API、论坛、水鱼、落雪、别名服务器等）、进程性能、今日收发消息量与时段分布，并附 up.wmc.pub 状态页摘要（详见 运行状态自检） |
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 |
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 与票券
| 命令 | 说明 |
|---|---|
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 |
票券计费与处罚
发票提交后失败默认收取 100 BREAK 固定罚金；提交前的二维码验证 / 余额检查失败，以及本地 API 配额拒绝，不收该罚金。发现账号仍有未使用倍率票时会拦截发票，另按未使用票券处罚规则收取 20 BREAK（one_time_qrcode 一次性二维码模式会跳过该库存检查）；上述处罚仅在余额足够时扣除，不扣成负数。不要囤票，已发票券需上机使用。
商店与下线功能
商店默认单价为双倍 BREAK 卡 300 BREAK/小时、FREEDOM 1000 BREAK/小时、PASS 150 BREAK/次，管理员可调整，实际以 商店 显示为准；购买本身不享受 FREEDOM 免单。PASS 在 AWMC team 本地 API 配额耗尽时自动消耗一次放行一个请求，不适用于 public 服务端配额，也不突破小游戏奖励上限。
福利池相关的 抽奖池 / 贡献榜、领取福利 / 领福利、贡献总榜 / 首富榜 已临时下线；与仍可使用的 BREAK抽奖 不同。
1.6 账号高级操作（计费 / 高风险）
警告
mai改成绩、mai删成绩、mai改道具 会直接改动舞萌账号数据，其中 mai改道具 未经实际账号测试、可能造成不可逆数据异常，风险由用户自行承担。 参见 AWMC BOT 服务协议与隐私政策 第十条。
| 命令 | 说明 |
|---|---|
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 项资料修改与上传会话查询的总入口（详见指令调用说明） |
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> 精确查询 |
批量功能风险
mai批量编辑 / mai全解锁 未经测试，非常不推荐使用：上游最长可能处理约 30 分钟，很有可能卡死。超时或结果未确认时请先 查进度，确认未生效前不要重复提交。详情见账号编辑与批量操作。多谱面成绩编辑 / 删除仍按谱面计费，不适用整批一口价。
快速更新与自动更新
导 / u / 更 / 更新（或 mai对手同步）无需扫码快速同步成绩；mai自动更新 [小时] 默认开启 3 小时，默认每小时 30 BREAK、每 15 分钟同步一次，最多 12 小时，确认后预扣。查自动更新 查看状态，自动更新关闭 提前关闭且不退款。
需先 mai绑定；水鱼 / 落雪仅支持 OAuth 授权。快速 / 自动更新不补 FC/FS 与 PC 数据，完整更新仍需扫码。价格、间隔及开放状态以 Bot 实际配置为准，详见快速更新与自动更新。
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.1 基础
| 指令 | 说明 |
|---|---|
帮助maimaiDX | 查看帮助图 |
项目地址maimaiDX | 查看项目信息 |
今日mai | 今日运势与推荐曲目 |
主题 | 查看或切换成绩图主题 |
查看排名 | 查看全服 Rating 排行 |
我的排名 | 查看自己的 Rating 排名 |
赞助 / 赞助榜 / 本月赞助 | 查看本月赞助榜（金额默认隐藏，详见 赞助支持） |
选哪个：群里直接说「吃拉面还是米饭」「是去 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+ |
查图与下载限制
查图支持 PNG / JPEG / WebP，图片最大 12 MiB，同一用户冷却 8 秒；识别不确定时返回候选。高置信结果直接生成歌曲详情，按搜索计费：默认功能费 1 BREAK + 出图费 1 BREAK，每日首查、FREEDOM 等减免以 Bot 实际结算为准，不是无条件免费。
查图与下载均受本群搜索开关限制，猜歌期间禁止使用；下载入口当前没有单独扣费逻辑。识别结果仅供参考。
查歌速查行
查歌 的介绍图后面会跟一条速查行：曲师 / 谱师 / 分类 / 版本 / 谱式 / 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 等。
用法示例（新曲）
新歌列表 紫 13+、新歌列表 DX 未游玩、新歌列表 13.5；同一功能按「当前版本」口径 （即 B15 口径）统计，与历史版本筛选（镜代b50 等）不同。
段位表样本
段位认定图会展示 LIFE 规则、课题曲等级/定数、个人最高达成率、匿名样本量、均值、中位数、P25-P75 分布和 SSS 率。样本来自服务器近期已同步且未关闭数据共享的成绩；低样本、冷启动或聚合失败时会回退到内置样本。页脚会标明数据来源，段位通过与否仍以机台结算为准。
2.6 猜歌
私聊触发小游戏
如需游玩猜歌、猜谱面等群游戏，请在私聊中按提示加入 2 群（游戏群）993795066 后再发起（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 日趋势 + 积分/次数占比环图 + 各玩法卡片与近期明细；可 我的猜歌 @某人 查对方 |
BREAK获取
小游戏每日 BREAK 上限：全局合计 50 / 天；单游戏 猜歌/猜曲绘/猜曲子/猜铺面/你想我猜 各 20， 开字母/猜Rating/找内鬼 各 15，maidle 20，极限二选一 10，猜群友 50。单游戏到顶后该游戏不再发， 全局到顶后所有小游戏不再发，次日 0 点重置；双倍BREAK卡生效期间翻倍发放并豁免上述上限。发送 小游戏上限 查看当前配置与个人进度。
我的猜歌数据
- 玩法：猜歌 / 猜曲绘 / 猜曲子 / 猜铺面 / 开字母 / 猜 Rating / 找内鬼 / 二选一 / 你想我猜 / 猜群友
- 图内含：近 30 日趋势、自适应玩法卡片、积分/次数占比环图、近期明细；结算后实时更新
@某人可看对方本群数据，例如我的猜歌 @张三；无 at 仍查自己- 群内发送
我的AWMC会自动附带本群猜歌数据图（失败不影响账号状态主流程）
舞萌开字母
需先由群管发送 开启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 秒/人冷却（与下方猜歌全局限频独立）；进入文字模式后跳过
不玩了/结束开字母：结束并揭晓剩余，不发速度奖与贡献奖（不用通关奖池文案）
答题限流
同一用户全局 2.5 秒只能提交一次答案（猜歌 / 曲绘 / 曲子 / 铺面 / 猜 Rating / 找内鬼 / 猜群友）； 具体间隔以 Bot 提示为准。超限时提示：
嘿嘿，你的答案被我吃掉啦！(x.x秒后才能发送新的答案）
猜 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 时才发放。
B50 找内鬼
需先由群管发送 开启mai猜歌；与其它猜歌玩法及开字母 同群互斥。
- 题面混入题主的 4 张 B50 卡片和另一位群友的 1 张卡片；内鬼歌曲不在题主 B50 中，并非篡改 RA
- 45 秒内发送
1～5作答，可以修改；速度排名按最终答案的提交时间计算 - 题主和内鬼卡片的原主人均不能提交有效答案，也不会进入奖励名单
- 答对第一名获得 10 积分 + 2 BREAK，第二名 6 积分 + 1 BREAK，第三名及后续答对者 3 积分
- 有效提交人数（排除题主和内鬼本人）至少 3 人才发 BREAK；不足时仍按规则发积分
- 结算时标出内鬼卡片并揭晓题主与内鬼身份
极限二选一
需先由群管发送 开启mai猜歌；发 极限二选一 开局后，发送 加入 或 参赛 报名。
- 共 5 轮，每轮比较左右两首歌曲的随机指标，参赛者发送
左或右作答 - 每轮按正确与否累计分数，结束时统一结算并展示揭晓图
- 揭晓图会在谱面定数旁明确标注：绿 Basic、黄 Advanced、红 Expert、紫 Master、白 Re:MASTER
重置二选一可由管理员或发起者强制结束当前对局
你想我猜（20 问猜曲）
需先由群管发送 开启mai猜歌；与其它猜歌玩法及开字母 同群互斥。
- 发送
你想我猜/20问猜曲开局，Milk 心里想一首舞萌曲目 - 群友直接发送「是/否」类问题（如「是不是紫谱」「定数大于 14 吗」），由 LLM 理解并回答；也支持比较词、区间与分类/谱师/版本等条件
- 可随时直接猜曲名；输入
查看已有信息/20问进度查看本局问答记录，重置你想我猜强制结束 - 猜错不结束、超时公布答案；问得越少分越高，积分可叠加连击与加倍卡
猜群友
需先由群管发送 开启mai猜歌；与其它猜歌玩法 同群互斥。
- 发
猜群友开局：题面给出三位群友和一张谱面，猜谁在这张谱面上的达成率最高 - 每人只能交一注：作答期间题板不会透露对错，重复作答只回一句提示；15 秒后统一开牌
- 结算：按选项归并所有作答者，答案选项标 ✅；押对者逐人入账（最早押中的一注按首答 ×2， 连击口径与其它玩法一致），每押中一胜固定 +1 BREAK（
groupmate_break_per_win可调； 积分倍率与加倍卡不放大 BREAK） - 未完成 qbind 的游客也可参与并计入榜单，只是不发 BREAK
- 出题会避开本群最近出过的谱面，且只出 Expert 及以上难度；
重置猜群友强制结束本局
舞萌 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 总量排行（输出文字） |
说明
游玩排行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 |
说明
AWMC NET. 是默认成绩库，发送一次 SGWCMAID 即可查分，无需绑定水鱼/落雪。 B50 系列按用户偏好自动走 AWMCNET/水鱼/落雪；部分功能（拟合、含金量等）落雪不支持时会回退水鱼。
2.9 谱面印象
| 指令 | 说明 |
|---|---|
谱面印象 <曲目> | 查看谱面印象 |
写谱面印象 <曲目> | 上传谱面印象 |
谱面排行 / 谱面热度 | 查看谱面印象热度排行 |
提示
使用 查歌（ID 或别名）查询时，会自动附带谱面印象、标签、定数变化、预览链接等合并转发。
2.10 AWMC BREAK
| 指令 | 说明 |
|---|---|
AWMC签到 | 签到获取 BREAK；距上次成功签到满 24 小时即可再签 |
我的AWMC | 查看账号状态与使用统计（含发票 returnCode 统计）；群内附带猜歌数据图 |
AWMC帮助 | 查看 BREAK 系统说明 |
转账BREAK @用户 数量 | 向其他用户转账 BREAK |
BREAK抽奖 [1-1000] | 默认每次消耗 2 BREAK，可一次抽 1～1000 次 |
BREAK 食用说明
有修改建议请前往 AWMC 论坛 提出。接入 AI 后会自动修改机器人并更新。
- 签到可以获得 BREAK（距上次成功签到满 24 小时即可再签），连续签到可以获得更多 BREAK。
- 锐评按实际 Token 用量计费（基础价最低 3、最高 30 BREAK；LLM 峰时 ×2），调用前预扣 14 BREAK，成功后多退少补，失败全退。
- 可以使用 BREAK 抽奖，最多支持 1000 连抽。
- 普通猜歌成功默认获得 1 BREAK；猜 Rating / 找内鬼按本局排名与难度结算。
- 「今日舞萌」会根据人品值增加 BREAK。
- 和群主谈情说爱，可能会获得一些 BREAK。
查分指令每日首次实际请求查分器 API 免费，之后每次扣 1 BREAK（缓存命中不扣）。 普通猜歌每次猜对默认获得 1 BREAK；猜 Rating / 找内鬼按玩法规则结算。成绩上传在外部操作成功后结算，每日首次成功免费。 发票成功按价收费，实际提交后失败默认罚 100 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将 @某人 查询他人。
数据存储与报告
注意
需先 开启存储数据。
| 命令 | 说明 |
|---|---|
开启存储数据 / 开启数据存储 | 开启自动存储，并尝试立即同步一次完整数据 |
立即存储数据 | 手动存一份快照 |
关闭存储数据 | 关闭自动存储 |
存储历史 | 查看历史存档 ID |
查看存档 <ID> | 查看某次快照详情 |
日报 / 周报 / 月报 | 近 1/7/30 天成绩报告图 |
年报 | 近一年成绩报告图 |
对比存档 <旧ID> <新ID> | 两次存档对比报告 |
牌子统计 / 统计牌子 | 实时拉取查分器全量成绩，生成各代姓名框获取条件与个人进度长图；曲绘标注未打 / 已打 / 已鸟，附图例；渲染失败回退文字。需查分器已有成绩且绑定 / Token 可用 |
吃分推荐（多路线）
今日吃分推荐（别名 吃分推荐 / 今日推分推荐）与 我要上<分数>分 现在都由多路线版 生成：把候选谱面分成稳妥吃分 / 挑战突破 / 探索三条路线，每条给独立净收益 （不是可以相加的总和），并用一张图给出「当前 → 目标」的达成率与理由。
| 命令 | 说明 |
|---|---|
今日吃分推荐 / 吃分推荐 | 生成多路线吃分推荐（需先开启存储数据，计入 today_gain_recommend 计费） |
吃分换批 | 在同一个会话里换一批（已见过的谱面不重复展示，不重复扣生成费） |
吃分反馈 <编号> <不喜欢/卡住/跳过> | 按图上的编号反馈，影响后续推荐的筛选 |
吃分撤销 | 撤销本会话的反馈（同谱面的其它类别不受影响） |
吃分重看 | 显式重开会话（保留长期反馈） |
吃分练习 | 打开「瓶颈练习」页，与直接吃分分开 |
我要上<分数>分 / 我要在<等级>上<分数>分 | 目标分推分（旧入口，已委托多路线实现，支持私聊） |
群体辅助
推荐默认叠加群体辅助（依据已开启数据共享的群体数据做基线），可提升冷门谱面的排序质量； 未共享或样本不足时自动退回个人基线。
群聊互动扩展
| 命令 | 说明 |
|---|---|
群聊rating排行榜 | 群内 Rating 排行 |
群吃分榜 / 群寸止榜 / 群锁血榜 | 群内各类榜单 |
我的群吃分榜 [天数] | 群内查看自己的 Rating 增量排名及前后各 5 名；别名 我的吃分榜 / 我的群内吃分榜。默认近 7 天，范围 1～90（如 我的群吃分榜 30）；需本群查分 QQ 映射、成绩功能已开启，并开启存储且周期内至少有 2 次存档 |
boss / Boss / BOSS / 全服boss / 全服Boss / 全服BOSS | 群内无参数查看全服猜歌 Boss 概览；普通用户可用，但源码默认关闭，不代表已上线 |
开启mai猜歌 / 关闭mai猜歌 | 群管：开关猜歌 |
开启狼人杀 / 关闭狼人杀 | 群管：开关狼人杀（与猜歌共用群开关） |
开启phi / 关闭phi | 群管：开关 Phigros 查分（详见 Phigros 查分） |
开启别名推送 / 关闭别名推送 | 群管：本群别名推送 |
排卡帮助 / 排卡教程 | 查看机厅排卡功能用法（详见下方「机厅排卡」） |
排卡列表 | 查看已配置的机厅排卡列表 |
小游戏权限不再提醒 <版本号> | 群主 / 群管：按最近一次提醒里的版本号关闭本群「小游戏权限」提醒（别名 游戏权限不再提醒） |
全服 Boss 可用性
源码中 Boss 总开关与自动结算默认均为关闭（raid_enabled=0、raid_auto_settle=0），未开放时回复「全服 Boss 暂未开放」。该查询入口无单独扣费逻辑；奖励是否开放、是否结算以实际 Bot 公告与提示为准，不能据此视为自动发奖已启用。
官方 QQ 的「小游戏权限」
官方 QQ 群要在群内开小游戏（猜歌、猜群友、狼人杀等），需要群主为机器人开启 「允许主动消息 / 接收消息」权限。缺失时 Bot 会在开局时贴图提醒，群主核对设置后按提醒里的 版本号发送 小游戏权限不再提醒 <版本号>（或点提醒上的「不再提醒」按钮）即可停止同一版本的 重复提醒；权限状态发生变化后提醒会自动恢复。
机厅排卡
排卡需要群管理先在 群管理后台 开启，并在「机厅排卡」里添加机厅与别名。之后群友直接发送 机厅别名 + 后缀 即可，例如机厅别名是 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，查询时优先读取 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 群成员映射记录 |
后台身份 | 查看群管理后台识别到的当前身份 |
群管理 / 管理后台 / 群后台 | 获取本群群管理后台的一次性登录链接（详见 群管理后台） |
设置全局签到加成 <百分比> [开始日期] [结束日期] | 设置全局签到加成；0 / off / 关闭 立即停止 |
加成设置 / 加成管理 / 加成配置 | 管理签到加成规则：添加 / 编辑 / 开关 / 删除（周期 / 群 / 日期 / 连签） |
维护模式 [开/关] | 开启或关闭全局维护模式 |
维护消息 <文本> | 设置维护期间对用户的提示文案 |
附：关于「拍一拍」
BOT 对 QQ 的拍一拍会做出反馈。若 BOT 是管理，可能触发随机时长的禁言（最高 1 天），拍之前请三思。
2.13 狼人杀
群内开局、群内 / 私聊双通道操作的多人狼人杀。状态只存在内存里（Bot 重启即解散本局）， 玩法细节以 狼人杀帮助 的实时文案为准。
| 指令 | 说明 |
|---|---|
狼人杀 | 发起一局，返回游戏 ID |
狼人杀加入 / 狼人杀报名 | 报名（也可私聊 加入 <游戏ID>） |
狼人杀开始 / 狼人杀开局 | 发起者 / 管理员：人数达标时提前开局 |
狼人杀延长 / 延长报名 / 延长 | 报名阶段延长加入窗口 30 秒（全局最多 2 次） |
退出狼人杀 / 退出报名 | 报名阶段退出（开局后要打完本局，别名 不玩了） |
狼人杀状态 / 狼人杀战况 | 查看阶段、存活情况与倒计时 |
狼人杀名单 / 狼人杀玩家 | 查看本局玩家名单 |
结束狼人杀 / 解散狼人杀 | 发起者 / 管理员：强制结束本局 |
狼人杀帮助 / 狼人杀说明 | 查看实时玩法说明 |
开启狼人杀 / 关闭狼人杀 | 群管：本群开关（与猜歌共用同一个群开关） |
私聊动作：身份（重发身份牌）、刀 <编号>、查验 <编号>、救 / 毒 <编号> / 不用、 守 <编号>、开枪 <编号> / 不开枪、投票 <编号> / 弃权、说 <内容>；9 人以上还有警长 玩法（上警 / 退水 / 投警 <编号> / 警徽流 <编号> / 撕警徽）。
对局规则速览
- 人数 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 入群验证、自动审批与踢人（群管）
以下指令只能在群里使用，需要群主 / 群管理员（或在群管理后台被授权的管理）才能执行；Bot 需要先被设为本群管理员，才能审批、踢人或禁言。
入群人机验证
开启后，新成员入群时 Bot 会在群里出一道题，新成员直接在群里回复答案即可通过；超时或答错次数用完会被移出群聊。
| 指令 | 说明 |
|---|---|
入群验证 / 入群验证 状态 | 查看本群验证配置（别名 群验证 / 人机验证） |
入群验证 开启 / 入群验证 关闭 | 开关本群入群验证 |
入群验证 题目 算术 / 入群验证 题目 验证码 | 切换题目类型：加减乘算术题，或 4 位英数验证码 |
入群验证 兼容模式 开启 / 关闭 | 兼容模式（默认开启）下所有平台都发纯文本题目；关闭后部分客户端可能无法答题 |
- 默认 90 秒内作答，最多 3 次机会；验证期间该成员发的其它指令不会被执行。
- 未通过时优先踢出群聊；如果 Bot 没有开通官方踢人权限（错误码 11253），会改为禁言 30 天，并提示管理员手动处理。
入群自动审批
按关键词自动处理入群申请（匹配申请人填写的验证信息）。开启后 Bot 会在后台定时扫描待审批列表。
| 指令 | 说明 |
|---|---|
自动审批 / 自动审批 查看 | 查看本群自动审批配置（别名 加群自动审批 / 入群审批设置） |
自动审批 开启 / 自动审批 关闭 | 开关自动审批 |
自动审批 关键词 添加 <词> | 添加放行关键词，例如 自动审批 关键词 添加 舞萌 |
自动审批 关键词 删除 <词> / 清空 / 查看 | 管理关键词列表 |
自动审批 严格模式 开启 / 关闭 | 严格模式：没匹配关键词的申请自动拒绝；温和模式（默认）：保留给管理员人工审核 |
自动审批 频率 <秒> | 后台扫描间隔，默认 30 秒，可设 15～600 秒 |
自动审批 播报 开启 / 关闭 | 自动通过时是否在群里播报新成员 |
群审批 | 立即拉取一次待审批列表并按规则处理，回报通过 / 拒绝 / 挂起人数（别名 执行群审批 / 处理入群申请） |
踢人与群黑名单
| 指令 | 说明 |
|---|---|
mai踢 @某人 | 把成员移出群聊（别名 踢人 / 移出成员；带 @ 时也可直接发 踢 @某人） |
mai踢 @某人 -b | 移出群聊并同时加入群黑名单，之后无法再申请入群 |
mai拉黑 <OpenID> | 把已不在群里的成员加入黑名单（别名 拉黑 / 群黑名单）；还在群里的请用 mai踢 @某人 -b |
mai解封 @某人 / mai解封 <OpenID> | 移出群黑名单（别名 解封 / 移出黑名单） |
不会误伤聊天
踢 只有在后面 @ 了成员，或写成 踢 <OpenID> 时才会触发；「踢我」「踢球」之类的日常聊天不会被当成指令。 官方 QQ 群的踢人 / 黑名单接口需要腾讯开通权限，未开通时踢人会自动降级为禁言 30 天。
交流与反馈
- QQ 群：1 群 1072033605（主群）· 2 群 993795066（游戏）· 群规
- 官网：https://awmc.cc