> 规范网页：https://docs.tensuu.com/功能模块详解/04_指令设置.html ｜ Markdown：/功能模块详解/04_指令设置.md ｜ 文档修订：2026.10.26

# 指令设置

这篇帮你做什么：决定哪些内置指令启用、用什么关键词触发、哪些成员可以使用。入口：**应用设置 → 指令设置**。

## 适用与不适用

| 你想做的事 | 是否适合本页 | 原因 |
| --- | --- | --- |
| 改内置指令的触发词、等级、优先级、冷却或启停 | 适合 | 这些是目录允许覆盖的配置 |
| 查某条指令实际会做什么、需要什么权限 | 适合 | 详情页会显示固定的类型与匹配方式 |
| 新增一条自己的关键词自动回复 | 不适合 | 用[问答](15_问答.md)维护“问题 → 回答” |
| 让消息命中关键词后警告、禁言或踢人 | 不适合 | 用[监控方案](03_监控方案.md)配置处理规则 |
| 修改指令回复的正文 | 不适合 | 在[提示设置](23_提示设置.md)维护 |

## 作用范围与联动

- 本页修改的是**应用级指令目录覆盖项**，不是某个群的独立副本；同一条指令的关键词、等级和启停会影响所有使用该指令的群。
- 群级还有一层**指令分类开关**，按群决定某一类指令是否参与匹配。它不能代替本页的指令启停，也不能把全局权限降给更多人。
- 一条消息是否真的执行，还取决于发起者等级、目标保护、机器人平台权限、冷却和参数。**保存配置、匹配成功、平台执行是三件事。**
- 控制台没有应用层登录账号或角色系统。本页的“权限等级”指聊天身份等级，不是控制台账号权限；打开控制台也不会获得等级 11 聊天身份。

## 开始前确认

- 指令是应用提供的固定目录，页面不能新增或删除指令，也不能把一条回复指令改成踢人指令。想配置自己的关键词自动回复，请看[问答](15_问答.md)。
- 不要为了让一个成员能用指令，就把处罚指令的权限降到所有人可用。先核对[权限管理](../高级功能/权限管理.md)、目标群和机器人权限，初次练习选择只读查询指令。
- 本页的“匹配与回复预览”不是群内执行测试。它不发群消息、不踢人、不禁言，也不证明发送者有权限或机器人能完成操作。

## 部署维护者常用入口

