mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-16 15:12:00 +00:00
3f1eeff841
做了什么:
- 新建定时任务(目标是工作流时)先选怎么触发:定时 / 事件触发(TriggerEditor 的 TriggerModePicker);修改时只读地写出触发方式、
说明建好之后不能改。选了事件触发,频率那一节换成事件(EventSection):三种事件、对象下拉(能选哪些、不能选的原因由新接口
GET /api/schedules/trigger-options 给,界面照着画、选不了的置灰并写原因)、上传表格的期次(只认新增的一期)、上游工作流的
只认应用 / 只认来源和触发链上限的说明、去抖、时区;换事件种类时对象和过滤清掉。
- 预览按一次事件渲染输入(对象最近一次的事件,没有时照实说是示例值),不列触发时间;变量按事件种类取(api.schedules.eventVariables),
插得进 {{ event.* }};请求体带 trigger_kind、trigger,cron 交空串;修改时只交改了的触发条件。model.ts 加 TriggerForm 与
triggerBody / switchEvent,表单问题里事件触发不查频率、要求选对象;服务端 422 指 trigger 时落到事件那一节。
- 列表、详情:「事件触发」标签,频率处写触发说明;下次运行写在等什么(去抖中收到几次、何时合成一次触发;有事件等待派发;调度
没开时照实说不会派发)。触发历史:类型「事件」,写「由事件触发:…」、合并了几次、第几层;立即运行按最近一次事件发起的写
「按事件:…」并标示例值。运行详情页头写「由事件触发:…(定时任务「X」)」(RunDetailView 只多传一个 trigger 属性),立即运行
按事件发起的写「立即运行定时任务「X」,按事件:…」,不说成由事件触发;应用页印章同样不算。
- 文案进 lib/termsTrigger.ts;SCHEDULE_TEXT 只补触发类型「事件」和「还需处理」里的「触发事件」。立即运行按示例事件的说法
不再在服务端加「(示例值)」后缀,是不是示例值看 real。
为什么:总方案 §4 要求定时页能建事件触发的任务、列表 / 详情 / 触发历史 / 记录页照实显示;能不能选、为什么由服务端判,界面不放逻辑。
验证:tsc、check-copy;check-schedules 加纯函数一段(表单 ⇄ 请求体)和三段页面(新建的请求体、列表 / 详情 / 触发历史、运行详情
页头,含 390px 浅色),假接口加了触发选项、事件预览、事件变量、事件触发任务的夹具,写请求断言请求体;原有各段照过;check-runs 照过。
54 lines
2.5 KiB
Python
54 lines
2.5 KiB
Python
"""定时任务的后台调度:到点按定时任务的设置发起工作流运行,结束、失败、停在审批时推送 Webhook。
|
||
|
||
- cron.py:五字段 cron 的解析、下次触发、中文描述
|
||
- service.py:输入模板、和工作流入口字段的对照、发起一次触发(调度循环和「立即运行」共用)
|
||
- loop.py:调度循环,条件 UPDATE 认领到点的任务
|
||
- webhook.py:通知推送(通用 / 飞书 / 企业微信 / 钉钉)
|
||
- auto_compare.py:运行成功结束后和同一定时任务上一次成功的运行自动对比,结果记在触发记录上,通知里只带计数摘要和
|
||
对比页链接
|
||
- triggers.py、outbox.py:数据事件触发(trigger_kind=event,docs/design/orchestration-round/00-总方案.md §4)——触发条件的
|
||
规则和说法、防环;待派发事件的写入(发生处)与每一拍的派发、去抖
|
||
|
||
服务启动时(main.py 的 lifespan)只在 scheduler_enabled() 时调 start,关闭时总是调 stop——stop 要能在没 start
|
||
过时安全返回。start 自己也看一次开关:拷来的数据目录(检查脚本的 --stacks、验收副本)不管从哪条路径起服务,
|
||
都不会替原库把定时任务再执行一遍。
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
import logging
|
||
|
||
from app.core.config import Settings, settings
|
||
|
||
logger = logging.getLogger(__name__)
|
||
|
||
|
||
def scheduler_enabled(config: Settings | None = None) -> bool:
|
||
"""调度循环开不开:AGENTLAB_SCHEDULER,默认开,0 / false / off 关(见 core/config.py)。
|
||
|
||
config 只给测试用:settings 是模块级单例,改环境变量不会让它重读。"""
|
||
return bool((config or settings).scheduler)
|
||
|
||
|
||
async def start(*, interval: float | None = None, config: Settings | None = None) -> bool:
|
||
"""起调度循环,返回起没起。开关关着时什么都不做;已经在跑时不起第二个。interval 只给测试用。"""
|
||
if not scheduler_enabled(config):
|
||
logger.info("定时任务调度已关闭(AGENTLAB_SCHEDULER),不会自动发起运行")
|
||
return False
|
||
from app.scheduler.loop import TICK_SECONDS, runner
|
||
|
||
await runner.start(interval if interval is not None else TICK_SECONDS)
|
||
return True
|
||
|
||
|
||
async def stop() -> None:
|
||
"""停调度循环,等手上的那一轮收尾。没 start 过也能安全调用。"""
|
||
from app.scheduler.loop import runner
|
||
|
||
await runner.stop()
|
||
|
||
|
||
def running() -> bool:
|
||
from app.scheduler.loop import runner
|
||
|
||
return runner.running()
|