关键词回复插件

← 插件与自动化 · 所有分区

固定的“收到这句话 → 发送这段文字”使用内置关键词回复，不需要导入 JSON。需要参数、模板或入退服通知时再使用规则插件。

添加与管理

「扩展 → 关键词回复 → 管理回复」提供添加、搜索、编辑和删除，每个关联群共享这些回复。最多 200 条，关键词最多 80 字，回复最多 3500 字；可清空所有回复，也可单独停用插件。启用状态和回复内容保存到 data/plugin-state.json，保存立即生效。它精确匹配整条消息，内容按纯文字发送，花括号不会展开为模板，CQ 文本不会执行。

首次升级启动将原配置 [replies] 原样导入，有旧回复时保持启用，没有时默认停用。导入仅执行一次，后续重启和扫描不会恢复已删除的回复或重置启用状态。原 [replies] 保留为迁移备份，不再用于运行时回复；配置 API 不接受修改该字段。帮助、绑定等内置命令先执行，其后是已启用的关键词回复，再处理导入插件的群命令。

编辑器以「收到这句话 → 发送这段文字」组织每条问答，与远程服务器指令分开编辑。在「本地试一条群消息」输入文字，可检查当前草稿的精确匹配与回复内容；新增、修改和移除会同步更新结果，空条目或重复名称会提示先检查草稿。这个检查不发送 QQ 消息、不执行服务器命令，也不改变未保存状态。实际群响应仍受内置命令优先级、插件开关与权限限制；预览为文字展示，CQ 码、HTML 和花括号均不执行或展开。

内置 ID keyword_replies 保留，不可通过 JSON 导入或移除；需要关闭时停用即可。reply_map 是此内置插件的专用设置类型，不属于外部 JSON 插件声明格式。

管理员 API 使用 PUT /api/extensions/keyword_replies，正文例如 {"revision":"当前插件 revision","enabled":true,"settings":{"replies":{"官网":"https://example.com","规则":"友善交流"}}}。settings.replies 是完整替换，空对象表示清空所有回复；可只提交 enabled 切换状态。未提供 enabled 时保留原状态。接口需要面板管理令牌，版本冲突返回 409；网站注册 API 密钥不能管理插件。插件状态文件总量限制为 4 MiB，单次 HTTP 请求仍限制为 256 KiB。

使用范围与图片回复

在插件卡片的“权限”中限制服务器、群、使用者和 QQ 名单。关键词只在已关联群中响应，并受插件启用状态及 send_group、group_commands 等授权限制。需要转为图片时由服主在图片回复设置中指定关键词；不会执行回复里的 HTML 或 CQ 码。

完整规则、处理顺序和 API 见插件开发。