# Copyright 2023 # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """文件预加载助手管理器 - 管理基于unique_id的助手实例缓存""" import hashlib import time from typing import Dict, List, Optional from qwen_agent.agents import Assistant from qwen_agent.log import logger from modified_assistant import init_modified_agent_service_with_files, update_agent_llm class FileLoadedAgentManager: """文件预加载助手管理器 基于 unique_id 缓存助手实例，避免重复创建和文件解析 """ def __init__(self, max_cached_agents: int = 20): self.agents: Dict[str, Assistant] = {} # {unique_id: assistant_instance} self.unique_ids: Dict[str, str] = {} # {cache_key: unique_id} self.access_times: Dict[str, float] = {} # LRU 访问时间管理 self.creation_times: Dict[str, float] = {} # 创建时间记录 self.max_cached_agents = max_cached_agents def _get_cache_key(self, unique_id: str) -> str: """获取 unique_id 的哈希值作为缓存键""" return hashlib.md5(unique_id.encode('utf-8')).hexdigest()[:16] def _update_access_time(self, cache_key: str): """更新访问时间（LRU 管理）""" self.access_times[cache_key] = time.time() def _cleanup_old_agents(self): """清理旧的助手实例，基于 LRU 策略""" if len(self.agents) <= self.max_cached_agents: return # 按 LRU 顺序排序，删除最久未访问的实例 sorted_keys = sorted(self.access_times.keys(), key=lambda k: self.access_times[k]) keys_to_remove = sorted_keys[:-self.max_cached_agents] removed_count = 0 for cache_key in keys_to_remove: try: del self.agents[cache_key] del self.unique_ids[cache_key] del self.access_times[cache_key] del self.creation_times[cache_key] removed_count += 1 logger.info(f"清理过期的助手实例缓存: {cache_key}") except KeyError: continue if removed_count > 0: logger.info(f"已清理 {removed_count} 个过期的助手实例缓存") async def get_or_create_agent(self, unique_id: str, project_dir: str, model_name: str = "qwen3-next", api_key: Optional[str] = None, model_server: Optional[str] = None, generate_cfg: Optional[Dict] = None, language: Optional[str] = None) -> Assistant: """获取或创建文件预加载的助手实例 Args: unique_id: 项目的唯一标识符 files: 需要预加载的文件路径列表 project_dir: 项目目录路径，用于读取system_prompt.md和mcp_settings.json model_name: 模型名称 api_key: API 密钥 model_server: 模型服务器地址 generate_cfg: 生成配置 language: 语言代码，用于选择对应的系统提示词 Returns: Assistant: 配置好的助手实例 """ import os import json # 使用prompt_loader读取system_prompt模板 from .prompt_loader import load_system_prompt system_prompt_template = load_system_prompt(project_dir, language) readme = "" readme_path = os.path.join(project_dir, "README.md") if os.path.exists(readme_path): with open(readme_path, "r", encoding="utf-8") as f: readme = f.read().strip() dataset_dir = os.path.join(project_dir, "dataset") final_system_prompt = system_prompt_template.replace("{dataset_dir}", str(dataset_dir)).replace("{readme}", str(readme)) logger.info(f"Loaded global system_prompt for unique_id: {unique_id}") if not final_system_prompt: logger.info(f"No system_prompt found for unique_id: {unique_id}") # 读取mcp_settings：优先从项目目录读取，然后降级到全局配置 final_mcp_settings = None # 尝试从项目目录读取 mcp_settings_file = os.path.join(project_dir, "mcp_settings.json") if os.path.exists(mcp_settings_file): with open(mcp_settings_file, 'r', encoding='utf-8') as f: final_mcp_settings = json.load(f) logger.info(f"Loaded mcp_settings from project directory for unique_id: {unique_id}") else: # 降级到全局配置 mcp_settings_path = "./mcp/mcp_settings.json" if os.path.exists(mcp_settings_path): with open(mcp_settings_path, "r", encoding="utf-8") as f: final_mcp_settings = json.load(f) logger.info(f"Loaded global mcp_settings for unique_id: {unique_id}") else: final_mcp_settings = [] logger.info(f"No mcp_settings found for unique_id: {unique_id}") if final_mcp_settings is None: final_mcp_settings = [] cache_key = self._get_cache_key(unique_id) # 检查是否已存在该助手实例 if cache_key in self.agents: self._update_access_time(cache_key) agent = self.agents[cache_key] # 动态更新 LLM 配置和系统设置（如果参数有变化） update_agent_llm(agent, model_name, api_key, model_server, generate_cfg, final_system_prompt, final_mcp_settings) logger.info(f"复用现有的助手实例缓存: {cache_key} (unique_id: {unique_id}") return agent # 清理过期实例 self._cleanup_old_agents() # 创建新的助手实例，预加载文件 logger.info(f"创建新的助手实例缓存: {cache_key}, unique_id: {unique_id}") current_time = time.time() agent = init_modified_agent_service_with_files( model_name=model_name, api_key=api_key, model_server=model_server, generate_cfg=generate_cfg, system_prompt=final_system_prompt, mcp=final_mcp_settings ) # 缓存实例 self.agents[cache_key] = agent self.unique_ids[cache_key] = unique_id self.access_times[cache_key] = current_time self.creation_times[cache_key] = current_time logger.info(f"助手实例缓存创建完成: {cache_key}") return agent def get_cache_stats(self) -> Dict: """获取缓存统计信息""" current_time = time.time() stats = { "total_cached_agents": len(self.agents), "max_cached_agents": self.max_cached_agents, "agents": {} } for cache_key, agent in self.agents.items(): stats["agents"][cache_key] = { "unique_id": self.unique_ids.get(cache_key, "unknown"), "created_at": self.creation_times.get(cache_key, 0), "last_accessed": self.access_times.get(cache_key, 0), "age_seconds": int(current_time - self.creation_times.get(cache_key, current_time)), "idle_seconds": int(current_time - self.access_times.get(cache_key, current_time)) } return stats def clear_cache(self) -> int: """清空所有缓存 Returns: int: 清理的实例数量 """ cache_count = len(self.agents) self.agents.clear() self.unique_ids.clear() self.access_times.clear() self.creation_times.clear() logger.info(f"已清空所有助手实例缓存，共清理 {cache_count} 个实例") return cache_count def remove_cache_by_unique_id(self, unique_id: str) -> bool: """根据 unique_id 移除特定的缓存 Args: unique_id: 项目的唯一标识符 Returns: bool: 是否成功移除 """ cache_key = self._get_cache_key(unique_id) if cache_key in self.agents: del self.agents[cache_key] del self.unique_ids[cache_key] del self.access_times[cache_key] del self.creation_times[cache_key] logger.info(f"已移除特定 unique_id 的助手实例缓存: {unique_id}") return True return False # 全局文件预加载助手管理器实例 _global_agent_manager: Optional[FileLoadedAgentManager] = None def get_global_agent_manager() -> FileLoadedAgentManager: """获取全局文件预加载助手管理器实例""" global _global_agent_manager if _global_agent_manager is None: _global_agent_manager = FileLoadedAgentManager() return _global_agent_manager def init_global_agent_manager(max_cached_agents: int = 20): """初始化全局文件预加载助手管理器""" global _global_agent_manager _global_agent_manager = FileLoadedAgentManager(max_cached_agents) return _global_agent_manager