--- url: https://wiki.awmc.team/guide/bot/intro.md --- # AWMC QueryBot 使用说明 ::: tip ☕ 支持 AWMC AWMC 的全部服务永久免费，但维持运转需要真实成本。如果 AWMC 帮到了你，欢迎 [赞助支持我们](https://afdian.com/a/AWMC_TEAM?tab=shop)，每一份心意都会让服务更稳定喵～ ::: ::: danger ⚠️ QQ 机器人限制 由于 QQ 机器人平台限制，如果想要使用**排卡**、**猜歌游戏**等群功能，需要群主在群管理中将 Bot 设置为「允许获取全部消息」，才能获得最佳体验。 设置方法：[把 Bot 拉进自己的群](#add-to-group)。 ::: 账号绑定、成绩上传、PC 同步、查分与 BREAK 互动现已合并在同一个 QueryBot 中， 无需再区分“账号 Bot”和“查询 Bot”。本文中的指令默认不写命令前缀；如果当前平台 配置了 `/` 等前缀，请在指令前补上对应前缀。 ::: tip 交流与反馈 加入 QQ 群参与交流：[1 群 1072033605](https://qm.qq.com/q/Gj3QmfEyY0)（主群，不解锁游戏）、[2 群 993795066](https://qm.qq.com/q/PF5t1VXPi0)（游戏群）；进群前请先看[交流群群规](/guide/group-rules)。 遇到异常时请保留 Bot 返回的 `Ref_ID`，并到[论坛 AWMC Bot 版块](https://bbs.wmc.pub/forums/awmc-bot.17/)发帖反馈； 请勿在群里反复 @ 群主或管理团队催问（无端骚扰按[群规](/guide/group-rules)可禁言 1 日）。 ::: ::: danger 凭据安全 `SGWCMAID`、舞萌官方二维码链接和查分器 Token 都属于敏感凭据。Bot 收到后会优先 尝试撤回原消息；如果提示撤回失败，请立即手动撤回，不要把凭据转发给他人。 ::: ::: info 版本与可用性 本页按当前源码整理，未核验生产部署；命令开放状态、价格与限制以实际部署配置及 Bot 提示为准，文中价格为源码默认值。 ::: ## 〇、快速上手路线 第一次使用按这个顺序来，五分钟就能查分： 1. **添加机器人** — 点击本页顶部的「添加 AWMC Bot」，或由群主把 Bot 拉进自己的群； 群功能使用前建议在群管理中允许 Bot 查看全部消息（见 [十一、把 Bot 拉进自己的群](#add-to-group)）。 2. **同意用户协议** — 发送 `用户协议`，阅读网页后把完整确认词发回。 3. **绑定舞萌账号** — 发送 `mai绑定`，提交 `SGWCMAID...` 或官方二维码链接，无需绑定 水鱼 / 落雪即可查分（AWMC NET 默认成绩库）。 4. **查分** — 发送 `b50`、`ab50` 或 `我的pc数` 开始体验；完整指令见 [指令帮助](/guide/bot/advanced)。 5. **群管理与排卡** — 群主 / 管理员发送 `群管理` 打开 [群管理后台](/guide/bot/group-console)， 一键开关群功能、看群数据、管机厅排卡与天气。 ## 一、首次使用 ### 1. 阅读并确认用户协议 1. 向 Bot 发送 `用户协议`。 2. 打开 Bot 返回的 [AWMC maiBot 服务协议（v4）](https://wiki.awmc.team/guide/bot/terms)。 3. 认真阅读完整网页，并复制页面中的**完整确认词**。 4. 将确认词直接发送给 Bot；也可以发送 `同意用户协议 <完整确认词>`。 确认成功后，才可使用账号绑定、上传、发票、BREAK 转账和抽奖等功能。发送 `撤回用户协议` 可以撤回同意，但不会自动删除已有账号绑定。 成绩、Rating、趋势等数据默认会脱敏后作为公开数据（含训练用途）。若不希望共享，请向 Bot 发送 `不同意共享我的数据`。 ### 2. 绑定舞萌账号 发送： ```text mai绑定 ``` Bot 会要求提交最新的玩家二维码数据。获取方式： 1. 打开微信中的「舞萌DX | 中二节奏」玩家二维码； 2. 长按二维码，选择「识别图中二维码」； 3. 复制识别出的字符或网页地址，发送给 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](https://net.wmc.pub) 注册网页查询。 这意味着**无需再绑定水鱼或落雪**也能直接查 B50，详见 [下一节](#三、awmc-net-免绑定查分)。 ## 二、查询账号状态 发送 `mymai` 或 `mai状态` 可查看： * 玩家名、Rating 及新旧版本 Rating 拆分； * 友人对战等级、游玩次数、机台与数据版本； * 最近登录、游玩、拼机、地区与觉醒次数； * 账号封禁状态、BREAK 余额； * 水鱼/落雪绑定、最近上传和有效票券摘要。 状态消息不会显示完整二维码、Token 或街机 UID。 最近一次验证成功的二维码默认缓存 10 分钟。缓存有效时，Bot 会先重新验证账号身份， 再获取最新状态；缓存过期、返回空值/500、上次使用失败或身份不一致时，Bot 会重新 询问二维码。最多输入 3 次，发送 `取消` 可直接查看已保存的缓存资料。 ## 三、AWMC NET 免绑定查分 AWMC NET. 是 QueryBot 内置的默认成绩镜像库（地址 [net.wmc.pub](https://net.wmc.pub)）， 所有新用户的默认成绩数据源都是 AWMCNET。它让你**不用绑定任何第三方查分器** （水鱼 / 落雪）就能查分： 1. 完成 `mai绑定`，或直接发送一次最新的 `SGWCMAID` / 官方二维码链接； 2. Bot 验真通过后自动建档，并把脱敏成绩上传到 AWMC NET.； 3. 首次同步成功会收到提示：「AWMC NET. 已同步您的信息，您无需其他操作」； 4. 之后直接发送 `b50`、`ab50` 等指令即可出图，不需要水鱼 Token 或落雪 OAuth。 在网页端可用与 QQ 邮箱同名的账号注册 [net.wmc.pub](https://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. 绑定水鱼 前往 [水鱼查分器](https://maimai.diving-fish.com/) 获取导入 Token，然后发送： ```text mai绑定水鱼 ``` 别名：`maibindfish `。 ### 2. 绑定落雪 推荐直接发送： ```text lxbind ``` 按提示完成落雪 OAuth 授权，之后无需向 Bot 提交落雪导入 Token。 如需使用兼容方式，也可以发送： ```text 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 次；发送 `取消` 可结束本轮上传。 ::: info 第三方查分说明 QueryBot 无法自动知道玩家何时在机台游玩、打了什么歌。机台游玩后，需要重新执行 `maiu`、`maiul` 或 `maiua`，查分器中的 B50 才会更新。 ::: ## 五、直接发送二维码 直接发送以 `SGWCMAID` 或上述 Wahlap 官方链接开头的消息时，Bot 会按以下顺序处理： 1. 优先撤回原凭据消息； 2. 验证用户协议和群功能开关； 3. 获取并保存最新 PC 数据； 4. 根据绑定情况自动上传：只绑定水鱼就传水鱼，只绑定落雪就传落雪，两边都绑定就 同时上传； 5. 合并返回 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，详见[计费条件](/guide/bot/commands#六、break-与票券) | | 抽奖 | 默认每次消耗 2 BREAK，可一次抽 1～1000 次 | ### 3. 群互动 ```text 转账BREAK @用户 10 BREAK抽奖 BREAK抽奖 5 ``` `BREAK抽奖` 默认抽 1 次，数字表示连抽次数。BREAK 仅为 Bot 内部互动积分，不具有 现金价值。 ## 八、论坛账号绑定（qbind） qbind 用于绑定你的**查分 QQ**，绑定后可直接使用签到、查分、B50 等账号功能；首次绑定默认发放 **3 BREAK** 奖励（以 Bot 配置为准）。现在可以用 **QQ 邮箱验证码绑定，无需先注册论坛**；已有论坛账号也可继续走 OAuth。 ### 1. 发起绑定 推荐发送（将示例数字换成自己的 QQ 号）： ```text qbind 123456 ``` 1. Bot 向 `123456@qq.com` 发送一封含 **6 位验证码**的邮件； 2. 在 **10 分钟内**，直接把验证码回复给同一个 Bot 即可，无需再带 `qbind`； 3. 验证码输错 **5 次**会作废，需要重新申请。验证码属于绑定凭据，请勿公开或转发。 只发送 `qbind` 会收到用法提示；`绑定qq` / `mai绑定qq` / `maiqbind` 也可进入邮箱绑定。 ::: warning 收不到邮件或发送受限 先检查 QQ 邮箱垃圾箱，并确认输入的是自己的 QQ 号。同一平台用户、同一 QQ 邮箱均须间隔 **60 秒**才能重发；滚动 24 小时内，同一平台用户最多发 **10 封**、同一 QQ 邮箱最多收 **5 封**；全服每小时最多 **300 封**。受限时请等待，或发送 `论坛绑定` 使用下方备用流程。 ::: **备用：论坛 OAuth 授权。** 发送 `论坛绑定` / `论坛登录` / `AWMC论坛绑定`，Bot 会返回授权引导： 1. 在浏览器打开链接并登录论坛； 2. 论坛邮箱必须使用 `你的QQ号@qq.com`（例如 QQ 是 123456，邮箱就填 `123456@qq.com`）； 3. 授权后，把授权码或完整回调链接发回给 Bot 即可完成绑定，无需再带命令前缀。 > OAuth 授权码同样为 10 分钟有效、仅一次可用。邮箱绑定不可用时，`qbind` 会转为论坛 OAuth 流程，请按 Bot 实际提示操作。 ### 2. 绑定成功 邮箱验证后 Bot 会回执「QQ 邮箱验证成功，绑定完成」，显示查分 QQ 与可用功能；论坛 OAuth 则回执论坛绑定成功。 邮箱绑定还会尝试关联同邮箱的论坛账号；没有账号则自动创建。新建账号可在论坛登录页点「邮件链接登录」，输入 QQ 号免密登录。**论坛关联失败不影响已经完成的查分 QQ 绑定**，是否创建或关联成功以 Bot 回执为准。 ### 3. 查看绑定状态 发送： ```text qbind状态 ``` 别名：`查绑定qq` / `我的qbind` / `论坛绑定状态` / `论坛账号状态` / `论坛状态`。 ### 4. 解绑 / 取消 | 指令 | 说明 | |---|---| | `qunbind` | 查看论坛 / 查分 QQ 解绑报价，不立即扣费（别名：`解绑qq` / `QQ解绑` / `解绑qbind` / `解绑论坛` / `论坛解绑`） | | `qunbind 确认` | 确认扣费并解绑查分 QQ 与论坛身份 | | `取消论坛绑定` | 取消进行中的绑定流程（别名：`论坛绑定取消` / `取消qbind`） | ::: warning 换绑前须付费解绑 已绑定时不能直接用 `qbind` 换绑，须先发送 `qunbind` 查看报价，再发送 `qunbind 确认`。手续费按**旧查分 QQ**的解绑流水累计：首次默认 **100 BREAK**，之后每次 **200 BREAK**，从旧查分 QQ 余额扣除，不享 FREEDOM 或免费窗口；余额不足不解绑。解绑后签到、查分等账号功能需要重新 `qbind`。`取消论坛绑定` 仅取消进行中的流程，不能代替解绑。 ::: ### 5. 查看或修改论坛用户名 发送 `nickname` 查看当前用户名及下次可改时间；发送 `nickname 新名字` 修改（别名：`论坛改名` / `修改论坛用户名` / `改论坛用户名` / `论坛用户名`）。需先成功关联论坛身份，仅有查分 QQ 映射还不够；此入口没有单独 BREAK 扣费逻辑。 自动生成的用户名可立即首次修改，之后通常每 30 天一次，实际限制与可改时间以论坛返回为准。新名字须为 3～25 字符，不能是纯数字、自动用户名、平台 OpenID，也不能含表情或被禁止的特殊字符；重名等情况可能被论坛拒绝。管理账号或不支持 Bot 改名时，请到论坛「账户设置」修改。 ::: info 说明 当前为 OneBot 模式时，消息 QQ 即查分 QQ，无需 qbind / 论坛 OAuth 即可使用账号功能。 ::: ## 九、发票 发送 `发票 2` 或 `fp 2` 请求 2 倍票，当前支持 2、3、5 倍： | 倍率 | 价格（每次成功） | |---:|---:| | 2 倍 | 20 BREAK | | 3 倍 | 30 BREAK | | 5 倍 | 50 BREAK | 发票成功按倍率扣费，没有每日首免；实际提交后失败默认罚 100 BREAK，提交前验码 / 余额检查失败和本地配额拒绝免该罚金。未使用倍率票拦截等条件详见[指令调用说明](/guide/bot/commands#六、break-与票券)，实际金额以 Bot 热配置为准。 使用 `mai查票` 或 `查票` 可按票种、库存和有效期查看票券状态，默认成功查询 1 BREAK；回复不会显示舞萌账号 UID 或原始接口数据。 ::: danger 风险提示 ⚠️ 发票不可逆：票券一经发放必须上机使用，不可以屯票。 发票、上传及二维码相关功能可能影响舞萌官方账号安全。使用前请完整阅读 [AWMC BOT 服务协议与隐私政策](/guide/bot/terms)，并自行承担相应风险。 ::: ## 十、常见问题 ### Bot 提示“尚未建立账号记录” 依次完成： 1. 发送 `mai绑定`，再提交最新的 `SGWCMAID` 字符串或官方链接； 2. 按需发送 `mai绑定水鱼 `，或使用 `lxbind` 绑定落雪 OAuth； 3. 使用 `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 无需 @ 即可回复消息、正常游玩猜歌等功能，请按以下步骤设置。 1. 打开 Bot 的个人主页，点击右上角的设置按钮。 2. 把 Bot 修改为「允许查看所有消息」。 3. 允许 Bot 主动推送消息，保证猜歌等功能可用。 4. 如需 Bot 自动撤回消息，请在群管理中把 Bot 添加为管理员。 ::: warning 开启「允许查看所有消息」的影响 群里的其他 Bot 也会一并读取群消息，可能出现重复回复的情况。 ::: 群主 / 管理员常用的开关与管理指令（小游戏开关、入群验证、自动审批、踢人、排卡、投票等）汇总在 [群管理后台 · 群主 / 管理员指令速查](/guide/bot/group-console#admin-quick-ref)。 如遇问题请联系负责管理员。 午高峰和晚高峰服务可能会有所卡顿，请耐心等待。 ## 十二、更多指令 * [完整指令帮助](/guide/bot/advanced) * [服务协议与隐私政策](/guide/bot/terms) * [术语解释](/guide/bot/explain)