baka86bot 音游查分食用教程

14039 字
70 分钟
baka86bot 音游查分食用教程

baka86bot 功能使用指南合集#

本文档整合了 baka86bot 的多个功能模块使用说明,方便用户快速查阅。


📑 目录导航#

板块说明跳转
4K准度计算器ACC计算器插件使用帮助点击跳转
舞萌DXmaimaiDX插件使用帮助(含相对旧版新增)点击跳转
Paradigm: RebootParadigm: Reboot Prober插件使用帮助点击跳转
PJSKProject Sekai 机器人帮助(官方文档跳转)点击跳转
PhigrosPhi插件使用帮助点击跳转
RizlineRizline(riz-plugin)插件使用帮助点击跳转
CHUNITHMCHUNITHM(中二节奏)插件使用帮助点击跳转
舞萌DX(NoneBot)nonebot_plugin_maimaidx 插件使用帮助点击跳转
舞立方 DanceFengdancefengbot 插件使用帮助点击跳转
osu! / Malodyosu! 与 Malody 插件使用帮助点击跳转

 4K准度计算器使用帮助#

功能介绍#

本插件提供一个交互式的ACC(准确度)计算器,主要用于音游段位认定中,帮助玩家计算单曲ACC或推算段位总体ACC的变化。

使用方法#

通过发送指令#acc计算器来启动计算器。

启动后,机器人会通过一系列交互式问题引导您完成计算。您只需要根据提示回复相应的数字或内容即可。

交互流程#

  1. 启动计算器: 发送 #acc计算器
  2. 选择计算方式:
    • 1: 由段位ACC变化计算单曲ACC(知道每次打完一首歌后的段位总ACC,计算出每首歌的ACC是多少)。
    • 2: 由单曲ACC推算段位ACC变化(知道每首歌的单曲ACC,推算出段位总ACC的变化过程)。
  3. 选择段位类别: 根据机器人列出的段位类别列表,输入序号进行选择。
  4. 选择具体段位: 根据机器人列出的具体段位列表,输入序号进行选择。
  5. 输入ACC: 根据机器人的提示,依次输入ACC数值(0-100)。
  6. 查看结果: 输入所有必需的ACC后,机器人将返回计算结果。

取消操作#

在计算过程中的任何时候,您都可以发送 取消 来退出当前的计算任务。

支持的段位类别#

计算器支持以下多种音游的段位认定:

  • Malody 4K Dan v2
  • Malody 4K Extra Dan v2 (Sample)
  • Malody 4K Dan v3
  • osu!mania 4K Dan ~ REFORM
  • osu!mania 4K Dan ~ REFORM ~ Sample
  • osu!mania 4K Dan ~ REFORM ~ FINAL
  • osu!mania 4K LN Dan Course v2
  • Haku Dan (白段)
  • Senpai Dan v1
  • wds0 Dan
  • osu!mania 7K Regular Dan Course
  • osu!mania 7K LN Dan Course

示例#

你: #acc计算器
机器人: 欢迎使用baka86ACC计算器!
请选择计算方式:
1. 由段位ACC变化计算单曲ACC
2. 由单曲ACC推算段位ACC变化
您可以随时发送"取消"来退出计算。
你: 1
机器人: 请选择段位类别:
1. Malody 4K Dan v2
...
你: 3
机器人: 您选择了【Malody 4K Dan v3】,请选择具体段位:
1. 0
2. 1
...
你: 2
机器人: 请输入第 1 首歌【尘世闲游】结束时的段位 ACC:
你: 98.5
机器人: 请输入第 2 首歌【恋せよ乙女!】结束时的段位 ACC:
你: 98.2
... (继续输入直到完成)
机器人: (返回最终计算结果)

⬆️ 返回顶部 | 下一板块:舞萌DX →


 baka86bot maimaiDX插件使用帮助#

maimaidx - 别名管理#

指令别名可选参数用法备注
添加本地别名添加本地别称 <需要添加的本地别名>添加本地别名 <需要添加的本地别名>添加后可以在baka86bot里用这个别名查到这首歌,不会同步到水鱼别名库
添加别名申请别名, 增加别名, 增添别名, 添加别称 <需要添加的别名>添加别名 <需要添加的别名>
同意别名同意别称同意别名
当前投票当前别名投票, 当前别称投票


[歌曲名/id]有什么别名[歌曲名/id]有什么别称[歌曲名/id]

maimaidx - 基础功能#

指令别名可选参数用法备注
今日mai今日舞萌, 今日运势


mai什么(模糊匹配, 例如 “今天mai什么”)


随个[dx/sd/标准][绿黄红紫白][难度]来个..., 给个...<sd/dx/标准> <绿/黄/红/紫/白><难度>

查看排名查看排行


我的排名(无)


我有多菜



我在群里有多菜



群聊rating排行榜
<排名>群聊rating排行榜<排名>

maimaidx - 猜歌#

指令别名可选参数备注
猜歌


猜曲绘


重置猜歌


开启mai猜歌


关闭mai猜歌


maimaidx - 曲绘#

指令别名可选参数用法备注
提取曲绘
<id>提取曲绘<id>

maimaidx - 谱面印象#

指令别名可选参数用法备注
谱面印象查谱面印象, 曲目印象<id> <别名><原名>

写谱面印象上传谱面印象, 添加谱面印象<曲目id或曲名> <难度0-4> <印象内容>写谱面印象<曲目id或曲名> <难度0-4> <印象内容>难度:0=Basic 1=Advanced 2=Expert 3=Master 4=Re
回复谱面印象回复印象<歌曲id> <评论id> <回复内容>回复谱面印象 <歌曲id> <评论id> <回复内容>
点赞谱面印象点赞印象<歌曲id> <评论id>点赞谱面印象 <歌曲id> <评论id>

maimaidx - 分数 & B50#

指令别名可选参数用法备注
b50B50<qq号> <水鱼昵称> <@某人>b50 <qq号> <水鱼昵称> <@某人>
ab50a50, allb50<@某人>
无视新版本分类
合作b50合作B50<@某人>合作B50<@某人>
合作a50合作A50<@某人>合作A50<@某人>
<难度>b50绿b50, 黄b50, 红b50, 紫b50, 白b50<@某人>紫b50按难度筛选B50
<难度>ab50绿ab50, 黄ab50, 红ab50, 紫ab50, 白ab50<@某人>紫ab50无视版本分类+难度筛选
理想b50
<@某人>
成绩升一级后的B50
理想ab50
<@某人>
无视版本分类+成绩升级
<任意筛选>b50 / ab50见下「难度 B50」
如 紫14+b50、Master 13 ab50由 DifficultyFilter 解析,支持定数区间、谱面类型等(旧版仅支持简写颜色+单数字)
我有多菜



含金量



含水量



fcb50
<@某人>

fcallb50fca50<@某人>
无视新版本分类
apb50(无)<@某人>

apallb50apa50<@某人>
无视新版本分类
拟合b50(无)<@某人>

拟合b50全部拟合allb50, 拟合a50<@某人>
无视新版本分类
寸b50(无)<@某人>

寸ab50寸a50, 寸allb50<@某人>
无视新版本分类
锁血b50锁血B50<@某人>

锁血ab50锁血a50<@某人>
无视新版本分类
越级b50越级B50<@某人>

越级ab50越级a50<@某人>
无视新版本分类
[版本]代b50

真代b50
底力分析(无)


minfoMinfo, MINFO, info, Info, INFO<别名><曲名><曲目id>
曲目信息 包括你的成绩
ginfoGinfo, GINFO<别名><曲名><曲目id>

