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

# 提示设置

这篇帮你做什么：修改机器人 **回复指令时用的固定文案**——比如在群里发“帮助”时机器人回的那段帮助清单、查黑名单时回的结果格式等。入口：**侧边栏 → 应用设置 → 提示设置**。

## 适用与不适用

| 你想做的事 | 是否适合本页 | 原因 |
| --- | --- | --- |
| 改“帮助”“查黑名单”等指令的回复文案 | 适合 | 每条提示对应固定指令或固定场景 |
| 调整查询结果的展示格式 | 适合，但查询结果类不建议改结构 | 结构改动容易让整条回复失败 |
| 按群设置入群欢迎、退群通知 | 不适合 | 用[群提示](05_群提示.md) |
| 维护成员提问后的固定回答 | 不适合 | 用[问答](15_问答.md) |
| 修改 AI 提示词 | 不适合 | 在[AI 功能](28_AI%20功能.md)维护 |
| 新增一种机器人回复类型 | 不适合 | 提示是固定目录，不能新增或删除条目 |

## 作用范围与工作方式

- 这里的提示是**全局的**：改一次，所有群都生效。页面没有群选择框，这是它与“群提示”（按群的事件通知）最大的区别。
- 提示条目是**固定目录**：每条对应一个指令或一个固定场景（如“帮助指令”“查询本群黑名单”“加黑结果汇总”），**不能新增、不能删除**，只能改“启用状态”和“提示内容”。
- 每条提示有唯一的 **Code**（英文标识）和分类，列表里可按名称、Code、内容搜索，也可按分类、状态筛选。
- 控制台没有应用层登录账号或角色系统；能打开本页不等于拥有对应的聊天指令等级。修改全局文案前先确认影响所有群。
- 文案在下次指令触发时使用。保存或导入后，运行时读取的是更新后的合并配置，不需要重启服务。

## 修改一条提示

1. 在列表中找到条目（可用搜索框按名称或内容查找），点 **操作 → 编辑**。
2. 弹窗上部（名称、Code、分类）是固定信息，不能改。
3. 可修改的只有两项：
   - **启用状态**：关闭后该条文案不再生效——对应的指令执行时 **不会回复任何内容**（静默跳过）。比如关掉“帮助指令”，群里发“帮助”机器人就不回话了。
   - **提示内容**：点击 **可用变量** 标签把变量插入到光标位置；变量详见[变量使用指南](../高级功能/变量使用指南.md)。
4. 点 **确定** 保存。
5. **怎样确认成功**：列表里该条的内容预览已更新；被自定义过的条目会挂一个 **已修改** 小标签。刷新后内容仍在。

**清空内容不等于停用**：普通编辑只把非空内容视为修改，把内容删空再保存可能仍保留旧文案。要停止回复，请关闭 **启用状态**，不要靠清空内容。

## 设置项参考

| 字段 | 含义与取值 | 作用与限制 |
| --- | --- | --- |
| 名称 / Code / 分类 | 目录固定信息 | 不能改；Code 是导入导出的匹配键 |
| 启用状态 | enabled / disabled | 关闭后对应指令不回复任何内容 |
| 提示内容 | 模板文本 | 支持当前条目的“可用变量”；语法错误会导致整条回复失败 |
| 已修改标签 | 是否存在覆盖项 | 只表示与内置文案不同，不表示已验证效果 |

## 模板变量与失败表现

- 每条提示的变量不同，**以编辑弹窗中的“可用变量”标签为准**。指令回复类常见 `{{.user_id}}`、`{{.group_id}}`、`{{.nickname}}`、`{{.reason}}`、`{{.trigger_keyword}}`。
- 查询结果类常有成套变量（如 `{{.count}}`、`{{.entries}}`），可能包含 `range` 结构；**不建议改动结构**，只改固定文字更安全。
- **模板语法错误**（如括号未闭合）：对应指令执行时回复失败、什么都不回，不会自动退回默认文案。
- **变量名不存在**：通常渲染为空字符串，不一定报错；不能因为“没有报错”就认为变量有效。

正例：只把“帮助指令”的开头改成“`{{.nickname}}`，以下是可用指令”，保留原有列表结构，然后让有权限的测试身份在测试群触发一次。反例：删掉查询结果的 `range` 结构或把列表变量改成单个字段，导致整条查询回复渲染失败。

## 恢复默认

- **单条恢复**：点 **操作 → 恢复默认**（只有被修改过的条目该按钮可用），删掉这条的自定义、回到内置文案。
- **全部恢复**：页面右上角 **恢复默认设置** 会清空所有条目的自定义，全部回到内置文案。此操作影响全局，点之前确认好。
- 恢复默认只改提示文案，不会改变指令的启停、权限或群级开关；已经发出的消息也不能撤回。

## 备份与迁移

- 右上角 **导入/导出** 下拉可导出 CSV，UTF-8 带 BOM。列固定为：

  ```text
  code,content,status
  ```

- **导入**按 Code 逐条覆盖对应条目的内容和状态，规则如下：

| 情况 | 实际行为 |
| --- | --- |
| 文件里没出现的 Code | 保持现有配置不变 |
| Code 未知 | 该行跳过，不报错 |
| 列数少于 3 | 该行跳过 |
| status 不是 `enabled`/`disabled` | 该行跳过 |
| content 与 status 都为空 | 该行跳过 |
| 同一 Code 出现多次 | 后面的行覆盖前面的行 |
| 整个文件没有有效行 | 导入失败，不做改动 |

- 导入的内容会去掉首尾空白。导入后刷新页面，确认内容和启用状态与文件一致；导入结果以实际条目为准，不以提示文字为准。
- 先导出当前配置留底再导入。不要先执行 **恢复默认设置** 清空所有自定义，再指望用旧导出文件逐条导回：导入只覆盖文件中列出的条目，不能还原文件之外的历史调整。

## 没成功先检查什么

- 指令不回复了：先看该指令对应的提示是否被 **禁用**；再看内容里的变量写法是否被改动——若自定义内容的模板语法写错，对应指令执行时 **回复会失败**（不会自动退回默认文案）。恢复默认或改正语法即可恢复。
- 修改后群里没变化：提示内容在下次指令触发时才使用；确认机器人在线、指令确实命中（见[指令设置](04_指令设置.md)），并区分“保存成功”和“实际回复”。
- 搜索不到某条提示：确认没有按分类/状态筛选过滤掉。
- 导入后条目数不符：核对是否有未知 Code、列数不足、状态非法或被跳过的行；先刷新回读，不要直接重复导入。

## 关闭或改回

- 单条：开关关闭即停用；点 **恢复默认** 还原文案。
- 全部：右上角 **恢复默认设置**。
- 停用或恢复默认只影响后续回复，不会撤回已发送内容。

## 和其他页面的关系

- 本页文案由指令系统在回复时使用，指令的开关与关键词见[指令设置](04_指令设置.md)。
- 按群独立的事件通知（入群欢迎、退群通知等）在[群提示](05_群提示.md)，与本页互不影响。
- 页面上的 **变量说明** 弹窗列出的变量名与编辑弹窗中“可用变量”标签不一致；**请以编辑弹窗中“可用变量”标签为准**。
- 查询类提示涉及警告和信用分时，机制本身见[群基本设置](群基本设置.md#告警与信用分)，不要只改文案来改变行为。
- 全局与应用级配置的影响面见[群管家怎样工作](../核心概念/工作方式与作用范围.md#作用范围)。