捷帮定时任务#

为AI Agent提供完整的定时任务管理能力：创建、查询、完成、删除定时任务，查看执行日志，使用预设模板快速创建常用任务。

免费使用，自动注册，无需配置。

核心能力#

1. 创建定时任务 — 支持Cron表达式和自然语言时间描述，支持失败重试配置
2. 查询任务列表 — 查看所有任务或仅查看到期任务，按标签筛选
3. 完成/失败标记 — 标记任务执行结果，支持附加消息
4. 执行日志 — 查看任务执行历史，包括成功/失败状态和时间
5. 预设模板 — 12个常用模板：每日早报、每小时检查、工作日盯盘、每月报告等
6. 删除任务 — 不再需要的任务可以删除

工作流程#

第一步：确保API Key可用#

运行 python3 main.py ensure-key 自动注册获取API Key。Key会保存到本地文件，后续调用自动读取。

只需执行一次，除非Key丢失才需要重新注册。

第二步：根据用户需求执行操作#

用户意图执行命令创建定时任务python3 main.py create --name "任务名" --cron "0 9 * * *" [--retries 3] [--tags "daily,report"]查看所有任务python3 main.py list只看到期任务python3 main.py list --due按标签筛选python3 main.py list --tag "stock"标记完成python3 main.py done <task_id> [--status success] [--msg "执行成功"]标记失败python3 main.py done <task_id> --status failed --msg "API超时"查看执行日志python3 main.py logs [--task-id <id>] [--limit 20]查看预设模板python3 main.py templates用模板创建python3 main.py create --template "daily-morning" --name "每日早报"删除任务python3 main.py delete <task_id>

Cron表达式说明#

格式： 分 时 日 月 周

常用示例：

• 0 9 * * * — 每天9点
• 0 9,22 * * 1-5 — 工作日9点和22点
• */30 * * * * — 每30分钟
• 0 0 1 * * — 每月1号零点
• 0 9 * * 1 — 每周一9点

预设模板列表#

模板ID名称Cron说明daily-morning每日早报0 9 * * *每天早上9点daily-evening每日晚报0 18 * * *每天下午6点hourly每小时检查0 * * * *每小时整点every-30min每30分钟*/30 * * * *每30分钟weekday-morning工作日早报0 9 * * 1-5工作日9点weekday-evening工作日晚报0 18 * * 1-5工作日18点weekly每周报告0 9 * * 1每周一9点monthly每月报告0 9 1 * *每月1号9点stock-open开盘提醒30 9 * * 1-5工作日9:30stock-close收盘提醒0 15 * * 1-5工作日15:00stock-morning盘前分析0 8 * * 1-5工作日8点stock-evening盘后复盘0 22 * * 1-5工作日22点

输出格式#

所有命令输出JSON格式，包含status和data/result字段。错误时返回error字段。

边界情况#

• 首次使用必须先运行 ensure-key 注册API Key
• 免费版限制：10次/分钟，100次/天
• Cron表达式必须是5段格式（分 时 日 月 周）
• 任务ID是字符串，在完成/删除时需要精确传入
• 同一agent_id下的任务名称可以重复，用task_id区分

使用示例#

text

输入: "帮我设个每天早上9点的定时任务"
执行: python3 main.py create --name "每日任务" --cron "0 9 * * *"

输入: "看看我有哪些到期的任务"
执行: python3 main.py list --due

输入: "用盯盘模板创建一个任务"
执行: python3 main.py create --template "stock-open" --name "开盘提醒"

输入: "任务abc123完成了"
执行: python3 main.py done "abc123" --status success