分数线(无)

计算达到某个完成度至少的容错

maimaidx - 数据存储#

指令别名可选参数用法备注
开启存储数据开启数据存储

开启每日自动存储;首次开启会立即全量同步一次,便于「牌子统计」等走本地快照
关闭存储数据关闭数据存储

关闭自动存储
立即存储数据存储数据

立即手动存储当前成绩数据(需已开启存储)
存储历史查询存储历史, 存储记录[条数]
查看最近快照摘要
查看存档查看存储快照, 存档详情[快照ID]
不传 ID 则查看最新一次快照详情

maimaidx - 友人对战#

指令别名可选参数用法备注
友人对战好友对战[数字]友人对战 / 友人对战 300仅群聊、需成绩功能开关与 开发者 Token。从你 B50 随机一首,在群内匹配 总 rating 水平接近 的已绑定查分器群友,比该谱 达成率(相同再比 DX);结算友对段位/CP(含连胜等)。


数字
可选 50~800:在「分档允许的最大 |Δrating|」内再收紧(取较小值,不能放宽超过分档)。分档按双方 rating 均分:≥16000 → 约 ±50,≥15000 → 约 ±100,再低按阶梯放宽,避免高分碾压/被碾。




对手成绩:已开数据存储则优先用其 最近快照;否则本场对该 QQ 只请求一次 get_dev 全量后在本地筛该谱(减轻单谱 POST 失败与限流)。

maimaidx - 牌子统计#

指令别名可选参数用法备注
牌子统计统计牌子@某人牌子统计 / @xxx 牌子统计统计已完成的 牌子种类数(规则与牌子进度/完成表一致;不含舞·霸代等)。优先用你 最近一次本地快照;若无快照则本指令内 临时拉一次全量 dev 再统计(不写本地)。想省查分负载建议开启存储并 立即存储数据。

maimaidx - 存档与报表#

指令别名可选参数备注
周报成绩周报, maimai周报
基于本地快照的周期报告
月报成绩月报, maimai月报
同上
日报成绩日报, maimai日报
同上
对比存档存档对比, 报告对比<旧ID> <新ID>两次快照对比
今日吃分推荐吃分推荐, 今日推分推荐
需已开启数据存储与足够快照

相较旧版插件(参考仓库 maimaidx-plugin-edit-main)新增与变化#

以下对照的是旧版单文件 mai_score 内指令 + 旧版 libraries 文件集合;当前线上插件为 fork/迭代后的 nonebot_plugin_maimaidx(f:\nb 等部署路径)。

全新或显著扩展的功能

  • 友人对战 / 好友对战:群聊从本人 B50 随机曲目,按总 rating 分档匹配群友比达成率;友对 段位·CP·连胜系数(friend_battle_class);对手成绩优先 本地快照,否则 get_dev 缓存 + 小并发,避免旧版依赖单谱 POST 易失败的问题。
  • 牌子统计 / 统计牌子:按牌子规则统计完成种数;快照优先,无快照时临时拉全量。
  • 群吃分榜、群寸止榜、群锁血榜:旧版 mai_score 中无这三条指令;新版基于群成员 + 存储或全量成绩统计;列表缓存 TTL 与「群聊 rating 排行榜」一致(maimaidx_rating_cache_seconds,默认 15 分钟)。
  • 存档与报表:存储历史、查看存档、周报/月报/日报、对比存档、今日吃分推荐;开启数据存储后 首次立即全量同步(旧版仅有开启/关闭/立即存储,无历史与报表命令入口)。
  • 群内单曲排名:旧版在 mai_score 内用正则匹配;新版独立 mai_song_rank,并与 SongResolver / 难度解析 联动,支持更丰富的歌曲与难度写法。

工程与体验(对玩家多为透明)

  • 新增模块示例:maimaidx_b50_pipeline、maimaidx_difficulty_filter、maimaidx_song_resolver、maimaidx_score_formatter、maimaidx_progress_report、maimaidx_gain_recommend、maimaidx_plate_count 等,用于 B50 流水线、难度筛选、文案与存档分析。

maimaidx - 群排名#

指令别名可选参数用法备注
我在群里有多菜


群内 rating 排名与上下位合并转发
群聊rating排行榜
<排名>群聊rating排行榜<排名>合并转发;列表带缓存(默认 15 分钟,与吃分/寸止/锁血榜一致)
群吃分榜群内吃分榜, 吃分榜可选天数等
旧版无;依赖成员开启数据存储与多次存档
群寸止榜群内寸止榜, 寸止榜

旧版无;全量成绩统计寸止区间
群锁血榜群内锁血榜, 锁血榜

旧版无;全量成绩统计锁血区间
我的 <歌曲> 排名
<歌曲名/别名/id>我的 ガヴリールドロップキック 排名查询自己在本群该歌曲的排名
<歌曲> 排名
<歌曲名/别名/id>ガヴリールドロップキック 排名查询本群该歌曲的排行榜

maimaidx - 查歌#

指令别名可选参数所需权限用法
查歌search


定数查歌search base


bpm查歌search bpm


曲师查歌search artist


谱师查歌search charter


[别名]是什么歌[别名]是啥歌


id[歌曲id]




⬆️ 返回顶部 | ← 上一板块:4K准度计算器 | 下一板块:Paradigm →


Paradigm: Reboot Prober 插件使用帮助#

