mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2026-09-29 00:32:06 +08:00
922d092650
* ♻️ 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>
337 lines
12 KiB
Python
337 lines
12 KiB
Python
from typing import Any
|
||
|
||
from pydantic import BaseModel, ValidationError
|
||
|
||
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
|
||
|
||
|
||
class SchedulerAdminService:
|
||
"""封装定时任务管理的所有业务逻辑"""
|
||
|
||
async def get_schedules_view(
|
||
self,
|
||
user_id: str,
|
||
group_id: str | None,
|
||
is_superuser: bool,
|
||
filters: dict[str, Any],
|
||
page: int,
|
||
) -> bytes | str:
|
||
"""获取任务列表视图"""
|
||
page_size = 30
|
||
schedules, total_items = await scheduler_manager.get_schedules(
|
||
page=page, page_size=page_size, **filters
|
||
)
|
||
|
||
if not schedules:
|
||
return "没有找到任何相关的定时任务。"
|
||
|
||
permitted_schedules = schedules
|
||
skipped_count = 0
|
||
if not is_superuser:
|
||
permitted_schedules, skipped_count = await self._filter_schedules_for_user(
|
||
schedules, user_id, group_id
|
||
)
|
||
|
||
if not permitted_schedules:
|
||
return (
|
||
f"您没有权限查看任何匹配的任务。（因权限不足跳过 {skipped_count} 个）"
|
||
)
|
||
|
||
title = self._generate_view_title(filters)
|
||
|
||
return await presenters.format_schedule_list_as_image(
|
||
schedules=permitted_schedules,
|
||
title=title,
|
||
current_page=page,
|
||
total_items=total_items,
|
||
)
|
||
|
||
async def set_schedule(
|
||
self,
|
||
targets: list[str],
|
||
creator_permission_level: int,
|
||
plugin_name: str,
|
||
trigger: BaseTrigger,
|
||
job_kwargs: dict,
|
||
permission: int,
|
||
bot_id: str,
|
||
job_name: str | None,
|
||
jitter: int | None,
|
||
spread: int | None,
|
||
interval: int | None,
|
||
created_by: str,
|
||
) -> str:
|
||
"""创建或更新一个定时任务"""
|
||
success_targets = []
|
||
failed_targets = []
|
||
permission_denied_targets = []
|
||
execution_options = {}
|
||
if jitter is not None:
|
||
execution_options["jitter"] = jitter
|
||
if spread is not None:
|
||
execution_options["spread"] = spread
|
||
if interval is not None:
|
||
execution_options["interval"] = interval
|
||
|
||
for target_desc in targets:
|
||
target_type, target_id = self._resolve_target_descriptor(target_desc)
|
||
|
||
existing_schedule = await ScheduleRepository.filter(
|
||
plugin_name=plugin_name,
|
||
target_type=target_type,
|
||
target_identifier=target_id,
|
||
bot_id=bot_id,
|
||
).first()
|
||
|
||
if (
|
||
existing_schedule
|
||
and creator_permission_level < existing_schedule.required_permission
|
||
):
|
||
permission_denied_targets.append(
|
||
(
|
||
target_desc,
|
||
f"需要 {existing_schedule.required_permission} 级权限",
|
||
)
|
||
)
|
||
continue
|
||
|
||
if target_type in [TargetType.TAG.value, TargetType.ALL_GROUPS.value]:
|
||
logger.debug(
|
||
f"检测到多目标任务 (类型: {target_type})，"
|
||
f"将所需权限强制提升至超级用户级别。"
|
||
)
|
||
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,
|
||
config=config,
|
||
)
|
||
if schedule:
|
||
success_targets.append((target_desc, schedule.id))
|
||
else:
|
||
failed_targets.append((target_desc, "服务返回失败"))
|
||
except Exception as e:
|
||
failed_targets.append((target_desc, str(e)))
|
||
|
||
return self._format_set_result_message(
|
||
targets, success_targets, failed_targets, permission_denied_targets
|
||
)
|
||
|
||
async def perform_bulk_operation(
|
||
self,
|
||
operation_name: str,
|
||
user_id: str,
|
||
group_id: str | None,
|
||
is_superuser: bool,
|
||
targeter,
|
||
all_flag: bool,
|
||
global_flag: bool,
|
||
) -> str:
|
||
"""执行批量操作（删除、暂停、恢复）"""
|
||
if not is_superuser:
|
||
permission_denied = False
|
||
if all_flag or global_flag:
|
||
permission_denied = True
|
||
elif targeter._filters.get("target_type") in [
|
||
TargetType.TAG.value,
|
||
TargetType.ALL_GROUPS.value,
|
||
]:
|
||
permission_denied = True
|
||
|
||
if permission_denied:
|
||
return "权限不足，只有超级用户才能对所有群组或通过标签进行批量操作。"
|
||
|
||
schedules_to_operate = await targeter._get_schedules()
|
||
if not schedules_to_operate:
|
||
return "没有找到符合条件的可操作任务。"
|
||
|
||
permitted_schedules, skipped_count = (
|
||
(schedules_to_operate, 0)
|
||
if is_superuser
|
||
else await self._filter_schedules_for_user(
|
||
schedules_to_operate, user_id, group_id
|
||
)
|
||
)
|
||
|
||
if not permitted_schedules:
|
||
return (
|
||
f"您没有权限{operation_name}任何匹配的任务。"
|
||
f"（因权限不足跳过 {skipped_count} 个）"
|
||
)
|
||
|
||
permitted_ids = [s.id for s in permitted_schedules]
|
||
final_targeter = scheduler_manager.target(id__in=permitted_ids)
|
||
|
||
operation_map = {
|
||
"删除": final_targeter.remove,
|
||
"暂停": final_targeter.pause,
|
||
"恢复": final_targeter.resume,
|
||
}
|
||
operation_func = operation_map.get(operation_name)
|
||
if not operation_func:
|
||
return f"未知的批量操作: {operation_name}"
|
||
|
||
count, _ = await operation_func()
|
||
msg = f"批量{operation_name}操作完成：\n - 成功: {count} 个"
|
||
if skipped_count > 0:
|
||
msg += f"\n - 因权限不足跳过: {skipped_count} 个"
|
||
return msg
|
||
|
||
async def trigger_schedule_now(self, schedule: ScheduledJob) -> str:
|
||
"""立即触发一个任务"""
|
||
success, message = await scheduler_manager.trigger_now(schedule.id)
|
||
return (
|
||
presenters.format_trigger_success(schedule)
|
||
if success
|
||
else f"❌ 触发失败: {message}"
|
||
)
|
||
|
||
async def update_schedule(
|
||
self,
|
||
schedule: ScheduledJob,
|
||
trigger: BaseTrigger | None,
|
||
kwargs_str: str | None,
|
||
) -> str:
|
||
"""更新一个任务的配置"""
|
||
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
|
||
)
|
||
success, message = await scheduler_manager.update_schedule(
|
||
schedule.id, trigger_type, trigger_config, job_kwargs
|
||
)
|
||
if success:
|
||
updated_schedule = await scheduler_manager.get_schedule_by_id(schedule.id)
|
||
return (
|
||
presenters.format_update_success(updated_schedule)
|
||
if updated_schedule
|
||
else "✅ 更新成功，但无法获取更新后的任务详情。"
|
||
)
|
||
return f"❌ 更新失败: {message}"
|
||
|
||
async def get_schedule_status(self, schedule_id: int) -> str:
|
||
"""获取单个任务的状态"""
|
||
status = await scheduler_manager.get_schedule_status(schedule_id)
|
||
if not status:
|
||
return f"未找到ID为 {schedule_id} 的任务。"
|
||
return presenters.format_single_status_message(status)
|
||
|
||
async def get_plugins_list(self) -> str:
|
||
"""获取可定时执行的插件列表"""
|
||
return await presenters.format_plugins_list()
|
||
|
||
async def _filter_schedules_for_user(
|
||
self, schedules: list[ScheduledJob], user_id: str, group_id: str | None
|
||
) -> tuple[list[ScheduledJob], int]:
|
||
user_level = await LevelUser.get_user_level(user_id, group_id)
|
||
permitted = [s for s in schedules if user_level >= s.required_permission]
|
||
skipped_count = len(schedules) - len(permitted)
|
||
return permitted, skipped_count
|
||
|
||
def _generate_view_title(self, filters: dict) -> str:
|
||
title = "定时任务"
|
||
if filters.get("target_type") == TargetType.ALL_GROUPS.value:
|
||
title = "全局定时任务"
|
||
elif "target_identifier" in filters:
|
||
title = f"群 {filters['target_identifier']} 的定时任务"
|
||
if "plugin_name" in filters:
|
||
title += f" [插件: {filters['plugin_name']}]"
|
||
return title
|
||
|
||
def _resolve_target_descriptor(self, target_desc: str) -> tuple[str, str]:
|
||
if target_desc == scheduler_manager.ALL_GROUPS:
|
||
return TargetType.ALL_GROUPS.value, scheduler_manager.ALL_GROUPS
|
||
if target_desc.startswith("tag:"):
|
||
return TargetType.TAG.value, target_desc[4:]
|
||
if target_desc.isdigit():
|
||
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
|
||
) -> str:
|
||
msg = f"为 {len(targets)} 个目标设置/更新任务完成：\n"
|
||
if success:
|
||
msg += f"- 成功: {len(success)} 个"
|
||
ids_str = ", ".join(str(s[1]) for s in success)
|
||
msg += f"\n - ID列表: {ids_str}"
|
||
else:
|
||
msg += "- 成功: 0 个"
|
||
if permission_denied:
|
||
msg += f"\n- 因权限不足跳过: {len(permission_denied)} 个"
|
||
for target, reason in permission_denied:
|
||
msg += f"\n - 目标 {target}: {reason}"
|
||
if failed:
|
||
msg += f"\n- 失败: {len(failed)} 个"
|
||
for target, reason in failed:
|
||
msg += f"\n - 目标 {target}: {reason}"
|
||
return msg.strip()
|
||
|
||
async def _parse_and_validate_kwargs_for_update(
|
||
self, plugin_name: str, kwargs_str: str | None
|
||
) -> dict:
|
||
if not kwargs_str:
|
||
return {}
|
||
|
||
task_meta = scheduler_registry.tasks.get(plugin_name)
|
||
if not task_meta:
|
||
raise ValueError(f"插件 '{plugin_name}' 未注册。")
|
||
|
||
params_model = task_meta.get("model")
|
||
if not (
|
||
params_model
|
||
and isinstance(params_model, type)
|
||
and issubclass(params_model, BaseModel)
|
||
):
|
||
raise ValueError(f"插件 '{plugin_name}' 不支持或配置了无效的参数模型。")
|
||
|
||
try:
|
||
raw_kwargs = dict(
|
||
item.strip().split("=", 1) for item in kwargs_str.split(";")
|
||
)
|
||
validated_model = model_validate(params_model, raw_kwargs)
|
||
return model_dump(validated_model)
|
||
except ValidationError as e:
|
||
errors = [f" - {err['loc'][0]}: {err['msg']}" for err in e.errors()]
|
||
raise ValueError("参数验证失败:\n" + "\n".join(errors))
|
||
except Exception as e:
|
||
raise ValueError(f"参数格式错误: {e}")
|
||
|
||
|
||
scheduler_admin_service = SchedulerAdminService()
|