Mac Sai

开源的 Mac 清理、优化与恶意软件扫描工具。
免费、经 Apple 公证的 CleanMyMac 替代品，使用 Swift 6 和 SwiftUI 构建。
_{下载量已超过 100,000 次。永久免费，零遥测。}

English | 简体中文 | 繁體中文 | Deutsch | Français | Русский

一条命令即可安装：

brew install --cask mac-sai

或下载最新的 DMG。它已经过 Apple 公证，双击即可打开，无需右键、无警告、无需终端命令。

_{应用内永远没有广告。本页面只有一个经过筛选的赞助位，目前空缺。}

为什么选择 Mac Sai？

一款功能完整的 Mac 清理工具，不该收取年度订阅费，也不该让你把对文件的深度访问权限交给一个黑盒。Mac Sai 把整套工具完全透明地交到你手中。

• 永久免费。 没有订阅、没有内购、没有“升级到 Pro”、没有弹窗催促。BSD-3 许可证。
• 零遥测。 没有分析统计、没有崩溃上报、没有追踪器、没有可回传的服务器。而且不必只听我们说，你可以自行验证，两条命令即可。
• CleanMyMac 的每一项主要工具，集于一身。 22 个模块，覆盖清理、防护、性能、应用管理和磁盘洞察，外加一个菜单栏小组件。
• 安全为先。 优先移入废纸篓、受保护路径黑名单、符号链接与 TOCTOU 防护，以及会校验每一条路径的 SafetyGuard。它从设计上就力求绝不丢失你的数据。
• 经 Apple 公证，且完全开源。 你的 Mac 每次启动都会校验签名，而每一行代码都在这里供你审阅。

功能一览

功能详解

🧹 清理

🛡️ 防护

⚡ 性能

📦 应用

🗂️ 文件

📊 菜单栏小组件

一个毛玻璃风格的菜单栏小组件，让你的 Mac 关键状态一键可达。它是一个独立进程，登录时启动，可从应用侧边栏开关，无需打开主窗口即可随时查看。

• 实时状态环：CPU 负载、内存压力、磁盘占用和电池，以 2x2 环形网格呈现（host_processor_info、vm_statistics64、APFS 容量、IOKit 电源），按绿 → 黄 → 红分级着色
• 可配置读数：可选择显示可用磁盘、GPU 使用率、内存使用率或电池温度；选择会保存，不可用的传感器显示 --
• 网络、运行时间与交换空间：实时上/下行吞吐、系统运行时间、交换空间使用
• 建议：可操作、可关闭的提示（“用户缓存已增长到 2.52 GB，运行系统垃圾清理”），点击即可执行，关闭后 30 天内不再提示
• 防护状态：上次恶意软件扫描时间和威胁数量，按时效着色
• 已连接设备：一眼查看外置卷（含剩余空间）和外接显示器
• 健康提醒：当磁盘空间严重不足或内存压力持续偏高时发出通知（已限流、可选启用）

⌨️ 键盘快捷键

Mac Sai 横向对比

CleanMyMac 是一款很棒的产品，愿意为打磨精良、有官方支持的体验付费的用户理应让他们获得收入。Mac Sai 则面向所有更希望拥有透明源代码、零订阅的人。

安装

Homebrew（推荐）

Mac Sai 已收录进官方 Homebrew cask，无需 tap：

brew install --cask mac-sai

它已经过 Apple 公证，可从聚焦或“应用程序”直接启动，没有警告，也无需额外步骤。

curl -fsSL https://raw.githubusercontent.com/iliyami/MacSai/main/scripts/install.sh | bash

git clone https://github.com/iliyami/MacSai.git
cd MacSai
swift build
swift test                     # 运行完整的 1048 个测试
bash scripts/build-dmg.sh      # 构建本地 DMG（未签名）

授予完全磁盘访问权限

部分模块（邮件附件、隐私、恶意软件）需要完全磁盘访问权限才能扫描受保护区域：

1. 打开 系统设置、隐私与安全性、完全磁盘访问权限
2. 点击 +，添加 Mac Sai.app
3. 重新启动 Mac Sai

卸载

Homebrew 安装：

brew uninstall --zap --cask mac-sai

DMG 或手动安装（也能处理 Homebrew 安装）：

