Kavor Schedule：为你的图谱加上时钟

Schedule 是一种可见的活动起因：你决定何时发生、连接一个目标，并让每次尝试都能在 Canvas 中检查。

在 Kavor 领域中，Schedule 是当前可用的 Trigger 来源。它不完成工作，也不判断是否应该行动；它只负责两件事：何时触发以及交付什么 payload。

目标决定 payload 的含义：

连接 CodingAgent 时，payload 是 prompt；
连接 Terminal 时，payload 是 shell 命令。

其余行为属于目标。Workspace、目录、provider 或 shell、Git mode、权限、Guardrails 和图谱上下文都保持不变。

Schedule 发起活动；CodingAgent 使用可达上下文执行工作并解释结果。

值得使用 Schedule 的三种场景

带着上下文唤醒 Maintainer

Schedule 每天向 CodingAgent 交付 prompt。该 agent 可以到达保存维护契约的 Specification、执行检查的 Terminal、提供输入的 File、记录报告的 Sticky Note，以及进行独立评估的 Reviewer。

Schedule 提供起因；图谱提供意图、工具、记忆与协作。

执行可见的运维命令

直接连接 Terminal 的 Schedule 可以交付检查、脚本或维护命令。如果 File 也通过环境变量连接到 Terminal，命令可以使用其规范路径，无需在窗口之间复制值。

sqlite3 app.db < "$CHECK_SQL"

进程仍在真实 Terminal 中运行。Schedule 历史只记录 Kavor 能观察到的交付结果，不会根据 shell 文本臆测成功。

构建小型半自主系统

Schedule — Maintainer — Specification
                      ├─ Terminal
                      ├─ File
                      ├─ Sticky Note
                      └─ Reviewer

这些线表示没有持久方向的 Connections。Schedule 只有一个直接目标：Maintainer。CodingAgent 使用其余可达组件完成 prompt，并为人工决策留下证据。

先配置，再让时钟运行

新的 Schedule 以未来一次性执行且 Paused 的状态开始。你可以先编写 payload、选择周期、连接目标并检查预览，再授权活动。

安全顺序如下：

向 Canvas 添加 Schedule；
编写具体且可验证的 payload；
选择一次执行或周期执行；
检查 Next occurrences 和显示的时区；
直接连接一个 CodingAgent 或 Terminal；
结构准备好后才使用 Resume。

Trigger 在配置期间可以没有目标。运行中的 Schedule 若没有目标 Connection，会将该时刻记录为 Blocked；没有目标时执行 Run now 会在创建尝试前被拒绝。

编写能够结束的 payload

好的 CodingAgent prompt 应说明目标、图谱资源、预期证据和停止条件：

分析最近的 CI 失败。只在 Checks Terminal 中执行相关检查，把有证据的摘要写入 Daily report Sticky Note，并请 Reviewer 独立评估。在记录可能原因前不要修改代码；如果修复需要扩大 Specification 范围就停止。

好的 Terminal 命令应明确、非交互，并产生可观察结果：

pnpm test -- --runInBand

payload 不能替代 Connections。仅在文字中提到 Sticky Note、File 或 Specification 不会授予访问权；该 Node 必须属于 CodingAgent 的可达组件。

不隐藏日历的周期设置

编辑器提供 Once、Hourly、Daily、Weekdays、Weekly、Monthly，以及用于高级 cron 的 Custom。预设和高级编辑器修改同一个表达式，不存在两套会漂移的计划。最小间隔为一分钟。对于 cron 无法正确表达的周期，例如“从某天起每两周一次”，不要使用误导性的近似表达式。

Kavor 保存明确的 IANA 时区，并按显示 Canvas 的机器本地时区展示后续发生时间。时区不能在界面中编辑；保存时由 host 写入。使用 Resume 前始终检查预览。

夏令时重叠的本地时间只触发一次；向前调钟时不存在的时间会移到第一个有效的本地时刻。月度预设会跳过当月不存在的日期，例如 31 日不会在二月执行。