♻️ refactor(core): 重构 AI 能力与定时任务调度系统 (#2148)

* ♻️ refactor(core): 重构 AI 能力与定时任务调度系统

- 【AI 能力与工具】重构 Capability 注册与管理机制，引入 CapabilityManager 统一管理
- 移除全局能力注册表，改用声明式装饰器 `@capability` 进行解耦注册
- 重构工具解析器链，使用统一的 BaseToolResolver 代替原有的多个特定解析器
- 增强工具查询过滤，支持通配符匹配、工具箱过滤和排除标签
- 【定时任务调度】重构定时任务管理器，引入 SchedulerRegistry 统一管理任务元数据
- 引入 JobConfig 聚合定时任务配置，支持用户维度的定时任务调度
- 重构执行分发器，支持并发限制、串行间隔和随机延迟打散
- 【运行上下文】引入 ScheduledDeps 以支持后台和定时任务环境下的依赖注入
- 优化 RunContext，支持从定时任务上下文快速构造，并提供 emit 辅助方法
- 【日志与监控】引入 AILoggerProxy，实现 AI 各模块的专属日志输出
- 将各模块的全局 logger 替换为对应的模块专属日志代理
- 【其他优化】修复 Pydantic V1 兼容层中 model_validator 的装饰器兼容性问题
- 在非交互式环境（如定时任务）中自动隐藏 HITL 交互工具以节省 Token

* ♻️ refactor(core): 优化内部导入路径并提升 Pydantic 兼容性

- 【重构】将 `services/ai` 模块内的绝对导入重构为相对导入，优化包结构
- 【重构】移除不必要的 `if TYPE_CHECKING` 保护，通过 `from __future__ import annotations` 直接导入类型
- 【清理】清理 `core/messages/types.py` 中未使用的 `AssistantContentUnion` 等联合类型定义
- 【优化】在 `utils/pydantic_compat.py` 中新增 `model_rebuild` 兼容函数，统一 Pydantic V1/V2 的模型重建逻辑
- 【优化】将部分函数内部的延迟导入提升至模块顶部，规范代码结构

* ♻️ refactor(imports): 优化导入路径为相对导入并清理冗余导入

- 【重构】将 AI 服务相关模块中的绝对导入路径修改为相对导入，提升模块内聚性与可移植性
- 【清理】移除多处函数内部或类方法中未使用的冗余导入，避免循环引用和资源浪费
- 【格式化】微调部分工具装饰器和返回语句的格式与尾随逗号

* 🚨 auto fix by pre-commit hooks

---------

Co-authored-by: webjoin111 <455457521@qq.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

zhenxun/builtin_plugins/scheduler_admin/data_source.py

@@ -6,7 +6,14 @@ from zhenxun.models.level_user import LevelUser
 from zhenxun.models.scheduled_job import ScheduledJob
 from zhenxun.services import scheduler_manager
 from zhenxun.services.log import logger
+from zhenxun.services.scheduler.registry import scheduler_registry
 from zhenxun.services.scheduler.repository import ScheduleRepository
+from zhenxun.services.scheduler.types import (
+    BaseTrigger,
+    ExecutionOptions,
+    JobConfig,
+    TargetType,
+)
 from zhenxun.utils.pydantic_compat import model_dump, model_validate
 
 from . import presenters
@@ -58,7 +65,7 @@ class SchedulerAdminService:
         targets: list[str],
         creator_permission_level: int,
         plugin_name: str,
-        trigger_info: tuple[str, dict],
+        trigger: BaseTrigger,
         job_kwargs: dict,
         permission: int,
         bot_id: str,
@@ -69,7 +76,6 @@ class SchedulerAdminService:
         created_by: str,
     ) -> str:
         """创建或更新一个定时任务"""
-        trigger_type, trigger_config = trigger_info
         success_targets = []
         failed_targets = []
         permission_denied_targets = []
@@ -103,7 +109,7 @@ class SchedulerAdminService:
                 )
                 continue
 