curl -fsSL https://raw.githubusercontent.com/iliyami/MacSai/main/scripts/uninstall.sh | bash

两者都会删除 Mac Sai 及其在 ~/Library 下的偏好设置、缓存、日志和数据库。

已签名、已公证，值得信任

Mac Sai 使用 Apple Developer ID 进行代码签名，并经 Apple 公证。对于清理类应用而言，这一点比几乎任何你安装的软件都更重要，因为你即将赋予它对文件的深度访问权限，你有权确认运行在你 Mac 上的确实是我们的、且未被篡改的版本。以下这些都由你自己的 Mac 强制执行，而不仅仅是我们的承诺：

• Apple 已扫描过它。 每个版本都会提交给 Apple 并在发布前检查恶意软件。
• 它无法被篡改。 签名是覆盖每个文件的加密封印；哪怕改动一个字节，macOS 也会拒绝打开。
• 它确实来自我们。 签名绑定到我们的 Apple 开发者身份，任何其他人都无法发布你的 Mac 会当作 Mac Sai 接受的东西。
• 开箱即用。 没有 Gatekeeper 警告，无需右键打开，也无需终端命令。

再加上完全开源，这是一条你无需盲信的信任链：代码公开、我们对每个版本签名、Apple 进行验证、而你的 Mac 在每次打开时都会重新校验这个封印。

自行验证无遥测

不必只听我们说，源码和运行中的进程都可以核对。

1. 在源码中搜索网络 API

rg -n 'URLSession|NSURLConnection|Sparkle|SecTrustEvaluate' Sources --glob '*.swift'

可选的网络访问列于下方。本地清理不会上传扫描结果或文件列表：

• Sources/MacClean/Services/SelfUpdateController.swift: Sparkle 检查签名应用中固定的 HTTPS 源，并下载签名的版本说明和更新归档。自动检查与自动下载/安装分别设置；系统信息上报及版本说明中的 JavaScript 均已禁用。参见更新配置。 对于已配置的直接安装版本，自动检查更新默认开启，每天运行一次；每个请求都会在 User-Agent 中包含应用和 Sparkle 的版本，可在“设置”中关闭自动检查。
• Sources/MacCleanKit/UpdateChecker.swift: Homebrew 更新检查，以及未配置签名源时使用的版本发布页面
• Sources/MacClean/Modules/Updater/UpdaterModule.swift：打开“应用更新”模块时，由用户触发的对其它应用 Sparkle 源的检查
• Sources/MacCleanKit/MalwareBazaarFeed.swift：可选的 MalwareBazaar 哈希下载。只有在你添加自己的 abuse.ch Auth-Key 并在“设置 > 恶意软件数据库”中点击“立即更新”时才会运行。每次请求只发送你的 Auth-Key 和查询内容，绝不发送文件哈希值或路径。如果下载的哈希与某个已签名的文件匹配，macOS 会向 Apple 查询其签名证书是否已被吊销（与 Gatekeeper 的检查相同）；该请求只涉及证书，不涉及你的文件

代码库中没有任何分析、崩溃上报或追踪 SDK。

2. 观察实时进程

