pi-scheduler

English

使用固定格式模板为 pi 设置定时任务。支持一次性任务和周期性任务，全程正则解析，不依赖 AI，因此即使 token 配额耗尽也能正常工作。

为什么选择 pi-scheduler？

• 不依赖 AI：所有调度解析使用正则表达式，而非 AI。即使被限流或 token 耗尽，依然可以配置定时任务。
• 两种配置方式：通过 /schedule add 交互式添加，或直接编辑 JSON 配置文件。
• 灵活的定时规则：支持一次性（绝对时间 / 相对延迟）、每日、每小时、固定间隔、每周。

安装

pi install npm:@vincentff/pi-scheduler

本地开发：

pi install ./path/to/pi-scheduler

模板格式

<调度规则> | <提示词>

一次性任务

| 模板 | 示例 | |----------|---------| | at YYYY-MM-DD HH:mm | at 2025-12-31 23:59 \| 新年快乐！ | | in Ns / Nm / Nh / Nd | in 30m \| 检查服务器状态 |

周期性任务

| 模板 | 示例 | |----------|---------| | daily HH:mm | daily 09:00 \| 早安，来个今日摘要 | | hourly | hourly \| 健康检查 | | every Ns/Nm/Nh/Nd | every 2h \| 检查长时间运行的任务 | | weekly DAY HH:mm | weekly mon 09:00 \| 周计划 |

星期缩写：mon、tue、wed、thu、fri、sat、sun

使用案例

案例 1：Token 配额重置后自动重试

你触发了速率限制，但配额将在 45 分钟后重置。让 pi 到时间自动重试：

/schedule add in 45m | 重试我上次的请求：review auth 模块的重构

定时器触发后，pi 会将 prompt 作为用户消息发送——就像你亲手输入一样。你可以暂时离开，回来直接看结果。

案例 2：每日早间简报

设置一个周期性任务，让每个工作日自动启动：

/schedule add daily 09:00 | 早上好！查看我从昨天以来的 git 历史，总结我做了什么，并建议今天的前 3 个优先事项。

也可以在配置文件中批量配置，实现完整的日常流程：

{
  "tasks": [
    {
      "id": "morning-brief",
      "schedule": "daily 09:00",
      "prompt": "总结仓库最近的改动，并建议今天的优先事项",
      "enabled": true,
      "createdAt": "2025-07-21T00:00:00.000Z"
    },
    {
      "id": "afternoon-check",
      "schedule": "daily 14:00",
      "prompt": "查看待处理的 issue，提醒我有哪些未完成的 code review",
      "enabled": true,
      "createdAt": "2025-07-21T00:00:00.000Z"
    }
  ],
  "paused": false
}

命令

| 命令 | 说明 | |---------|-------------| | /schedule add <模板> | 添加定时任务 | | /schedule list | 列出所有任务及下次执行时间 | | /schedule remove <id> | 删除任务（支持 ID 前缀匹配） | | /schedule toggle <id> | 启用/禁用某个任务 | | /schedule pause | 暂停所有调度 | | /schedule resume | 恢复所有调度 | | /schedule clear | 清除所有任务 | | /schedule help | 显示模板参考 |

配置文件

任务以 JSON 格式存储，可直接编辑进行批量修改：

全局： ~/.pi/agent/scheduler-tasks.json 项目： .pi/scheduler-tasks.json（优先级更高）

{
  "tasks": [
    {
      "id": "a1b2c3d4-...",
      "schedule": "daily 09:00",
      "prompt": "总结今天的待办事项",
      "enabled": true,
      "createdAt": "2025-01-15T08:00:00.000Z"
    },
    {
      "id": "e5f6g7h8-...",
      "schedule": "in 30m",
      "prompt": "检查构建状态",
      "enabled": true,
      "createdAt": "2025-01-15T09:00:00.000Z"
    }
  ],
  "paused": false
}

License

MIT