/loop 循环执行的参数格式、间隔单位、默认值与取消方式
/loop 让 Qoder CLI 按固定间隔重复执行一段提示或斜杠命令,底层通过定时任务系统实现。本页说明其参数格式、间隔换算与取消方式。关于循环执行的使用指南,见 重复执行任务。
用法
[间隔](可选):执行间隔。省略时默认10m(10 分钟)。<提示>(必填):要重复执行的提示文本或斜杠命令。为空时显示用法提示。
间隔单位
间隔由数字加单位后缀组成:
| 后缀 | 单位 | 说明 |
|---|---|---|
s | 秒 | 向上取整到最近的分钟(最小粒度 1 分钟)。 |
m | 分钟 | 每 N 分钟。 |
h | 小时 | 每 N 小时。 |
d | 天 | 每 N 天(本地时间午夜触发)。 |
最小粒度为 1 分钟。以秒为单位的间隔会被向上取整为 ceil(N/60) 分钟,取整时会提示你。
解析规则
/loop 按以下优先级解析输入:
- 前导 token:若第一个词匹配
^\d+[smhd]$(如5m、2h),则作为间隔,其余为提示。 - 尾随 every 子句:否则若输入以
every <N><单位>或every <N> <单位词>结尾(如every 20m、every 5 minutes),提取为间隔并从提示中去除。仅当every后接时间表达式时才匹配——check every PR不含间隔。 - 默认:否则间隔为
10m,整段输入作为提示。
示例
间隔到 cron 的换算
| 间隔模式 | cron 表达式 | 说明 |
|---|---|---|
Nm(N ≤ 59) | */N * * * * | 每 N 分钟 |
Nm(N ≥ 60) | 0 */H * * * | 换算为小时(H = N/60,需整除 24) |
Nh(N ≤ 23) | 0 */N * * * | 每 N 小时 |
Nd | 0 0 */N * * | 每 N 天午夜 |
Ns | 视为 ceil(N/60)m | cron 最小粒度为 1 分钟 |
7m 会产生不均匀间隔、90m 无法用 cron 表达),会选择最接近的整齐间隔并在创建任务前告知取整结果。
取消与失效
- 循环任务在创建后 7 天自动过期。
- 可在过期前手动删除对应的定时任务(用自然语言请求 Agent 删除,并提供任务 ID)。
- 创建循环任务后会立即执行一次当前提示,不等待第一次 cron 触发。