Auto_Bangumi/docs/en/dev/plugins/points/scheduled-task.md

Scheduled Task (scheduled_task)

Adds a periodic background task. @provider(points.SCHEDULED_TASK, id=...) returns a ScheduledTask.

from ab_sdk.tasks import ScheduledTask

@provider(points.SCHEDULED_TASK, id="sync")
def sync(self):
    async def run() -> None:
        ...

    return ScheduledTask(run, interval=lambda: self.config.interval, initial_delay=60)

Field	Description
run	An async function with no parameters
interval	The wait between two runs, in seconds. It can be a function. AB reads it again each round, so it follows configuration changes
initial_delay	The seconds to wait before the first run. Default 0
enabled	An optional function. If it returns False, AB skips that round

• The task runs only while the program runs. It starts and stops together with built-in tasks such as the RSS refresh.
• An exception from run counts toward the plugin breaker.
• The interval starts when the previous run ends. It is not a fixed beat.