-            if target_type in ["TAG", "ALL_GROUPS"]:
+            if target_type in [TargetType.TAG.value, TargetType.ALL_GROUPS.value]:
                 logger.debug(
                     f"检测到多目标任务 (类型: {target_type})，"
                     f"将所需权限强制提升至超级用户级别。"
@@ -111,18 +117,26 @@ class SchedulerAdminService:
                 permission = 9
 
             try:
+                exec_opts = (
+                    model_validate(ExecutionOptions, execution_options)
+                    if execution_options
+                    else model_validate(ExecutionOptions, {})
+                )
+
+                config = JobConfig(
+                    trigger=trigger,
+                    job_kwargs=job_kwargs,
+                    bot_id=bot_id,
+                    name=job_name,
+                    created_by=created_by,
+                    required_permission=permission,
+                    execution_options=exec_opts,
+                )
                 schedule = await scheduler_manager.add_schedule(
                     plugin_name=plugin_name,
                     target_type=target_type,
                     target_identifier=target_id,
-                    trigger_type=trigger_type,
-                    trigger_config=trigger_config,
-                    job_kwargs=job_kwargs,
-                    bot_id=bot_id,
-                    required_permission=permission,
-                    name=job_name,
-                    created_by=created_by,
-                    execution_options=execution_options if execution_options else None,
+                    config=config,
                 )
                 if schedule:
                     success_targets.append((target_desc, schedule.id))
@@ -150,7 +164,10 @@ class SchedulerAdminService:
             permission_denied = False
             if all_flag or global_flag:
                 permission_denied = True
-            elif targeter._filters.get("target_type") in ["TAG", "ALL_GROUPS"]:
+            elif targeter._filters.get("target_type") in [
+                TargetType.TAG.value,
+                TargetType.ALL_GROUPS.value,
+            ]:
                 permission_denied = True
 
             if permission_denied:
@@ -202,11 +219,16 @@ class SchedulerAdminService:
         )
 
     async def update_schedule(
-        self, schedule: ScheduledJob, trigger_info: tuple | None, kwargs_str: str | None
+        self,
+        schedule: ScheduledJob,
+        trigger: BaseTrigger | None,
+        kwargs_str: str | None,
     ) -> str:
         """更新一个任务的配置"""
-        trigger_type = trigger_info[0] if trigger_info else None
-        trigger_config = trigger_info[1] if trigger_info else None
+        trigger_type = trigger.trigger_type if trigger else None
+        trigger_config = (
+            model_dump(trigger, exclude={"trigger_type"}) if trigger else None
+        )
         job_kwargs = await self._parse_and_validate_kwargs_for_update(
             schedule.plugin_name, kwargs_str
         )
@@ -243,7 +265,7 @@ class SchedulerAdminService:
 
     def _generate_view_title(self, filters: dict) -> str:
         title = "定时任务"
-        if filters.get("target_type") == "ALL_GROUPS":
+        if filters.get("target_type") == TargetType.ALL_GROUPS.value:
             title = "全局定时任务"
         elif "target_identifier" in filters:
             title = f"群 {filters['target_identifier']} 的定时任务"
@@ -253,12 +275,12 @@ class SchedulerAdminService:
 
     def _resolve_target_descriptor(self, target_desc: str) -> tuple[str, str]:
         if target_desc == scheduler_manager.ALL_GROUPS:
-            return "ALL_GROUPS", scheduler_manager.ALL_GROUPS
+            return TargetType.ALL_GROUPS.value, scheduler_manager.ALL_GROUPS
         if target_desc.startswith("tag:"):
-            return "TAG", target_desc[4:]
+            return TargetType.TAG.value, target_desc[4:]
         if target_desc.isdigit():
-            return "GROUP", target_desc
-        return "USER", target_desc
+            return TargetType.GROUP.value, target_desc
+        return TargetType.USER.value, target_desc
 
     def _format_set_result_message(
         self, targets: list, success: list, failed: list, permission_denied: list
@@ -286,7 +308,7 @@ class SchedulerAdminService:
         if not kwargs_str:
             return {}
 
-        task_meta = scheduler_manager._registered_tasks.get(plugin_name)
+        task_meta = scheduler_registry.tasks.get(plugin_name)
         if not task_meta:
             raise ValueError(f"插件 '{plugin_name}' 未注册。")