定时任务

把一件要反复做的事交给 agent:它按计划自己跑,每轮交一份简报,出了事才叫你。

有些事要反复做:每天看一遍线上、每周写周报、每小时查一次有没有新的失败。定时任务就是把这类事写成一段指令,定一个计划,交给 agent 自己跑。

它和在系统里配一条 cron 的区别是:每一轮它都读得到上一轮记下的东西,跑完会交一份你能直接看的结果,失败了会自己换一个 agent 再试。

定时任务页:要你处理的排最前,每张卡片上是最近一轮的结论
定时任务页:要你处理的排最前,每张卡片上是最近一轮的结论

建一个任务

点「新建任务」。

新建任务:上面写指令,下面一排是计划、用谁跑、在哪跑
新建任务:上面写指令,下面一排是计划、用谁跑、在哪跑

最少只要填三样:名字、指令、计划。

指令要写清楚三件事:每一轮做什么、看哪里、什么算做完。它每一轮都会读这段话,所以要写成「每次都成立」的说法,不要写「今天」「这次」。

计划

选项 意思 例子
每隔一段 上一轮结束后等这么久再跑 30m、2h、1d
每天 每天固定时间 每天 09:00
工作日 周一到周五固定时间 每个工作日 09:00
每周 每周某一天固定时间 每周一 09:00
Cron 五段表达式,按本机时区 0 9 * * 1-5

间隔最短 1 分钟,最长 366 天。

用谁跑

默认用 Claude Code。可以加多个 agent,排好顺序:第一个失败了,自动换下一个接着跑这一轮。每个 agent 还可以单独指定模型和备用模型。

只有 agent 那一侧出问题才会换,比如它卡死了、起不来、模型服务报错。你手动停掉的、超时的、权限不够的,不会换。

在哪跑

默认每个任务有一个自己的目录。要让它在某个项目里干活,选那个项目,或者选一个本地文件夹。

会话

选项 意思 适合
接着上一轮的会话(默认) 所有轮次在同一条会话里 需要记得上下文的事
每轮开新会话 每轮带着任务记忆从头开始 每轮互相独立的检查
接在指定会话后面 到点去唤醒你已有的一条会话 让一段现成的对话定期往下推

限制

都可以不填。

  • 最多跑几轮:到了就自己停。
  • 每轮最长:一轮的总时间上限,包含换 agent 重试的时间。只算电脑醒着的时间。
  • 每几轮整理:隔几轮把记忆压缩一次,见下面「记忆」。

开跑前检查

很多时候「到点」不等于「该跑」:仓库没有新提交,就没必要再查一遍。开跑前检查是一小段脚本,到点先跑它,由退出码决定这一轮要不要叫醒 agent:

脚本退出码 结果
0 叫醒 agent。脚本的输出会带给它
2 跳过这一轮,不花额度
其他,或 30 秒没跑完 这一轮记为失败,并提醒你

脚本里能读到这几个环境变量:YIHEE_CRON_TASK_ID、YIHEE_CRON_TASK_NAME、YIHEE_CRON_LAST_RUN_AT(上一轮结束的时间,毫秒)。

不会写脚本的话,写一句条件,比如「仓库有新提交时」,点「让 AI 写」。写完点「试跑一次」看它会放行还是跳过。

手动点「现在跑一轮」时,即使检查脚本退出码是 2,这一轮也照样会跑。跳过只对按计划到点的轮次生效。

每一轮发生了什么

  1. 到点。有开跑前检查就先跑检查。
  2. Yihee 把这几样东西发给 agent:这是第几轮、上一轮结果如何、任务记忆的全文、你写的指令。
  3. agent 干活。
  4. 它交一份简报,并把要记住的事写进任务记忆。
  5. Yihee 记下这一轮的结果,排好下一轮。

记忆

每个任务有一份 task-memory.md,每一轮开始前都会读。所以它不会重复上一轮做过的事,也记得你定过的规矩。里面有两部分:

  • Yihee 自动记的:每一轮结束后追加一行结论。
  • agent 自己记的:它觉得下一轮需要知道的事。

你可以在任务的「设置 → 规则 → 记忆」里直接改。比如加一条「周末不要发通知」。

轮次多了,同一条会话会越来越长。到了你设的轮数,或者上下文用到七成,Yihee 会让 agent 把前面的内容压成一份摘要,然后开一条新会话从摘要接着跑。

简报

每一轮结束,agent 交回一组数据,Yihee 把它画成简报。上一轮的数字它记着。

seriescalloutchecksbarsheat还有 table、timeline、radar、flow 等 10 种记录

每日依赖巡检· 第 13 轮

在跑

可升级的依赖

10

上轮 10↓5

高危

1

上轮 1↓1

用时

52s

上轮 52s↓11

高危已修。app 还有 2 个小版本可以升

检查项

  • go.mod高危已修
  • package.json2 个可升级
  • Cargo.toml已是最新
  • 许可证没有变化

各模块落后的依赖

app
server
cli

近 7 轮

app
server
cli

每一轮结束,agent 会交一份简报。最重要的是它自己下的一个结论:

