# 语法：分 时 日 月 周 命令
0 9 * * * /usr/local/bin/send_weather_report.sh
0 */2 * * * /usr/local/bin/health_check.sh
0 9 * * 1-5 /usr/local/bin/daily_standup.sh

用户：帮我设置一个定时任务：每天早上9点推送今日天气报告

Hermes：
1. 解析时间："每天早上9点" → cron: 0 9 * * *
2. 确认任务内容：获取天气报告
3. 确定推送目标：当前对话平台 (Telegram)
4. 创建任务：✅ 任务已创建

┌─────────────────────────────────────────────────────────┐
│                    Hermes Agent Core                     │
├─────────────────────────────────────────────────────────┤
│  Cron Scheduler                                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │ 时间解析器   │  │ 任务编排器   │  │ 执行引擎    │    │
│  │ (自然语言)   │  │ (依赖+并行)  │  │ (技能调用)  │    │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘    │
└─────────┼────────────────┼────────────────┼─────────────┘
          │                │                │
          ▼                ▼                ▼
    ┌───────────┐   ┌───────────┐   ┌───────────┐
    │  任务队列  │──▶│ 执行单元  │──▶│  推送适配 │
    │  (Redis)  │   │ (Worker)  │   │  器       │
    └───────────┘   └───────────┘   └───────────┘
                                              │
                    ┌──────────────┬──────────┴──────────┐
                    ▼              ▼                      ▼
               Telegram      Discord                  Slack

用户：帮我设置一个定时任务，每天早上9点推送今日天气报告

Hermes：
✅ 任务已创建！

📅 时间：每天 09:00
📋 内容：获取天气报告
📮 推送：Telegram (@你的Bot)
🆔 任务ID：task_weather_daily

回复"取消这个任务"可删除

每天早上9点，推送天气报告到 Discord #general 频道

每天早上9点：先检查天气，然后查询股票行情，最后生成简报

每小时检查服务器状态，如果 CPU > 80% 则发送告警

/hermes cron list

📅 定时任务列表 (共 5 个)

┌────────────────────┬──────────────┬────────────┬────────┐
│ 任务名称           │ 时间         │ 平台       │ 状态   │
├────────────────────┼──────────────┼────────────┼────────┤
│ daily-weather      │ 每天 09:00   │ Telegram   │ ✅ 活跃│
│ hourly-health      │ 每小时       │ Discord    │ ✅ 活跃│
│ weekly-report      │ 周一 10:00   │ Slack      │ ✅ 活跃│
│ stock-alert        │ 工作日 09:30 │ Telegram   │ ⏸️ 暂停│
│ backup-night       │ 每天 02:00   │ CLI        │ ✅ 活跃│
└────────────────────┴──────────────┴────────────┴────────┘

查看 daily-weather 任务的详情

📋 任务详情：daily-weather

⏰ 执行计划：每天 09:00 (cron: 0 9 * * *)
📮 推送目标：Telegram (@HermesWeatherBot)
📝 执行技能：get-weather-report
🔄 重试策略：失败重试 3 次，间隔 5 分钟
📊 统计：
  - 总执行：45 次
  - 成功：43 次 (95.6%)
  - 失败：2 次
  - 最后执行：2026-05-10 09:00:15
  - 下次执行：2026-05-11 09:00:00

取消每天早上9点的天气报告任务

/hermes cron remove daily-weather

暂停 stock-alert 任务

恢复 stock-alert 任务

把这个任务的执行时间改到每天早上10点

输入：每天早上9点
解析：
  - "每天" → 周期：daily
  - "早上9点" → 时间：09:00
  - 结果：cron 0 9 * * *

输入：工作日上午9点30分
解析：
  - "工作日" → 周一到周五
  - "9点30分" → 09:30
  - 结果：cron 30 9 * * 1-5

输入：每月1号下午3点
解析：
  - "每月1号" → 每月1日
  - "下午3点" → 15:00
  - 结果：cron 0 15 1 * *

每隔2小时
→ cron: 0 */2 * * *

每45分钟
→ cron: */45 * * * *

每天9点到18点每小时
→ cron: 0 9-18 * * *

工作日9点到12点每30分钟
→ cron: */30 9-12 * * 1-5

每月最后一个周五
→ cron: 0 15 * * 5L

telegram:
  # 支持 MarkdownV2 和 HTML
  parse_mode: "HTML"
  # 自定义键盘
  reply_markup:
    keyboard:
      - ["📊 查看统计", "⚙️ 设置"]
      - ["❓ 帮助"]
  # 禁用网页预览
  disable_web_page_preview: true

