触发器

触发器模板定义“什么事件发生时，把什么提示词发送到哪个 AI 会话”。模板创建后必须部署到会话才会执行。

来源类型

计划

支持固定间隔、每天指定时间和每周指定日期。墙上时间计划必须选择时区，避免服务器时区变化导致误执行。

文件变更

配置一个或多个根目录、glob、忽略规则和防抖时间。监视范围应尽量小，排除构建产物、依赖目录和高频日志。

AI 会话

可以按 Agent、会话状态或执行阶段触发，例如 Codex/OpenCode 进入失败、空闲、工具执行或等待批准。留空条件表示匹配任意值。

运行策略

• 冷却时间：抑制短时间内的重复事件；
• 繁忙时跳过：不允许任务重叠，适合状态刷新；
• 繁忙时排队：每次运行都需保留，适合审计或批处理；
• 最大并发数：限制资源占用，初始建议设为 1。

部署和运行

创建模板后选择“部署到会话”。同一个模板可以有多个部署，每个部署在目标会话所属实例中运行。可以手动运行以验证提示词、权限和工作目录。

解除部署只停止该位置继续触发，不删除模板。删除模板会同时删除 Control Plane 管理的部署且无法撤销。

监控

触发器库显示模板、部署、运行中和错误数量。最近活动区分手动、计划、文件变更和 AI 会话事件，并显示完成、失败或跳过。

与 Story 自动化的区别

Story 自动化以预设动作为中心，适合固定业务流程和计划任务；触发器以事件源和现有会话为中心，适合文件或会话状态驱动。不要为同一任务同时配置两套计划，避免重复运行。