结论 意思 在页面上
无事 一切正常 安静地记一笔
有情况 动了手,或者发现了新东西 标「要注意」,进「要你处理」
没做成 结果不对,或者没跑成 标「失败」,进「要你处理」

这是 agent 的判断,不是程序的退出码。一轮可以顺利跑完,但它发现线上有问题,那就是「有情况」。

简报里除了一句话结论,还可以带图表。一共 15 种,agent 会按这件事的性质选:

类型 用来表示
数值 一个数跨轮次的趋势
核对 一项项检查,通过、警告还是失败
清单 键值对,或者产出列表
变化 这一轮改了什么
经过 按时间发生的事
提示 要你知道或处理的一件事
排行 同一个量在几个对象上的比较
仪表 一个有上限的量:磁盘、额度、进度
构成 一个整体由哪几部分组成
漏斗 一步步筛下来还剩多少
热力 两个维度交叉的密度
评分 一个对象在几个维度上的得分
流向 从哪里流到哪里,各多少
散点 每个对象两个量之间的关系
明细 多列的表格

用哪几种、怎么排,在任务建好时就定下来,之后每一轮都用同一套版式,这样跨轮次才能比较。改了指令会重新定一次。

看结果

点开一个任务有三页:

  • 结果:最近一轮的简报。可以翻到上一轮、下一轮。下面能展开看它是怎么一步步做的。
  • 历史:每一轮一行。最近 100 轮直接看,更早的可以往前翻。
  • 设置:改指令、计划、规则,暂停或恢复。

失败或有情况的那一轮,页面上有一个「知道了」按钮。点了它才算你看过,任务才会从「要你处理」里出去。正常的轮次点开看一眼就算看过。

什么时候会叫你

默认只在出事时叫你:

  • 按计划的一轮没跑成,或者 agent 说有情况,并且 Yihee 窗口不在前台:发一条系统通知。点通知直接打开那个任务。
  • 平淡无事的轮次、你手动跑的、你自己停掉的:不通知。

这个通知可以在「设置 → 通用 → 定时任务有情况时通知」里关掉。

额度用完了怎么办

如果一轮是因为额度用完而失败的,它不会被当成普通失败:

额度用完的一轮:标的是「额度用完」,写明几点补跑
额度用完的一轮:标的是「额度用完」,写明几点补跑
  • 不提醒你,不进「要你处理」。
  • 下一轮直接排到额度恢复的时刻补跑,而不是等原来的计划。
  • 补跑时 agent 会被告知「上一轮跑到一半额度用完了,先接上」。
  • 补跑完,回到原来的计划。

几点恢复,取的是报错里写的时间,或者账号上记的重置时间。如果你有别的账号还有额度,会换过去,一分钟后就补。

Pal 建的任务要你批准

Pal 可以自己建定时任务,但建出来是停着的,标「等你批准」。你在任务的设置里点「批准,按计划运行」之后才会跑。批准前连手动跑一轮都不行。

团队任务

把任务共享给团队后,队友能看到它每一轮的结果。

同一时间只在一个人的电脑上跑。 每一轮开跑前,运行者的电脑要先向团队服务器认领这一轮。认领不到就不跑,所以不会出现两台电脑同时跑同一轮。连不上服务器时这一轮先等着,等了 30 分钟还连不上就记为跳过。

转交。 运行者点「转交」,选一个队友。对方接手前仍由你的电脑运行。对方会看到任务的指令、计划、检查脚本和记忆,确认后点「接手」。交过去的有:指令、计划、检查脚本、限制、任务记忆。不交的有:你的 agent 和账号、你的会话、你电脑上的路径。对方用自己的。

请对方交给我。 你想接一个别人在跑的任务,点「请他交给我」,对方会收到提示。

直接接手。 只有运行者已经离开团队时才行。只要他还在团队里,不管多久没上线,都只能由他转交。

接手后轮次接着往下编号,记忆一起过来,第一轮 agent 会先读记忆接上进度。

电脑关着的时候

定时任务是在你的电脑上跑的,所以:

  • 关窗口不影响。 Yihee 留在菜单栏继续跑。
  • 按 ⌘Q 时,如果有启用中的定时任务,Yihee 不会真的退出,而是收到菜单栏。要彻底退出,点菜单栏图标里的「退出」。
  • 电脑睡着了就不跑。想让它不睡,打开「设置 → 通用 → 有定时任务时保持唤醒」。合上盖子仍然会睡。
  • 错过的轮次:重新打开后,过期的任务只补跑一轮,不管错过了几个周期。补跑的那一轮会标「补跑,原定某时」。
  • 跑到一半时退出了:那一轮记为失败,不会自动重跑。待办里会提示你。

想让任务一直能跑,在「设置 → 通用」里打开「登录时启动」。

从命令行触发

装了命令行后,可以用 yihee task 管理任务。最常用的是从别的脚本里触发一轮,并带一句话给它:

yihee task list
yihee task run <任务 ID> --note "部署刚完成,查一下错误率"

这要求 Yihee 桌面应用正在运行。完整的参数见 命令行。