Action schedule

schedule 是延迟 plugin action 的基础设施概念。

它负责轮询调度任务，并把到点的 plugin action 重新派发执行。当前用户侧 CLI 里，它不是一个可以 start、stop 或执行业务 action 的独立 plugin。

主要形状

持久化 action job
runtime 轮询与恢复
没有业务 action

它主要解决什么问题

如果你想理解这些问题，应该看 action scheduling：

为什么调度能力归属于 plugin lifecycle，而不是 agent 顶层壳
延迟/定时 plugin action 是怎么被重新调用的
为什么它通过 downcity plugin schedule 管理，而不是单独提供 downcity schedule 命令

用户怎么使用

给 plugin action 命令加 --delay 或 --time，就会创建 scheduled job：

downcity chat send --chat-key <chatKey> --text "Later" --delay 60000
downcity memory remember --content "Remember this later" --time "2026-06-06T09:00:00+08:00"

通过 downcity plugin schedule 查看或取消 scheduled job：

downcity plugin schedule list
downcity plugin schedule info <jobId>
downcity plugin schedule cancel <jobId>

如果要做可复用自动化，用 task plugin，而不是一次性的 scheduled action。

关键语义

它主要轮询 PluginScheduleStore
启动恢复时会把中断的 running jobs 重置回 pending
它是核心基础设施模式，不是普通用户业务型 plugin

公开性说明

action scheduling 属于平台基础设施，不是典型公开 SDK 能力插件。

schedule Plugin