(
MACSAI_APP=$(cd "/Applications/Mac Sai.app" && pwd -P) || exit 1
MACSAI_PIDS=$(ps -ww -axo pid=,comm= | awk -v bundle="$MACSAI_APP/" '
  { pid=$1; sub(/^[[:space:]]*[0-9]+[[:space:]]+/, "")
    if (index($0, bundle) == 1) print pid }' | paste -sd, -)
if [ -n "$MACSAI_PIDS" ]; then
  ps -p "$MACSAI_PIDS" -o pid=,comm=
  lsof -nP -a -p "$MACSAI_PIDS" -i
else
  echo "No running executables from this Mac Sai bundle"
fi
)

此快照按所选应用包内的可执行文件路径选取 PID，因此不会包含无关的 Installer/Updater 进程。复制到其他位置的 Sparkle 辅助程序和 macOS 信任服务不在此范围内；请使用可识别进程的防火墙观察它们。在检查或下载更新时重复运行此命令，以观察短暂的连接。

没有进行更新检查、下载或可选的恶意软件验证时，本地清理不会建立网络连接。观察更新时也要包含 Sparkle 子进程；Apple 证书检查由 macOS 信任服务执行。也可以使用 Little Snitch 或 LuLu 查看这些连接。

3. 检查你实际安装的二进制文件

对于 DMG 或 Homebrew 安装，此循环只需要 macOS 命令行工具，无需源码或 Python。它读取全部七个内置二进制文件，并列出常见网络导入、静态 URL 和跟踪器字符串，供手动检查：

(
MACSAI_APP="/Applications/Mac Sai.app"
MACSAI_SPARKLE="$MACSAI_APP/Contents/Frameworks/Sparkle.framework/Versions/B"
for MACSAI_BINARY in \
  "$MACSAI_APP/Contents/MacOS/MacClean" \
  "$MACSAI_APP/Contents/Library/LoginItems/MacCleanMenu.app/Contents/MacOS/MacCleanMenu" \
  "$MACSAI_SPARKLE/Sparkle" "$MACSAI_SPARKLE/Autoupdate" \
  "$MACSAI_SPARKLE/Updater.app/Contents/MacOS/Updater" \
  "$MACSAI_SPARKLE/XPCServices/Downloader.xpc/Contents/MacOS/Downloader" \
  "$MACSAI_SPARKLE/XPCServices/Installer.xpc/Contents/MacOS/Installer"
do
  printf '\n%s\n' "$MACSAI_BINARY"
  MACSAI_IMPORTS=$(nm -uj "$MACSAI_BINARY") || exit 1
  printf '%s\n' "$MACSAI_IMPORTS" | grep -Ei \
    'URLSession|URLConnection|CFNetwork|Network|nw_|DNSService|NetService|curl_|^_(socket|connect|connectx|send|recv)([$]|$)' || true
  MACSAI_STRINGS=$(strings -a "$MACSAI_BINARY") || exit 1
  printf '%s\n' "$MACSAI_STRINGS" | grep -Ei \
    '://|sentry|firebase|mixpanel|amplitude|bugsnag|crashlytics|posthog|appsflyer' || true
done
)

这些列表并非自动通过或失败的结论，也不能证明所有运行时目标地址均可见。要核对完整组件清单、明确的允许列表和内置隐私设置，请使用下面的自动检查。

请从与安装版本对应的源码目录运行检查。它分析实际安装的应用包，包括主程序、菜单栏助手、Sparkle.framework、Autoupdate、Updater.app、Downloader.xpc 和 Installer.xpc：

bash scripts/check-network-surface.sh "/Applications/Mac Sai.app"

预期结果：七个 Mach-O 文件全部通过。缺失或多出的二进制文件、未获允许的网络导入或静态 URL，以及跟踪器标记都会使检查失败。只有 Mac Sai、菜单栏助手、Sparkle 和 Downloader 允许导入 URLSession；其他 Sparkle 助手不允许网络导入。Sparkle 的文档链接和 XML 命名空间已单独列明，不作为下载端点。

脚本还会显示内置的 SUFeedURL，并检查签名源、解包前验证和隐私设置。请将该源中的归档/版本说明地址，以及你主动查询的其他应用更新源，与上述实时连接核对。回退端点为 api.github.com/repos/iliyami/MacSai/releases/latest 和 formulae.brew.sh/api/cask/mac-sai.json；可选的恶意软件数据库端点为 mb-api.abuse.ch/api/v1/。项目、支持及浏览器设置链接只会应用户请求打开。打包时执行相同的完整应用检查；CI 检查两个构建出的可执行文件及固定版本 Sparkle 的全部五个二进制文件。检查实现及允许列表。

架构

Mac Sai
├── MacClean          主 SwiftUI 应用（22 个模块）
├── MacCleanKit       共享框架（模型、常量、协议）
├── MacCleanHelper    XPC 特权助手（用于 root 操作的 LaunchDaemon）
└── MacCleanMenu      菜单栏监视器（独立进程）

技术栈

安全模型

Mac Sai 的设计目标是绝不造成数据丢失：

• 受保护路径黑名单：/System、/usr、/bin、/sbin 以及 Apple 系统应用不可触碰，并对 macOS firmlink 做规范化，使符号链接重定向检测不会误判合法系统路径
• 扫描前的可清理性过滤：当前进程无法移入废纸篓的项目（系统缓存中 root 拥有的子项、~/Library/Caches/com.apple.* 下被数据保险库保护的目录）在扫描时即被剔除，绝不会作为“可清理”出现
• 优先移入废纸篓：所有删除默认进入废纸篓，预演模式可在不触碰任何文件的前提下预览
• TOCTOU 防护：删除前立即重新解析符号链接
• 排除文件夹：可在设置中选择让扫描完全跳过的文件夹，SafetyGuard 还会拒绝删除这些文件夹下的任何内容
• 分块、可取消的清理：大批量选择会拆分为每批 5000 项，在批次之间遵循取消；点击取消后扫描约在一秒内回到空闲
• 应用内活动日志：清理过程中的每个错误都会记录完整路径，可在清理后界面查看并复制，日志 30 天后自动清理
• 内核强制的 XPC 闸门：特权助手使用 NSXPCListener.setCodeSigningRequirement，由内核本身拒绝任何代码签名与主应用标识符和团队不匹配的连接

测试

swift test

基于 XCTest 的测试套件包含 1048 个测试，并把 SafetyGuard 和 CleaningEngine（生死攸关的文件）视为必须完美：对符号链接、路径穿越、NULL 字节、SIP、受保护应用、文件数量上限、TOCTOU 和幂等性的对抗式覆盖，外加对预演 / 移入废纸篓 / 永久删除清理、扫描状态机、每一个系统垃圾类别、树状图算法、卸载器匹配引擎、重复文件检测、appcast 解析，以及完整的“从合成夹具到清理”端到端流程的集成覆盖。测试夹具（withTempHome、withFakeApp、withFakePlist）确保每个测试都不会触碰你真实的个人目录。

参与贡献

非常欢迎贡献。请阅读贡献指南，然后：

1. Fork 仓库并创建功能分支
2. 进行修改（每个 PR 聚焦一件事，便于审阅）
3. 运行 swift test
4. 提交 Pull Request

这里还有一个开放的功能投票：为你希望接下来构建的工具点 👍。

许可证

BSD 3-Clause。详见 LICENSE。你可以使用、修改和再分发本代码，但须保留版权与许可证文本，且未经许可不得使用“Mac Sai”名称或贡献者姓名为衍生产品背书。

致谢

灵感来自开源 Mac 实用工具社区：

• Pearcleaner：应用卸载模式
• Mole：清理类别
• Tencent Lemon Cleaner：模块化架构
• 方形化树状图算法，作者 Bruls、Huizing 与 van Wijk（2000）

支持与赞助

Mac Sai 免费，并且会一直免费：没有付费版，没有广告，没有追踪。如果它帮你省下了一笔清理软件的订阅费，欢迎请我喝杯咖啡 ☕，或成为会员。这能让每个版本继续保持签名、公证，并持续更新。

支持者

会员可以看到幕后开发动态、提前了解每个版本、自愿试用测试版，名字也会出现在应用里。应用里没有任何功能需要会员才能使用。

还没有会员。 来做第一个 →
_{Power User 和 Team 会员会在这里致谢。所有支持者都列在 SUPPORTERS.md（英文）。}

赞助位

Mac Sai 只有一个赞助位，展示在这里和本页顶部，覆盖本 README 的所有语言版本。

访客以开发者和 Mac 重度用户为主，主要来自 Google 搜索，其次是 YouTube、GitHub 和 Reddit。

• 同一时间只有一位赞助者，你的名字不会淹没在一堆 logo 里。
• 经过筛选。 开发者工具、隐私与安全产品，以及尊重用户的 Mac 应用。不接受清理或"优化"类软件、加密货币、VPN 推广分成，以及任何追踪用户的产品。
• 绝不进入应用内。 Mac Sai 没有广告、没有遥测，任何赞助都不会改变这一点。

这个位置目前空缺。 成为赞助者 →
_{受众详情和申请方式：SPONSORS.md（英文）}

Star 历史

Mac Sai 是由社区、为社区打造的免费软件。
如果它帮你省下了一笔订阅费，点个 ⭐ 能帮助更多人发现它，请杯咖啡 ☕ 能让它走得更远。