## 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` 即可获得短链接
Trending Articles
More Pages to Explore .....