koishi-plugin-custom-ping

检测关键词并返回用户设置的信息。

功能

• 自定义关键词触发自动回复
• 支持多个关键词映射到同一条回复（使用 | 分隔）
• 多个回复选项随机选择：每个规则的响应可以设置多个（用 | 分隔），将等概率随机选择其中一个
• 支持变量替换：
  • {name} — 用户昵称
  • {id} — 用户 ID
  • {image:"path/to/image"} — 发送图片（支持本地路径和网络 URL）
• 可配置调用间隔（冷却时间），防止刷屏

安装

通过 Koishi 插件市场搜索 custom-ping 安装，或手动安装：

npm install koishi-plugin-custom-ping

配置

| 配置项 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | interval | number | 0 | 调用间隔（秒），0 表示无限制 | | rules | PingRule[] | [] | 关键词与回复的映射列表 |

PingRule 字段

| 字段 | 类型 | 说明 | | --- | --- | --- | | keywords | string | 触发关键词（多个用 \| 分隔，例如：你好 | hello | hi）| | response | string | 返回信息选项（多个用 \| 分隔将随机选择一个，例如：早上好 | 上午好 | Hello）|

配置示例

plugins:
  custom-ping:
    interval: 5  # 5秒冷却
    rules:
      # 多个关键词触发同一回复
      - keywords: "你好 | hello | hi"
        response: "你好呀 {name}！欢迎！"
      
      # 多个回复随机选择
      - keywords: "晚安 | 睡觉"
        response: "晚安 {name}，睡眠愉快！ | 晚安呀，{name}，明天见！ | 好梦，{name}！💤"
      
      # 使用变量
      - keywords: "我是谁"
        response: "你是 {name}，ID 为 {id}"
      
      # 发送图片
      - keywords: "logo"
        response: "这是我们的 logo：{image:\"./assets/logo.png\"}"

许可证

MIT