AWMC QueryBot 使用说明
☕ 支持 AWMC
AWMC 的全部服务永久免费，但维持运转需要真实成本。如果 AWMC 帮到了你，欢迎 赞助支持我们，每一份心意都会让服务更稳定喵～
账号绑定、成绩上传、PC 同步、查分与 BREAK 互动现已合并在同一个 QueryBot 中， 无需再区分“账号 Bot”和“查询 Bot”。本文中的指令默认不写命令前缀；如果当前平台 配置了 / 等前缀，请在指令前补上对应前缀。
凭据安全
SGWCMAID、舞萌官方二维码链接和查分器 Token 都属于敏感凭据。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 |
我的AWMC | 查看余额、连续签到、今日使用量、最近流水，以及发票 returnCode 统计 |
AWMC帮助 | 查看 BREAK 规则 |
签到基础奖励默认为 1～2 BREAK，连续签到最高额外增加 2 BREAK。指定群、周四和群内 当日首签可能获得额外倍率，实际结果以 Bot 返回为准。
2. 默认消费规则
| 业务 | 默认规则 |
|---|---|
| 查分器 API | 每日首次实际请求免费，之后 1 BREAK；缓存命中不扣 |
| B50 分析 | Token 基础价 ×3，最低 6、最高 60；调用前预扣 6，成功后多退少补、失败全退 |
| 猜歌 | 普通猜歌每次猜对默认 1 BREAK；猜 Rating / 找内鬼按排名和难度结算 |
| 上传成绩 | 每日首次成功免费，之后水鱼 2、落雪 2、同时上传 3 |
| 发票 | 每日首次成功免费，之后为 20 / 30 BREAK |
| 抽奖 | 默认每次消耗 2 BREAK，可一次抽 1～10 次 |
3. 群互动
转账BREAK @用户 10
BREAK抽奖
BREAK抽奖 5BREAK抽奖 默认抽 1 次，数字表示连抽次数。BREAK 仅为 Bot 内部互动积分，不具有 现金价值。
八、论坛账号绑定（qbind）
qbind 用于把你的查分 QQ 与 AWMC 论坛账号绑定；绑定后可直接使用签到、查分、B50 等账号功能，首次绑定还会发放 3 BREAK 奖励。
1. 发起绑定
发送：
qbind别名：论坛绑定 / 绑定qq / mai绑定qq / maiqbind / AWMC论坛绑定。
Bot 会返回一段 AWMC 论坛 OAuth 授权引导：
- 在浏览器打开链接并登录论坛；
- 论坛邮箱必须使用
你的QQ号@qq.com（例如 QQ 是 123456，邮箱就填123456@qq.com）； - 授权后，把授权链接直接发回给 Bot 即可完成绑定。
授权码 10 分钟内有效，仅一次可用，请尽快操作。 已发起
qbind后，也可以直接把授权码或完整回调链接发给 Bot（无需再带qbind前缀）。
2. 绑定成功
绑定成功后 Bot 会回执「论坛绑定成功」，显示论坛账号、邮箱与查分 QQ，并提示已可使用签到、查分、B50 等功能。
3. 查看绑定状态
发送：
qbind状态别名：查绑定qq / 我的qbind / 论坛绑定状态 / 论坛账号状态 / 论坛状态。
4. 解绑 / 取消
| 指令 | 说明 |
|---|---|
qunbind | 解绑论坛/查分 QQ（别名：解绑qq / QQ解绑 / 解绑qbind / 解绑论坛 / 论坛解绑） |
取消论坛绑定 | 取消进行中的绑定流程（别名：论坛绑定取消 / 取消qbind） |
说明
当前为 OneBot 模式时，消息 QQ 即查分 QQ，无需 qbind / 论坛 OAuth 即可使用账号功能。
九、发票
发送 发票 2 或 fp 2 请求 2 倍票，当前支持 2、3 倍：
| 倍率 | 每日首免后价格 |
|---|---|
| 2 倍 | 20 BREAK |
| 3 倍 | 30 BREAK |
只有发票真正成功并确认到账时才扣费。使用 mai查票 或 查票 可按票种、库存和 有效期查看票券状态；回复不会显示舞萌账号 UID 或原始接口数据。
风险提示
发票、上传及二维码相关功能可能影响舞萌官方账号安全。使用前请完整阅读 AWMC BOT 服务协议与隐私政策，并自行承担相应风险。
十、常见问题
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 也会一并读取群消息，可能出现重复回复的情况。
如遇问题请联系负责管理员。
午高峰和晚高峰服务可能会有所卡顿，请耐心等待。