组卡查看器开源组件文档服务状态
开发者控制台
文档

起步

快速开始

接入指南

Bot 接入umbel 命令

参考

API 参考QQ 表情图鉴

数据上传

总览AndroidiOS

平台

隐私与模型

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 | p1/p2/u1/u2 | 无

平台个人资料名片。无参数时查自己,@用户查询目标用户,输入游戏 ID 查询对应账号,用 pN/uN 指定绑定的第 N 个账号。返回图片。

示例
/个人信息 — 查自己的名片/个人信息 @用户 — 查该用户的名片/个人信息 123456789012345 — 查该游戏 ID 的名片/个人信息 p2 — 查自己第 2 个绑定的名片
/自定义名片/cp, /costume
参数@用户 | 游戏ID | p1/p2/u1/u2 | 无

游戏内自定义名片(多页)。参数规则同 /个人信息。静态页为 JPEG,动态页为 H.264 MP4;合并转发先发送逐页图片/视频,最后用精简文本列出每页 wall、关键阶段和整批端到端耗时。若目标用户未设置自定义名片,返回提示。

示例
/自定义名片 — 查自己/cp @用户 — 查他人的自定义名片
/cp tN/自定义名片 tN, /costume tN
参数t1 ~ t100(排行榜第 N 名)

查看 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。锁定会牺牲部分分数(约束下最优,非全局最优)。

/活动组卡/活动组队
参数活动ID | #固定 | 通用参数 | p1/p2/u1/u2(均可选)

按当前活动推荐组卡,目标为最高分(score)。可指定活动 ID(纯数字 1-6 位)查特定活动,给定活动 ID 时不自动绑定当前活动。世界开花活动可指定章节角色名(如 mfy、初音)优化该章节,不填则默认第一个章节角色。用 # 固定队长/成员(第一个 # 是队长)。叠加通用参数(养成/顶配/火数/难度)。<b>其他文本</b>同时当作章节角色名与歌曲查询。返回图片。

示例
/活动组卡 — 当前活动推荐/活动组卡 123 — 指定活动 ID/活动组卡 170 mfy — 世界开花指定章节角色/活动组卡 170 #初音 #mfy 满级 — 初音当队长+必含mfy+全满级/活动组卡 顶配 — 用图鉴模拟满配卡组/活动组卡 u1 满级 ex — 用第 1 个绑定的账号组卡
/挑战组卡/挑战组队
参数挑战角色名 | 歌曲名/别名 | #卡ID | 通用参数 | p1/p2/u1/u2(均可选)

挑战活动组卡推荐(live_type=challenge)。会优先从文本中识别挑战角色,剩余文本作为歌曲名或别名。固定只能用 #卡ID,<b>不支持 #角色名</b>(会提示报错)。可叠加通用参数(养成/顶配/火数/难度)。返回图片。

示例
/挑战组卡 — 当前挑战活动推荐/挑战组卡 初音未来 — 指定角色挑战组卡/挑战组卡 miku 十周年 ma — 指定角色 + 歌曲 + MASTER
/最强组卡/best
参数通用参数 | p1/p2/u1/u2(均可选)

综合力(power)最优组卡,排除活动加成(force_no_event)。适用于无活动期间。可叠加通用参数(养成/顶配/火数/难度)。固定 # 与其他文本均忽略。返回图片。

示例
/最强组卡/最强组卡 顶配/best 满级/最强组卡 u1
/最弱组卡/worst
参数通用参数 | p1/p2/u1/u2(均可选)

综合力(power)最低组卡(minimize),排除活动加成,娱乐向。参数规则同 /最强组卡:可叠加通用参数,固定 # 与其他文本均忽略。返回图片。

示例
/最弱组卡/worst 顶配
/烤森组卡/烤森组队, /ms组卡
参数通用参数 | p1/p2/u1/u2(均可选)

烤森活动专用组卡推荐(target=mysekai、live_type=mysekai),默认使用当前活动,也可指定活动 ID。可叠加通用参数(养成/顶配/火数/难度)。固定 # 与其他非数字文本忽略。返回图片。

示例
/烤森组卡/烤森组卡 123/烤森组卡 顶配/烤森组卡 u1
/组卡/组队, /deck
参数活动ID | #固定 | 通用参数 | p1/p2/u1/u2(均可选)

通用组卡入口,行为同 /活动组卡。返回图片。

示例
/组卡/deck 123/deck 170 mfy 满级

账号

/绑定/bind
参数游戏ID(必填,5-20 位纯数字)

将 QQ 账号与游戏 ID 绑定。绑定成功后在 /账号 列表中显示游戏名(如有)。重复绑定同一游戏 ID 仅触发幂等返回(不重复写入,但也不获取新的游戏名)。返回文本确认。

示例
/绑定 123456789012345
/验证
参数C-验证码(必填,C- 或 c- 前缀均可)

确认 QQ 身份。接受 C- 或 c- 前缀的验证码,统一归一化为大写 C- 后发送。签名验证(V- 流程)在网页端完成,不走此命令。返回确认结果文本。

示例
/验证 C-XXXXXX — QQ 身份确认
/账号
参数无

查看当前 QQ 账号下所有已绑定的游戏账号列表。显示游戏名(如有)、遮挡后的游戏 ID(前 3 后 3,中间 ***)、绑定等级(numeric / 已验证)、别名、默认标记。返回列表文本。

示例
/账号
/切换
参数编号 | 游戏ID | 别名(必填)

切换默认游戏账号。可传 /账号 列表里的编号(1 起,不限位数)、游戏 ID 或别名。切换后所有命令的默认账号随之改变。返回确认文本。

示例
/切换 1 — 按列表编号切换/切换 100 — 三位数编号也可用(不限制位数)/切换 123456789012345 — 按游戏 ID 切换/切换 主号 — 按别名切换
/别名
参数别名 游戏ID(两个参数,必填)

为已绑定的游戏账号设置别名。第一个参数为别名,第二个参数为游戏 ID(5-20 位纯数字)。别名可用于 /切换 和显示。成功后显示遮挡后的游戏 ID。返回确认文本。

示例
/别名 主号 123456789012345
/解绑/unbind
参数编号 | 别名 | 游戏ID(必填)

解除 QQ 账号与游戏 ID 的绑定。参数规则同 /切换:支持列表编号(1 起)、别名、游戏 ID。删除后无法恢复,需重新 /绑定。返回确认文本。

示例
/解绑 1 — 按编号解绑第 1 个账号/解绑 主号 — 按别名解绑/解绑 123456789012345 — 按游戏 ID 解绑

其他

/星图/mysekai
参数p1/p2/u1/u2 | 无

收获地图(MySekai star chart)。默认查自己的默认账号,可用 pN/uN 指定。返回星图图片及数据上传时间。需验证绑定。

示例
/星图/mysekai/星图 u1 — 查第 1 个绑定的星图
/help/帮助, /?, /菜单
参数无

返回简短提示并指向本文档页面。完整命令、参数与示例以本页为准。

示例
/help/帮助/?
/ping
参数无

连通性检查。Bot 存活确认,返回 "pong from allium-umbel"。

示例
/ping
Empty Sekai
联系我们隐私政策

© 2026 Empty Sekai · 非官方工具,与 SEGA / Colorful Palette 无关