提示设置
这篇帮你做什么：修改机器人 回复指令时用的固定文案——比如在群里发“帮助”时机器人回的那段帮助清单、查黑名单时回的结果格式等。入口：侧边栏 → 应用设置 → 提示设置。
适用与不适用
| 你想做的事 | 是否适合本页 | 原因 |
|---|---|---|
| 改“帮助”“查黑名单”等指令的回复文案 | 适合 | 每条提示对应固定指令或固定场景 |
| 调整查询结果的展示格式 | 适合，但查询结果类不建议改结构 | 结构改动容易让整条回复失败 |
| 按群设置入群欢迎、退群通知 | 不适合 | 用群提示 |
| 维护成员提问后的固定回答 | 不适合 | 用问答 |
| 修改 AI 提示词 | 不适合 | 在AI 功能维护 |
| 新增一种机器人回复类型 | 不适合 | 提示是固定目录，不能新增或删除条目 |
作用范围与工作方式
- 这里的提示是全局的：改一次，所有群都生效。页面没有群选择框，这是它与“群提示”（按群的事件通知）最大的区别。
- 提示条目是固定目录：每条对应一个指令或一个固定场景（如“帮助指令”“查询本群黑名单”“加黑结果汇总”），不能新增、不能删除，只能改“启用状态”和“提示内容”。
- 每条提示有唯一的 Code（英文标识）和分类，列表里可按名称、Code、内容搜索，也可按分类、状态筛选。
- 控制台没有应用层登录账号或角色系统；能打开本页不等于拥有对应的聊天指令等级。修改全局文案前先确认影响所有群。
- 文案在下次指令触发时使用。保存或导入后，运行时读取的是更新后的合并配置，不需要重启服务。
修改一条提示
- 在列表中找到条目（可用搜索框按名称或内容查找），点 操作 → 编辑。
- 弹窗上部（名称、Code、分类）是固定信息，不能改。
- 可修改的只有两项：
- 启用状态：关闭后该条文案不再生效——对应的指令执行时 不会回复任何内容（静默跳过）。比如关掉“帮助指令”，群里发“帮助”机器人就不回话了。
- 提示内容：点击 可用变量 标签把变量插入到光标位置；变量详见变量使用指南。
- 点 确定 保存。
- 怎样确认成功：列表里该条的内容预览已更新；被自定义过的条目会挂一个 已修改 小标签。刷新后内容仍在。
清空内容不等于停用：普通编辑只把非空内容视为修改，把内容删空再保存可能仍保留旧文案。要停止回复，请关闭 启用状态，不要靠清空内容。
设置项参考
| 字段 | 含义与取值 | 作用与限制 |
|---|---|---|
| 名称 / Code / 分类 | 目录固定信息 | 不能改；Code 是导入导出的匹配键 |
| 启用状态 | enabled / disabled | 关闭后对应指令不回复任何内容 |
| 提示内容 | 模板文本 | 支持当前条目的“可用变量”；语法错误会导致整条回复失败 |
| 已修改标签 | 是否存在覆盖项 | 只表示与内置文案不同，不表示已验证效果 |
模板变量与失败表现
- 每条提示的变量不同，以编辑弹窗中的“可用变量”标签为准。指令回复类常见
{{.user_id}}、{{.group_id}}、{{.nickname}}、{{.reason}}、{{.trigger_keyword}}。 - 查询结果类常有成套变量（如
{{.count}}、{{.entries}}），可能包含range结构；不建议改动结构，只改固定文字更安全。 - 模板语法错误（如括号未闭合）：对应指令执行时回复失败、什么都不回，不会自动退回默认文案。
- 变量名不存在：通常渲染为空字符串，不一定报错；不能因为“没有报错”就认为变量有效。
正例：只把“帮助指令”的开头改成“{{.nickname}}，以下是可用指令”，保留原有列表结构，然后让有权限的测试身份在测试群触发一次。反例：删掉查询结果的 range 结构或把列表变量改成单个字段，导致整条查询回复渲染失败。
恢复默认
- 单条恢复：点 操作 → 恢复默认（只有被修改过的条目该按钮可用），删掉这条的自定义、回到内置文案。
- 全部恢复：页面右上角 恢复默认设置 会清空所有条目的自定义，全部回到内置文案。此操作影响全局，点之前确认好。
- 恢复默认只改提示文案，不会改变指令的启停、权限或群级开关；已经发出的消息也不能撤回。
备份与迁移
右上角 导入/导出 下拉可导出 CSV，UTF-8 带 BOM。列固定为：
textcode,content,status导入按 Code 逐条覆盖对应条目的内容和状态，规则如下：
| 情况 | 实际行为 |
|---|---|
| 文件里没出现的 Code | 保持现有配置不变 |
| Code 未知 | 该行跳过，不报错 |
| 列数少于 3 | 该行跳过 |
status 不是 enabled/disabled | 该行跳过 |
| content 与 status 都为空 | 该行跳过 |
| 同一 Code 出现多次 | 后面的行覆盖前面的行 |
| 整个文件没有有效行 | 导入失败，不做改动 |
- 导入的内容会去掉首尾空白。导入后刷新页面，确认内容和启用状态与文件一致；导入结果以实际条目为准，不以提示文字为准。
- 先导出当前配置留底再导入。不要先执行 恢复默认设置 清空所有自定义，再指望用旧导出文件逐条导回：导入只覆盖文件中列出的条目，不能还原文件之外的历史调整。
没成功先检查什么
- 指令不回复了：先看该指令对应的提示是否被 禁用；再看内容里的变量写法是否被改动——若自定义内容的模板语法写错，对应指令执行时 回复会失败（不会自动退回默认文案）。恢复默认或改正语法即可恢复。
- 修改后群里没变化：提示内容在下次指令触发时才使用；确认机器人在线、指令确实命中（见指令设置），并区分“保存成功”和“实际回复”。
- 搜索不到某条提示：确认没有按分类/状态筛选过滤掉。
- 导入后条目数不符：核对是否有未知 Code、列数不足、状态非法或被跳过的行；先刷新回读，不要直接重复导入。
关闭或改回
- 单条：开关关闭即停用；点 恢复默认 还原文案。
- 全部：右上角 恢复默认设置。
- 停用或恢复默认只影响后续回复，不会撤回已发送内容。