AWMC QueryBot 使用说明
☕ 支持 AWMC
AWMC 的全部服务永久免费，但维持运转需要真实成本。如果 AWMC 帮到了你，欢迎 赞助支持我们，每一份心意都会让服务更稳定喵～
账号绑定、成绩上传、PC 同步、查分与 BREAK 互动现已合并在同一个 QueryBot 中， 无需再区分“账号 Bot”和“查询 Bot”。本文中的指令默认不写命令前缀；如果当前平台 配置了 / 等前缀，请在指令前补上对应前缀。
交流与反馈
加入 QQ 群参与交流：1 群 1072033605（主群，不解锁游戏）、2 群 993795066（游戏群）；进群前请先看交流群群规。
遇到异常时请保留 Bot 返回的 Ref_ID，并到论坛 AWMC Bot 版块发帖反馈； 请勿在群里反复 @ 群主或管理团队催问（无端骚扰按群规可禁言 1 日）。
凭据安全
SGWCMAID、舞萌官方二维码链接和查分器 Token 都属于敏感凭据。Bot 收到后会优先 尝试撤回原消息；如果提示撤回失败，请立即手动撤回，不要把凭据转发给他人。
版本与可用性
本页按当前源码整理，未核验生产部署；命令开放状态、价格与限制以实际部署配置及 Bot 提示为准，文中价格为源码默认值。
〇、快速上手路线
第一次使用按这个顺序来，五分钟就能查分：
- 添加机器人 — 点击本页顶部的「添加 AWMC Bot」，或由群主把 Bot 拉进自己的群； 群功能使用前建议在群管理中允许 Bot 查看全部消息（见 十一、把 Bot 拉进自己的群）。
- 同意用户协议 — 发送
用户协议，阅读网页后把完整确认词发回。 - 绑定舞萌账号 — 发送
mai绑定，提交SGWCMAID...或官方二维码链接，无需绑定 水鱼 / 落雪即可查分（AWMC NET 默认成绩库）。 - 查分 — 发送
b50、ab50或我的pc数开始体验；完整指令见 指令帮助。 - 群管理与排卡 — 群主 / 管理员发送
群管理打开 群管理后台， 一键开关群功能、看群数据、管机厅排卡与天气。
一、首次使用
1. 阅读并确认用户协议
- 向 Bot 发送
用户协议。 - 打开 Bot 返回的 AWMC maiBot 服务协议（v4）。
- 认真阅读完整网页，并复制页面中的完整确认词。
- 将确认词直接发送给 Bot；也可以发送
同意用户协议 <完整确认词>。
确认成功后，才可使用账号绑定、上传、发票、BREAK 转账和抽奖等功能。发送 撤回用户协议 可以撤回同意，但不会自动删除已有账号绑定。
成绩、Rating、趋势等数据默认会脱敏后作为公开数据（含训练用途）。若不希望共享，请向 Bot 发送 不同意共享我的数据。
2. 绑定舞萌账号
发送：
mai绑定Bot 会要求提交最新的玩家二维码数据。获取方式：
- 打开微信中的「舞萌DX | 中二节奏」玩家二维码；
- 长按二维码，选择「识别图中二维码」；
- 复制识别出的字符或网页地址，发送给 Bot。
支持以下三种内容：
- 完整的
SGWCMAID...字符串； https://wq.wahlap.net/qrcode/img/MAID....png图片链接；https://wq.wahlap.net/qrcode/req/MAID....html请求链接。
也可以一次发送 mai绑定 SGWCMAID...。常用别名：maibind。
Bot 会验证二维码中的账号身份，绑定成功后只显示玩家名和 Rating，不会发送街机 UID。 如果同一个舞萌账号存在于旧 Bot 迁移记录中，新凭据验证成功后会自动认领旧记录； BREAK、协议状态和落雪 OAuth 不随认领转移。
绑定验证通过后，Bot 会自动把脱敏后的成绩同步到 AWMC NET.（默认成绩库）， 并提示可用 QQ 邮箱前往 net.wmc.pub 注册网页查询。 这意味着无需再绑定水鱼或落雪也能直接查 B50，详见 下一节。
二、查询账号状态
发送 mymai 或 mai状态 可查看：
- 玩家名、Rating 及新旧版本 Rating 拆分；
- 友人对战等级、游玩次数、机台与数据版本；
- 最近登录、游玩、拼机、地区与觉醒次数；
- 账号封禁状态、BREAK 余额；
- 水鱼/落雪绑定、最近上传和有效票券摘要。
状态消息不会显示完整二维码、Token 或街机 UID。
最近一次验证成功的二维码默认缓存 10 分钟。缓存有效时，Bot 会先重新验证账号身份， 再获取最新状态；缓存过期、返回空值/500、上次使用失败或身份不一致时，Bot 会重新 询问二维码。最多输入 3 次，发送 取消 可直接查看已保存的缓存资料。
三、AWMC NET 免绑定查分
AWMC NET. 是 QueryBot 内置的默认成绩镜像库（地址 net.wmc.pub）， 所有新用户的默认成绩数据源都是 AWMCNET。它让你不用绑定任何第三方查分器 （水鱼 / 落雪）就能查分：
- 完成
mai绑定，或直接发送一次最新的SGWCMAID/ 官方二维码链接； - Bot 验真通过后自动建档，并把脱敏成绩上传到 AWMC NET.；
- 首次同步成功会收到提示：「AWMC NET. 已同步您的信息，您无需其他操作」；
- 之后直接发送
b50、ab50等指令即可出图，不需要水鱼 Token 或落雪 OAuth。
在网页端可用与 QQ 邮箱同名的账号注册 net.wmc.pub 查看成绩。 AWMC NET. 只接收脱敏后的 QQ、展示名与成绩，不发送二维码、街机 UID 或第三方 Token。
常用指令：
| 指令 | 说明 |
|---|---|
数据源 | 查看当前数据源（新用户默认为 AWMCNET） |
数据源 AWMCNET / 数据源 水鱼 / 数据源 落雪 | 切换个人数据源 |
成绩趋势 [天数] | 查看 AWMC NET. 服务端记录的近 30 天 Rating 趋势，默认 30 天，范围 1～365 |
别名：rating趋势、mai趋势、awmc趋势。AWMC NET. 没有成绩时，Bot 会自动探测 已绑定的水鱼/落雪并迁移一次成绩快照；部分高级分析（拟合、含金量等）落雪不支持时 会自动回退水鱼。
水鱼 Token 和落雪 OAuth 现在都是可选项：绑定后会在同步 AWMCNET 之外额外同步 对应平台，方便在外部查分器查看。
四、上传成绩到查分器（可选）
1. 绑定水鱼
前往 水鱼查分器 获取导入 Token，然后发送：
mai绑定水鱼 <Token>别名：maibindfish <Token>。
2. 绑定落雪
推荐直接发送：
lxbind按提示完成落雪 OAuth 授权，之后无需向 Bot 提交落雪导入 Token。
如需使用兼容方式，也可以发送：
mai绑定落雪 <导入Token>别名：maibindlx <导入Token>。上传时会优先使用 OAuth，只有未授权或需要兼容回退时 才使用导入 Token。
3. 执行上传
| 指令 | 作用 | 默认价格 |
|---|---|---|
maiu | 上传水鱼 | 2 BREAK |
maiul | 上传落雪 | 2 BREAK |
maiua | 同时上传水鱼和落雪 | 3 BREAK |
三种上传都会同时写入 AWMC NET.（始终同步）；maiu 仅水鱼、maiul 仅落雪、 maiua 两边。外部平台只有在已绑定时才参与，不绑定也不影响 AWMCNET 查分。
三种方式共享“每日首次上传成功免费”额度。只有外部服务真正返回成功后才结算；二维码 无效、HTTP 500、返回全空、任务失败或超时均不扣 BREAK。
上传会优先使用 10 分钟内已验证的二维码缓存。缓存不可用时，Bot 会要求发送最新的 SGWCMAID 或官方链接，最多重试 3 次；发送 取消 可结束本轮上传。
第三方查分说明
QueryBot 无法自动知道玩家何时在机台游玩、打了什么歌。机台游玩后，需要重新执行 maiu、maiul 或 maiua，查分器中的 B50 才会更新。
五、直接发送二维码
直接发送以 SGWCMAID 或上述 Wahlap 官方链接开头的消息时，Bot 会按以下顺序处理：
- 优先撤回原凭据消息；
- 验证用户协议和群功能开关；
- 获取并保存最新 PC 数据；
- 根据绑定情况自动上传：只绑定水鱼就传水鱼，只绑定落雪就传落雪，两边都绑定就 同时上传；
- 合并返回 PC 数量、上传结果、BREAK 结算和
Ref_ID。
如果没有绑定任何查分器，本次只同步 PC。二维码无效、过期或服务暂时不可用时， 3 分钟内最多可重新发送 3 次。
六、PC 数据与查分
| 指令 | 说明 |
|---|---|
更新pc数 | 使用有效缓存或最新二维码同步 PC 数据 |
我的pc数 | 查看总 PC 与游玩最多的 15 个谱面 |
pc数 <歌曲> | 查看指定歌曲的 PC 数据 |
pc50 | B50 按游玩次数排序 |
pca50 | Rating B50 内按 PC 重新排序 |
游玩排行50 | 全库游玩最多的 50 个谱面 |
pc排行 | 全部已同步用户的 PC 总量排行 |
PC 数据来自舞萌账号同步；b50、ab50 等成绩图仍以水鱼或落雪查分器为准。
如果刚完成上传但查询仍显示旧成绩，可以稍等片刻后发送 刷新b50。Bot 会在上传前后 主动清理本地成绩缓存，但查分器本身也可能需要时间处理。
七、BREAK
1. 获取与查看
| 指令 | 说明 |
|---|---|
AWMC签到 / 签到 | 签到获取 BREAK；距上次成功签到满 24 小时即可再签 |
我的AWMC | 查看余额、连续签到、今日使用量、最近流水，以及发票 returnCode 统计 |
AWMC帮助 | 查看 BREAK 规则 |
签到基础奖励默认为 1～2 BREAK，连续签到额外奖励最高 3 BREAK（第 5 天起封顶）。指定群、周四和群内 当日首签可能获得额外倍率，实际结果以 Bot 返回为准。
2. 默认消费规则
| 业务 | 默认规则 |
|---|---|
| 查分器 API | 每日首次实际请求免费，之后 1 BREAK；缓存命中不扣 |
| B50 分析 | Token 用量计费：基础价最低 3、最高 30；调用前预扣 14，成功后多退少补、失败全退（LLM 峰时均 ×2） |
| 猜歌 | 普通猜歌每次猜对默认 1 BREAK；猜 Rating / 找内鬼按排名和难度结算 |
| 上传成绩 | 每日首次成功免费，之后水鱼 2、落雪 2、同时上传 3 |
| 发票 | 成功按倍率扣费（2 倍 20、3 倍 30、5 倍 50 BREAK）；实际提交后失败默认罚 100 BREAK，详见计费条件 |
| 抽奖 | 默认每次消耗 2 BREAK，可一次抽 1～1000 次 |
3. 群互动
转账BREAK @用户 10
BREAK抽奖
BREAK抽奖 5BREAK抽奖 默认抽 1 次，数字表示连抽次数。BREAK 仅为 Bot 内部互动积分，不具有 现金价值。
八、论坛账号绑定（qbind）
qbind 用于绑定你的查分 QQ，绑定后可直接使用签到、查分、B50 等账号功能；首次绑定默认发放 3 BREAK 奖励（以 Bot 配置为准）。现在可以用 QQ 邮箱验证码绑定，无需先注册论坛；已有论坛账号也可继续走 OAuth。
1. 发起绑定
推荐发送（将示例数字换成自己的 QQ 号）：
qbind 123456- Bot 向
123456@qq.com发送一封含 6 位验证码的邮件； - 在 10 分钟内，直接把验证码回复给同一个 Bot 即可，无需再带
qbind； - 验证码输错 5 次会作废，需要重新申请。验证码属于绑定凭据，请勿公开或转发。
只发送 qbind 会收到用法提示；绑定qq / mai绑定qq / maiqbind 也可进入邮箱绑定。
收不到邮件或发送受限
先检查 QQ 邮箱垃圾箱，并确认输入的是自己的 QQ 号。同一平台用户、同一 QQ 邮箱均须间隔 60 秒才能重发；滚动 24 小时内，同一平台用户最多发 10 封、同一 QQ 邮箱最多收 5 封；全服每小时最多 300 封。受限时请等待，或发送 论坛绑定 使用下方备用流程。
备用：论坛 OAuth 授权。 发送 论坛绑定 / 论坛登录 / AWMC论坛绑定，Bot 会返回授权引导：
- 在浏览器打开链接并登录论坛；
- 论坛邮箱必须使用
你的QQ号@qq.com（例如 QQ 是 123456，邮箱就填123456@qq.com）； - 授权后，把授权码或完整回调链接发回给 Bot 即可完成绑定，无需再带命令前缀。
OAuth 授权码同样为 10 分钟有效、仅一次可用。邮箱绑定不可用时，
qbind会转为论坛 OAuth 流程，请按 Bot 实际提示操作。
2. 绑定成功
邮箱验证后 Bot 会回执「QQ 邮箱验证成功，绑定完成」，显示查分 QQ 与可用功能；论坛 OAuth 则回执论坛绑定成功。
邮箱绑定还会尝试关联同邮箱的论坛账号；没有账号则自动创建。新建账号可在论坛登录页点「邮件链接登录」，输入 QQ 号免密登录。论坛关联失败不影响已经完成的查分 QQ 绑定，是否创建或关联成功以 Bot 回执为准。
3. 查看绑定状态
发送：
qbind状态别名：查绑定qq / 我的qbind / 论坛绑定状态 / 论坛账号状态 / 论坛状态。
4. 解绑 / 取消
| 指令 | 说明 |
|---|---|
qunbind | 查看论坛 / 查分 QQ 解绑报价，不立即扣费（别名：解绑qq / QQ解绑 / 解绑qbind / 解绑论坛 / 论坛解绑） |
qunbind 确认 | 确认扣费并解绑查分 QQ 与论坛身份 |
取消论坛绑定 | 取消进行中的绑定流程（别名：论坛绑定取消 / 取消qbind） |
换绑前须付费解绑
已绑定时不能直接用 qbind 换绑，须先发送 qunbind 查看报价，再发送 qunbind 确认。手续费按旧查分 QQ的解绑流水累计：首次默认 100 BREAK，之后每次 200 BREAK，从旧查分 QQ 余额扣除，不享 FREEDOM 或免费窗口；余额不足不解绑。解绑后签到、查分等账号功能需要重新 qbind。取消论坛绑定 仅取消进行中的流程，不能代替解绑。
5. 查看或修改论坛用户名
发送 nickname 查看当前用户名及下次可改时间；发送 nickname 新名字 修改（别名：论坛改名 / 修改论坛用户名 / 改论坛用户名 / 论坛用户名）。需先成功关联论坛身份，仅有查分 QQ 映射还不够；此入口没有单独 BREAK 扣费逻辑。
自动生成的用户名可立即首次修改，之后通常每 30 天一次，实际限制与可改时间以论坛返回为准。新名字须为 3～25 字符，不能是纯数字、自动用户名、平台 OpenID，也不能含表情或被禁止的特殊字符；重名等情况可能被论坛拒绝。管理账号或不支持 Bot 改名时，请到论坛「账户设置」修改。
说明
当前为 OneBot 模式时，消息 QQ 即查分 QQ，无需 qbind / 论坛 OAuth 即可使用账号功能。
九、发票
发送 发票 2 或 fp 2 请求 2 倍票，当前支持 2、3、5 倍：
| 倍率 | 价格（每次成功） |
|---|---|
| 2 倍 | 20 BREAK |
| 3 倍 | 30 BREAK |
| 5 倍 | 50 BREAK |
发票成功按倍率扣费，没有每日首免；实际提交后失败默认罚 100 BREAK，提交前验码 / 余额检查失败和本地配额拒绝免该罚金。未使用倍率票拦截等条件详见指令调用说明，实际金额以 Bot 热配置为准。 使用 mai查票 或 查票 可按票种、库存和有效期查看票券状态，默认成功查询 1 BREAK；回复不会显示舞萌账号 UID 或原始接口数据。
十、常见问题
Bot 提示“尚未建立账号记录”
依次完成：
- 发送
mai绑定，再提交最新的SGWCMAID字符串或官方链接； - 按需发送
mai绑定水鱼 <Token>，或使用lxbind绑定落雪 OAuth； - 使用
maiu、maiul、maiua上传水鱼、落雪或两边。
二维码返回 500、全是 null 或提示过期
返回舞萌玩家二维码页面重新生成并长按识别。不要重复发送旧二维码；同一轮流程最多 允许 3 次，仍失败时请稍后重新开始。
Bot 无法撤回凭据消息
请立即手动撤回。Bot 仍会继续返回脱敏后的处理结果，但无法替代用户删除原消息。
查分提示用户不存在或没有数据
新用户默认走 AWMC NET.，发送一次最新 SGWCMAID 完成同步后即可查分，无需绑定 水鱼/落雪。若你手动切换到了水鱼，请确认水鱼个人资料填写了正确的 QQ 号、关闭 “禁止其他人查询我的成绩”，并至少执行一次 maiu；使用落雪时请检查 OAuth 是否仍有效。
B50 成绩是整数或与网页不一致
检查水鱼隐私设置，关闭“对非网页查询的成绩使用掩码”，然后发送 刷新b50 重试。
上传提示登录失败
通常是二维码已过期、账号仍登录在机台，或外部服务暂时不可用。请重新获取二维码， 按照 Bot 提示最多重试 3 次；失败流程不会扣 BREAK。
想用纯文本 / Bot 回复显示异常
部分客户端（如某些 QQ 版本或特殊环境）无法正常渲染 Markdown 与快捷按钮。发送「切换兼容模式」即可开启兼容模式，Bot 会回复：
已开启兼容模式：除 @、图片、音频等必要消息段外，后续回复使用普通文本，链接显示为原始网址。
发送「切换兼容模式」或「标准模式」可恢复 Markdown 和快捷按钮。
十一、把 Bot 拉进自己的群（群主/管理员）
Bot 支持拉入其他 QQ 群使用。如果你是群主或管理员，希望 Bot 无需 @ 即可回复消息、正常游玩猜歌等功能，请按以下步骤设置。
- 打开 Bot 的个人主页，点击右上角的设置按钮。
- 把 Bot 修改为「允许查看所有消息」。
- 允许 Bot 主动推送消息，保证猜歌等功能可用。
- 如需 Bot 自动撤回消息，请在群管理中把 Bot 添加为管理员。
开启「允许查看所有消息」的影响
群里的其他 Bot 也会一并读取群消息，可能出现重复回复的情况。
群主 / 管理员常用的开关与管理指令（小游戏开关、入群验证、自动审批、踢人、排卡、投票等）汇总在 群管理后台 · 群主 / 管理员指令速查。
如遇问题请联系负责管理员。
午高峰和晚高峰服务可能会有所卡顿，请耐心等待。