Skip to content

触发配置

本文档详细说明触发方式的配置选项。

基础配置

yaml
trigger:
  # 私聊触发方式
  private: prefix
  
  # 群聊触发方式
  group: at
  
  # 触发前缀
  prefix: "#chat"

触发类型

类型说明
at@机器人触发
prefix前缀触发
both两者皆可
none禁用触发

前缀配置

单前缀

yaml
trigger:
  prefix: "#chat"

多前缀

yaml
trigger:
  prefixes:
    - "#chat"
    - "/ai"
    - "AI:"

关键词触发

yaml
trigger:
  keywords:
    - "问一下"
    - "请问"
    - "帮我"

正则匹配

yaml
trigger:
  keywordPatterns:
    - "^你好"
    - "天气.*怎么样"

随机触发

yaml
trigger:
  # 随机触发概率 (0-100)
  randomRate: 10
  
  # 冷却时间(秒)
  randomCooldown: 60

冷却配置

yaml
trigger:
  # 全局冷却
  globalCooldown: 5
  
  # 用户冷却
  userCooldown: 10
  
  # 群组冷却
  groupCooldown: 3

黑白名单

用户

yaml
trigger:
  userWhitelist: []
  userBlacklist:
    - "123456789"

群组

yaml
trigger:
  groupWhitelist: []
  groupBlacklist:
    - "987654321"

消息过滤

yaml
trigger:
  # 最小消息长度
  minLength: 2
  
  # 最大消息长度
  maxLength: 2000
  
  # 允许纯图片触发
  allowImageOnly: false

群组独立配置

yaml
groups:
  "123456789":
    trigger:
      type: both
      prefix: "#ai"
      randomRate: 5

完整示例

yaml
trigger:
  private: prefix
  group: at
  prefix: "#chat"
  prefixes:
    - "#chat"
    - "/ai"
  keywords: []
  keywordPatterns: []
  randomRate: 0
  randomCooldown: 60
  globalCooldown: 5
  userCooldown: 10
  groupCooldown: 3
  minLength: 2
  maxLength: 2000
  allowImageOnly: false
  userWhitelist: []
  userBlacklist: []
  groupWhitelist: []
  groupBlacklist: []

下一步

基于 MIT 许可发布