第 8 章　群里怎么用命令

这一章是写给群里的人看的：怎么查数据、拉报告、订阅提醒。控制台的管理员 不用记这些，转发这一章就行。先说怎么发才算命令，再给整张命令表和几句常见问法。

怎么发才算命令

• 群里要先 @ 机器人：@机器人 命令名 参数，比如 @机器人 数据排行榜 礼物。没 @ 的消息一概不理——群里聊天随口说到某个命令名，它不该接话
• 私聊直接发命令名，不用 @
• 机器人只在配置过推送的群里应答；没配过的群里 @ 了它也不说话
• @ 了但不是命令（包括只 @ 了一下什么都没写），它会回一份菜单，顶行写着当前会话该怎么发命令；发 菜单 也是这一份
• 同一个群 3 秒内只回一次：执行命令、回菜单、回「本群已关闭……命令」「……仅群主、群管理员或超级管理员可用」共用这一份冷却，防的是刷屏

命令表

提醒订阅按这位主播推到本群的 @ 方式判断：若通知只 @全体成员，会说明订了也不会被单独 @，不加入名单；本群推着这位主播、但这类通知一条也没开的，照样订上，但会说清现在收不到、推送开了才会 @ 你；按订阅名单 @ 或 @全体成员失败后改按名单 @ 的，照常订阅。

几点说明：

• 参数怎么摆：榜单名、「总」、主播名三者顺序不限（数据排行榜 云山 礼物、数据排行榜 流水 云山、数据排行榜 总 弹幕 都认）。昵称或 uid 都认。这个群只配了一位主播时，主播可以省略；配了多位时必须带上是哪一位。三位以内的纯数字照收但不用——那是旧版翻页用的页码，现在一张长图全装下了
• 榜单有七张：弹幕、礼物、流水、醒目留言（SC）、盲盒、盲盒盈亏（盈亏）、大航海（舰长）。礼物榜只算礼物，按主播到手的价值排：背包礼物和盲盒开出的礼物算进去，免费礼物不算，也不是观众实际花掉的数额。流水榜是同一个人的礼物、醒目留言和上舰加在一起。金额不可见的会话里，礼物榜、流水榜、醒目留言、盲盒盈亏这四张查不了，它会明说「本会话不展示「主播名」的金额相关榜单」，并列出还能查哪几张
• 流水榜带「总」时，累计只从开始按人记流水的那次升级起算。 更早的场次不在累计里，图下面写着从哪一版起。没留下按人流水的场次，本场按礼物和醒目留言排，上舰不算进去，图下会另写一句。升级那天正在播的那一场，升级以后又有人送礼、发醒目留言或上舰，榜上只算升级以后的那一部分
• 「总」要先开才有：没开累计数据时，它会说「本机没开累计数据，只能查本场」，而不是回一堆 0 让人以为数据丢了。开的地方在控制台设置页的「累计数据 Redis · 地址」，填好即生效，不用重启；Redis 只需本机可达，不要暴露到公网
• 管理员是谁：群主、群管理员自动就是；机器人的主人未必是每个群的管理员，可以在设置页「超级管理员」里填一份跨群生效的名单
• @名单 只写群昵称（取不到时退回 QQ 昵称），不列 QQ 号
• 取消开播@我、取消动态@我 只取消，不会再订上。 正名才是开关：没订就订，订了再发一次就取消。旧名再发一次，也不会把刚取消的订回去
• 关掉命令是按用法，不是按整条。 禁用命令 直播间数据 只挡本场；禁用命令 直播间总数据，或 禁用命令 直播间数据 总，才挡累计。排行榜同理。禁用命令 @名单 会把「开播@名单」「动态@名单」一起关掉；只关其中一类，就点名那一类
• 几位主播的群里，可以只关一位的。 查数据、拉报告、订阅提醒这几类按主播分开关：禁用命令 直播报告 关掉本群每一位主播的这一条，回「已禁用本群 N 位主播的「直播报告」」；后面带上主播昵称或 uid，比如 禁用命令 直播报告 云山，只关这一位。启用命令 同理。只关了某一位的，点名查那一位时回「本群已关闭「云山」的「直播报告」」，不点名时只在没关的几位里挑
• 菜单（帮助、命令）、启用命令、禁用命令 关不掉，几位主播的群里也一样，发了会回「「菜单」不可开关」这样的话。别的插件加的命令不分主播，整个群一起开关
• 旧命令名（取消开播@我、总数据排行榜 这些）仍然可用，菜单里只列新名

常见问法

@ 了怎么不理我？ 按顺序查：这个群配过推送吗（没配的群一概不应答）； 这条命令被本群关了吗（被关的会回「本群已关闭……」，点名是哪一条、哪位主播的，不是沉默）；三秒内是不是 已经让它回过一次；最后才是——你发的是命令吗，聊天里提到命令名不算。

它反问我要看哪张榜？ 参数里没有它认得出的榜单名。榜单名、主播名、「总」写在哪都行， 但榜单名得是弹幕、礼物、流水、醒目留言（SC）、盲盒、盲盒盈亏（盈亏）、大航海（舰长）里的一个。 只写了主播名、没写榜单名，它也会这么问。

想让开播消息 @ 我？ 自己发 @机器人 开播@我 就行，不用找管理员； 不想被 @ 了再发一次同一句。

推送的文字能改吗？ 能，但不在群里改——那是控制台推送页的事， 见第 6 章。

群里发 @机器人 菜单，机器人回的是一段文字，长这样（示例：本机没开累计数据、 本群没关任何命令）：

用法：@ 我，后面接命令名，例如「菜单」。

可用命令：

【提醒订阅】
@名单 [开播|动态] [主播 uid 或昵称] — 查看提醒订阅名单，可带「开播」或「动态」
动态@我 [主播 uid 或昵称] — 开关动态提醒：没订就订上，订了就取消
开播@我 [主播 uid 或昵称] — 开关开播提醒：没订就订上，订了就取消

【命令管理】
启用命令 <命令名> — 在本群启用某个命令
禁用命令 <命令名> — 在本群禁用某个命令
菜单 — 列出可用命令

【数据查询】
数据排行榜 <榜单> [总] [主播 uid 或昵称]（三者顺序不限） — 查各榜单排行，带「总」出历次累计（带「总」查累计要先开累计数据）
直播报告 [主播 uid 或昵称] — 查看正在直播主播的实时数据报告
直播间数据 [总] [主播 uid 或昵称] — 查询直播间的整体数据，带「总」出历次累计（带「总」查累计要先开累计数据）

接下来

命令查的是当下的数；一场播完，还有一整张报告图和按周月的趋势可看： 第 9 章　看播得怎么样。