♻️ 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/services/ai/flow/agent/engine/builders.py

@@ -6,9 +6,7 @@ from typing import Any, cast
 from nonebot.utils import is_coroutine_callable
 
 from zhenxun.services.ai.capabilities import (
-    AbstractCapability,
     CombinedCapability,
-    DynamicCapability,
 )
 from zhenxun.services.ai.context.memory.builder import MemoryBuilder
 from zhenxun.services.ai.context.memory.engine import MemoryReader, MemoryWriter
@@ -22,13 +20,13 @@ from zhenxun.services.ai.flow.agent.capabilities import (
     TaskTrackingCapability,
 )
 from zhenxun.services.ai.flow.agent.models import Persona
-from zhenxun.services.ai.run import GLOBAL_CAPABILITIES, RunContext
+from zhenxun.services.ai.run import RunContext
 from zhenxun.services.ai.run.di import DependencyInjector
 from zhenxun.services.ai.tools.engine.registry import (
     ToolCollection,
     tool_provider_manager,
 )
-from zhenxun.services.ai.tools.models import GlobalToolFilter, ResolvedToolPayload
+from zhenxun.services.ai.tools.models import ResolvedToolPayload
 from zhenxun.services.ai.utils.scope import ScopeSelector
 from zhenxun.utils.pydantic_compat import model_copy
 
@@ -135,22 +133,21 @@ class CapabilityBuilder:
         if task_obj:
             dynamic_caps.append(TaskTrackingCapability(task_obj, agent_name))
 
-        run_level_caps = []
-        if profile_capabilities:
-            for cap in profile_capabilities:
-                if isinstance(cap, AbstractCapability):
-                    run_level_caps.append(cap)
-                elif callable(cap):
-                    run_level_caps.append(DynamicCapability(cap))
+        from zhenxun.services.ai.capabilities.manager import capability_manager
 
-        base_caps = GLOBAL_CAPABILITIES.get("global", []).copy()
-        if namespace != "global" and namespace in GLOBAL_CAPABILITIES:
-            base_caps.extend(GLOBAL_CAPABILITIES[namespace])
+        run_level_caps = capability_manager.resolve_capabilities(
+            profile_capabilities or [], namespace
+        )
+        agent_level_caps = capability_manager.resolve_capabilities(
+            agent_capabilities or [], namespace
+        )
+
+        auto_caps = capability_manager.get_auto_apply_capabilities(namespace)
 
         combined_cap = CombinedCapability(
-            base_caps
+            auto_caps
             + getattr(context, "capabilities", [])
-            + agent_capabilities
+            + agent_level_caps
             + run_level_caps
             + dynamic_caps
         )
@@ -298,7 +295,6 @@ class ToolBuilder:
         toolset_funcs: list[Any],
         system_tools: list[Any],
         namespace: str,
-        tool_filter: GlobalToolFilter | None,
         run_context: RunContext,
         run_scoped_cap: CombinedCapability,
     ) -> ResolvedToolPayload:
@@ -309,9 +305,8 @@ class ToolBuilder:
         参数：
             tool_definitions: 静态工具或工具集合的定义列表。
             toolset_funcs: 待依赖注入解析的工具集生成函数列表。
-            system_tools: 系统默认强制集成的工具定义列表。
+            system_tools: 系统默认强制集成的工具定义列表.
             namespace: 会话命名空间。
-            tool_filter: 全局的工具过滤条件，此处为占位。
             run_context: 运行上下文对象实例.
             run_scoped_cap: 运行域下的合并能力中间件，用于提供特定的能力工具。
 
@@ -411,14 +406,14 @@ class ToolBuilder:
             current_tool_defs = list(_cap_res)
 
         final_defs_map = {d.name.lower(): d for d in current_tool_defs if d}
-        final_effective_tools = ToolCollection()
+        final_effective_tools_list = []
         for t_exec in effective_tools:
             t_name = getattr(t_exec, "name", "unknown")
             if t_name.lower() in final_defs_map:
                 cloned_tool = copy.copy(t_exec)
                 cloned_tool._dynamic_def = final_defs_map[t_name.lower()]
-                final_effective_tools.append(cloned_tool)
-        return final_effective_tools
+                final_effective_tools_list.append(cloned_tool)
+        return ToolCollection(final_effective_tools_list)
 
 
 class SessionBuilder: