【免费下载链接】MacSaiMac Sai: the open-source Mac cleaner, optimizer, and malware scanner. A free, Apple-notarized alternative to CleanMyMac, built with Swift 6 and SwiftUI.项目地址https://gitcode.com/gh_mirrors/mac/MacSai点击查看免费下载Mac Sai 是一款开源的 Mac 清理、优化与恶意软件扫描工具也是免费、无遥测、经 Apple 公证的 CleanMyMac 替代品使用 Swift 6 与 SwiftUI 构建。本文带你拆解它的工程架构4 个 SPM 目标如何分工、为什么刻意放弃传统 XPC 特权 Helper、菜单栏小组件如何实现常驻与多指标显示以及 Swift 6 严格并发在真实代码中的落地方式。先看全貌一个应用两种进程形态Mac Sai 由两个可执行程序组成主程序负责 17 个清理/防护/性能模块菜单栏程序则是一个轻量系统监视器。主程序入口是 MacCleanApp.swift刻意使用单个Window而非WindowGroup——配合 Info.plist 的LSMultipleInstancesProhibited保证菜单栏深链macclean://module/slug见 onOpenURL 处理打开应用时复用同一窗口永远不会出现两个主窗口。SPM 4 目标设计业务逻辑与 I/O 的边界整个仓库是一个 Swift PackagePackage.swift 声明了 3 个产品、4 个源码目标目标类型职责MacClean可执行主应用SwiftUI 视图、模块注册、权限服务MacCleanMenu可执行菜单栏 Login Item 应用实时统计与提示MacCleanKit库全部业务逻辑策略、解析、过滤、格式化零系统 I/O 依赖MacCleanTestSupport库测试夹具MockClock、二进制构造器等另有 MacCleanTests 与 MacCleanKitTests 两个测试目标合计 860 个测试用例。这种划分带来一个清晰约定见 菜单栏小组件持久化设计文档业务逻辑放 MacCleanKitI/O 留在 MacClean / MacCleanMenu。例如重复实例该退出哪一个这个看似琐碎的问题被抽成纯函数 MenuBarInstancePolicy——按launchDate最早、PID 最小做全序比较保证恰好一个存活、永不双方互杀这正是 issue #138 的根因而真正的exit(0)调用留在 MacCleanMenuApp.swift 这个薄 I/O 层。纯策略可以直接用 XCTest 穷举三进程竞态场景。为什么不用传统 XPC 特权 Helper大多数 Mac 清理软件会安装一个 root 级 XPC 特权 Helper 来执行系统维护。Mac Sai 做了不同的取舍原因写在 PrivilegedShellRunner.swift 的注释里密码提示体验macOS 对do shell script ... with administrator privileges的管理员密码缓存是按进程计算的约 5 分钟。如果每执行一次维护任务就 spawn 一个osascript子进程每个任务都会弹一次密码框issue #143。方案改用进程内NSAppleScript执行顺序执行的所有维护任务共享同一个凭据缓存只弹一次密码。命令拼装是纯字符串逻辑 MaintenanceShell.appleScriptSource每个参数用单引号 POSIX 转义可单测而不实际执行任何东西错误信息还会被 humanReadableError 剥掉1:92: execution error:前缀把真实的diskutil报错直接展示给用户。执行端是 actor MaintenanceExecutor——它同时持有需要管理员与普通Process两条路径actor 天然串行化所有任务避免并发弹出多个授权框。而菜单栏 Helper 走的是另一条路SMAppService.loginItem注册的Login Item嵌入在Mac Sai.app/Contents/Library/LoginItems/MacCleanMenu.app/由 MenuBarLauncher 管理注册/注销——注册本身是与backgroundtaskmanagementd的 XPC 往返但 Helper 本身不需要任何提升权限这也是安全设计的一部分能不用 root 就不用 root。菜单栏设计4 个指标、3 秒轮询、永不消失用户可选的 4 个实时指标菜单栏图标旁的数字由 MenuBarMetric 枚举决定磁盘可用空间、GPU 使用率、内存使用率、电池温度外加仅图标选项。rawValue 持久化在共享 defaults 中因此跨版本必须保持稳定——这类看似小的约束直接写进了类型注释里。轮询循环从 App 生命周期驱动而不是弹窗驱动MenuStatsModel 每 3 秒轮询一轮每个采集器系统统计、网速、连接设备、建议提示都被一个超时预算包围单个系统调用卡死 → 该指标保留上次值面板不白屏超 500ms 的步骤会打 OSLog 警告方便用户从 Console 定位到具体采集器轮询在applicationDidFinishLaunching启动不依赖 popover 的 onAppear后者在 Intel macOS 14.x 上不可靠是面板卡在加载转圈的旧 bug。跨进程共享状态一个 plist 就够了主应用和菜单栏 Helper 通过命名 UserDefaults suite交换状态见 SharedAppState.swift最近一次恶意软件扫描结果、被用户关闭的提示、通知节流日志。共享数据小、可 JSON 序列化、不涉密所以没上 App Group——注释里明确记录了为什么不用标准方案的取舍理由。保活策略纯函数决定要不要重启Helper 意外退出后主应用监听NSWorkspace.didTerminateApplicationNotification决定是否拉起。决策逻辑同样是纯函数 MenuBarKeepAlivePolicy.action关闭开关 → terminate用户主动退出监视器写入menuBarWidgetUserQuit标记→ 不再拉起register()之后先等 500ms 让 SMAppService 有机会自行拉起避免第二条启动路径竞态。Swift 6 严格并发从注释能读出的实战经验swift-tools-version: 6.0意味着默认开启严格并发检查以下模式在代码中反复出现actor 隔离可变状态MaintenanceExecutor 用 actor 串行化维护任务MainActor 标注 UI 状态MenuBarLauncher、MenuStatsModel全部MainActor Observable跨线程回调统一用Task { MainActor in }跳回主 actor注释标注了不要用会触碰 MainActor 状态的 completion handlerissue #58Sendable 协议贯穿数据模型ScanModule、MenuBarInstance、MaintenanceShell结果类型均为Sendable可在Task间自由传递桥接非线程安全 APINSAppleScript不是线程安全的且可能阻塞数分钟因此放到专用 DispatchQueue用withCheckedContinuation包进 async 世界AppleScriptPrivilegedRunner后台工作不让窗口卡AppState初始化时用Task.detached(priority: .background)做日志清理与语言发现AppState.swift慢文件系统不延迟窗口出现preconcurrency 兼容旧 SDKMenuAppDelegate 对NSApplicationDelegate使用preconcurrency标注在 CI 旧 SDK 上保持可编译。模块体系同样受益于并发安全14 个扫描模块在 AppState.registerModules 统一注册到 ScanCoordinatoridle / scanning / completed / failed状态机驱动 Smart Scan 的一键清理流程。本地构建与测试git clone https://gitcode.com/gh_mirrors/mac/MacSai cd MacSai swift build swift test测试覆盖策略类纯函数如MenuBarHelperPolicy到端到端场景EndToEndScenarioTests完整说明见 docs/TESTING.md发布流程见 docs/RELEASING.md。小结Mac Sai 的架构可以浓缩为三句话4 目标分工——MacCleanKit承载全部可测的纯逻辑两个可执行目标只做薄 I/O无特权 Helper 的权限方案——进程内 AppleScript 换一次密码框Login Item 换常驻监视器能不提权就不提权Swift 6 严格并发不是负担而是护栏——actor、Sendable、MainActor 让多进程 3 秒轮询 异步扫描这类场景在编译期就排除了数据竞争。对一个追求安全设计的清理工具来说这些取舍比功能清单更能解释它为什么敢开源。赞分享【免费下载链接】MacSaiMac Sai: the open-source Mac cleaner, optimizer, and malware scanner. A free, Apple-notarized alternative to CleanMyMac, built with Swift 6 and SwiftUI.项目地址https://gitcode.com/gh_mirrors/mac/MacSai点击查看免费下载相关推荐ECC 规则体系中的 Swift 编码风格格式、不可变性、Swift 6 类型化错误与严格并发的完整实践ECC 规则体系中的 Swift 编码风格格式、不可变性、Swift 6 类型化错误与严格并发的完整实践 在 ECCagent harness 性能优化系统人工智能AI 技能AI 插件AI 评测Agent 评测MCP Clients开发工具Tinycast 架构深度解析四层分层、单所有者核心与 Swift 6 并发模型Tinycast 架构深度解析四层分层、单所有者核心与 Swift 6 并发模型 Tinycast 是一个完全原生的 macOS 启动器、热键与剪贴板历史工具桌面应用Sparkle 2 框架架构设计实践XPC 服务、非单例化与 Objective-C 代码瘦身指南Sparkle 2 框架架构设计实践XPC 服务、非单例化与 Objective C 代码瘦身指南 导读 本文以 Sparkle 2 的官方架构设计文档 De桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考