Skip to content

关键词自定义回复

Dice!Next 支持灵活的关键词自动回复,可在 Web 管理面板 → 回复管理 可视化编排。回复管理页有三个选项卡:基础回复因果规则计数器

聊天里可用 .reply on/off 开关自定义回复;单个群也可用 .group +禁用回复 关闭(见群管与系统)。

基础回复

匹配方式

类型说明
关键词匹配整条消息与内容完全相等才触发(忽略大小写)
前缀匹配消息以某前缀开头触发
正则匹配正则表达式(从消息开头匹配)并可捕获分组
搜索匹配消息包含该内容即触发(忽略大小写)

一条规则支持多条件 AND / OR 组合,以及多结果随机(命中后从多条回复里随机选一条发送),并可设置优先级。

回复模板变量

回复内容里可以使用 {…} 占位符,发送时实时替换:

变量含义
{nick}触发者显示名(带包裹符号,包裹符号可在配置中改)
{name}触发者显示名(人物卡名 > .nn 昵称 > QQ 昵称)
{qqnick} / {card} / {pcname}QQ 昵称 / 群名片 / 人物卡名(干净无包裹;加 w 后缀如 {qqnickw} 则带包裹)
{user}触发者账号
{self}骰子自称
{group}群号
{date} / {time}日期 / 时间
{$1} {$2}正则捕获分组;前缀匹配时 {$1} = 前缀之后的内容,{$0} = 整条消息

原版 Dice! 风格的旧变量名(如 {pc})也有别名兼容,旧回复文案可直接沿用。

动态指令

写法效果
{roll:3d6+2}求值骰子表达式,替换为结果
{draw:塔罗牌}从牌堆抽一张
{a|b|c}在候选中随机选一个
{counter:名称}当前计数器值(配合因果规则)
{api:URL}请求一个网址,把返回内容填进回复

{api:URL} 外部请求

{api:} 会让骰子向外部网址发起请求,默认关闭。需在系统设置的「外部请求」中开启。

出于安全考虑,仅允许 http/https,并自动拦截内网 / 本机地址;可在配置文件中设置允许访问的域名白名单(dice.api_whitelist)。

示例

触发:天气
回复:今天{a|晴|多云|小雨},记得带伞~

触发(正则):^点歌 (.+)$
回复:已为你点播《{$1}》🎵

触发:今日运势
回复:{nick} 的运势:{draw:运势}

因果规则(进阶)

「因果规则」是带状态的回复引擎,比基础回复多了条件门槛动作链,用可视化编辑器编排:

  • 条件:关键词 / 前缀 / 正则 / 搜索之外,还可加 用户过滤、群过滤、冷却时间(按人 / 按群 / 全局)、计数器判断(如 打卡次数 ≥ 7),多条件同样支持 AND / OR。
  • 动作:发送回复(可多条随机)、计数器 设值 / 累加 / 重置、API 调用。
  • 作用域:全局 / 指定群 / 指定用户,并可设优先级与启停。

配合「计数器」选项卡可以做出打卡、抽奖限次、积分之类的玩法;计数器当前值可在回复里用 {counter:名称} 引用。

插入图片

回复内容支持图片:在管理面板编辑回复时点「插入图片」上传,图片以平台中立码 [img,file=<本地路径>] 保存,发送时自动转换成对应平台的图片消息。也可直接写入 CQ 码 / 海豹码([CQ:image,file=…][图片:…])。

发送形式在 系统设置 →「图片发送方式」选择:base64 内嵌(默认,QQ 框架跑在任何设备都能收到)或 HTTP 链接(可配主机,需 QQ 框架所在设备能访问)。

基于 AGPLv3 协议发布