赤歌姬指令清单
一、点歌台观众指令
点歌和队列
| 指令 | 说明 |
|---|---|
点歌 歌名 | 点网易云歌曲 |
点bv BV号[/分P] | 点 B站视频；需后台开启 BV 点播 |
查询 0 | 查询当前播放 |
查询 序号 | 查询指定待播项 |
查询 @B站用户名 | 查询指定用户的播放和待播项目 |
查询 歌名或歌手 | 模糊查询活动队列 |
查询 \纯数字文本 | 强制把纯数字按歌名或歌手查询 |
置顶 序号/歌名 | 置顶普通歌曲；权限、范围、价格和冷却按设置 |
置顶bv 序号/标题 | 置顶 BV；权限、范围、价格和冷却按 BV 设置 |
切歌 [序号/歌名] | 切当前普通歌曲或取消待播歌曲；通常至少能操作自己的歌，实际按设置 |
切bv [序号/标题] | 切当前 BV 或取消待播 BV；实际按设置 |
快进 数量 | 默认按分钟快进；当前配置为仅房管，观众只有改成“全部”后可用 |
快进 数量秒 | 按秒快进，例如 快进 30秒 |
快进 数量分钟 | 显式按分钟快进，例如 快进 2分钟 |
查询、签到和资产
| 指令 | 说明 |
|---|---|
查询余额 | 查询电池和积分 |
签到 | B站签到；与绑定账号的 QQ 签到共用一次，每天04:00开启新一天签到 |
绑定 绑定码 | 使用 QQ 端生成的6位绑定码完成绑定 |
冒泡 | 刷新自己的活跃时间 |
冒泡@用户名 | 为自己和指定用户冒泡；一次最多代20人 |
兑换电池 数量 | 使用积分兑换电池；需开启兑换且满足汇率 |
兑换积分 数量 | 使用电池兑换积分；需开启兑换且满足汇率 |
赠送积分 @B站用户名 数量 | 向系统内用户赠送积分 |
主题、颜色和其他
| 指令 | 说明 |
|---|---|
颜色 #RRGGBB | 免费预览颜色，不保存主题 |
颜色 随机 | 免费预览随机颜色 |
主题 部位 #RRGGBB | 修改部位颜色；部位包括标题、播放信息、点歌人、歌词、列表文字、歌单、列表标题、列表点歌人 |
主题 部位 随机 | 随机修改指定部位 |
主题 主题序号/主题名称 | 切换已保存主题 |
主题 随机 | 随机刷新整套主题 |
主题 保存 名称 | 保存当前主题并返回序号 |
随机数 数量 [最小值，最大值] | 生成1～20个随机整数 |
喊话 内容 | 向已配置的 QQ 通知目标喊话；是否允许观众及冷却按设置 |
当前全部配置方案的主题规则：房管和观众修改部位1积分、切换主题1积分、整体随机10积分，保存主题免费。主播、真实管理员以及有效卡片效果仍按特权规则处理。
二、点歌台管理指令
主播、真实管理员和房管也能使用上一节的普通指令；下表是管理操作。房管能否使用由后台对应权限决定，主播和真实管理员通常拥有最高业务权限。
| 指令 | 说明 |
|---|---|
快进 数量[秒/分钟] | 当前方案仅房管及以上可用；管理员体验卡也可用 |
置顶 序号/歌名 | 可按配置置顶任意普通歌曲 |
置顶bv 序号/标题 | 可按配置置顶任意 BV |
切歌 [序号/歌名] | 可按配置切当前或他人的普通歌曲 |
切bv [序号/标题] | 可按配置切当前或他人的 BV |
拉黑 歌曲标题 | 拉黑普通歌曲标题 |
取消拉黑 歌曲标题 | 取消歌曲标题黑名单 |
拉黑@B站用户名 | 禁止指定 UID 点普通歌曲 |
取消拉黑@B站用户名 | 取消普通歌曲用户黑名单 |
拉黑bv BV号[/分P] | 拉黑整个 BV 或指定分P |
取消拉黑bv BV号[/分P] | 取消 BV 黑名单 |
拉黑bv@B站用户名 | 禁止指定 UID 点 BV |
取消拉黑bv@B站用户名 | 取消 BV 用户黑名单 |
禁言 @B站用户名 分钟 | 点歌台内部禁言，不是 B站官方群禁言 |
取消禁言 @B站用户名 | 取消点歌台内部禁言 |
清列表 | 清除超时不活跃且没有免清保护的待播项目 |
强制清列表 | 清除全部待播项目；管理员体验卡不具备此权限 |
冷却置顶 分钟 | 开启或重启全局置顶冷却，范围1～1440分钟 |
取消冷却置顶 | 关闭全局置顶冷却 |
喊话 内容 | 主播和真实管理员始终允许；房管按喊话设置 |
补充：管理员体验卡可以获得项目明确授予的置顶、切歌、Ban位绕过、拉黑、禁言、普通清列表、主题和快进特权，但不能执行 强制清列表。
三、Q群普通用户指令
帮助、状态和查询
| 指令 | 说明 |
|---|---|
帮助 | 显示主帮助；同义词：菜单、help、/help |
点歌台帮助 | 显示点歌台查询与资产帮助 |
签到帮助 | 显示绑定和签到帮助 |
排行榜帮助 | 显示排行榜帮助；同义词：排行帮助 |
背包帮助 | 显示背包帮助 |
抽奖帮助 | 显示抽奖帮助 |
状态 | 查询 B站直播状态；同义词：直播状态 |
点歌台状态 | 查询点歌台服务、播放和等待数量 |
当前播放 | 查询当前播放；同义词：当前、正在播放 |
队列 | 查询待播队列；同义词：点歌队列、等待队列、列表、当前列表 |
我的身份 | 显示当前群、私信和用户标识；同义词：身份、openid |
QQ 机器人当前不支持 点歌、点bv、置顶、切歌 或 快进，这些命令需要在 B站直播间发送。
绑定、签到和排行榜
| 指令 | 说明 |
|---|---|
绑定 B站用户名 | 申请10分钟有效的绑定码，再到 B站发送 绑定 绑定码 |
绑定 | 查询当前绑定账号 |
解除绑定 | 解除当前 QQ 与 B站账号绑定 |
签到 | QQ 签到；需要先绑定 B站账号 |
签到排行 | 连续签到榜和累计签到榜；同义词：签到排行榜 |
歌曲排行 周期 数量 | 周期支持昨日、本周、上周、本月、上月、累计；数量1～30，默认10 |
歌曲排行 ban位 数量 | 查询本周 Ban 位，数量1～30，默认10 |
歌手排行 周期 数量 | 查询歌手排行，数量1～30，默认10 |
积分、背包和道具
以下资产操作均需要先绑定 B站账号。
| 指令 | 说明 |
|---|---|
查询余额 | 查询绑定账号的电池和积分 |
冒泡 | 刷新绑定 B站用户的活跃时间 |
兑换电池 数量 | 积分兑换电池 |
兑换积分 数量 | 电池兑换积分 |
赠送积分 B站用户名 数量 | 向指定用户赠送积分 |
我的背包 | 查看绑定账号的道具 |
赠送道具 B站用户名 道具名 [数量] | 赠送背包道具，数量默认1 |
消耗道具 免清列表一天卡 [数量] | 开启免清列表效果 |
消耗道具 管理员一天体验卡 [数量] | 开启管理员体验特权 |
消耗道具 免费主题一天卡 [数量] | 开启主题免费效果 |
消耗道具 100积分卡 [数量] | 每张兑换100积分 |
消耗道具 补签卡 xxxx年x月x日 | 补过去未签到的日期，不补发历史积分 |
使用道具 是 消耗道具 的同义说法。单次个人列表+1卡 是点歌时自动消耗的被动道具；头衔改名卡 和 🌿 当前不能主动使用。
抽奖和喊话
| 指令 | 说明 |
|---|---|
奖池列表 | 查看全部启用奖池 |
奖池 [奖池名称] | 查看奖池阈值和奖品；不填时使用默认池 |
道具 [道具名称] | 查看全部道具或指定道具介绍 |
抽奖 [奖池名称] 积分 | 消耗指定积分真实抽奖 |
模拟抽奖 [奖池名称] 积分 | 完整模拟，但不扣积分、不发奖、不修改保底进度 |
抽奖规则 | 查看抽奖规则 |
喊话 内容 | 向点歌台 Overlay 喊话；需目标允许控制且受 QQ 群喊话冷却限制 |
四、Q群管理指令
QQ 管理权限按机器人、会话和用户分别配置。群聊权限不会自动继承到私信；私信使用独立的 __c2c__ 会话。
直播管理员 live_admin
直播管理员能使用全部普通指令，并增加：
| 指令 | 说明 |
|---|---|
管理员帮助 | 查看管理指令帮助；普通用户无权查看 |
开播 | B站开播、取得推流码并启动 OBS；同义词：开始直播 |
关播 | 停止 OBS 并调用 B站下播；同义词：下播、结束直播 |
重连 | 重新连接推流；同义词：重连推流、重新推流 |
修改标题 新标题 | 修改直播间标题；同义格式：标题 新标题 |
修改分区 分区ID | 修改直播分区；同义格式：分区 分区ID |
超级管理员 super_admin
超级管理员拥有直播管理员权限，并增加：
| 指令 | 说明 |
|---|---|
发放道具 B站用户名 道具名 [数量] | 直接向目标背包发放道具，数量默认1 |
销毁道具 B站用户名 道具名 [数量] | 销毁目标背包内道具，数量默认1 |
可识别的内置道具名：单次个人列表+1卡、免清列表一天卡、管理员一天体验卡、免费主题一天卡、100积分卡、补签卡、头衔改名卡、🌿。
权限说明
- B站主播、点歌台数据库角色、B站房管身份、QQ 的
live_admin/super_admin是不同权限体系，不能互相替代。 - QQ 普通查询不要求白名单；签到、积分、背包、抽奖等个人资产操作通常要求先绑定。
- QQ 直播管理还要求当前群或私信目标开启控制权限。
- 点歌台的置顶、切歌、主题、喊话、清列表、黑名单、禁言和快进权限最终以当前
settings及所应用配置方案为准。