| 要查或要改什么 | 当前入口 | 注意 |
| --- | --- | --- |
| 查指令目录、改关键词/等级/启停 | 应用设置 → 指令设置 | 改的是全局覆盖项，影响多个群 |
| 查某群哪些指令分类被关闭 | 群设置 → 群聊监控 → 指令分类开关 | 按顶部所选群生效，不是全局设置 |
| 配置超级管理员、高级管理员 | 应用设置 → 全局设置 | 分别对应等级 11、10 的全局名单 |
| 配置某群代理管理员（等级 7） | 群设置 → 基本设置 → 代理管理员 | 只影响该群，警告/卧底等通知会复用这份名单 |
| 理解等级、保护、免检与授权 | [权限管理](../高级功能/权限管理.md) | 控制台操作、聊天等级、平台权限不是同一件事 |
| 核对实际执行结果 | [结果判断与排障](../核心概念/结果判断与排障.md#结果入口) | 先区分保存、匹配、受理和平台结果 |

本页不承诺存在稳定的公共指令 API。需要程序化操作时，先核对当前部署实际提供的接口和权限边界，不要按页面文案猜端点。

## 修改一条指令

1. 按**分类**和**状态**筛选，找到目标指令；点该行 **操作 → 详情**，先看名称、类型和匹配模式。不要仅凭关键词猜它会做什么。
2. 点 **操作 → 编辑**，只修改需要的字段：
   - **触发关键词**：多个关键词用逗号或换行分隔。不要与其他指令重复；是否要求完整相等、包含或正则匹配，由该指令固定的匹配模式决定。
   - **权限等级**：0–11，数字越大要求越高。身份与名单如何对应等级，见[权限管理](../高级功能/权限管理.md)。
   - **状态**：启用或禁用。
   - **优先级**：数字越大越先检查；不是越大执行权限越高。
   - **冷却时间**：单位为秒，0 表示不限制。它是运行中的频率限制，不是可靠的定时任务，也不保证重启后仍保留执行记录。
   - **描述**：供维护者辨认用途的备注。
3. 点 **确认**，然后刷新页面并重新打开详情，核对保存值。
4. 记录修改前的关键词、等级和状态，方便改回。指令名称、类型、匹配模式等只读字段不能在这里修改。

列表的搜索框标为“触发关键词”，实际匹配的是指令名称和描述；只按某个触发词搜不到时，改用名称或分类查找。

## 设置项参考

| 字段 | 含义与取值 | 单位/默认 | 作用与限制 |
| --- | --- | --- | --- |
| 触发关键词 | 该指令可被哪些文本触发；多个用逗号或换行分隔 | 来自目录默认值 | 匹配方式由指令固定，不是每条都能改成正则 |
| 权限等级 | 0–11，越高要求越严 | 目录默认值 | 部分高风险指令有不可下调的底线 |
| 状态 | 启用/禁用 | 目录默认值 | 禁用后所有群都不再匹配该指令 |
| 优先级 | 整数，越大越先检查 | 目录默认值（不同指令不同） | 只影响取哪条命中，不改变权限 |
| 冷却时间 | 秒；0 表示不限制 | 目录默认值 | 运行期频率限制，不是持久账本 |
| 描述 | 维护备注 | 空 | 列表搜索会匹配名称和描述 |

## 预览匹配与回复

1. 点 **匹配与回复预览**。
2. 填入准备检查的文本，点 **查询**。
3. 看返回的是**匹配成功**、**未匹配到启用的指令**，还是**请求失败**。
4. 匹配成功时核对命中的是哪条指令，并查看可预览的回复。优先级冲突时，可能命中了另一条指令。

**预览的边界**：

- 只检查启用指令的关键词和优先级，展示的是内置回复文案；**不检查**群级分类开关、发送者等级、目标保护、冷却和机器人平台权限。
- 预览使用的是提示目录中的内置文案，不保证已经反映你在[提示设置](23_提示设置.md)里自定义的回复。
- 显示“无可预览的回复文案”不代表动作一定可执行，也不证明模板配置正确。

正例：先用预览确认同一段文本命中哪条指令，再用符合条件的测试身份在授权测试群实际触发一次。反例：只在预览里看到“匹配成功”，就认为普通成员发这句话一定能执行管理动作。

## 怎样判断结果

分开看三件事：

- **保存**：刷新后配置没有变回原值。
- **匹配**：预览命中了预期指令，且没有更高优先级的指令抢先命中。
- **实际执行**：在已授权的测试群中，用符合权限的成员发送指令，检查实际回复或处理结果。管理动作还要核对目标成员的平台状态和处理记录。

匹配成功不保证群级开关、成员保护和机器人平台权限全部满足。结果入口见[结果判断与排障](../核心概念/结果判断与排障.md#结果入口)。

## 导入、导出和批量停用

- **导出**为 JSON，只保存可修改字段（关键词、权限等级、状态、冷却、优先级、描述），不导出一套可以新增任意动作的指令程序。
- **导入**接受同格式 JSON 覆盖项，不能增加新指令。先导出当前配置留底，再检查文件来源和影响范围。
- 导入可能在配置已写入后仍提示“导入失败”，列表也不会自动刷新；遇到该提示先刷新页面并核对覆盖值，不要只凭提示重复导入。
- 勾选指令后可**批量启用**或**批量禁用**；不确定批量范围时逐条改。
- 指令回复文案在[提示设置](23_提示设置.md)维护，不在本页编辑。

## 私聊管理指令

部分指令支持在私聊中操作（私聊机器人发送，按私聊指令链检查权限）。先核对当前指令目录、启用状态和机器人回复，不要把群内语法直接照搬到私聊。

- **移除授权**用于批准不活跃清退、人口控制和跨群独占的持续执行，默认关闭，要求等级 11；具体步骤见[踢人禁言](13_踢人禁言.md)。保存规则不等于授权。
- **未决核实**用于本人查询及按原尝试的持久证据核实，默认关闭，最低要求等级 6；它不是人工指定成功、退款或强行解锁入口。
- **文本群发**默认关闭，最低要求等级 6，须先核对显式目标群和正文再确认；发出后不能靠停用撤回已送达消息。
- 部分高风险指令有不可下调的权限底线。把输入等级改低，不能绕过底线、目标保护、确认或执行额度。

### 连接凭据指令

**读取连接凭据会在原聊天通道返回明文。** 不要在有无关成员的群里读取，不要分享聊天记录、截图或包含凭据的日志。启用 webhook 推送时，相关敏感事件仍可能以明文进入接收端；接收端及其日志也必须保护。

等级 11 的真实超级管理员可通过受支持的群聊或私聊指令读取、替换、清除凭据。

保存凭据不等于所有连接已重新装配，回信失败也不代表保存失败，应先核对状态，不要只凭有没有回信重复修改。

## 没成功先检查什么

1. 指令是否启用，关键词是否符合它的匹配模式。
2. 有没有另一条更高优先级指令先命中。
3. 发送者等级是否满足要求，群级分类开关是否允许。
4. 如果是处罚动作，目标是否受保护，机器人是否有平台管理权限。
5. 如果动作与回复分开，检查回复模板是否启用、变量是否正确，再查处理记录；没有文字回复不等于动作没发生。

## 关闭或改回

点 **操作 → 禁用** 可以停止该条指令；这会影响使用它的多个群。恢复时改回原配置并启用。停用不会撤销已经发生的踢人、消息发送等动作。

## 和其他页面的关系

- 本页是固定指令目录的应用级配置；群级分类开关在[群聊监控](08_群聊监控.md)，不要把它当成同一层总开关。
- 各功能页（如[踢人禁言](13_踢人禁言.md)、[投票](24_投票.md)）依赖这里保存的指令开关与等级。
- 指令反馈文案模板在[提示设置](23_提示设置.md)；操作者等级体系见[权限管理](../高级功能/权限管理.md)。
- 告警、信用分与升级处罚的集中说明见[群基本设置](群基本设置.md#告警与信用分)。
- 想先理解“配置影响哪里、为什么一条消息只触发部分功能”，见[群管家怎样工作](../核心概念/工作方式与作用范围.md#作用范围)。