# deps_registry.py """ 依赖注册中心 (Dependency Registry) 负责解析 config/registry.yaml 配置文件,提供结构化的依赖元数据访问接口。 """ import os import sys # Allow direct execution from either the project root or this directory. ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) if ROOT_DIR not in sys.path: sys.path.insert(0, ROOT_DIR) import yaml from dataclasses import dataclass from typing import List, Optional DEFAULT_CONFIG_PATH = os.path.join(ROOT_DIR, "config", "registry.yaml") @dataclass class Dependency: """二进制依赖实体""" name: str # 依赖名称 (如 chrome, mihomo, cloakbrowser) version: str # 版本号 (如 146.0.7680.177.5, v1.19.24) platform: str # 适配平台 (linux, windows, darwin) url: str # 下载地址 filename: Optional[str] = None # 本地保存文件名 (位于 downloads/ 目录下) def get_filename(self) -> str: """获取目标落地文件名,未指定时默认从 URL 提取""" if self.filename: return self.filename return self.url.rstrip("/").split("/")[-1] class DependencyRegistry: """依赖注册器""" def __init__(self): self._dependencies: List[Dependency] = [] def register( self, name: str, version: str, platform: str, url: str, filename: Optional[str] = None ) -> "DependencyRegistry": """注册一个二进制依赖项""" dep = Dependency( name=name, version=str(version), platform=platform.lower(), url=url, filename=filename ) self._dependencies.append(dep) return self def load_from_yaml(self, config_path: str = DEFAULT_CONFIG_PATH) -> "DependencyRegistry": """从 yaml 配置文件加载所有注册项""" if not os.path.exists(config_path): raise FileNotFoundError(f"未找到注册表配置文件: {config_path}") with open(config_path, "r", encoding="utf-8") as f: data = yaml.safe_load(f) or {} dep_list = data.get("dependencies", []) self._dependencies.clear() for item in dep_list: self.register( name=item["name"], version=item["version"], platform=item["platform"], url=item["url"], filename=item.get("filename") ) return self def get_by_platform(self, target_platform: str) -> List[Dependency]: """按平台筛选依赖列表,若为 'all' 则返回所有平台依赖""" target = target_platform.lower() if target == "all": return list(self._dependencies) return [d for d in self._dependencies if d.platform == target] def get_all(self) -> List[Dependency]: """获取所有已注册依赖""" return list(self._dependencies) # 全局依赖注册中心实例(模块加载时自动从 config/registry.yaml 初始化) registry = DependencyRegistry() if os.path.exists(DEFAULT_CONFIG_PATH): registry.load_from_yaml(DEFAULT_CONFIG_PATH)