refactor(ActionScheduler): implement Kotlin time-wheel scheduling and requeue scheduled actions after execution

2026-05-12 16:53:04 +08:00 · 2026-02-08 13:24:56 +08:00
parent 3bc2ce839a
commit be43b7eec6
2 changed files with 302 additions and 11 deletions
--- a/Partner-Main/src/main/java/work/slhaf/partner/module/modules/action/dispatcher/executor/ActionExecutor.java
+++ b/Partner-Main/src/main/java/work/slhaf/partner/module/modules/action/dispatcher/executor/ActionExecutor.java
@@ -15,9 +15,11 @@ import work.slhaf.partner.core.action.runner.RunnerClient;
 import work.slhaf.partner.core.cognation.CognationCapability;
 import work.slhaf.partner.core.memory.MemoryCapability;
 import work.slhaf.partner.module.modules.action.dispatcher.executor.entity.*;
+import work.slhaf.partner.module.modules.action.dispatcher.scheduler.ActionScheduler;

 import java.util.ArrayList;
 import java.util.List;
+import java.util.Set;
 import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Phaser;
@@ -41,6 +43,8 @@ public class ActionExecutor extends AgentRunningSubModule<ActionExecutorInput, V
    private ActionRepairer actionRepairer;
    @InjectModule
    private ActionCorrector actionCorrector;
+    @InjectModule
+    private ActionScheduler actionScheduler;

    private ExecutorService virtualExecutor;
    private ExecutorService platformExecutor;
@@ -157,6 +161,7 @@ public class ActionExecutor extends AgentRunningSubModule<ActionExecutorInput, V
                    // 如果是 ScheduledActionData, 则重置 ActionData 内容,记录执行历史与最终结果
                    if (actionData instanceof ScheduledActionData scheduledActionData) {
                        scheduledActionData.recordAndReset();
+                        actionScheduler.execute(Set.of(scheduledActionData));
                    } else {
                        actionData.setStatus(ActionStatus.SUCCESS);
                    }
--- a/Partner-Main/src/main/java/work/slhaf/partner/module/modules/action/dispatcher/scheduler/ActionScheduler.kt
+++ b/Partner-Main/src/main/java/work/slhaf/partner/module/modules/action/dispatcher/scheduler/ActionScheduler.kt
@@ -1,16 +1,302 @@
-package work.slhaf.partner.module.modules.action.dispatcher.scheduler;
+package work.slhaf.partner.module.modules.action.dispatcher.scheduler

-import work.slhaf.partner.api.agent.factory.module.annotation.AgentSubModule;
-import work.slhaf.partner.api.agent.runtime.interaction.flow.abstracts.AgentRunningSubModule;
-import work.slhaf.partner.core.action.entity.ScheduledActionData;
-
-import java.util.List;
+import com.cronutils.model.CronType
+import com.cronutils.model.definition.CronDefinition
+import com.cronutils.model.definition.CronDefinitionBuilder
+import com.cronutils.model.time.ExecutionTime
+import com.cronutils.parser.CronParser
+import kotlinx.coroutines.*
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.first
+import org.slf4j.LoggerFactory
+import work.slhaf.partner.api.agent.factory.capability.annotation.InjectCapability
+import work.slhaf.partner.api.agent.factory.module.annotation.AgentSubModule
+import work.slhaf.partner.api.agent.factory.module.annotation.Init
+import work.slhaf.partner.api.agent.factory.module.annotation.InjectModule
+import work.slhaf.partner.api.agent.runtime.interaction.flow.abstracts.AgentRunningSubModule
+import work.slhaf.partner.core.action.ActionCapability
+import work.slhaf.partner.core.action.entity.ActionData
+import work.slhaf.partner.core.action.entity.ScheduledActionData
+import work.slhaf.partner.module.modules.action.dispatcher.executor.ActionExecutor
+import work.slhaf.partner.module.modules.action.dispatcher.executor.entity.ActionExecutorInput
+import java.time.ZonedDateTime
+import java.time.temporal.ChronoUnit
+import java.util.stream.Collectors
+import kotlin.jvm.optionals.getOrNull