discord:
  # Embed 样式
  embed:
    title: "📊 {{task_name}} 执行报告"
    color: 5814783  # 绿色
    fields:
      - name: "执行时间"
        value: "{{timestamp}}"
      - name: "状态"
        value: "{{status}}"
    footer:
      text: "Hermes Agent Cron"

slack:
  blocks:
    - type: "section"
      text:
        type: "mrkdwn"
        text: "📊 *{{task_name}}* 执行报告"
    - type: "divider"
    - type: "context"
      elements:
        - type: "mrkdwn"
          text: "执行时间: {{timestamp}}"

每天早上9点，同时推送天气报告到 Telegram 和 Slack #general

task:
  name: "daily-weather-multi"
  skill: "get-weather-report"
  schedule: "0 9 * * *"
  targets:
    - platform: "telegram"
      chat_id: "@weather_channel"
    - platform: "discord"
      channel_id: "123456789"
      webhook: "custom-webhook-url"
    - platform: "slack"
      channel: "#general"

每天早上10点，汇总昨天的 GitHub commits 并推送到 Slack #dev-team 频道

📊 2026-05-10 GitHub Commits 汇总

🏠 home-frontend
  - fix: 修复用户登录状态丢失问题 (#234)
  - feat: 添加暗黑模式切换 (#233)
  
🏠 api-service
  - refactor: 重构用户认证模块 (#456)
  - test: 添加单元测试 (#455)

📈 今日统计：5 commits, 2 PRs

每天凌晨2点，备份 ~/projects 目录到 S3 bucket-backup

task:
  name: "nightly-backup"
  schedule: "0 2 * * *"
  skill: "s3-backup"
  config:
    source: "~/projects"
    bucket: "my-backup-bucket"
    retention: 7  # 保留7天
    exclude:
      - "node_modules"
      - ".git"
      - "*.log"

每周一早上9点，检查项目中的 TODO 和 FIXME，生成报告推送到 Discord

📋 技术债务审计报告 - 2026-05-05

🔴 高优先级 (3)
  src/auth/login.ts:42 - TODO: 替换为 OAuth2
  src/payment/api.ts:128 - FIXME: 处理超时异常
  tests/unit/auth.test.ts:15 - HACK: 临时绕过验证
  
🟡 中优先级 (7)
  src/utils/format.ts:22 - TODO: 添加单元测试
  ...
  
📊 趋势：相比上周 +2 TODO, -1 FIXME

每小时检查服务器状态，CPU 或内存超过 80% 时发送告警到 Telegram

task:
  name: "hourly-health"
  schedule: "0 * * * *"
  skill: "health-check"
  condition: "cpu > 80 OR memory > 80"
  targets:
    - platform: "telegram"
      chat_id: "@admin_channel"

⚠️ 服务器告警

🖥️ server-1
  CPU: 92% 🔴
  内存: 67% 🟡
  磁盘: 45% 🟢
  
⏰ 检测时间: 2026-05-11 10:00:03

工作日上午9:30，检查 AAPL、GOOGL、MSFT 股票价格，推送变动摘要

task:
  name: "stock-morning"
  schedule: "30 9 * * 1-5"
  skill: "stock-checker"
  config:
    symbols: ["AAPL", "GOOGL", "MSFT"]
    threshold: 2  # 变动超过 2% 才提醒

每天下午6点，汇总我今天的日程、邮件、任务完成情况，生成日报

每天早上9点：
1. 先获取天气数据
2. 然后查询股票行情
3. 接着生成综合简报
4. 最后推送到 Slack

Task A (天气) ──┐
               ├──► Task C (生成简报) ──► Task D (推送)
Task B (股票) ──┘

tasks:
  - name: "morning-brief"
    chain:
      - skill: "get-weather"
        output_var: "weather_data"
      - skill: "get-stock"
        input: "${weather_data.date}"
        output_var: "stock_data"
      - skill: "generate-brief"
        input:
          weather: "${weather_data}"
          stock: "${stock_data}"
      - skill: "send-to-slack"

每天早上9点，同时执行：天气查询、股票查询、新闻聚合

task:
  name: "morning-aggregate"
  schedule: "0 9 * * *"
  parallel:
    - skill: "get-weather"
    - skill: "get-stock"
    - skill: "get-news"
  merge_type: "combine"  # 合并结果

如果天气晴朗，推送适合出行的建议；否则推送室内活动建议

task:
  name: "weather-action"
  schedule: "0 8 * * *"
  conditional:
    - condition: "weather == 'sunny'"
      then:
        - skill: "push-sunny-activities"
    - condition: "weather == 'rainy'"
      then:
        - skill: "push-indoor-activities"

# redis 结构
hermes:cron:tasks
  ├── task_weather_daily
  │   ├── schedule: "0 9 * * *"
  │   ├── enabled: true
  │   ├── last_run: 1715400000
  │   ├── next_run: 1715486400
  │   └── stats: {...}
  └── ...

1. 系统启动
2. 加载 cron 配置
3. 扫描 Redis 中的任务
4. 检查是否有遗漏执行的任务
5. 根据配置决定是否执行遗漏任务

cron:
  # 是否执行遗漏的任务
  recover_missed: true
  
  # 遗漏任务的最大延迟时间（秒）
  # 超过这个时间则不执行
  max_recovery_delay: 3600
  
  # 恢复时的行为
  recovery_action: "run"  # run | skip | notify

/hermes cron status

📊 Cron 执行状态

┌────────────────────┬──────────────┬────────────┬────────────┐
│ 任务               │ 上次执行      │ 下次执行    │ 状态        │
├────────────────────┼──────────────┼────────────┼────────────┤
│ daily-weather      │ 09:00:15 ✅  │ 09:00:00   │ 等待中     │
│ hourly-health      │ 10:00:03 ✅  │ 11:00:00   │ 等待中     │
│ weekly-report      │ Mon 10:00 ✅ │ Mon 10:00  │ 等待中     │
│ backup-night       │ 02:00:22 ✅  │ 02:00:00   │ 等待中     │
└────────────────────┴──────────────┴────────────┴────────────┘

内存使用: 45MB
任务队列: 2 个待执行

/hermes cron logs daily-weather

📜 日志：daily-weather (最近 20 条)

┌─────────────────────┬────────┬───────────────────────────┐
│ 时间                │ 状态   │ 详情                      │
├─────────────────────┼────────┼───────────────────────────┤
│ 2026-05-11 09:00:15│ ✅ 成功│ 执行耗时: 3.2s            │
│ 2026-05-10 09:00:22│ ✅ 成功│ 执行耗时: 4.1s            │
│ 2026-05-09 09:00:18│ ✅ 成功│ 执行耗时: 2.8s            │
│ 2026-05-08 09:00:45│ ❌ 失败│ 错误: API 限流            │
│ 2026-05-08 09:05:12│ ✅ 成功│ 重试成功，执行耗时: 3.5s   │
│ ...                 │ ...    │ ...                       │
└─────────────────────┴────────┴───────────────────────────┘

/hermes cron stats daily-weather --days 30

📊 统计：daily-weather (30 天)

执行统计：
  - 总执行：30 次
  - 成功：28 次 (93.3%)
  - 失败：2 次 (6.7%)
  
失败分析：
  - API 限流：1 次
  - 网络超时：1 次
  
性能：
  - 平均耗时：3.4s
  - 最快：2.1s
  - 最慢：8.2s
  
时间分布：
  - 09:00-09:05: 28 次
  - 09:05-09:10: 2 次 (重试)

/hermes cron test daily-weather --verbose

cron_tasks:
  - name: "custom-task"
    schedule: "0 */2 * * *"  # 每2小时
    skill: "my-skill"
    platform: "telegram"
    config:
      param1: "value1"

cron_tasks:
  - name: "alert-task"
    schedule: "0 * * * *"
    # 只有满足条件才执行
    condition: "server_status != 'ok'"
    platform: "telegram"

task:
  name: "reliable-task"
  retry:
    max_attempts: 3      # 最多重试3次
    initial_delay: 60    # 首次重试延迟 60s
    max_delay: 300       # 最大延迟 5 分钟
    exponential: true    # 指数退避

task:
  name: "timeout-task"
  timeout: 300  # 5 分钟超时
  on_timeout: "cancel"  # cancel | continue

task:
  name: "rate-limited-task"
  rate_limit:
    max_runs: 10
    window: 3600  # 每小时最多10次

# 诊断任务问题
/hermes cron doctor daily-weather

# 测试技能是否正常工作
/hermes skill test get-weather

# 查看系统日志
/hermes logs --component cron --level debug

查看我的所有定时任务
取消每天早上的天气任务
暂停 stock-alert 任务
恢复它