ELF_RSS 订阅插件使用、安装教程

Author： Quan
发布时间：December 23, 2020
121845views
114 comments
3888 words
Categories：主页代码教程

## 2.0 使用教程（1.x 在后面）

> 注意：
>
> 1. 所有命令均分群组、和私聊两种情况，执行结果也会不同
> 2. [] 包起来的参数表示可选，但某些情况下为必须参数
> 3. 所有 订阅命令 群管都可使用（如果不需要请自行修改代码）
> 4. 私聊直接发送命令即可，群聊需在前面添加 **机器人昵称** 或者 **@机器人**
> 5. 所有参数之间均用空格分割，符号为英文标点

### 添加订阅

> 命令：add （添加订阅、sub）
>
> 参数：订阅名 [RSS 地址]
>
> 示例：`add test twitter/user/huagequan`
>
> 使用技巧：先快速添加订阅，之后再 通过 `change` 命令修改
>
> 命令解释：
>
> 1. 完全新增订阅时，必需 `订阅名` 及 `RSS地址` 两个参数，默认订阅到当前 `群组` 或 `QQ`
> 2. 当该 `订阅名` 存在时，只需 `订阅名` 一个参数，此时会将该订阅订阅到当前 `群组` 或 `QQ`

### 删除订阅

> 命令：deldy （删除订阅、drop）
>
> 参数：订阅名
>
> 示例：`deldy test`
>
> 命令解释：
>
> 1. 在私聊使用该命令时，必需 `订阅名` 参数，可完全删除该订阅
> 2. 在群组使用该命令时，必需 `订阅名` 参数，默认将 该群组 从 订阅群组 中删除

### 所有订阅

> 命令：showall（所有订阅、selectall）
>
> 参数：无
>
> 示例：`showall`
>
> 命令解释：
>
> 1. 在私聊使用该命令时，展示所有订阅
> 2. 在群组使用该命令时，展示该群组的订阅

### 查看订阅

> 命令：show（查看订阅）
>
> 参数：[订阅名]
>
> 示例：`show test`
>
> 命令解释：
>
> 1. 携带 `订阅名` 参数时，展示该订阅的详细信息
> 2. 不携带 `订阅名` 参数时，展示该 群组 或 QQ 的订阅详情

### 修改订阅