@AgentSubModule
-public class ActionScheduler extends AgentRunningSubModule<List<ScheduledActionData>, Void> {
-    @Override
-    public Void execute(List<ScheduledActionData> data) {
+class ActionScheduler : AgentRunningSubModule<Set<ScheduledActionData>, Void>() {

-        return null;
+    @InjectCapability
+    private lateinit var actionCapability: ActionCapability
+
+    @InjectModule
+    private lateinit var actionExecutor: ActionExecutor
+
+    private lateinit var timeWheel: TimeWheel
+
+    companion object {
+        private val log = LoggerFactory.getLogger(ActionScheduler::class.java)
    }
-}
+
+    @Init
+    fun init() {
+        val actions = actionCapability.listActions(null, null)
+            .stream()
+            .filter { actionData -> actionData is ScheduledActionData }
+            .map { actionData -> actionData as ScheduledActionData }
+            .collect(Collectors.toSet())
+        timeWheel = TimeWheel(actions) { actionDataSet ->
+            val input = ActionExecutorInput.builder()
+                .actions(actionDataSet)
+                .build()
+            actionExecutor.execute(input)
+        }
+    }
+
+    override fun execute(scheduledActionDataSet: Set<ScheduledActionData>?): Void? {
+        scheduledActionDataSet?.run {
+            for (scheduledActionData in scheduledActionDataSet) {
+                actionCapability.putAction(scheduledActionData)
+                timeWheel.schedule(scheduledActionData)
+            }
+        }
+        return null
+    }
+
+    private class TimeWheel(
+        val primaryActions: Set<ScheduledActionData>,
+        val onTrigger: (Set<ScheduledActionData>) -> Unit
+    ) {
+
+        private val actionsGroupByHour = Array<MutableSet<ScheduledActionData>>(24) { mutableSetOf() }
+        private val wheel = Array<MutableSet<ScheduledActionData>>(60 * 60) { mutableSetOf() }
+        private var currentHour: Int = 0
+        private val state = MutableStateFlow(WheelState.SLEEPING)
+
+        private val cronDefinition: CronDefinition = CronDefinitionBuilder.instanceDefinitionFor(CronType.QUARTZ)
+        private val cronParser: CronParser = CronParser(cronDefinition)
+
+        /**
+         * 根据 primaryActions 建立时间轮，并只加载当天任务，同时启动 tick 线程
+         */
+        init {
+            // 加载 primaryActions 进 actionsGroupByHour
+            loadDayActions()
+            // 依据当前时间移动至合适的 hour 并启动时间轮
+            launchWheel()
+        }
+
+        fun schedule(actionData: ScheduledActionData) {
+            if (actionData.status != ActionData.ActionStatus.PREPARE) {
+                return
+            }
+
+            val parseToZonedDateTime = parseToZonedDateTime(
+                actionData.type,
+                actionData.scheduleContent,
+                ZonedDateTime.now()
+            ) ?: run {
+                logFailedStatus(actionData)
+                return
+            }
+
+            val hour = parseToZonedDateTime.hour
+            actionsGroupByHour[hour].add(actionData)
+            if (currentHour == hour) {
+                state.value = WheelState.ACTIVE
+            }
+        }
+
+        private fun launchWheel() {
+            val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default + CoroutineName("TimeWheel"))
+            fun tickOnTrigger(tick: Int, previousTick: Int) {
+                if (tick > previousTick) {
+                    val toTrigger = linkedSetOf<ScheduledActionData>()
+                    for (i in (previousTick + 1)..tick) {
+                        val bucket = wheel[i]
+                        if (bucket.isNotEmpty()) {
+                            toTrigger.addAll(bucket)
+                            actionsGroupByHour[currentHour].removeAll(bucket)
+                            bucket.clear() // 避免重复触发
+                        }
+                    }
+
+                    if (toTrigger.isNotEmpty()) {
+                        onTrigger(toTrigger)
+                    }
+                }
+            }
+
+            scope.launch {
+                while (isActive) {
+                    // 判断是否该步入下一小时
+                    val actionsLoadingTime = loadHourActions()
+                    currentHour = actionsLoadingTime.hour
+
+                    // 如果该时无任务则等待，插入事件可提前唤醒
+                    if (actionsGroupByHour[currentHour].isEmpty()) {
+                        // 计算距离下一小时的时间，等待
+                        val seconds = java.time.Duration.between(
+                            actionsLoadingTime, actionsLoadingTime.truncatedTo(ChronoUnit.HOURS).plusHours(1)
+                        ).toMillis()
+                        withTimeout(seconds) {
+                            state.first { it == WheelState.ACTIVE }
+                        }
+                        state.value = WheelState.SLEEPING
+                        continue
+                    }
+
+                    // 唤醒进行时间轮循环
+                    // 计算当前距离时内下次任务的剩余时间, 秒级推进
+                    val now = ZonedDateTime.now()
+                    var tick = now.minute * 60 + now.second
+                    var lastTickAdvanceTime = System.nanoTime()
+                    while (isActive) {
+                        // tick 推进（nano -> second）
+                        val current = System.nanoTime()
+                        val step = ((current - lastTickAdvanceTime) / 1_000_000_000L).toInt()
+                        if (step <= 0) {
+                            delay(50) // 避免空转
+                            continue
+                        }
+
+                        val previousTick = tick
+                        tick = (tick + step).coerceAtMost(wheel.lastIndex)
+                        lastTickAdvanceTime = current
+
+                        // 取当前 tick、推进过程中经过的 tick 对应任务，异步启动
+                        tickOnTrigger(tick, previousTick)
+
+                        // 推进到顶时停止循环、当前时无任务时停止循环
+                        if (tick >= wheel.lastIndex || actionsGroupByHour[currentHour].isEmpty()) {
+                            break
+                        }
+
+                        // 休眠一秒
+                        delay(1000)
+                    }
+                }
+
+            }
+        }
+
+        private fun loadHourActions(): ZonedDateTime {
+            val load: (ZonedDateTime, ScheduledActionData) -> Unit = { latestExecutionTime, actionData ->
+                val secondsTime = latestExecutionTime.minute * 60 + latestExecutionTime.second - 1
+                wheel[secondsTime].add(actionData)
+            }
+
+            val invalid: (ZonedDateTime, ZonedDateTime) -> Boolean = { before, after ->
+                before.hour != after.hour
+            }
+
+            val repair: () -> Unit = {
+                for (set in wheel) {
+                    set.clear()
+                }
+            }
+
+            return loadActions(load, invalid, repair)
+        }
+
+        private fun loadDayActions() {
+            val load: (ZonedDateTime, ScheduledActionData) -> Unit = { latestExecutingTime, actionData ->
+                actionsGroupByHour[latestExecutingTime.hour].add(actionData)
+            }
+
+            val invalid: (ZonedDateTime, ZonedDateTime) -> Boolean = { before, after ->
+                before.dayOfYear != after.dayOfYear
+            }
+
+            val repair: () -> Unit = {
+                for (set in actionsGroupByHour) {
+                    set.clear()
+                }
+            }
+
+            loadActions(load, invalid, repair)
+
+        }
+
+        private fun loadActions(
+            load: (latestExecutingTime: ZonedDateTime, actionData: ScheduledActionData) -> Unit,
+            invalid: (before: ZonedDateTime, after: ZonedDateTime) -> Boolean,
+            repair: () -> Unit
+        ): ZonedDateTime {
+            val runLoading = {
+                val now = ZonedDateTime.now()
+                for (actionData in primaryActions) {
+                    val latestExecutingTime =
+                        parseToZonedDateTime(
+                            actionData.type,
+                            actionData.scheduleContent,
+                            now
+                        ) ?: run {
+                            logFailedStatus(actionData)
+                            continue
+                        }
+
+                    load(latestExecutingTime, actionData)
+                }
+            }
+
+            val before = ZonedDateTime.now()
+            runLoading()
+            val after = ZonedDateTime.now()
+            if (invalid(before, after)) {
+                repair()
+                runLoading()
+            }
+            return after
+
+        }
+
+        private fun parseToZonedDateTime(
+            scheduleType: ScheduledActionData.ScheduledType,
+            scheduleContent: String,
+            now: ZonedDateTime
+        ): ZonedDateTime? {
+            return when (scheduleType) {
+                ScheduledActionData.ScheduledType.CYCLE -> {
+                    val cron = try {
+                        cronParser.parse(scheduleContent).validate()
+                    } catch (_: Exception) {
+                        return null
+                    }
+                    val executionTime = ExecutionTime.forCron(cron)
+                    executionTime.nextExecution(now).getOrNull()
+                }
+
+                ScheduledActionData.ScheduledType.ONCE -> {
+                    val executionTime = try {
+                        ZonedDateTime.parse(scheduleContent)
+                    } catch (_: Exception) {
+                        return null
+                    }
+                    if (executionTime.isBefore(now) || executionTime.dayOfYear != now.dayOfYear)
+                        null
+                    else
+                        executionTime
+                }
+
+            }
+
+        }
+
+        private fun logFailedStatus(actionData: ScheduledActionData) {
+            log.warn(
+                "行动未加载，uuid: {}, source: {}, tendency: {}, scheduleContent: {}",
+                actionData.uuid,
+                actionData.source,
+                actionData.tendency,
+                actionData.scheduleContent,
+            )
+        }
+
+        private enum class WheelState {
+            ACTIVE,
+            SLEEPING,
+        }
+    }
+}