默认插件

默认插件也就是 el-bot 默认携带的功能。

更多插件请见官方插件库 el-bot-plugins

你也可以在你的自定义配置文件中如下设置,来只启用某几个默认的插件。

plugins:
  default:
    - answer
    # - forward
    # - rss

TIP

强烈建议你先阅读 配置讲解 部分

其中 listentarget 分别代表监听对象和目标对象,是很多插件的通用配置属性。

应答 answer

  • reply: 类型
NameTypeExampleDescription
reObject见代码正则表达式,包含 patternflags 属性
isString / Array见代码类型为字符串时,代表消息与文本相同;类型为数组时,代表(即只要有一个完全相同则触发 )
includesString / Array见代码类型为字符串时,代表消息包含文本;类型为数组时,代表(即同时包含,才会触发 )
atbooleantrue是否只有被 @ 时才回复 (默认不需要)
quotebooleantrue是否引用回复的消息内容 (默认不引用)
replyString / MessageType.MessageChain见代码消息链 ,匹配则回复(你也可以直接写成文本)如果包含如换行符等特殊字符,请用 "" 包裹
elseString / MessageType.MessageChain见代码非当前监听者时,匹配则回复(你也可以直接写成文本)
聊天记录
云游君
早上好
小云
新的一天也要加油鸭
# 消息应答
answer:
  - includes: 早上好啊
    reply: 新的一天也要加油鸭

聊天记录
云游君
早呀
小云
云游君
哦哈呦
小云
云游君
起床啦
小云
聊天记录
云游君
你好吗
云游君
Hello
小云
你好
云游君
你好
小云
你好
聊天记录
云游君
怎么了
云游君
怎么了啊
小云
不告诉你
# 消息应答
answer:
  - re:
      pattern:|哦哈呦|起床啦
    reply:
      - type: Plain
        text:# 或
  - is:
      - Hello
      - 你好
    reply:
      - type: Plain
        text: 你好
  # 同时包含
  - includes:
      - 怎么
      -reply:
      - type: Plain
        text: 不告诉你
聊天记录
云游君
在吗
小云
主人我在
ADD-SP
在吗
小云
爪巴
answer:
  - listen: master
    includes: 在吗
    reply:
      - type: Plain
        text: 主人我在
    else:
      - type: Plain
        text: 爪巴

应答的内容实际是消息链(所以实质,你可以填写任何符合消息链格式的内容)

譬如发送图片(返回随机 bing 壁纸):

https://images.weserv.nl/?url= 用来代理图片

answer:
  - includes:
      - bing
      - 壁纸
    reply:
      - type: Image
        url: https://images.weserv.nl/?url=https://bing.ioliu.cn/v1/rand

你可以传入 API,来回复 API 中返回的数据:

data 为默认的 API 返回的 JSON 数据对象名。

answer:
  # 晚安土味情话
  - re: 晚安|哦呀斯密
    quote: true
    api: https://el-bot-api.vercel.app/api/wanan
    reply: ${data[0]}

转发 forward

譬如:你可以建立一个 沙雕图转发群(群成员为你和机器人),监听对象为该群,发送到该群的任何消息将会被转发至其他多个群或好友。

沙雕图转发群
云游君
舔狗日记 6月16日 阴
今天去修手机,老板说手机没坏,我一把揪住他的领子:“那我怎么收不到她的消息?”
一号沙雕群
小云
舔狗日记 6月16日 阴
今天去修手机,老板说手机没坏,我一把揪住他的领子:“那我怎么收不到她的消息?”
二号沙雕群
小云
舔狗日记 6月16日 阴
今天去修手机,老板说手机没坏,我一把揪住他的领子:“那我怎么收不到她的消息?”

forward 下可配置多个数组

forward:
  - listen:
      friend:
        - 123456
      group:
        - 123456
    target:
      friend:
        - 123456
      group:
        - 123456

支持集体撤回(误将某条消息转发至多个群时,撤回时同样可以撤回多个群的消息)

RSS 订阅 rss

使用 rss-parser 解析

私聊发送 rss 指令可显示当前所有订阅的 RSS 源,并立即抓取最新 RSS。 在群中发送 rss 可查看对应群订阅的 RSS 源。

抓取的 RSS 信息,将存储在 el-bot/tmp/rss.json 中。(默认只存储各 RSS 中第一条信息,以判断是否更新。你也可以删除该文件,以强制触发。)