> 命令：change（修改订阅，moddy）
>
> 参数：订阅名 属性=值 [[属性=值]...]
>
> 示例：`change test qq=,123,234 ot=1`
>
> 使用技巧：可以先只发送 `change` ，机器人会返回提示信息，无需记住复杂的参数列表
>
> 对应参数: 
>
> 订阅链接-url QQ-q 群-qun 更新频率-time 
>
> 代理-proxy 翻译-tl 仅title-ot，仅图片-op 
>
> **注：**
>
> proxy、tl、ot、op 值为 1/0 
>
> QQ、群号前加英文逗号表示追加,-1设为空 
>
> 各个属性之间使用**空格**分割 
>
> time 的值在为数字时，表示每分x钟进行一次更新操作，其值必须大于等于 1，单位分钟
>
> time属性兼容 Linux crontab 格式，**但不同的是，crontab 中的空格应该替换为 `_` 即下划线**
>
> 可以参考 [Linux crontab 命令](https://www.runoob.com/linux/linux-comm-crontab.html) 务必理解！
>
> 时间格式如下：
>
> ```
> f1_f2_f3_f4_f5
> ```
>
> - 其中 f1 是表示分钟，f2 表示小时，f3 表示一个月份中的第几日，f4 表示月份，f5 表示一个星期中的第几天。program 表示要执行的程序。
> - 当 f1 为 * 时表示每分钟都要执行 program，f2 为 * 时表示每小时都要执行程序，其馀类推
> - 当 f1 为 a-b 时表示从第 a 分钟到第 b 分钟这段时间内要执行，f2 为 a-b 时表示从第 a 到第 b 小时都要执行，其馀类推
> - 当 f1 为 */n 时表示每 n 分钟个时间间隔执行一次，f2 为 */n 表示每 n 小时个时间间隔执行一次，其馀类推
> - 当 f1 为 a, b, c,... 时表示第 a, b, c,... 分钟要执行，f2 为 a, b, c,... 时表示第 a, b, c...个小时要执行，其馀类推
>
> ```
> *    *    *    *    *
> -    -    -    -    -
> |    |    |    |    |
> |    |    |    |    +----- 星期中星期几 (0 - 7) (星期天 为0)
> |    |    |    +---------- 月份 (1 - 12) 
> |    |    +--------------- 一个月中的第几天 (1 - 31)
> |    +-------------------- 小时 (0 - 23)
> +------------------------- 分钟 (0 - 59)
> ```
>
> 以下是一些示例：
>
> ```bash
> 1            # 每分钟执行一次（普通）
> 1_           # 每小时的第一分钟运行（cron）
> */1          # 每分钟执行一次
> *_*/1        # 每小时执行一次（注意，均在整点运行）
> *_*_*_*_1,2,6,0 # 每周1、2、6、日运行，周日为0
> 0_6-12/3_*_12_* #在 12 月内, 每天的早上 6 点到 12 点，每隔 3 个小时 0 分钟执行一次
> *_12_*          # 每天12点运行
> # 如果不生效请查看控制台输出
> ```
>
>

## 以下为 1.x 版本使用教程

### 添加订阅

**添加订阅所有提到可选参数都只能从后面开始省略，不能设置在代理时省略更新频率的参数，设置第三方时省略更新频率、代理参数**

向机器人发送 
```python
add mytwitter /twitter/user/Huagequan 123456,23445 -1 5 1 0

# 以下为注释

# add是添加订阅命令，若单独发送了add后，根据提示填写订阅信息即可，无需再加add

# mytwitt 为订阅名 因为要根据名字生成文件，所以不能有文件名不允许的特殊字符存在
# 不能命名为rss，会与配置文件冲突！！！

# /twitter/user/Huagequan 为订阅地址，此处为rsshub路由地址，非rsshub订阅源要写完整
# 如 https://myelf.club/index.php/feed/ 同时要设置第三方为1

# 123456,23445为订阅者qq号，逗号分开，-1表示设为空

# -1 为订阅群号，和qq号一样英文逗号分开，-1表示为空。
# qq号，群号两者必须有一个不为空，且有效，否则会出错。

# 5 为检查更新的频率，单位分钟/次，最小一分钟，还受到订阅源缓存影响 可选，默认为5

# 1 是否开启代理，有两种参数0/1 1开启，0关闭，设置此项为一必须设置好代理，此项可选，默认为0不开启

# 0 是否第三方订阅，即非rsshub订阅源时必须设为1  可选，默认为0关闭

# 0 翻译，Google翻译，效果一般  可选，默认为0关闭

# 0 仅输出标题，在正文较长的情况下建议启用  可选，默认为0关闭

# 可选参数建议添加订阅成功后通过change修改

```
机器人回复成功则添加成功。

### 查看订阅

向机器人发送
`show_all` 或`showall`、`seeall`
即可查看所有订阅

向机器人发送
`show test`
即可查看某一个订阅详细信息
test为订阅名或者订阅链接

### 删除订阅

向机器人发送
`deldy test`
即可删除某一个订阅
test为订阅名或者订阅链接

### 修改订阅

向机器人发送
`change`
即可查看修改方法
```python
输入要修改的订阅的 
订阅名 修改项=,属性 
如:
test dyqq=,xx dsf=0
对应参数： 订阅地址-url，订阅QQ-dyqq，订阅群-dyqun，更新频率-uptime，代理-proxy，第三方-dsf，翻译-tl，仅title-ot

注：
代理、第三方、翻译、仅title属性值为1/0
qq、群号前加英文逗号表示追加
```
test为订阅名
也可直接在change后面加修改参数，也可单独修改某一个参数

### 短链接

发送 `短链 https://myelf.club` 即可获得短链接

Last modification：January 13th, 2021 at 05:44 pm

If you think my article is useful to you, please feel free to appreciate