Seira Bot

成绩查询与分析 ​

/bp：最好成绩 ​

/bo 是 /bp 的完整别名。

单条详情 ​

text
/bp
/bp <过滤条件 ...>

使用自己的绑定 UID 查询最好成绩并返回单条成绩详情。未指定过滤条件时返回第 1 条；仅指定过滤条件、不指定数量时，会在前 200 条最好成绩中返回第一个符合全部条件的成绩。未绑定时无法使用。

text
/bp acc>=98 mod!~DT

多条汇总 ​

text
/bp <数量或范围> [UID/用户名/@用户] [过滤条件 ...]
text
/bp 5
/bp 21-30
/bp 10 peppy
/bp 3 124493
/bp5 @用户
/bp21-30 @用户

数量和范围端点必须在 1–200 之间，且范围起点不能大于终点。空格写法中的单个数字会被当作列表数量；紧凑写法 /bpN [玩家] 则查询第 N 条成绩详情。

过滤成绩 ​

/bo、/bp、/rs（以及 /rp）可在原参数后追加一个或多个过滤条件，多个条件同时满足才会展示：

text
/bp 10 acc>=98 combo>=1000
/bp 8 peppy mod~HD mod!~DT pp>=300
/rs 12 time<2:30 rank!=F
/rp 20 title~"Song Name" mapper!=peppy video=true

<数量> 表示先获取多少条原始成绩，再在这些成绩上应用过滤；<范围>（如 21-30）则只展示该范围内的原始成绩，序号仍与普通查询一致。过滤条件会在所选范围内应用，因此过滤后的实际展示数量可能更少。终点超过 100 时，系统会继续获取第 101–200 条后再统一处理。支持的字段和写法如下：

数量或范围也可以紧跟在命令名后：/bp5 @用户 查询该玩家的第 5 条最好成绩详情，/bp21-30 [@用户] 查询第 21–30 条列表。/rs、/rp 支持相同写法。

字段含义支持的运算符示例
acc / accuracy准确率，数值按百分比> >= < <= = !=acc>=98.5
combo最大连击数值运算符combo>=1000
ppPP数值运算符pp>300
time / length / len原谱面总时长数值运算符time<150、time<2:30、time<2m30s
star / sr星数数值运算符star>=6.5
bpmBPM数值运算符bpm>180
missMiss 数数值运算符miss=0
score总分数值运算符score>=1000000
rank成绩评级> >= < <= = !=rank>=S
mod / modsMod 集合~ 包含、!~ 不包含、= 完全等于、!= 不完全等于mod~HD、mod=HDDT、mod=NM
any全部谱面文本元数据= 包含、!= 不包含any=stream
title歌曲标题（含 Unicode 标题）~ !~ = !=title~"Big Black"
artist艺术家（含 Unicode 名称）~ !~ = !=artist="xi"
mapper谱师~ !~ = !=mapper!=peppy
genre曲风~ !~ = !=genre~Rock
language语言~ !~ = !=language=English
video是否包含视频= !=，值为 true / falsevideo=true
storyboard是否包含 Storyboard= !=，值为 true / falsestoryboard=false
fullcombo是否 Full Combo= !=，值为 true / falsefullcombo=true

运算符只支持表格中的符号写法。 过滤值包含空格时，需要用双引号，例如 title~"The Big Black"； 双引号不会成为匹配内容的一部分。

rank 的比较顺序为 XH = SSH > X = SS > SH > S > A > B > C > D > F。例如，rank>=S 会匹配 S、SH、SS/X、SSH/XH。

文本条件支持用方括号包裹正则表达式，例如 title="[^(Blue|Red) Sky$]"、artist!=[xi|sakuzyo]。正则匹配不区分大小写，并在字段文本中查找匹配项。any 会同时搜索标题、艺术家、谱师、难度名、来源、标签、曲风和语言等谱面文本元数据，也支持相同的正则写法。

常用条件可以使用简写：

简写等价条件
1miss / !1missmiss=1 / miss!=1
video / !videovideo=true / video=false
sb / !sbstoryboard=true / storyboard=false
fc / !fcfullcombo=true / fullcombo=false
!S（其他评级同理）rank!=S

/rs：最近成绩 ​

text
/rs
/rs <过滤条件 ...>
/rs <数量或范围> [UID/用户名/@用户] [过滤条件 ...]
  • 无参数：返回本人最近成绩第 1 条详情。
  • 仅有过滤条件：在本人前 200 条最近成绩中返回第一个匹配项的详情。
  • 有数量：生成最近 n 条成绩汇总，包含失败成绩。
text
/rs
/rs acc>=99 miss=0
/rs 5
/rs 5 peppy

/rp：最近通过成绩 ​

用法与 /rs 相同，但过滤失败成绩：

text
/rp
/rp pp>=300 mod~HD
/rp 5
/rp 5 124493

无参数时等价于取本人 rp1 的单条成绩详情。

/tb：近期达成 BP ​

text
/tb [#N] [UID/用户名/@用户]

获取指定玩家近 N 天内达成的 BP，并显示其完整 BP 排名编号。 省略 #N 时默认为近 1 天，省略玩家时查询自己的绑定账号。天数必须为正整数。

text
/tb
/tb #7
/tb #30 peppy
/tb peppy
/tb 124493

/s：单条成绩 ​

text
/s [成绩ID或快捷查询]
text
/s 1234567890
/s rs5
/s peppy bo3
/s

显式目标会成为该用户的最近目标。省略目标时沿用最近一次目标；若没有最近目标则显示用法。

也可以直接发送 /rs5、/rp2、/bo3，解析器会把这种完整快捷指令路由到 /s。

/sa：成绩分析 ​

text
/sa [成绩ID或快捷查询]

生成指定成绩的分析图。目标解析、最近目标和快捷查询规则与 /s 相同。

text
/sa 1234567890
/sa rs1

/ma：Miss 分析 ​

/ma 可以先列出 Miss，也可以可视化指定的某一次 Miss。

列出 Miss ​

text
/ma [成绩ID或快捷查询]
text
/ma rs1
/ma

不提供 Miss 序号时返回该成绩的 Miss 列表。省略目标时必须已有最近目标。

可视化一个 Miss ​

text
/ma <成绩ID或快捷查询> <序号>
/ma #<序号>
text
/ma rs1 2
/ma 1234567890 1
/ma #3

当显式提供成绩目标时，序号可写 2 或 #2；当省略目标并沿用最近目标时， 必须写 #2，否则数字会被误认为成绩 ID。序号必须为正整数。

/u：玩家资料 ​

text
/u [UID/用户名/@用户]
text
/u
/u peppy
/u 2
/u @某人

玩家资料卡，包含 PP、全球与地区排名、Rank 变化趋势、 游玩统计、评级计数及 5 条最好成绩。

无参时指定为自己。

/ux：玩家基本数据 ​

text
/ux [UID/用户名/@用户]
text
/ux
/ux peppy
/ux @某人

玩家基本数据，包含 PP、全球与地区排名、游玩统计等信息，返回文字结果。

无参时指定为自己。

/@：快捷查询玩家 ​

text
/@
/@用户

相当于 /ux [@用户]。

/wx：成绩监视 ​

text
/wx start <UID列表> <谱面ID列表>
/wx stop

开始监视指定玩家在指定谱面取得的成绩，成功获取后会发送成绩ID。 监视任务会持续存在并运行，直到执行了 /wx stop 。

/rbp：随机BP ​

同 /bp，但是从1-200中随机选择一个BP。

Seira is under MIT License