Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/haikerapples/timetask
一款支持自定义定时任务的chatgpt-on-wechat插件
https://github.com/haikerapples/timetask
Last synced: 3 months ago
JSON representation
一款支持自定义定时任务的chatgpt-on-wechat插件
- Host: GitHub
- URL: https://github.com/haikerapples/timetask
- Owner: haikerapples
- License: mit
- Created: 2023-06-24T11:18:25.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-03-16T13:35:25.000Z (8 months ago)
- Last Synced: 2024-06-15T16:38:32.089Z (5 months ago)
- Language: Python
- Size: 1.51 MB
- Stars: 181
- Watchers: 4
- Forks: 42
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ChatGPT-repositories - timetask - 一款支持自定义定时任务的chatgpt-on-wechat插件 (Others)
README
# timetask
一款支持自定义定时任务的chatgpt-on-wechat插件，支持自定义时间、轮询周期、自定义时间，包含动态添加任务、取消任务、查看任务列表等功能，一款定时任务系统的插件。
## **【插件功能介绍】**
##### 🎉功能一：
支持用户设定时间，添加定时任务，定时自动发消息；
* 时间支持自定义
* 日期支持轮询，支持每天、每周、工作日、具体日期、cron表达式等
##### 🎉功能二：
支持 普通的提醒消息、及链接其他插件的拓展功能。比如早报、点歌、搜索、转发GPT等，理论上已安装的插件均可一键调度
##### 🎉功能三：
支持动态的取消定时任务、随时查看任务列表等
##### 🎉功能四：
无侵入性，原项目无需改造，安装插件即可使用
## **【插件安装方法】**
1. clone本仓库 或 下载源代码（源码下载方式时，timetask文件夹会自动带上分支名，将文件夹名称去除，命名timetask为即可）
2. 将本插件的文件夹timetask, 放进 chatgpt-on-wechat 的 plugins 文件夹中（chatgpt-on-wechat启动后，会自动加载本插件）
3. 安装插件依赖库：进入 timetask 文件夹，执行命令：pip3 install -r requirements.txt
4. 至此，插件安转完毕，启动chatgpt-on-wechat，使用 timetask 插件
## **【如何使用 - 定时任务】**
Tips：与机器人对话，发送如下定时任务指令即可
### **一、添加定时任务**
【指令格式】：**$time 周期 时间 事件**
1. **$time**：指令前缀，当聊天内容以$time开头时，则会被当做为定时指令
2. **周期**：今天、明天、后天、每天、工作日、每周X（如：每周三）、YYYY-MM-DD的日期、cron表达式
3. **时间**：X点X分（如：十点十分）、HH:mm:ss的时间
4. **事件**：想要做的事情 （支持普通提醒、以及项目中的拓展插件，详情如下）
5. **群标题（可选）**：可选项，不传时，正常任务； 传该项时，可以支持私聊给目标群标题的群，定任务（格式为：group[群标题]，注意机器人必须在目标群中）
【备注】：目前第5点的支持的通道：itchat（即微信)、ntchat（windows版微信)、ntwork(windows版企业微信)
```
事件-拓展功能：默认已支持早报、搜索、点歌
示例 - 早报：$time 每天 10:30 早报
示例 - 点歌：$time 明天 10:30 点歌 演员
示例 - 搜索：$time 每周三 10:30 搜索 乌克兰局势
示例 - 提醒：$time 每周三 10:30 提醒我健身
示例 - cron：$time cron[0 * * * *] 准点报时
示例 - GPT：$time 每周三 10:30 GPT 夸一夸我
示例 - 画画：$time 每周三 10:30 GPT 画一只小老虎
示例 - 群任务：$time 每周三 10:30 滴滴滴 group[群标题]
拓展功能效果：将在对应时间点，自动执行拓展插件功能，发送早报、点歌、搜索等功能。
文案提醒效果：将在对应时间点，自动提醒（如：提醒我健身）
Tips：拓展功能需要项目已安装该插件，更多自定义插件支持可在
timetask/config.json 的 extension_function 自助配置即可。
```
### **二、取消定时任务**
##### **方法一、直接通过任务编号，取消定时任务**
【指令格式】：**$time 取消任务 任务编号**
1. **$time 取消任务**：指令前缀，以此前缀，会取消定时任务
2. **任务编号**：机器人回复的任务编号（添加任务成功时，机器人回复中有）
##### **方法二、先查询任务编号列表，然后选择要取消的任务编号，取消定时任务**
1. 【指令格式】：$time 任务列表
2. 根据任务列表，选择要取消的任务编号，执行上面的方法一（直接通过任务编号，取消定时任务）
### **三、查看定时任务列表**
【指令格式】：**$time 任务列表**
* 指令执行成后，机器人会将所有 **待执行的任务列表**，回复出来
* 已过期或已被消费过的任务会自动过滤
### **四、插件文件介绍**
##### 配置文件：config.json
```
{
#定时任务前缀（以该前缀时，会被定时任务插件捕获）
"command_prefix": "$time",
#是否开启debug（会输出日志）
"debug": false,
#检测频率（默认1秒一次，注意不建议修改！！如果任务带秒钟，则可能会被跳过）
"time_check_rate": 1,
#Excel中迁移任务的时间（默认在凌晨4点将Excel 任务列表sheet 中失效的任务 迁移至 -> 历史任务sheet中）
"move_historyTask_time": "04:00:00",
#是否每个任务回复前，均 路由查询一遍是否能被其他插件解释，若会被解释，则使用解释内容回复；否则继续查询是否开启了拓展功能，如果均不可被消费，则最终使用原始内容兜底
#比如 $time 今天 13:35 搜索股票，到达目标时间，则会将 “搜索股票”的关键词默认路由到其他插件查询一遍，如果可以被其他插件解释，则再会使用使用解释后的内容回复。
#定时内容可自由设定，比如 “搜索股票”、“$tool 查询天气”，只要你的工程的插件可以解释关键字即可（前面2个内容为示例，是否可以成功取决于你工程是否有识别该关键字的插件）
"is_open_route_everyReply": true,
#是否开启拓展功能（开启后，会识别项目中已安装的插件，如果命中 extension_function中的前缀，则会将消息路由转发给目标插件）
"is_open_extension_function": true,
#支持的拓展功能列表（理论上 已安装的插件，均支持路由转发，其他插件可自主配置，参考早报的配置方式）
"extension_function":
[
{
# 触发词
"key_word": "早报",
# 路由插件的 指令前缀
"func_command_prefix":"$tool "
},
{
"key_word": "点歌",
"func_command_prefix": "$"
},
{
"key_word": "搜索",
"func_command_prefix": "$tool google "
},
{
# 触发词
"key_word": "GPT",
"func_command_prefix": "GPT"
}
]
}
```
### **五、其他**
##### 查看所有定时任务指令：
##### 任务Excel文件：timetask/timeTask.xlsx
```
定时任务 - sheet： 存放当天要消费的任务
历史任务 - sheet： 存放历史已消费的任务
```