聊天指令与帮助
不打开控制台,在群里或私聊机器人发送帮助,就能查清全部操作的用法、示例和当前状态;聊天里也能只读查询运行状态并修改同一份配置。本页讲聊天侧入口;控制台里的触发词、权限、优先级、冷却与启停见指令设置。
本页内容:
帮助入口与菜单
群聊发送当前生效的帮助触发词(目录默认「帮助」,可在控制台修改)。私聊固定使用 帮助、帮助私聊、help 三个内建入口,不随群聊帮助触发词的修改而改变。
帮助正文由当前指令配置生成,不是另一份需要单独维护的清单。在指令设置改过触发词、权限或启停后,帮助会展示当前有效配置;群聊与私聊的帮助入口按上面的通道说明使用。
群聊与私聊同源,但不等于每条操作都支持双通道。 两边使用同一份目录和同一组子命令;只支持群聊或只支持私聊的操作,会在详情和状态标签里注明。私聊未选群也能读说明,真正管理某个群前要先选好操作群,见私聊管理与群发。
根目录固定列出十个主题,每个主题一行「主题名——一句用途」,按顺序为:群通知、成员与名单、禁言踢人与投票、警告与信用、监控与方案、问答与消息、定时与广播、名片与群资料、AI 与总结、系统与指令。
菜单分页、详情与状态标签
| 想做什么 | 发送 |
|---|---|
| 打开根目录 | 帮助 |
| 直接翻到某页 | 帮助 2 |
| 按主题查看 | 帮助 群通知、帮助 群通知 2 |
| 按关键词查找 | 帮助 搜索 禁言、帮助 搜索 禁言 第2页 |
| 查看全部操作 | 帮助 全部、帮助 全部 2 |
| 查看某一项详情 | 帮助 设置群通知,或 帮助 详情 设置群通知 |
以上写法以目录默认的「帮助」演示。群聊改过帮助触发词后,用新词触发,并按回复给出的完整命令翻页或查详情。私聊使用 帮助、帮助私聊、help 之一加上对应查询内容;如果回复里的入口词已被自定义,仍使用这三个私聊入口,不直接套用群聊入口词。
列表每页最多 8 项;一段正文超过单条消息长度上限时按条目或段落拆页,页脚给出「第 X/Y 页,本页 N 项。」和完整的「下一页:…」命令,不会出现半截命令,也不裁掉内容。
操作详情按固定顺序给出:用途、完整用法、示例、对象取得方法、影响范围、支持通道、权限、当前状态、保存或执行时机、风险提醒。管理操作按当前有效词位写出完整用法和可复制示例,一条消息发送完整指令即提交;权限、参数、目标保护和作用域等校验通过后直接执行,缺参、越权或目标不合法会被拒绝并说明原因。触发词修改后,以本次生效的帮助用法和示例为准。
状态标签只陈述事实:已停用、仅支持群聊、仅支持私聊、需先选群、需核验身份、权限不足,需[权限名]及以上;条件具备时显示「当前条件允许发起;执行前仍会复核」。停用和权限不足的操作仍会出现在清单里,不会因为暂时不可用而被隐藏。
搜索、详情与占位说明
- 搜索匹配当前有效触发词、名称、用途、用法与示例;没有结果时会提示改用「帮助 全部」。
- 搜索翻页必须把「第N页」放在末尾,不要拼进关键词;页码超出范围会提示有效页码,并给出重新发送的完整命令。
- 同一操作名匹配到多条时,按提示改用完整操作名再查。
- 帮助只是说明入口,不代替执行时的权限、身份、冷却和目标保护核验。
示例里的标识都是占位:账号、群号、条目 ID、file-1 等只示意格式;file-1 是附件标识,不是文件名或链接,实际发送时要换成真实的附件标识。
在聊天里改同一份配置
指令、群通知和指令回复也都有对应的聊天操作,完整词形、参数和示例以 帮助 <操作名> 当前显示为准。
写入操作发送一条完整指令即提交,权限与业务校验通过后直接执行,结果以回执为准。写入前后都可以先用 查… 类读操作核对当前值,再按回执判断是否生效。
聊天里的只读查询
常用状态不用打开控制台,在群里或私聊发一句就能查:
下表用操作名称定位查询;触发词改过时,按 帮助 <操作名> 返回的完整消息发送。
| 想查什么 | 默认操作名称/参数 | 范围与等级 |
|---|---|---|
| 本群自动化运行、执行和功能就绪状态 | 查自动化状态 | 本群,等级 8 |
| 本群进群审核的评分指标与总分预览 | 查评分指标 | 本群,等级 8 |
| 跨群独占的待移除关系 | 查独占待移除 <互斥标签> | 整个实例,等级 11 |
| 实例的队列、规则缓存等运行统计 | 查运行统计 | 整个实例,等级 11 |
- 只读不写:这几项只读取当前状态并返回查询回复,不改配置、不触发业务消息发送,也不占用治理执行额度;查到结果不会顺带改变被查对象。
- 回不完就按段续读:内容较长时按「第M段」分段,末段给出「(以上为全部内容)」;续读沿用同一条触发词和同样的筛选,只替换段号。
- 未知就是未知:后端没有给出的指标显示「未知」,不会用 0 冒充已采集到的真实值;未接入的统计区块显示「未启用」或「统计不可用」。评分预览在没有示例值时也不会编出一个总分。
- 实例级不因为你在群里管事就放开:需要 11 级的项,即使你在某个群里有管理权限,也不会因此显示其他群或整个实例的数据。
- 评分预览按中文指标名等值匹配:要自己给示例值时用
示例=指标中文名:原始值,例如查评分指标 示例=QQ 号位数:8;指标名必须和控制台里的中文名完全一致,重复、未知或不是数字的值会被拒绝。没有给示例值的已启用指标显示「未知」,不按 0 分计入总分。
聊天里还能只读预览一条完整消息会命中什么:发送 预览指令 <完整消息>,会给出命中的是哪条指令、解析出的参数和回复正文的渲染结果。它只做匹配与渲染——不执行动作、不消费冷却、不调用平台或模型、不核验真实成员身份;权限只按你给的示例身份给提示。控制台里的同类预览见指令设置。