参考

日程

日程就是加上了时间的工作流。一条条目列出几个自动化流程、你想要的执行顺序,以及每个流程该跑在哪些环境上——「这三个,每个工作日 9 点」,这正是「日程」标签页存在的理由。

本页内容

日程就是加上了时间的工作流

一条条目列出几个自动化流程、你选定的顺序,以及每个流程该跑在哪些环境上。它是工作流而不是清单:这个标签页存在的意义就是「这三个,每个工作日 9 点」——这是一句同时讲清三件事的话。

新建日程对话框:一个名称、一排色块、一个启用开关,重复方式选的是「某天跑一次」并在下面给出日期和时间,时区留作「这台电脑」,再往下是步骤列表,第一步写明了一条自动化流程和它要跑的那些环境。列表下面是一个「这一步失败就停掉后面的步骤」的复选框,以及一行说明——步骤按顺序来,一次只跑一条。
一条日程、几条自动化流程,顺序由你定。上一步跑完,下一步才开始——采集正是这样把结果行交给随后汇报它们的那一步。

条目里的自动化流程一次只跑一个:上一个跑完,下一个才开始。这正是把它们编成一组、而不是各自单独排期的全部理由——采集可以把自己拿到的行交给负责汇报的那一步,因为在采集完成之前,汇报那一步根本没有开始。

每一步指定一个自动化流程和它该跑在哪些环境上,并各自带着「这一步失败就停掉后面的步骤」的开关。开着它,建立在昨天那批行之上的工作流就不会在没有它们的情况下往下走;对于失败了后面也扛得住的步骤,把它关掉。

单个自动化流程如果只是自己重复,在它自身里设置更简单——在「按日程运行」那里。这些也会出现在日历上,画成虚线的小块,并且在这里只读——拥有它们的是自动化流程本身。自动化流程自带的日程是更小的那件工具,在没有什么需要排先后的时候,它才是对的那一件。

重复、时间窗与时区

一条条目有三种重复方式,对话框提供的正是这三种:

某一天,只跑一次每天每周指定几天

你可以让条目在某一天跑一次、每天跑,或者在你挑的那几个工作日跑。重复会一直进行到你把它停掉,除非你给它一个开始日和一个结束日——「只在下周的工作日跑」就是这么说出来的。

条目可以保留自己的时区,也可以跟着这台电脑走。指定时区的价值不只是照顾出差:时段是按条目自己对时钟的读法认领的,所以身处两个国家的两台机器会对「这是哪个 09:00」达成一致,第二台就会退让。留成「这台电脑」,则各自把 09:00 读成自己的 09:00——当条目属于那张桌子时这正是你要的,当它属于整个工作区时就不是。

它到底什么时候跑

Argus 关着的时候,这里的任何东西都不会触发。启动器关闭期间错过的时间是跳过,而不是补跑:一次定在 03:00 的采集,在你 09:00 打开笔记本时才启动,那是意外,不是服务。这些时段在日历上显示为「已错过」,那是关于这一天的事实,而不是一个错误。

日程页头部的「保持唤醒」会请求 macOS 在启动器运行期间不要因闲置而休眠,整个通宵日历能不能跑得起来全靠它。它只是停掉闲置计时器,仅此而已:屏幕仍然可能息屏,合上盖子照样休眠,你手动让它睡下的机器也会一直睡着。这几件事上,操作系统说了算。

如果两台电脑登录了同一个工作区,只有先抢到某个时段的那台会真正执行。另一台看到认领记录后就让开,所以共享日历不会仅仅因为两个人碰巧都开着应用就跑两遍。

读懂日历

每个日期格里都有它的小块:时间、名称、一个用该日程自身颜色画的圆点,以及一圈说明结果的描边——待运行、运行中、已完成、部分失败、失败或已错过。「部分失败」自成一种结果,因为它确实是另一回事:条目做完了它能做的每一步,并且能告诉你没做成的是哪一步。

待运行运行中已完成部分失败失败已错过
日程标签页把 2026 年 8 月铺成一张月历。工作日的格子里是写着「09:00 周一至周五 流程」的胶囊标签,每个都带一个彩色圆点和一圈状态环;有两天带着第二条和第三条。月历下面一行写道:日程只在启动器开着时触发,它关着的那段时间会被跳过,不会补跑。同一行的右端是一个「保持唤醒」开关。
一个月的日程,每个胶囊标签都带着自己的时间、自己的颜色和最后的结果。月历下面那一行最实在:Argus 关着的时候,什么都不会跑。

虚线小块是按自己的日程触发的自动化流程。把它们画在这里是为了让这一天是完整的;它们在这里只读,理由和它们是虚线的理由一样——拥有它的是自动化流程本身。

点开某一天可以看到每一步的结果。在某一天或某个小块上点右键,不用打开任何东西就能编辑、复制、粘贴或删除——下个月想重复的一周,是一次复制加一次粘贴,而不是五个对话框。

当天的 Telegram

Telegram 关于这些日子告诉你什么——失败时随时通报,还是一天结束后发一份汇总——在「自动化」里的通知机器人那里设置,而任何单独的一天都可以和它设得不一样。一个机器人服务整个工作区,但你绑定的是自己的聊天,所以你的订阅永远不会响在同事的手机上。

通过 API 使用日程

一条日程条目是一串按顺序排列、带有时间的自动化流程——这和自动化流程自带的日程不是一回事,后者只运行它自己。条目只在启动器开着时触发:启动器关闭期间的时间点会被记为错过并跳过,永远不会补跑。Occurrences 记录的是已经跑过什么,而不是将要跑什么。

共 10 个端点,每一个都配有对应的 Agent 工具,所以除了对话框之外,别的东西也能读写这份日历。创建、修改和删除条目需要一把不带文件夹范围的密钥;读取日历及其历史则不需要。

GET/v1/schedule/entriesargus_list_schedule_entriesEvery scheduled workflow in the workspace
POST/v1/schedule/entries/createargus_create_schedule_entry无范围密钥Create a scheduled workflow or AI task
POST/v1/schedule/entries/updateargus_update_schedule_entry无范围密钥Change a scheduled workflow's time, steps, colour or enabled state
POST/v1/schedule/entries/deleteargus_delete_schedule_entry无范围密钥Delete a scheduled workflow
POST/v1/schedule/occurrencesargus_schedule_historyWhat the calendar actually ran over a range of days
GET/v1/schedule/keep-awakeargus_keep_awakeWhether this computer is being held awake for the schedule
POST/v1/schedule/keep-awakeargus_set_keep_awake无范围密钥Hold this computer awake so scheduled runs are not missed
GET/v1/schedule/notificationsargus_schedule_notificationsWhether the signed-in user hears about their scheduled days
POST/v1/schedule/notificationsargus_set_schedule_notifications无范围密钥Turn the schedule's Telegram messages on or off
POST/v1/schedule/dayargus_schedule_dayOne day of the calendar

「保持唤醒」和当天的 Telegram 消息之所以出现在这份清单里,是因为它们是每台机器、每个人各自的设置,而一次运行要靠它们:被要求让今晚的日历跑通的 Agent,可以去核实这台电脑确实被保持唤醒,而不是假定如此。

把一个工作流放到某一天

日历在启动器里,位于「日程」。先把自动化流程搭好——条目只是你给已有流程排定的顺序。