如果你不知道哪里有有趣的 RSS 源,推荐你使用 RSSHub。 但很遗憾国内已经被墙了,因此你可以选择自建。

私人助理
云游君
rss
小云
您当前订阅的 RSS 源:
云游君的小站: https://www.yunyoujun.cn/atom.xml
addesp: https://www.addesp.com/atom.xml
el-bot: https://github.com/ElpsyCN/el-bot/commits.atom
关键字必要类型示例说明
nameString云游君的小站将作为 RSS 订阅的 ID
cronString"*/15 * * * *"定时器(类 Unix Cron 语法) | node-schedule
customFieldsObject见代码可参见 Custom Fields - rss-parser,自定义后的变量可在 content 中使用
contentArray见代码内容输出形式,可通过 ${item.xxx} 的形式调用变量

默认每 15 分钟获取一次,与本地缓存的 RSS 信息比较,若内容不同时,则发送最新的一篇提示。

私人助理
小云
云游君的小站
标题:hexo-theme-yun 制作笔记
链接:https://www.yunyoujun.cn/note/make-hexo-theme-yun/
时间:2020-05-31 20:00:00
摘要: Hexo-Theme-Yun 绝赞开发中~

#前言
还在用 WordPress 的时候,总是喜新厌旧,经常换主题。且装了一堆插件,速度慢还容易崩。
而迁移到 Hexo 之后(小水管服务器太慢,拿去挂 MC 了。根本原因是没钱),光是 hexo-theme-next 的配置项,便让我花了好一番功夫。
导致觉得自己不一直用下去,感到十分对不起仔细一个一个配置过来的自己。

当然,还是改不了喜新厌旧的毛病。加之 next 主题过于广泛,显得自己泯然众人。心中颇有愤懑。(虽然本就如此)

而如今,诸事已毕,终于腾出空来。
便决定开发一款属于自己的主题。
rss:
  - name: 云游君的小站
    url: https://www.yunyoujun.cn/atom.xml
    # cron: "*/15 * * * *"
    customFields:
      item:
        - updated
        - summary
    content:
      - 标题:${item.title}
      - 链接:${item.link}
      - 时间:${item.updated}
      - 摘要:${item.summary}
    target:
      friend:
        - 910426929
      group:
        - 1072803190

默认包含的变量

当字段存在 summarycontent 时,会对其内容进行 html 标签的过滤。

譬如:

<p>哎呀</p>

会被过滤为:

哎呀

feed

NameTypeExample
authorObject{name: ['云游君']}
updatedString2020-05-31T12:00:00.000Z
linkString/atom.xml
feedUrlString/atom.xml
titleString云游君的小站
lastBuildDateString2020-05-31T12:00:00.000Z
NameTypeExample
titleStringhexo-theme-yun 制作笔记
linkString"https://www.yunyoujun.cn/note/make-hexo-theme-yun/"
pubDateString2019-04-27T04:00:00.000Z
idString"https://www.yunyoujun.cn/note/make-hexo-theme-yun/"
isoDateString2019-04-27T04:00:00.000Z

消息频率限制 limit

消息发送频率限制插件名为 limit,默认开启,默认限制为每 20 秒 10 条。

你也可以自定义你的配置,或不加载该插件。

  • interval: 时间间隔,单位为 ms
  • count: 允许发送消息数量
  • sender: 发送者
    • interval: 默认 600000,即超过十分钟后重置
    • maximum: 最大连续触发次数,超过将会禁言触发者(需要有管理员权限)
    • tooltip: 禁言时的提示
    • time: 禁言时长
limit:
  interval: 20000
  count: 10
  sender:
    interval: 600000
    # 连续次数
    maximum: 3
    tooltip: 我生气了!
    time: 600

黑名单 blacklist

blacklist

聊天记录
云游君
el block qq 114514
小云
[blacklist] 封禁 qq 114514
云游君
el unblock qq 114514
小云
[blacklist] 解封 qq 114514

能不能好好说话 nbnhhsh

nbnhhsh

聊天记录
云游君
el nbnhhsh yysy qs
小云
yysy 的含义:有一说一
小云
qs 的含义:确实,去死,起诉,劝删,潜水,拳师,骑士,气死,茄神,缺神,歧视,券商,水银