一、整体架构设计1.1 设计理念本工具定位为高级用户专属的深度系统清理工具，参考 Pear Cleaner 的 Bundle ID 追踪技术，但清理维度远超普通应用卸载工具。目标是通过系统化扫描与精准清理，使系统状态无限接近全新安装后的纯净度，同时保留用户核心数据文件。1.2 技术栈GUI 框架：PyQt6（原生 macOS 风格适配）核心语言：Python 3.10+系统交互： subprocess 调用系统命令 + os 模块文件操作数据存储：SQLite（扫描结果缓存、清理历史记录）权限管理：通过 AppleScript 授权 + sudo 提权机制1.3 整体架构图┌─────────────────────────────────────────────────────┐ │ PyQt6 主界面 │ │ ┌─────────┬─────────┬─────────┬─────────┬───────┐ │ │ │ 概览仪表盘│系统缓存 │应用残留 │用户记录 │ 高级工具│ │ │ └─────────┴─────────┴─────────┴─────────┴───────┘ │ └───────────────────────┬─────────────────────────────┘ │ ┌───────────────────────▼─────────────────────────────┐ │ 核心扫描引擎层 │ │ ┌────────────┬────────────┬────────────────────┐ │ │ │ 文件扫描器 │ Bundle追踪器│ 系统命令执行器 │ │ │ └────────────┴────────────┴────────────────────┘ │ └───────────────────────┬─────────────────────────────┘ │ ┌───────────────────────▼─────────────────────────────┐ │ 清理模块层 │ │ ┌─────────┬─────────┬─────────┬─────────┬───────┐ │ │ │系统缓存 │应用残留 │用户痕迹 │日志诊断 │ 系统级 │ │ │ │清理模块 │清理模块 │清理模块 │清理模块 │ 清理 │ │ │ └─────────┴─────────┴─────────┴─────────┴───────┘ │ └───────────────────────┬─────────────────────────────┘ │ ┌───────────────────────▼─────────────────────────────┐ │ 安全与权限层 │ │ 白名单机制 │ SIP 检测 │ 清理前备份 │ 操作日志审计 │ └─────────────────────────────────────────────────────┘二、核心扫描引擎设计（参考 Pear Cleaner 原理）2.1 Bundle ID 基因追踪引擎借鉴 Pear Cleaner 的应用基因识别技术，实现比普通清理工具更精准的关联文件定位：# 核心算法伪代码 class BundleTracker: def __init__(self, app_path): self.bundle_id = self._extract_bundle_id(app_path) self.app_name = self._extract_app_name(app_path) self.signature = self._extract_code_signature(app_path) def _extract_bundle_id(self, app_path): """解析 Info.plist 获取 CFBundleIdentifier""" plist_path = os.path.join(app_path, "Contents", "Info.plist") return read_plist(plist_path).get("CFBundleIdentifier") def find_associated_files(self): """四维扫描：路径匹配 + 命名匹配 + 时间匹配 + 内容特征匹配""" results = [] # 1. 标准目录精确匹配（按 Bundle ID） for std_dir in STANDARD_APP_DATA_DIRS: results.extend(self._scan_by_bundle_id(std_dir)) # 2. 模糊名称匹配 results.extend(self._scan_by_app_name_fuzzy()) # 3. 创建时间聚类匹配 results.extend(self._scan_by_creation_time_cluster()) return self._deduplicate(results)扫描覆盖的 17 个标准目录：目录路径存储内容清理风险~/Library/Preferences应用偏好设置 plist中~/Library/Caches应用缓存数据低~/Library/Application Support应用数据文件中~/Library/Containers沙盒应用容器低~/Library/Group Containers应用组共享容器中~/Library/Logs应用日志低~/Library/Saved Application State应用保存状态低~/Library/WebKitWebKit 缓存数据低/Library/Caches系统级缓存中/Library/Logs系统级日志低/private/var/logUnix 系统日志低~/Library/LaunchAgents用户级启动项高/Library/LaunchDaemons系统级守护进程高~/Library/Application Scripts应用脚本低~/Library/CookiesCookie 数据低~/Library/HTTPStoragesHTTP 缓存低~/Library/Receipts安装收据低2.2 文件系统拓扑分析器采用 BFS 广度优先遍历算法，对关键目录进行分层扫描，支持按大小、修改时间、文件类型多维度筛选。class FileSystemScanner: def scan_directory(self, path, depth=3, filters=None): """深度扫描目录，返回结构化文件树""" result_tree = {} queue = [(path, 0)] while queue: current_path, current_depth = queue.pop(0) if current_depth depth: continue for item in os.scandir(current_path): if item.is_dir(follow_symlinks=False): queue.append((item.path, current_depth + 1)) size = self._get_size(item.path) result_tree[item.path] = { "size": size, "mtime": item.stat().st_mtime, "type": "dir" if item.is_dir() else "file", "safe_level": self._assess_safety(item.path) } return result_tree三、五大清理模块详解3.1 模块一：系统缓存深度清理目标：清除所有非核心系统缓存，释放 5-30GB 空间子类别路径清理策略预期效果