mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-15 14:22:55 +08:00
fcb385cf01
**架构重构** - 拆分为 Service、Repository、Adapter 三层架构，提升模块化 - 统一 APScheduler Job ID 生成方式，优化 ScheduleTargeter 逻辑 **新增功能** - 支持定时任务时区配置 - 新增"运行中"任务状态显示 - 为"所有群组"任务增加随机延迟，分散并发压力 **用户体验优化** - 重构操作反馈消息，提供详细的成功提示卡片 - 优化任务查看命令的筛选逻辑 - 统一删除、暂停、恢复、执行、更新操作的响应格式 Co-authored-by: webjoin111 <455457521@qq.com>
86 lines
3.2 KiB
Python
86 lines
3.2 KiB
Python
from nonebot.plugin import PluginMetadata
|
|
|
|
from zhenxun.configs.utils import PluginExtraData, RegisterConfig
|
|
from zhenxun.utils.enum import PluginType
|
|
|
|
from . import commands, handlers
|
|
|
|
__all__ = ["commands", "handlers"]
|
|
|
|
__plugin_meta__ = PluginMetadata(
|
|
name="定时任务管理",
|
|
description="查看和管理由 SchedulerManager 控制的定时任务。",
|
|
usage="""
|
|
📋 定时任务管理 - 支持群聊和私聊操作
|
|
|
|
🔍 查看任务:
|
|
定时任务 查看 [-all] [-g <群号>] [-p <插件>] [--page <页码>]
|
|
• 群聊中: 查看本群任务
|
|
• 私聊中: 必须使用 -g <群号> 或 -all 选项 (SUPERUSER)
|
|
|
|
📊 任务状态:
|
|
定时任务 状态 <任务ID> 或 任务状态 <任务ID>
|
|
• 查看单个任务的详细信息和状态
|
|
|
|
⚙️ 任务管理 (SUPERUSER):
|
|
定时任务 设置 <插件> [时间选项] [-g <群号> | -g all] [--kwargs <参数>]
|
|
定时任务 删除 <任务ID> | -p <插件> [-g <群号>] | -all
|
|
定时任务 暂停 <任务ID> | -p <插件> [-g <群号>] | -all
|
|
定时任务 恢复 <任务ID> | -p <插件> [-g <群号>] | -all
|
|
定时任务 执行 <任务ID>
|
|
定时任务 更新 <任务ID> [时间选项] [--kwargs <参数>]
|
|
# [修改] 增加说明
|
|
• 说明: -p 选项可单独使用，用于操作指定插件的所有任务
|
|
|
|
📝 时间选项 (三选一):
|
|
--cron "<分> <时> <日> <月> <周>" # 例: --cron "0 8 * * *"
|
|
--interval <时间间隔> # 例: --interval 30m, 2h, 10s
|
|
--date "<YYYY-MM-DD HH:MM:SS>" # 例: --date "2024-01-01 08:00:00"
|
|
--daily "<HH:MM>" # 例: --daily "08:30"
|
|
|
|
📚 其他功能:
|
|
定时任务 插件列表 # 查看所有可设置定时任务的插件 (SUPERUSER)
|
|
|
|
🏷️ 别名支持:
|
|
查看: ls, list | 设置: add, 开启 | 删除: del, rm, remove, 关闭, 取消
|
|
暂停: pause | 恢复: resume | 执行: trigger, run | 状态: status, info
|
|
更新: update, modify, 修改 | 插件列表: plugins
|
|
""".strip(),
|
|
extra=PluginExtraData(
|
|
author="HibiKier",
|
|
version="0.1.2",
|
|
plugin_type=PluginType.SUPERUSER,
|
|
is_show=False,
|
|
configs=[
|
|
RegisterConfig(
|
|
module="SchedulerManager",
|
|
key="ALL_GROUPS_CONCURRENCY_LIMIT",
|
|
value=5,
|
|
help="“所有群组”类型定时任务的并发执行数量限制",
|
|
type=int,
|
|
),
|
|
RegisterConfig(
|
|
module="SchedulerManager",
|
|
key="JOB_MAX_RETRIES",
|
|
value=2,
|
|
help="定时任务执行失败时的最大重试次数",
|
|
type=int,
|
|
),
|
|
RegisterConfig(
|
|
module="SchedulerManager",
|
|
key="JOB_RETRY_DELAY",
|
|
value=10,
|
|
help="定时任务执行重试的间隔时间（秒）",
|
|
type=int,
|
|
),
|
|
RegisterConfig(
|
|
module="SchedulerManager",
|
|
key="SCHEDULER_TIMEZONE",
|
|
value="Asia/Shanghai",
|
|
help="定时任务使用的时区，默认为 Asia/Shanghai",
|
|
type=str,
|
|
),
|
|
],
|
|
).to_dict(),
|
|
)
|