当前安装的是 API v2 适配版(接口基址默认 https://api.prp.icel.site/api/v2)。所有命令统一使用小写 prp 前缀、命令与参数之间用空格分隔,且不需要 #,例如 prp bind、prp b50。旧版 prp-bind、prp-b50 写法在本版本中不再识别;前缀区分大小写。

Paradigm: Reboot Prober - 绑定与账号#

指令别名参数权限说明
prp bind <用户名> [令牌]无用户名必填,令牌可选无将当前 QQ 绑定到 Prober 账号。只需用户名,不需要密码;插件只校验用户名是否存在并保存映射。带令牌时会自动识别类型(见下)。
prp unbind无无无解绑当前 QQ,删除绑定记录。
prp whoami无无无查看当前绑定的用户名与凭据类型。

绑定示例:

prp bind raincore1115
prp b50

读取成绩依赖目标账号的**匿名查询(anonymous_probe)**开关:已开启可直接读取;未开启会提示“该账号未开启匿名查询”,此时需要带凭据绑定。

带凭据绑定(可选,用于私有账号或上传成绩):

令牌类型作用有效期
refresh_token读取 + 上传长期有效(推荐)
access_token读取 + 上传约 30 分钟
upload_token仅上传成绩,不能读取 B50以平台为准
  • 插件会自动识别令牌:三段点分的是 JWT,纯十六进制的是 upload_token。
  • 遇到 401 时会用 refresh_token 自动续期并重试一次。

免绑定查询公开账号:prp b50 <用户名>、prp stats <用户名> 无需绑定,对方开启匿名查询即可。

Paradigm: Reboot Prober - 成绩查询#

指令别名参数权限说明
prp b50 [用户名]无可选用户名无查询并渲染 Best 50(Current B15 + Past B35)图片。不带用户名查自己,带用户名免绑查询对方公开账号。
prp stats [用户名]无可选用户名无查询 B50 平均 Rating 的本地累积趋势图。没有历史时请先发一次 prp b50。

Paradigm: Reboot Prober - 曲目信息#

指令别名参数权限说明
prp song <曲名>无曲名必填无查询单曲信息图(封面、BPM、曲包、各难度谱面等)。
prp random无无无随机抽取一首范曲并发送歌曲信息图。

Paradigm: Reboot Prober - 成绩上传#

指令别名参数权限说明
prp submit <曲名> <难度> <分数>无曲名、难度、分数(0~1010000)无向绑定账号上传单条成绩,需已绑定且具备可用凭据。

难度可选值与别名(不区分大小写):

难度别名
detectedd、dt
invadedi、in
massivem、ms
rebootr、rb

Paradigm: Reboot Prober - 其他#

指令别名参数权限说明
prp ping无无无测试插件是否存活,回复 pong。

⬆️ 返回顶部 | ← 上一板块:舞萌DX | 下一板块:PJSK →


PJSK 机器人帮助文档#

本板块不再展开具体指令,完整、最新的指令说明请以官方帮助文档为准:

用户数据相关的功能可加 tw / cn 前缀来触发台服 / 国服对应功能;绑定后默认「不给看」,无法被 @。

鸣谢:power by sakura and 8823(sakura 162993657 / 8823 920048364)


⬆️ 返回顶部 | ← 上一板块:Paradigm | 下一板块:Phigros →


Phi插件使用帮助#

命令前缀为 #phi(用 /phi 亦可),例如 #phi b30、#phi绑定。插件自带帮助图会把前缀渲染成 /phi xxx,实际发送时 # 与 / 都能识别。发送 #phi帮助(或 #pgr帮助)可查看自助菜单。

Phi - 绑定与存档#

指令说明
#phi (cn|gb)?(bind|绑定) <sessionToken>绑定 Phigros 查分器 sessionToken;cn 为国服(默认),gb 为国际服
#phi bind qrcode使用二维码方式获取并绑定 sessionToken
#phi (unbind|解绑)解绑并清除本地保存的 sessionToken、API ID、存档与历史(需二次确认,不影响 API 平台绑定)
#phi clean删除所有本地记录
#phi (update|更新存档)手动更新 Bot 端存储的成绩(#phi pgr 也会自动更新)
#phi tk helpsessionToken 相关帮助文档

Phi - 成绩查询与统计#

指令说明
#phi (pgr|rks|b30) [背景]获取 B30 成绩图,可指定背景曲绘
#phi p30 [背景]获取 P30(All Perfect)成绩图
#phi (b|p|x|fc)<N>显示指定数量的成绩图,如 #phi b60、#phi p30、#phi x30、#phi fc30
#phi info[1|2]查看个人统计信息
#phi (score|单曲成绩) <曲目> [-dif 难度] [-or acc|score|fc|time] [-unrank]查询单曲成绩与推分建议;-unrank 关闭排名成绩,-dif 指定排名难度,-or 指定排序方式
#phi (lvsco(re)|scolv) <定数范围> [难度]获取指定区间成绩统计图,如 #phi lvsco 12-15 IN
#phi chap <章节名称|help>查询章节成绩,#phi chap help 查看支持的章节
#phi (ahv|achievement) <定数> [-v 版本]查询定数成绩表,可指定版本号
#phi list [-dif 定数范围] [-acc ACC范围] [难度] [评级]列出所有匹配的成绩,如 #phi list -dif 11.1-12.2 -acc 98.5-100 IN FC
#phi hisb30根据历史记录计算 B30 变化情况
#phi lmtacc <0-100>计算筛去低于指定 ACC 成绩后的 RKS
#phi best<N>文字版 B 成绩(最高 99),建议私聊获取完整版
#phi (suggest|推分) [定数] [难度] [评级]推分建议(使游戏内显示数值 +0.01)
#phi data获取 data 数量

Phi - 图鉴与曲库#

指令说明
#phi (ranklist|排行榜) [名次]放榜
#phi (rankfind|查询排名) [rks]查询 RKS 排名
#phi (song|曲) <曲目> [-comment] [-p 页码]查询曲目图鉴,-comment 展示评论,-p 翻页
#phi chart <曲名> <难度>查询谱面详情
#phi tag <曲名> [难度=IN]查看谱面标签,难度默认为 IN
#phi settag <曲名> [难度=IN] <标签>给谱面打标签,建议先用 #phi tag 查询标签列表
#phi (cmt|comment|评论|评价) <曲名> [难度=IN](换行)<内容>评论曲目,难度默认为 IN
#phi mycmt查看自己的云端评论
#phi recmt <评论ID>查看并确认是否删评(仅发送者与主人权限)
#phi (table|定数表) <定数> [-v 版本]查询定数表,可指定版本号
#phi (ill|曲绘) <曲目>查询曲目曲绘
#phi (rand|随机) [定数] [难度]随机谱面,难度可多选,定数以 - 分隔
#phi randclg [课题总值] [难度] ([定数范围])随机课题,如 #phi randclg 40+ IN
#phi (search|查询|检索) [bpm N-N] [dif N-N] [cmb N-N]按 BPM / 定数 / 物量检索曲目,建议私聊
#phi alias <id或别名>查询曲目别名
#phi (com|计算) <定数> <ACC>计算等效 RKS,如 #phi com 15.9 99.50
#phi tips随机 tips

Phi - 别名提案#

指令说明
#phi (alias submit|别名 提案) <曲目> | <别名> | [私密备注]提交别名提案,仅限私聊且需绑定 sessionToken
#phi (alias mine|别名 我的)查询自己提交的别名提案及审核状态
#phi (alias public|别名 公审)查看正在公开投票的提案、理由与票数
#phi (alias appeal|别名 申诉) <提案ID> | <理由>为被私密拒绝的提案申请公开评审(仅私聊)
#phi (alias vote|别名 投票) <提案ID> <赞成|反对>参与公开投票,也支持 yes/no、1/-1
#phi (alias unvote|别名 撤票) <提案ID>撤回自己对指定提案的投票

Phi - phi-api 账号与权限#

指令说明
#phi apihelp查看 phi-api 绑定、权限与账号管理的详细帮助
#phi bind <查分ID>将当前平台账号绑定到已有 phi-api 查分账号
#phi auth <API Token>用 API Token 验证账号并获取、保存对应的 Phigros sessionToken
#phi setApiToken <新Token>设置或更新 phi-api 的 API Token(需本地已绑定 SSTK)
#phi (tkls|lstk)查看 phi-api 账号当前绑定的全部平台账号
#phi apiset [设置项] [开|关]查看或修改数据收集、排行榜、数据聚合、搜索权限,如 #phi apiset 排行榜 关
#phi clearApiData永久注销 phi-api 账号并清除云端数据(需二次确认)

Phi - 娱乐与个人设定#

指令说明
#phi (ltr|开字母)开字母小游戏:#出 A / #open A 开字母,#第n个 / #nX.xxx 回答,#ans 看答案
#phi (guess|猜曲绘)猜曲绘,直接回复曲名,#ans 结束
#phi (tipgame|提示猜曲)提示猜歌,#tip 获取下一条提示,#ans 看答案
#phi (theme|主题) [0-3]切换绘图主题
#phi market浏览主题市场:#phi market list [关键词] [页码]、#phi market detail <slug>
#phi (myset|个人设置) [字段] [值]查看或修改个人设置,值支持序号选择
#phi (sign|签到)签到获取 Notes 与任务卡
#phi (send|送|转) @目标 <数量>转账 Notes,会扣除部分手续费
#phi (task|我的任务)查看自己的任务
#phi (retask|刷新任务)花费 Notes 重置任务,每日首次免费
#phi jrrp查询今日人品(仅供娱乐)

Phi - 管理员命令(仅主人)#

指令说明
#phi set<功能><参数>修改设置,先发 #phi set 查看功能名称(命令与参数之间无空格)
#phi backup [back]备份存档;加 back 发送备份文件,自动保存于 /phi-plugin/backup/
#phi restore从备份还原(需先把文件放入 /phi-plugin/backup/)
#phi (setnick|设置别名) <原名>---><别名>设置某一歌曲的别名
#phi (delnick|删除别名) <别名>删除某一歌曲的别名
#phi repu重启 puppeteer(仅支持最新版喵崽)
#phi (下载曲绘|down ill)下载曲绘到本地,首次安装或渲染异常时优先执行
#phi [强制]更新 / #phi gx更新本插件
#phi get <名次>获取排行榜上某一名次的 sessionToken
#phi del <sessionToken> / #phi allow <sessionToken>禁用 / 恢复某一 sessionToken
#phi ban <功能> / #phi unban <功能>禁用 / 恢复某一类功能
#phi updateUserToken / #phi updateComment批量同步本地 sessionToken / 本地评论到 phi-api

Rizline(riz-plugin)插件使用帮助#

命令头由配置项 cmdhead 决定,默认值为 r,可用 # 或 / 触发,即 #r 曲 xxx 与 /r song xxx 等价。下文统一以默认的 #r 书写;若你修改了 cmdhead,请把 r 换成自己的命令头。

Rizline - 图鉴与定数#

指令别名参数权限说明
#r 曲 <曲名>#r song <曲名>曲名或别名(必填)无查询 Rizline 曲目图鉴并渲染图片,使用模糊匹配。匹配到多首时会列出编号,等待你回复序号(默认 10 秒)后继续。
#r 定数表 <定数>[+]#r table <定数>[+]定数(必填),尾部可加 +无按定数查表并渲染图片。14 = 14.014.5,14+ = 14.614.9,上限 15.1。

图鉴与 b40 受群禁用分类 song 控制;定数表不受群禁用控制。

Rizline - 平台绑定#

绑定原理:通过 riz-plugin-api 平台(默认 https://phib19.top:8090)把 Rizline 账号绑定到 Bot 用户,获得 sessionToken 供后续查分使用。

指令别名参数权限说明
#r bind [otk_xxx] [备注]#r 绑定 [otk_xxx] [备注]可选一次性密钥 otk_xxx 或会话令牌 st_xxx,可选备注无不带参数:Bot 申请临时授权链接(5 分钟有效),你打开链接同意协议并登录后,Bot 每 3 秒轮询并自动完成绑定。带 otk_:直接兑换 sessionToken。带 st_:直接写入绑定。
#r unbind#r 解绑平台无无解绑当前平台账号,清除本地 sessionToken。
#r bindinfo#r 绑定平台无无查看绑定状态:token 尾号、备注、平台地址、绑定时间。

绑定 / 解绑 / 绑定状态均受群禁用分类 bind 控制。

Rizline - 存档与 B40#

指令别名参数权限说明
#b40#r b40 / #r B40无无读取平台存档中 RKS 最高的 40 首渲染 B40 图(含头像、背景、称号、总 RKS 等)。触发即实时拉取存档,无需先执行更新命令;未绑定会提示先绑定。

Rizline - 管理功能(仅主人)#

指令别名参数权限说明
#riz 更新#rzl / #RIZ / #Riz / #日子线 + 更新 或 gx,可插 强制 / qz可选 强制/qz主人更新插件本体(git pull,强制模式会重置到远端)。
#riz 下载曲绘上述命令头 + 下载/更新/gx/down/up + 曲绘/ill无主人下载或更新曲绘资源到 resources/original_ill/。

注意:更新与下载曲绘的命令头固定为 riz 系列,不跟随 cmdhead(不能用 #r更新);且必须以主人权限执行曲绘下载,否则曲绘无法正常展示。

已知差异:README 提到的 /rizhelp 帮助菜单与 #update 命令在代码中并未注册;b40 会实时拉取存档,无需手动更新。本文即以源码为准整理。


CHUNITHM(中二节奏)插件使用帮助#

命令前缀统一为 chu,前面的 # 可省略,例如 chu b50、#chu song 曲名。chu帮助 允许 chu 后带一个可选空格;chu随个、chu随机 中「随/机」须紧跟 chu。

CHUNITHM - 帮助与基础#

指令别名参数权限说明
chu帮助#chu帮助、chu help无无显示插件内置帮助文本,末尾附带当前数据源(louis / 落雪)。

CHUNITHM - 曲目查询(公开,无需绑定)#

指令别名参数权限说明
chu song <曲名>#chu song <曲名>支持精确曲名、精确别名、模糊包含匹配无渲染曲目数据卡,展示 ID、曲师、分类、BPM、版本、各难度定数与物量。
chu songid <ID>#chu songid <ID>数字 musicID无以「封面图 + 文字」形式返回曲目信息。
<曲名>是什么歌 / <曲名>是什么曲无(全局触发,不需要 chu 前缀)曲名无等价于 chu song。
chu calc <分数> <曲名> [难度]#chu calc ...分数(0~1010000)、曲名、可选难度(默认 master)无计算单曲 rating,并给出允许的 JUSTICE / ATTACK / MISS 最大数量。
chu随个 [范围]chu随机、#chu随个可选等级范围(如 12、14+、14.0~15.7)无随机抽取一首曲目并展示曲目卡。

难度可写 bas/adv/exp/mas/ult,也接受 basic/advanced/expert/master/ultima 等完整写法。

CHUNITHM - 别名管理(公开)#

指令别名参数权限说明
chu set <别名> <曲名>#chu set ...别名、曲名无为指定曲目新增别名,已存在时会提示不要重复设置。
chu alias <曲名>#chu alias ...曲名无列出该曲目当前的全部别名。

CHUNITHM - 账号绑定与 OAuth(仅限私聊)#

指令别名参数权限说明
chu bind <louis|lx> <TOKEN>#chu bind ...服务器(louis 或 lx)、个人 API Token无(须私聊)校验 Token 通过后保存绑定,并把默认服务器设为所选服务器。
chu oauth#chu oauth无无(须私聊)生成落雪(LXNS)OAuth 授权链接,在授权页获得形如 JVJ6-VPTM-MGHZ 的授权码。
chu oauth <授权码>#chu oauth <code>授权码无(须私聊)用授权码换取访问 / 刷新令牌并保存,默认服务器设为落雪,令牌到期自动刷新。
chu oauth status#chu oauth status无无(须私聊)查看当前默认服务器、OAuth 授权状态或个人密钥绑定情况。
chu oauth unbind#chu oauth unbind无无(须私聊)解除本地保存的落雪 OAuth 授权。

CHUNITHM - 成绩查询(需先绑定账号)#

指令别名参数权限说明
chu b30#chu b30无无(需绑定)拉取并渲染 Best30 卡片。
chu b50#chu b50无无(需绑定)渲染 Best50 卡片:Top30 + New20。
chu score <曲名>#chu score <曲名>曲名无(需绑定)查询该曲全部难度的成绩与单曲 rating,渲染成绩卡。
chu list <等级区间>#chu list <等级区间>1215+,或 12.015.7 的小数定数无(需绑定)按定数区间列出该区间所有谱面的成绩与曲绘。
chu progress <版本>#chu progress <版本>版本名或别名(初代、无印、air、star、new、sun、luminous、verse-x、mate 等)无(需绑定)展示指定版本曲目的成绩分布。

CHUNITHM - 曲库维护与门条件#

指令别名参数权限说明
chu update#chu update无无(帮助文本标注“管理员”,代码未强制校验)按配置的数据源拉取曲库与定数并写入本地。
chu downill#chu downill无无(同上)下载曲绘仓库到本地,支持 githubProxy 代理。
origin门条件 / air门条件origin的门槛、ori门、air门 等前缀含 origin/ori/air无发送对应的门条件图片。

已知限制:成绩类命令需先绑定,绑定与 OAuth 仅能在私聊完成;chu update、chu downill 的内置帮助虽标注“管理员”,但源码未做主人 / 群管校验。帮助文本中的 chu b30 [/simple] 参数实际未实现,缺曲绘提示里的 chu 更新曲图 实际命令为 chu downill。


舞萌DX(NoneBot 版)插件使用帮助#

适用插件 nonebot_plugin_maimaidx(NoneBot2 + OneBot V11,移植自 mai-bot)。命令直接发送命令文字即可(如直接发 b50),源码没有自定义前缀,是否需前缀取决于 Bot 全局 COMMAND_START。唯一例外:倍率票 /tk2、/tk3、/tk5 必须带斜杠。

  • 数据源只有两个:水鱼 Diving-Fish 与 落雪 Lxns-Network(「舞萌」是游戏名,不是第三个数据源),用 数据源 切换。
  • 多数指令支持 @某人 查询对方,不 @ 则查自己;未标注权限的普通成员可用,部分需先绑定查分器。

舞萌DX(NoneBot) - 账号绑定与设置#

绑定落雪(推荐,支持 AP50 / 上传落雪):先在落雪「左上角菜单 → 账号详细 → 舞萌DX → 第三方应用」下滑复制个人 API 密钥,然后发送 lxtokenbind,按提示完成绑定;随后需在落雪「隐私设置」中开启允许读取成绩。

绑定水鱼:发送 dfbindtoken <水鱼Token>,Token 在水鱼个人设置获取(127–132 字符)。

注意:dfbind(别名 绑定水鱼、绑定df)自上游 3.1.x 起已改为 OAuth 绑定;本地 Token 绑定请改用 dfbindtoken。

指令别名参数权限说明
lxtokenbindlxbind、绑定落雪、绑定lx[落雪密钥]普通用户落雪 Token 绑定(个人 API 密钥);旧写法 lxbind 仍作为别名可用
dfbindtoken水鱼绑定、水鱼token、水鱼Token<水鱼Token>普通用户水鱼 Token 本地绑定,Token 为 127–132 字符
dfbind绑定水鱼、绑定df—普通用户水鱼 OAuth 绑定(上游 3.1.x 起从 Token 绑定改为此)
数据源—[序号]普通用户切换数据源:0=水鱼,1=落雪
主题—[序号]普通用户切换绘图表主题:0=prism_plus,1=circle
verify验证baka86.love普通用户阅读协议完成白名单验证(365 天),部分机台/上传功能需要

舞萌DX(NoneBot) - 机台会话(白名单,需先 verify)#

指令别名参数权限说明
登录扫码登录、sdgb登录、机台登录[SGWCMAID...]白名单用户机台扫码登录
登出退出登录、sdgb登出—白名单用户结束机台会话
登录状态会话状态、sdgb状态—白名单用户查看会话与闲置时间
查票查询票券、票券[SGWCMAID...]白名单用户查询功能票 / 免费票
拿票获取倍率票、倍率票、tk<2/3/5>白名单用户获取倍率票,如 拿票 2
/tk2 /tk3 /tk5——白名单用户带斜杠的倍率票快捷写法
更新pc数—[SGWCMAID...]白名单用户拉取机台游玩次数(PC 数),可附二维码;pc50 / pca50 需要先有它

群内发送 SGWCMAID... 后请尽快撤回;Bot 是管理员时会自动撤回。

舞萌DX(NoneBot) - 成绩上传与引导(白名单)#

指令别名参数权限说明
导引导、上传引导、快速开始[1/2/3/水鱼/落雪/都]白名单用户上传引导:设定默认上传方式,之后 导 SGWCMAID... 一键上传
上传帮助导帮助、查分器帮助、上传教程—普通用户完整的 B50 上传图文教程
上传水鱼水鱼b50、水鱼B50SGWCMAID...白名单用户把机台成绩上传到水鱼
上传落雪落雪b50、落雪B50SGWCMAID...白名单用户把机台成绩上传到落雪

设定默认上传方式:导 1 / 导 水鱼 只传水鱼;导 2 / 导 落雪 只传落雪;导 3 / 导 都 两个都传。发过 导 之后也可以直接回复 1 / 2 / 3 来选择。

一键上传:设好默认方式后发送 导 SGWCMAID... 即可按默认方式上传;想临时指定平台就用 上传水鱼 SGWCMAID... / 上传落雪 SGWCMAID...。

⚠️ SGWCMAID... 属于个人信息,发送后请尽快撤回。上传前请先绑定查分器(水鱼 dfbindtoken、落雪 lxtokenbind)。

舞萌DX(NoneBot) - astral 机台写入(白名单)#

对机台账号的真实写操作,属于白名单功能。免二维码:不写二维码时复用你 登录 时建立的会话;也可以直接在命令里带二维码(84 字符 SGWCMAID...)走一次性登录。

指令别名参数权限说明
upload—[二维码] <曲ID> <难度> <达成率> [DX分] [选项...]白名单用户上传一局成绩到机台账号
unlock—[二维码] <曲ID...>白名单用户解锁这些曲目的 MASTER 与 Re
kaleidxscopeks解锁、门解锁、钥匙解锁、unlock-ks[二维码] <门/钥匙ID...> 或 gate=1,2 key=3,4白名单用户解锁 KALEIDXSCOPE 的门(发现)/ 钥匙(获得)
reincarnate-plan—<me|源二维码|uid=userId|json=文件名> [per=1/3/4] [limit=N]白名单用户转生分批预览(只读,不改数据)
reincarnate—[目标二维码] <me|源二维码|uid=userId|json=文件名> [per=1/3/4] [limit=N]白名单用户把源账号的全量成绩分批写入目标账号

upload 参数说明

  • 难度用序号:0=Basic、1=Advanced、2=Expert、3=Master、4=Re。
  • 达成率可写 100.5(百分比)或 1005000(万分比)。
  • 判定总数与各类 note 构成会自动从谱面表读取,通常不用手填。
  • 常用选项(空格分隔、顺序任意):fc / fc+ / ap / ap+ 连击状态;miss= / great= / good= 全局判定数;combo= 最大连击;tap= / hold= / slide= / touch= / break= 逐类型判定明细;notes= 覆盖判定总数。
  • 示例:/upload 143 3 100.5 1234、/upload 10030 3 101 ap、/upload 143 3 99.5 fc miss=3

kaleidxscope 参数说明

  • 用于解锁 KALEIDXSCOPE 的门(发现)与钥匙(获得),门 / 钥匙 ID 在当前版本一一对应。
  • 只写数字 = 同时解锁门与钥匙,例如 /kaleidxscope 1 2 3。
  • 想只解锁其中一种就分开写:gate=1,2 只开门,key=3,4 只拿钥匙(逗号分隔)。
  • 示例:/kaleidxscope 1 2 3、/kaleidxscope gate=1,2 key=5

转生(reincarnate)怎么用

源账号可以是 me(当前登录账号)、一张源二维码、uid=<userId>,或放在 json= 里的文件;per= 控制每批数量(1 / 3 / 4),limit= 限制总上传数。

⚠️ 两条务必注意:

  1. 写操作直接执行,没有二次确认,且 reincarnate 不可撤销。转生请先用 reincarnate-plan 核对分批,再用 limit=10 之类的小批量试跑。
  2. 成绩参数会在发包前按 astral 的硬约束自查(判定之和、连击上限、FC/AP 一致性等),不一致会直接拒绝,避免出现「显示成功但没落库」。

舞萌DX(NoneBot) - B50 与成绩#

指令别名参数权限说明
b50B50[用户名]普通用户(需绑定)查询 Best50
lxap50—[用户名]普通用户(需绑定)落雪原生 AllPerfect50(水鱼源不支持)
ab50a50、allb50—普通用户(需绑定)无视分组取全量前 50
pc50PC50、Pc50—普通用户(需绑定)按机台游玩次数(PC)出图,分组对齐 b50(旧曲 PC35 + 新曲 PC15),排除宴谱;需先发过 更新pc数
pca50PCA50、Pca50—普通用户(需绑定)对齐 ab50,无视版本分组,全量按 PC 降序取前 50
<变体>b50—[阈值]普通用户(需绑定)fc/ap/拟合/寸止/锁血/越级/理想,如 fcb50、越级b50 97
<难度>b50——普通用户(需绑定)如 紫14+b50、红13.5 b50
<版本代>b50——普通用户(需绑定)如 熊代b50、镜代b35、dx2026b35
l<版本代>b50——普通用户(需绑定)旧版本定数重算,如 l熊代b50
合作b50合作a50@好友普通用户(需绑定)与好友合并 B50
帮助扩展扩展帮助、maimai帮助、舞萌帮助—普通用户输出扩展功能菜单

舞萌DX(NoneBot) - 对手查询(白名单)#

指令别名参数权限说明
对手信息对手资料、查对手信息<对手 userId>白名单用户查询对手昵称,不依赖机台会话
对手分数对手查分、查对手、对手成绩、rival<对手 userId>白名单用户拉取对手全量成绩,按 rating 取前 50(B35 + B15)出图,需机台会话
传分免扫码传分、rival传分、机台传分<游戏 userId>白名单用户把该 userId 的机台成绩免扫码导到自己绑定的水鱼账号;两步确认

读他人成绩属于敏感操作,因此与「登录 / 上传」保持同一门槛(需先 verify)。可先用 对手信息 <userId> 确认能否查到该玩家,再用 对手分数 出图。

传分 <userId> 会先发一份预览,确认无误后回复 传分 确认 <userId> 才会真正写入水鱼;需要先绑定水鱼 Import-Token。

舞萌DX(NoneBot) - 曲目查询#

指令别名参数权限说明
<关键词>查歌—[页码]普通用户按歌名搜索
定数查歌 <定数>—[最大] [页码]普通用户按定数范围查歌
bpm查歌 <BPM>—[最大] [页码]普通用户按 BPM 查歌
曲师查歌 <名字>—[页码]普通用户按曲师查歌
谱师查歌 <名字>—[页码]普通用户按谱师查歌
<别名>是什么歌<别名>啥歌[页码]普通用户如 天火是什么歌
id <歌曲ID>—<ID>普通用户按 ID 查询并附谱面印象
<歌曲>有什么别名<歌曲>有什么别称—普通用户查询曲目别名
随个[dx/sd][难度][等级]来个、给个—普通用户随机谱面,如 随个dx红13
mai什么——普通用户随机谱面;带推分/上分且已绑定时给推荐

舞萌DX(NoneBot) - 单曲成绩与谱面工具#

指令别名参数权限说明
infominfo<ID/曲名/别名>普通用户(需绑定)查询指定曲目的个人成绩
ginfo—[难度] <ID/曲名>普通用户查询谱面全局统计
分数线—<难度+ID> <目标达成率>普通用户计算分数线容错;分数线 帮助 看说明
谱面—<ID><绿/黄/红/紫/白>普通用户谱面预览,如 谱面 799紫
提取曲绘—<曲名/ID>普通用户提取并发送曲绘
多版本定数图定数变化图、历代定数<曲目ID>普通用户历代定数变化曲线

舞萌DX(NoneBot) - 猜歌与群聊功能#

五种猜歌玩法:发送 mai猜歌 会先列出模式菜单,回复编号(或模式名)即可开局。

编号玩法说明
1特征猜歌每 8 秒给出一条特征,共 7 条,最后给出裁切曲绘
2猜曲绘只给出裁切后的曲绘
3听音猜歌只给出 5 秒 key 音片段
4干扰猜曲绘裁切曲绘叠加模糊 / 反相 / 色相等干扰,逐个推进提示
5开字母猜歌同时打码 5 首曲名,群友翻字符或抢答
指令别名参数权限说明
mai猜歌—[1-5 或模式名]群成员(仅群聊)呼出模式菜单,选完开局
猜歌——群成员(仅群聊)特征猜歌,每 8 秒提示
猜曲绘——群成员(仅群聊)群内猜曲绘,30 秒内作答
猜key音听音猜歌、猜歌听音—群成员(仅群聊)只给 5 秒 key 音片段
开字母mai开字母、开字母猜歌—群成员(仅群聊)开字母猜歌:同时打码 5 首曲名
mai提示猜歌提示—群成员(仅群聊)开字母局中随机翻开一个字符(冷却 60 秒)
结束开字母开字母答案、mai答案—群成员(仅群聊)提前公布答案
重置猜歌 / 开启mai猜歌 / 关闭mai猜歌——群主/管理员/超管管理本群猜歌
我在群里有多菜——群成员群内实力排名
群聊rating排行榜群聊rating排行[数量]群成员默认前 10,最多 50
群吃分榜吃分榜[天数] [数量]群成员天数 1–90、数量 1–50
群寸止榜 / 群锁血榜寸止榜、锁血榜[数量]群成员默认 15,最多 50
友人对战好友对战[rating差限]群成员(需绑定)群内友人对战
<歌曲名>排名—[难度] [数量]群成员如 天火排名 紫 10
我的<歌曲名>排名—[难度]群成员查询自己在群内的排名

开字母猜歌怎么玩

操作写法说明
翻开字符出X / 开X / 翻X / open X拉丁字母、假名罗马音首字母、汉字拼音首字母均可;全局冷却 8 秒
抢答猜1 歌名 / n1. 歌名 / 1. 歌名猜第 1 首;全局冷却 3 秒
求提示mai提示随机翻开一个字符,冷却 60 秒
提前结算结束开字母直接公布答案
自动结算—无人操作 5 分钟后自动结算

同一群已有对局进行中时不能再开新局,会提示先发送 结束开字母。

舞萌DX(NoneBot) - 排名与每日#

指令别名参数权限说明
查看排名—[页码或昵称]普通用户Rating 排行榜
我的排名——普通用户(需绑定)查询自己的 Rating 排名
今日舞萌——普通用户今日人品值与推荐曲
我要在[等级]上加[分数]分——普通用户(需绑定)上分推荐,如 我要在14上加100分
帮助maimaiDX帮助maimaidx—普通用户原版图文帮助
项目地址maimaiDX项目地址maimaidx—普通用户插件项目地址

舞萌DX(NoneBot) - 定数表 / 完成表 / 牌子#

指令参数权限说明
<等级>定数表—普通用户仅 lv7–15,如 13定数表
<等级><fc/ap>完成表—普通用户(需绑定)如 13ap完成表
牌子条件—普通用户完成表条件图
<牌子>完成表[页码]普通用户(需绑定)如 真将完成表
<牌子>进度[页码]普通用户(需绑定)如 真将进度
<等级><评价>进度[已完成/未完成/未开始] [页码]普通用户(需绑定)如 14ap进度 未完成
<定数>分数列表[页码]普通用户(需绑定)如 13.5分数列表

舞萌DX(NoneBot) - 存储 / 报表与分析#

指令别名参数权限说明
开启存储数据开启数据存储—普通用户开启每日自动存档
关闭存储数据关闭数据存储—普通用户关闭自动存档
立即存储数据存储数据—普通用户(需绑定)立即抓取并存储
存储历史存储记录[数量]普通用户最近存档记录(1–50)
查看存档存档详情[快照ID]普通用户查看存档详情
对比存档存档对比[旧ID 新ID]普通用户对比两次存档
日报 / 周报 / 月报maimai日报 等—普通用户(需绑定)1 / 7 / 30 天成绩报告
今日吃分推荐吃分推荐—普通用户(需绑定)需先开启存储
牌子统计统计牌子—普通用户(需绑定)牌子完成情况
底力分析——普通用户(需绑定)基于 B50 的底力标签分析图
含金量 / 含水量——普通用户(需绑定)含金量 / 含水量分析
我有多菜—[@某人/用户名]普通用户战力对比

舞萌DX(NoneBot) - 谱面印象#

指令别名参数权限说明
谱面印象查谱面印象、曲目印象<曲目名/ID>普通用户查看谱面印象(最多 10 条)
写谱面印象上传谱面印象<曲目名/ID> <难度0-4> <星级1-5> [内容]普通用户提交谱面印象
回复谱面印象回复印象<曲目名/ID> <评论ID> <内容>普通用户回复某条印象
点赞谱面印象点赞印象<曲目名/ID> <评论ID>普通用户点赞某条印象

舞萌DX(NoneBot) - 别名库与管理员命令#

指令别名参数权限说明
添加别名申请别名、添加别称<歌曲ID> <别名>普通用户(仅群聊)向别名服务器申请新增
添加本地别名添加本地别称<歌曲ID> <别名>普通用户仅加入本地别名库
同意别名同意别称<投票TAG>普通用户(仅群聊)为别名投票
当前投票当前别名投票[页码]普通用户查看进行中的别名投票
开启别名推送 / 关闭别名推送——群主/管理员/超管开关本群别名推送
全局开启别名推送 / 全局关闭别名推送——超级用户全局开关
更新别名库——超级用户(仅私聊)手动更新别名库
更新maimai数据——超级用户(仅私聊)手动更新曲目数据
更新定数表 / 更新完成表——超级用户重新生成定数表 / 完成表

部署提示:落雪绑定与数据源需管理员配置 lxns_dev_token(或 lx_client_id + redirect_uri);水鱼开发者 Token 为 divingfish_token;多版本定数图 / 版本 B50 需 maimaidx_dxdata_path(dxdata.json);机台功能需 sdgbtechapi 等;底力分析需 tag_index_v3.json、tags.json、response.json。


舞立方(DanceFeng)插件使用帮助#

适用插件 dancefengbot(NoneBot2 + OneBot V11,原 Mirai/Java 版 DanceFengBot 的移植版)。命令直接发送命令文字即可,源码没有自定义前缀。

所有命令普通用户均可用;但登录、登出、手机号登录、机台登录、Token、兑换码仅限私聊,图片查询类需先登录。

舞立方 - 快速开始(登录流程)#

舞立方账号无需预先在网页绑定,登录后 Token 会自动保存到 data/dancefengbot/UserTokens.json,同一 QQ 在其它会话也能用。

方式一:微信扫码(推荐)

私聊发送:舞立方登录
→ Bot 回复登录二维码
→ 微信扫码,5 分钟内完成登录
→ 成功提示「登录成功,舞立方 ID:xxxx」

方式二:手机号 + 短信验证码

私聊发送:手机号登录 13800000000
→ 回复图中的图形验证码
→ 回复收到的短信验证码 → 登录成功

方式三:机台登录:先完成上述任一登录,再私聊发送 机台登录 <机台二维码链接>(别名 jt)。

登录后,私聊发送 15 位字母数字兑换码即可兑换自制谱,例如 AbCdEf123456789。

流程中任意一步发送 取消 可退出登录。

舞立方 - 账号与登录命令#

指令别名参数权限说明
舞立方登录登录—普通用户(仅私聊)获取微信登录二维码,5 分钟内扫码
手机号登录验证码登录<手机号>普通用户(仅私聊)手机号 + 图形码 + 短信码登录
退出登录——普通用户(仅私聊)删除本地保存的 Token
机台登录jt<二维码链接>普通用户(仅私聊)用已登录 Token 完成机台登录
舞立方Token#token—普通用户(仅私聊)查看当前 Token 信息
刷新舞立方Token#refresh—普通用户(仅私聊)手动刷新 Token

舞立方 - 机台查询与图片查询#

指令别名参数权限说明
查找舞立方查找机台、舞立方机台<地区>普通用户按地区查机台(≤15 字),最多显示前 5 条
个人信息看看我的、我的舞立方、mydc、mywlf—普通用户(需登录)生成个人资料图片
战力分析我的战力、myrt—普通用户(需登录)生成战力分析图片
战力分析b30myrtb30—普通用户(需登录)B30 战力分析图片
战力分析ap30myrtap30—普通用户(需登录)AP30 战力分析图片
成绩查询查询成绩、myplay[序号]普通用户(需登录)最近游玩记录,序号默认 1
分数列表难度分数列表[难度] [页]普通用户(需登录)按难度查询分数列表

机台类型带 [秀] 表示秀机台;查找舞立方 依赖高德 GAODE_API_KEY,未配置则无法定位地区。

舞立方 - 帮助与配置速查#

指令别名说明
舞立方帮助舞立方菜单、dancefeng帮助发送舞立方功能文字帮助
配置项位置是否必须说明
舞立方 client_id 列表data/dancefengbot/TokenIds.json必须JSON 数组,缺失则无法生成登录二维码
用户 Tokendata/dancefengbot/UserTokens.json自动生成插件自动读写,勿提交版本库,每 24 小时自动刷新
高德地图 Key.env 的 GAODE_API_KEY可选供 查找舞立方 地区转经纬度

警告:兑换码是一条宽泛正则,任意私聊消息中只要含 15 位连续字母数字就会尝试兑换,请注意。


osu! / Malody 插件使用帮助#

osu!(含 osu!mania)与 Malody 相关功能分两部分:

  1. 日常查分 / 通用指令:见官方帮助文档 https://docs.365246692.xyz/help/;
  2. osu!mania 高级分析工具箱:插件 nonebot-plugin-osumania-toolkit,命令为 /omtk 系列。

工具箱除 osu! 谱面(.osu / .osz)外,同样支持 Malody 谱面(.mc / .mcz 图包),并可用 /cvtscore 在不同游戏之间转换成绩。

工具箱命令都带斜杠(如 /mapview),且多数需要「回复一条含谱面/回放文件的消息」后再发命令。

osu! - 官方帮助文档(日常指令)#

查成绩、玩家信息、谱面搜索、群排行榜、猜歌等常用指令都在帮助站,按首字母与分类排列,点击卡片进入对应文章:

👉 https://docs.365246692.xyz/help/

osu! - mania 工具箱总览#

发送 /omtk 查看主菜单;发送 /omtk <命令名> [页码] 查看某条命令的详细用法。

指令别名功能
/omtk—工具箱帮助菜单;/omtk <命令名> [页码] 看详情
/mapview/rework谱面键型分析与难度估计
/pressingtime/按压回放按键时长分布
/analyze/分析、/analyse作弊分析(多维度)
/delta/偏差判定偏差柱状图
/lifebar/血条、/life血条变化折线图
/spectrum/频谱回放打击频谱
/scatter/散点判定位置散点图
/pattern/键型谱面键型分析
/percy/投皮LN 皮肤「投机取巧程度」修改
/acc/单曲单曲 ACC 计算 / 推算
/ett/msdEtterna(MinaCalc)难度计算
/cvtscore/转换按目标规则重算回放成绩
/omtk report—反馈问题(跳转 GitHub Issues)

osu! - 谱面分析:/mapview(别名 /rework)#

命令格式:

/mapview b<bid> +[mods] x[speed] OD[OD]

示例:

/mapview b4094064 +EZHO x1.25
/mapview b4094064 +IN OD8
参数写法说明
bidb + 整数从官网获取谱面;也可直接输入谱面网址
mods+ 开头支持 HR/EZ、DT/HT、IN/HO、DC/NC,大小写不敏感
speedx / * / × 开头倍速,范围 0.25–3.0
ODOD 开头OD 覆写,范围 -15–15

也可回复一条含 .osu/.mc(或 .osz/.mcz 图包)的消息再发 /mapview;回复文件时会忽略 bid。图包分析开销大,请勿滥用。

osu! - 回放图表类#

以下命令都需要回复一条含 .osr/.mr 回放文件的消息,再发送命令:

指令别名说明
/pressingtime/按压按键时长分布图
/spectrum/频谱打击频谱图
/lifebar/血条、/life血条变化折线图(回复 .osr)
/delta/偏差判定偏差柱状图(按列着色)
/scatter/散点判定位置二维散点图

/delta 与 /scatter 可同时用 b<bid>(或网址)指定谱面,例如 /delta b4094064(同时回复回放)。

osu! - 作弊分析:/analyze(别名 /分析)#

⚠️ 该命令开销较大,请勿滥用;结果为算法生成,仅供参考。

命令格式:/analyze [-reason] [b<bid>]

  • 回复 .osr/.mr 可触发分析;指定 bid(或输入网址)会直接分析 delta_t;未指定 bid 时可继续发送 .osu/.mc 或输入 1 执行无谱面分析;
  • -reason:未检测到作弊时也输出分析详情(作弊 / 可疑时始终输出);
  • 提供谱面时生成四格图:按压时长分布、脉冲序列频谱、delta_t 直方图、delta_t 散点图;不提供谱面时只生成前两张;
  • 文本按「时域与按压时长」「脉冲序列」「偏移」三块给结论,异常会标记 <!>(作弊)或 <*>(可疑)。

示例:/analyze b4094064

osu! - 键型分析:/pattern(别名 /键型)#

  • 用法 1:回复含 .osu/.mc/.osz/.mcz 的消息,再发 /pattern;
  • 用法 2:直接 pattern b<bid>,如 /pattern b4094064;
  • 加 -d 或 -detail 获取详细结果(以合并转发发送)。

LN 键型分析处于实验性状态。

osu! - Etterna 难度:/ett(别名 /msd)#

命令格式:/ett b<bid> x[speed],示例 /ett b4094064 x1.25。

  • 也可回复 .osu/.mc 或 .osz/.mcz 文件(回复文件时忽略 bid);
  • 仅支持 rate(如 x1.5),不支持 mods、OD 覆写和 IN/HO;
  • 使用 Etterna 0.74.0 MinaCalc,结果仅供参考。

osu! - 单曲 ACC:/acc(别名 /单曲)#

两种用法:

  1. 直接命令:
/acc [-r] <段位名> <acc>
/acc [-r] b<bid> [单曲个数] <acc> [-sv2]
  1. 交互模式:直接发送 /acc [-r],按提示操作。

说明:

  • 用 - 分隔 acc,如 99.4-99.3-98.8-97.6;用半角 , 分隔自定义物量,如 1145,1419,1981;
  • 支持上传 .osu/.mc 谱面文件;
  • -sv2 启用 sv2 模组;-r 反向计算(通过单曲 ACC 推算段内变化,仅首次命令可用);
  • 指定 bid 仅首次命令可用,可用网址代替。

段位列表:/omtk acc 2(可用段位)、/omtk acc 3(全部内置段位)。

osu! - 成绩转换:/cvtscore(别名 /转换)#

输入:回放(.osr/.mr) + 谱面(b<bid> 或 .osu/.mc) + 目标 ruleset。

示例:

/cvtscore Quaver/chill sc diff4 # 然后发送回放
/cvtscore b4094064 -sv2 # 然后发送回放和谱面
/cvtscore # 交互模式
  • 目标 ruleset 写法:模板优先(如 sc diff4、wife3 j7),具体规则用 Group/Name(如 Quaver/chill);
  • -sv2 / sv2 / +sv2 开启 sv2,-nosv2 / nosv2 / sv1 关闭;
  • 参数大小写不敏感;/omtk cvtscore 2 看参数详解、/omtk cvtscore 3 看全部 ruleset。

osu! - 投皮修改:/percy(别名 /投皮)#

回复一条含 .png 图片的消息,同时发送 /percy [d] [lazer|lzr](建议用文件发送,避免被压缩)。

  • d:目标投机取巧程度(整数),不填则仅识别并返回当前程度;
  • lazer / lzr:按 Lazer 规则处理与显示(会做 -75px 修正、下限 0,图片长度固定 32800px)。

示例:/percy、/percy 150、/percy 225 lzr

暂不支持渐变颜色面身、非单一颜色、身尾分离或含图案的面身;需要批处理 / 修复面尾白线请用 LeoBlackMT/percy_skin_editor。

osu! - 反馈与部署提示#

  • 反馈:/omtk report,或到 Issues 提交。
  • 部署:本工具箱是 NoneBot2 插件(nonebot-plugin-osumania-toolkit);Unix 系统上需给 algorithm/ett/official_minaclac_runner 加执行权限(chmod +x)才能正常使用 /ett;若图包分析触发段错误崩溃,可执行 pip uninstall uvloop 规避。

附录:舞萌插件更新公告(相对 maimaidx-plugin-edit-main 旧版)#

以下为可直接发群/动态的示例,可按需删改链接与 Bot 名。

【baka86bot / 舞萌 maimaidx 更新说明】
相对旧版参考插件,本次迭代主要多了这些能力:
① 友人对战:群内随机你 B50 一曲,按总 rating 分档匹配群友比达成率;带友对段位、CP、连胜;拉分优先走本地存档,更稳、更省查分器。
② 牌子统计:统计牌子完成种数,快照优先。
③ 群吃分榜 / 群寸止榜 / 群锁血榜:新指令;群榜类结果会与 rating 榜共用同一套缓存时间(默认约 15 分钟)。
④ 存档与报表:存储历史、查看存档、周/月/日报、存档对比、今日吃分推荐;开启「数据存储」后会立刻全量同步一次。
⑤ 单曲群内排名:独立指令模块 + 更强难度/曲名解析;难度 B50 也支持「紫14+」等复杂写法。
详细指令表见博客《baka86bot 音游查分食用教程》舞萌章节。

文档最后更新时间:2026-10-25

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!

赞助
baka86bot 音游查分食用教程
https://blog.baka86.love/posts/bot-help-integrated/
作者
RainCore
发布于
2026-04-24
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
RainCore
and in that light, I find deliverance.
公告
你好 这里是雨核 请输入文本喵 你看到这段话的时候已经变猫娘了喵
视奸我在干嘛awa
0 台在线 共 2 台设备
正在获取设备状态…
雨核在github干嘛
加载中...
Token 用量
站点统计
文章
5
分类
2
标签
68
总字数
27,292
运行时长
0 天
最后活动
0 天前
访问统计
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签

目录