源文件 按 main 分支生成 · 最新发布 v0.4.0

日程

Bot 可以按设定的时间自己开工:每天,或每周选定的几天。日程在哪看、怎么改,以及它按什么规则执行。

每日与每周日程

Bot 可以按设定的时间自己开工:每天,或每周选定的几天。这一页讲日程在哪里看、怎么改,以及它按什么规则执行。

回看不是日程。它是 Bot 在一条会话里给自己约的一次性叫醒(check_back 工具),一分钟到七天后,用来回头核对交出去或正在等的活。只响一次,落在同一会话、同一件事里,叫醒它的那一行只有它自己读得到(会话里不显示),不进日程图;约它的那一轮被 Stop、会话清空或删除、Bot 删除都会作废。应用也会替 Bot 约一次:它开的 Bot↔Bot 私聊静下来约 10 秒后,就在开这条私聊的那个会话立刻叫醒它,交代私聊的结果;私聊里没有新的话就不再叫,从这种回看开出去、对方一句没回的私聊也不再叫回。

桌面上,侧栏底部的工具再点日程打开日程图(桌面「视图」菜单里也还有;已经开着的日程图会定位到已有标签)。手机上仍在搜索旁边的工具菜单里,仍叫日程图,打开日程图那一页:有日程的 Bot,其每天和每周日程铺在同一张周视图里,只读。没有日程的 Bot 不出现。名册筛选是一枚可搜索的下拉,按名字或职责找,点一行隐藏或显示这个 Bot 的格子。议程里每一行也标出这个 Bot 的头像和名字。格子是规则展开,不是每次运行的记录;钟点按执行 Mac 的本地时间标出。改时间仍在 Bot 资料里做,手机上不能拖。

打开 Bot 资料(Bot 头像/名字 → 资料),在 日程 → 新建日程 中填写标题、任务指令,选择每天或每周(至少一天),再选时间。日程归当前 Bot。宽屏上,日程条数在「日程」标签上,日程直接列在页面里:每行右边是启停开关和删除按钮,点一行,编辑表单就展开在它下面;列表末尾的「新建日程」在同一处打开新建表单。手机上,日程条数和「新建日程」在日程页的顶栏里;点一条日程会打开整页,进入时不自动聚焦输入框:时间用系统时间选择,星期是一排可点的日子,启用是开关;暂停和删除不跟列表挤在一行里,删除在这一页底部,返回先回到日程列表。侧栏搜索日程会打开所属 Bot 的资料和对应编辑页。后来的搜索或关闭操作会取消较早的待完成跳转;所属 Bot 已删除的历史日程仍保留,但在搜索中标为不可用。确认框限制键盘焦点,取消后归还触发控件,保存中不能关闭。

时间按运行 Deskfolk 的那台电脑的本地时区解释,不按浏览器时区换算;没有单条日程时区或 cron 表达式。那台电脑需醒着且运行时可用;恢复后只补最近一次,不逐次补跑;从睡眠醒来后先等一分钟左右再补,Mac 合盖时系统自己醒几秒不算醒着;归档 Bot 不执行日程。你的叫停覆盖着这个 Bot、它和你的私聊或这条日程自己的规划时,到点不执行,也不算已执行;叫停解除后按最近一次补跑一回,和其他补跑一样。删除或暂停不会停止已经开始的任务。列表通过事件跨客户端实时更新,重连后刷新;另一客户端修改了正在编辑的日程时,先载入最新版本再保存,旧版本保存和删除会被拒绝,不会静默覆盖。连接中断不会自动重试写入,请重连后核对列表。请求结果未知时,可在日程页点击重试原请求,仅重发原内容和请求编号,不发送后来修改的草稿;待确认载荷提示不是版本冲突。原请求结束待确认后,修改的草稿仍保留显示,但需先核对列表并重新打开日程,才能继续提交。

每次到点,这条日程在它的常驻规划下开一张任务(NN-<日期>),那一次就在这张任务的目录里做(你和这个 Bot 的私聊用不跑事的引擎时例外:那一次是无事的一轮,不开规划和任务,文件落在工作区根,见 ADR 0103)。引擎 5 级起,这一次交出来的东西检查都过就直接放行,不出卡片等你放行或退回:日程本来就是无人值守地跑。结果不对时,在和这个 Bot 的私聊里说一句,照样会问你要不要转回返工。流程图上加的检查只绑得住某一天的那张任务,绑不住以后每天新开的。