指令设置
这篇帮你做什么：决定哪些内置指令启用、用什么关键词触发、哪些成员可以使用。入口：应用设置 → 指令设置。
适用与不适用
| 你想做的事 | 是否适合本页 | 原因 |
|---|---|---|
| 改内置指令的触发词、等级、优先级、冷却或启停 | 适合 | 这些是目录允许覆盖的配置 |
| 查某条指令实际会做什么、需要什么权限 | 适合 | 详情页会显示固定的类型与匹配方式 |
| 新增一条自己的关键词自动回复 | 不适合 | 用问答维护“问题 → 回答” |
| 让消息命中关键词后警告、禁言或踢人 | 不适合 | 用监控方案配置处理规则 |
| 修改指令回复的正文 | 不适合 | 在提示设置维护 |
作用范围与联动
- 本页修改的是应用级指令目录覆盖项，不是某个群的独立副本；同一条指令的关键词、等级和启停会影响所有使用该指令的群。
- 群级还有一层指令分类开关，按群决定某一类指令是否参与匹配。它不能代替本页的指令启停，也不能把全局权限降给更多人。
- 一条消息是否真的执行，还取决于发起者等级、目标保护、机器人平台权限、冷却和参数。保存配置、匹配成功、平台执行是三件事。
- 控制台没有应用层登录账号或角色系统。本页的“权限等级”指聊天身份等级，不是控制台账号权限；打开控制台也不会获得等级 11 聊天身份。
开始前确认
- 指令是应用提供的固定目录，页面不能新增或删除指令，也不能把一条回复指令改成踢人指令。想配置自己的关键词自动回复，请看问答。
- 不要为了让一个成员能用指令，就把处罚指令的权限降到所有人可用。先核对权限管理、目标群和机器人权限，初次练习选择只读查询指令。
- 本页的“匹配与回复预览”不是群内执行测试。它不发群消息、不踢人、不禁言，也不证明发送者有权限或机器人能完成操作。
部署维护者常用入口
| 要查或要改什么 | 当前入口 | 注意 |
|---|---|---|
| 查指令目录、改关键词/等级/启停 | 应用设置 → 指令设置 | 改的是全局覆盖项，影响多个群 |
| 查某群哪些指令分类被关闭 | 群设置 → 群聊监控 → 指令分类开关 | 按顶部所选群生效，不是全局设置 |
| 配置超级管理员、高级管理员 | 应用设置 → 全局设置 | 分别对应等级 11、10 的全局名单 |
| 配置某群代理管理员（等级 7） | 群设置 → 基本设置 → 代理管理员 | 只影响该群，警告/卧底等通知会复用这份名单 |
| 理解等级、保护、免检与授权 | 权限管理 | 控制台操作、聊天等级、平台权限不是同一件事 |
| 核对实际执行结果 | 结果判断与排障 | 先区分保存、匹配、受理和平台结果 |
本页不承诺存在稳定的公共指令 API。需要程序化操作时，先核对当前部署实际提供的接口和权限边界，不要按页面文案猜端点。
修改一条指令
- 按分类和状态筛选，找到目标指令；点该行 操作 → 详情，先看名称、类型和匹配模式。不要仅凭关键词猜它会做什么。
- 点 操作 → 编辑，只修改需要的字段：
- 触发关键词：多个关键词用逗号或换行分隔。不要与其他指令重复；是否要求完整相等、包含或正则匹配，由该指令固定的匹配模式决定。
- 权限等级：0–11，数字越大要求越高。身份与名单如何对应等级，见权限管理。
- 状态：启用或禁用。
- 优先级：数字越大越先检查；不是越大执行权限越高。
- 冷却时间：单位为秒，0 表示不限制。它是运行中的频率限制，不是可靠的定时任务，也不保证重启后仍保留执行记录。
- 描述：供维护者辨认用途的备注。
- 点 确认，然后刷新页面并重新打开详情，核对保存值。
- 记录修改前的关键词、等级和状态，方便改回。指令名称、类型、匹配模式等只读字段不能在这里修改。
列表的搜索框标为“触发关键词”，实际匹配的是指令名称和描述；只按某个触发词搜不到时，改用名称或分类查找。
设置项参考
| 字段 | 含义与取值 | 单位/默认 | 作用与限制 |
|---|---|---|---|
| 触发关键词 | 该指令可被哪些文本触发；多个用逗号或换行分隔 | 来自目录默认值 | 匹配方式由指令固定，不是每条都能改成正则 |
| 权限等级 | 0–11，越高要求越严 | 目录默认值 | 部分高风险指令有不可下调的底线 |
| 状态 | 启用/禁用 | 目录默认值 | 禁用后所有群都不再匹配该指令 |
| 优先级 | 整数，越大越先检查 | 目录默认值（不同指令不同） | 只影响取哪条命中，不改变权限 |
| 冷却时间 | 秒；0 表示不限制 | 目录默认值 | 运行期频率限制，不是持久账本 |
| 描述 | 维护备注 | 空 | 列表搜索会匹配名称和描述 |
预览匹配与回复
- 点 匹配与回复预览。
- 填入准备检查的文本，点 查询。
- 看返回的是匹配成功、未匹配到启用的指令，还是请求失败。
- 匹配成功时核对命中的是哪条指令，并查看可预览的回复。优先级冲突时，可能命中了另一条指令。
预览的边界：
- 只检查启用指令的关键词和优先级，展示的是内置回复文案；不检查群级分类开关、发送者等级、目标保护、冷却和机器人平台权限。
- 预览使用的是提示目录中的内置文案，不保证已经反映你在提示设置里自定义的回复。
- 显示“无可预览的回复文案”不代表动作一定可执行，也不证明模板配置正确。
正例：先用预览确认同一段文本命中哪条指令，再用符合条件的测试身份在授权测试群实际触发一次。反例：只在预览里看到“匹配成功”，就认为普通成员发这句话一定能执行管理动作。
怎样判断结果
分开看三件事：
- 保存：刷新后配置没有变回原值。
- 匹配：预览命中了预期指令，且没有更高优先级的指令抢先命中。
- 实际执行：在已授权的测试群中，用符合权限的成员发送指令，检查实际回复或处理结果。管理动作还要核对目标成员的平台状态和处理记录。
匹配成功不保证群级开关、成员保护和机器人平台权限全部满足。结果入口见结果判断与排障。
导入、导出和批量停用
- 导出为 JSON，只保存可修改字段（关键词、权限等级、状态、冷却、优先级、描述），不导出一套可以新增任意动作的指令程序。
- 导入接受同格式 JSON 覆盖项，不能增加新指令。先导出当前配置留底，再检查文件来源和影响范围。
- 导入可能在配置已写入后仍提示“导入失败”，列表也不会自动刷新；遇到该提示先刷新页面并核对覆盖值，不要只凭提示重复导入。
- 勾选指令后可批量启用或批量禁用；不确定批量范围时逐条改。
- 指令回复文案在提示设置维护，不在本页编辑。
私聊管理指令
部分指令支持在私聊中操作（私聊机器人发送，按私聊指令链检查权限）。先核对当前指令目录、启用状态和机器人回复，不要把群内语法直接照搬到私聊。
- 移除授权用于批准不活跃清退、人口控制和跨群独占的持续执行，默认关闭，要求等级 11；具体步骤见踢人禁言。保存规则不等于授权。
- 未决核实用于本人查询及按原尝试的持久证据核实，默认关闭，最低要求等级 6；它不是人工指定成功、退款或强行解锁入口。
- 文本群发默认关闭，最低要求等级 6，须先核对显式目标群和正文再确认；发出后不能靠停用撤回已送达消息。
- 部分高风险指令有不可下调的权限底线。把输入等级改低，不能绕过底线、目标保护、确认或执行额度。
连接凭据指令
读取连接凭据会在原聊天通道返回明文。 不要在有无关成员的群里读取，不要分享聊天记录、截图或包含凭据的日志。启用 webhook 推送时，相关敏感事件仍可能以明文进入接收端；接收端及其日志也必须保护。
等级 11 的真实超级管理员可通过受支持的群聊或私聊指令读取、替换、清除凭据。
保存凭据不等于所有连接已重新装配，回信失败也不代表保存失败，应先核对状态，不要只凭有没有回信重复修改。
没成功先检查什么
- 指令是否启用，关键词是否符合它的匹配模式。
- 有没有另一条更高优先级指令先命中。
- 发送者等级是否满足要求，群级分类开关是否允许。
- 如果是处罚动作，目标是否受保护，机器人是否有平台管理权限。
- 如果动作与回复分开，检查回复模板是否启用、变量是否正确，再查处理记录；没有文字回复不等于动作没发生。
关闭或改回
点 操作 → 禁用 可以停止该条指令；这会影响使用它的多个群。恢复时改回原配置并启用。停用不会撤销已经发生的踢人、消息发送等动作。