umbel 命令参考 beta
allium-umbel QQ Bot 全部命令及参数说明。功能持续迭代中,可能会有变动。
参数类型
umbel 自动识别以下参数类型,按优先级提取:
| 类型 | 格式 | 说明 |
|---|---|---|
| @提及 | @用户 | 通过 QQ @功能指定目标用户(优先级最高) |
| 游戏 ID | 纯数字 5-20 位 | 如 123456789012345,匹配 ^\d{5,20}$ |
| 活动 ID | 纯数字 1-6 位 | 如 123,仅组卡类命令使用 |
| 账号选择器 | p1 / u1 / ... | 指定绑定的第 N 个账号(见下方「多账号选择」) |
| 无参数 | (空) | 默认查发送者自己 |
多账号选择
如果你绑定了多个游戏账号,可以在任意命令中用 p1/u1、p2/u2 指定使用哪个账号。编号与 /账号 列表中显示的序号一致。
/活动组卡 u1 满级 ex用第 1 个绑定的账号组卡/个人信息 p2用第 2 个绑定的账号查个人名片/自定义名片 p1用第 1 个绑定的账号查自定义名片/星图 p2用第 2 个绑定的账号查星图不写 pN/uN 时使用默认账号(/账号 列表中标记 [默认] 的那个)。用 /切换 修改默认账号。
名片
/个人信息/名片, /profile平台个人资料名片。无参数时查自己,@用户查询目标用户,输入游戏 ID 查询对应账号,用 pN/uN 指定绑定的第 N 个账号。返回图片。
/个人信息 — 查自己的名片/个人信息 @用户 — 查该用户的名片/个人信息 123456789012345 — 查该游戏 ID 的名片/个人信息 p2 — 查自己第 2 个绑定的名片/自定义名片/cp, /costume游戏内自定义名片(多页)。参数规则同 /个人信息。静态页为 JPEG,动态页为 H.264 MP4;合并转发先发送逐页图片/视频,最后用精简文本列出每页 wall、关键阶段和整批端到端耗时。若目标用户未设置自定义名片,返回提示。
/自定义名片 — 查自己/cp @用户 — 查他人的自定义名片/cp tN/自定义名片 tN, /costume tN查看 CN 当前活动排行榜第 N 名玩家的自定义名片。Umbel 直接读取 rks-n.exmeaning.com 的公开最新快照,仅支持 top100 内的名次;不经过 allium 排行榜代理或存储。每次只能查一位,返回该玩家全部名片页的合并转发消息。
/cp t1 — 查看第 1 名的自定义名片/cp t100 — 查看第 100 名的自定义名片组卡
组卡类命令默认使用你的默认账号;可在命令中加 pN / uN 指定绑定的第 N 个账号。
通用参数(所有组卡命令通用,顺序随意、可组合):
· 养成开关(在你已有的卡上假设养成,可多选):满级 / 满破 / 满技能 / 满剧情 / 画布
· 顶配:无视你的卡况,用图鉴模拟一套满配卡组
· 火数(0火 / 1火 / 5火 / 10火):只影响结果图显示的活动点数,不改推荐卡组
· 歌曲难度(ex / ma / hard / nm / easy / apd):影响 base_score 与技能分权重;不指定默认 expert
· 活动团 / 属性(ln / mmj / vbs / ws / 25 / vs / cool / cute / happy / pure / 紫):指定活动加成口径
· 硬过滤(仅ln / 仅紫 / 仅活动团):限制候选卡池;VS 双团卡只要支援团匹配就算命中
· 协力参数(协力 / 欢乐 / 队友综合250000 / 队友技能200 / 协力技能下限250 / 对手分数1234567 / 体力800)
· 技能参数(吸分最高 / 吸分最低 / 技能顺序最差 / 指定顺序43210 / 不抢队长)
· 其他高级参数(wl / 马拉松 / 嘉年华 / 锁花前后 / 排除卡123,456)
· 其他文本(如歌名):同时当作 WL 章节角色和歌曲查询发给 web;角色优先,无法识别为角色时由 web 解析为 music_id
固定队长 / 成员(用 # 前缀,空格分隔):第一个 # 是队长,其余是必含成员。# 后接角色名(如 #初音 #mfy)或卡 ID(如 #123)。
· 限制:角色名与卡 ID 可混用,但混用时队长 = 第一个卡 ID(想精确控队长就别混用)。
· 挑战组卡只能用 #卡ID(不支持 #角色名)。最多 5 个;队长与成员不能同角色;锁定的卡/角色必须在你的卡组里。
· 注意:裸数字(如 170)是活动 ID,卡 ID 要写成 #170。锁定会牺牲部分分数(约束下最优,非全局最优)。
/活动组卡/活动组队按当前活动推荐组卡,目标为最高分(score)。可指定活动 ID(纯数字 1-6 位)查特定活动,给定活动 ID 时不自动绑定当前活动。世界开花活动可指定章节角色名(如 mfy、初音)优化该章节,不填则默认第一个章节角色。用 # 固定队长/成员(第一个 # 是队长)。叠加通用参数(养成/顶配/火数/难度)。<b>其他文本</b>同时当作章节角色名与歌曲查询。返回图片。
/活动组卡 — 当前活动推荐/活动组卡 123 — 指定活动 ID/活动组卡 170 mfy — 世界开花指定章节角色/活动组卡 170 #初音 #mfy 满级 — 初音当队长+必含mfy+全满级/活动组卡 顶配 — 用图鉴模拟满配卡组/活动组卡 u1 满级 ex — 用第 1 个绑定的账号组卡/挑战组卡/挑战组队挑战活动组卡推荐(live_type=challenge)。会优先从文本中识别挑战角色,剩余文本作为歌曲名或别名。固定只能用 #卡ID,<b>不支持 #角色名</b>(会提示报错)。可叠加通用参数(养成/顶配/火数/难度)。返回图片。
/挑战组卡 — 当前挑战活动推荐/挑战组卡 初音未来 — 指定角色挑战组卡/挑战组卡 miku 十周年 ma — 指定角色 + 歌曲 + MASTER/最强组卡/best综合力(power)最优组卡,排除活动加成(force_no_event)。适用于无活动期间。可叠加通用参数(养成/顶配/火数/难度)。固定 # 与其他文本均忽略。返回图片。
/最强组卡/最强组卡 顶配/best 满级/最强组卡 u1/最弱组卡/worst综合力(power)最低组卡(minimize),排除活动加成,娱乐向。参数规则同 /最强组卡:可叠加通用参数,固定 # 与其他文本均忽略。返回图片。
/最弱组卡/worst 顶配/烤森组卡/烤森组队, /ms组卡烤森活动专用组卡推荐(target=mysekai、live_type=mysekai),默认使用当前活动,也可指定活动 ID。可叠加通用参数(养成/顶配/火数/难度)。固定 # 与其他非数字文本忽略。返回图片。
/烤森组卡/烤森组卡 123/烤森组卡 顶配/烤森组卡 u1/组卡/组队, /deck通用组卡入口,行为同 /活动组卡。返回图片。
/组卡/deck 123/deck 170 mfy 满级账号
/绑定/bind将 QQ 账号与游戏 ID 绑定。绑定成功后在 /账号 列表中显示游戏名(如有)。重复绑定同一游戏 ID 仅触发幂等返回(不重复写入,但也不获取新的游戏名)。返回文本确认。
/绑定 123456789012345/验证确认 QQ 身份。接受 C- 或 c- 前缀的验证码,统一归一化为大写 C- 后发送。签名验证(V- 流程)在网页端完成,不走此命令。返回确认结果文本。
/验证 C-XXXXXX — QQ 身份确认/账号查看当前 QQ 账号下所有已绑定的游戏账号列表。显示游戏名(如有)、遮挡后的游戏 ID(前 3 后 3,中间 ***)、绑定等级(numeric / 已验证)、别名、默认标记。返回列表文本。
/账号/切换切换默认游戏账号。可传 /账号 列表里的编号(1 起,不限位数)、游戏 ID 或别名。切换后所有命令的默认账号随之改变。返回确认文本。
/切换 1 — 按列表编号切换/切换 100 — 三位数编号也可用(不限制位数)/切换 123456789012345 — 按游戏 ID 切换/切换 主号 — 按别名切换/别名为已绑定的游戏账号设置别名。第一个参数为别名,第二个参数为游戏 ID(5-20 位纯数字)。别名可用于 /切换 和显示。成功后显示遮挡后的游戏 ID。返回确认文本。
/别名 主号 123456789012345/解绑/unbind解除 QQ 账号与游戏 ID 的绑定。参数规则同 /切换:支持列表编号(1 起)、别名、游戏 ID。删除后无法恢复,需重新 /绑定。返回确认文本。
/解绑 1 — 按编号解绑第 1 个账号/解绑 主号 — 按别名解绑/解绑 123456789012345 — 按游戏 ID 解绑其他
/星图/mysekai收获地图(MySekai star chart)。默认查自己的默认账号,可用 pN/uN 指定。返回星图图片及数据上传时间。需验证绑定。
/星图/mysekai/星图 u1 — 查第 1 个绑定的星图/help/帮助, /?, /菜单返回简短提示并指向本文档页面。完整命令、参数与示例以本页为准。
/help/帮助/?/ping连通性检查。Bot 存活确认,返回 "pong from allium-umbel"。
/ping