+
-
+
- 
+
@@ -18,45 +24,45 @@
- Reclaim your Mac.
- Free, open-source uninstaller and cleaner for macOS. No subscription, no telemetry, no upsell.
+ 夺回你的 Mac。
+ 免费、开源的 macOS 卸载与清理工具。无订阅、无遥测、无推销。
- 
- Install - - Why this exists - - How it compares - - Our promise - - What it does - - Permissions - - Contributing + 安装 - + 为何存在 - + 对比 - + 我们的承诺 - + 功能 - + 权限 - + 贡献
- Want more open source? Try Pesty - a free, native clipboard manager for macOS. + 想要更多开源软件？试试 Pesty — 一款免费、原生的 macOS 剪贴板管理器。
--- -## Install +## 安装 ```bash brew install --cask puremac ``` -Or download the signed, notarized `.dmg` from [Releases](https://github.com/momenbasel/PureMac/releases/latest) and drag PureMac into `/Applications`. No Gatekeeper warnings, no quarantine workaround. +或从 [Releases](https://github.com/momenbasel/PureMac/releases/latest)) 下载已签名、已公证的 `.dmg`，将 PureMac 拖入 `/Applications`。无 Gatekeeper 警告，无需隔离属性变通。 -### Build from source +### 从源码构建 ```bash brew install xcodegen @@ -68,90 +74,90 @@ xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release \ open build/Build/Products/Release/PureMac.app ``` -## How it compares +## 对比 | | **PureMac** | CleanMyMac | Pearcleaner | Mole | OnyX | |---|:---:|:---:|:---:|:---:|:---:| -| Price | **Free** | $40+/yr | Free | CLI free / GUI paid | Free | -| Open source | **Yes (MIT)** | No | Source-available¹ | CLI only | No | -| Native Mac GUI | **Yes** | Yes | Yes | Terminal-first | Yes | -| No telemetry | **Yes** | No | Yes | Yes | Yes | -| No subscription | **Yes** | No | Yes | — | Yes | -| Signed + notarized | **Yes** | Yes | Yes | — | Yes | -| App uninstaller + orphans | **Yes** | Yes | Yes | Partial | No | -| Trash-only (recoverable) | **Yes** | Partial | Yes | Partial | No | -| Honest about purgeable space | **Yes** | No | n/a | n/a | n/a | +| 价格 | **免费** | $40+/yr | 免费 | CLI 免费 / GUI 付费 | 免费 | +| 开源 | **是（MIT）** | 否 | 源码可用¹ | 仅 CLI | 否 | +| 原生 Mac GUI | **是** | 是 | 是 | 以终端为主 | 是 | +| 无遥测 | **是** | 否 | 是 | 是 | 是 | +| 无订阅 | **是** | 否 | 是 | — | 是 | +| 签名 + 公证 | **是** | 是 | 是 | — | 是 | +| 应用卸载器 + 孤儿文件 | **是** | 是 | 是 | 部分 | 否 | +| 仅移至废纸篓（可恢复） | **是** | 部分 | 是 | 部分 | 否 | +| 如实说明可清除空间 | **是** | 否 | n/a | n/a | n/a | -¹ Pearcleaner is Apache 2.0 **+ Commons Clause** - source-available but not OSI-approved (you may not sell it). PureMac is true MIT. Comparison reflects publicly documented features as of 2026; corrections welcome via PR. +¹ Pearcleaner 采用 Apache 2.0 **+ Commons Clause** — 源码可用但未经 OSI 批准（不得出售）。PureMac 为真正的 MIT。对比反映截至 2026 年公开记录的功能；欢迎通过 PR 更正。 -## Our promise +## 我们的承诺 -A Mac cleaner asks for the deepest permission macOS grants - Full Disk Access - and then deletes your files. That demands a level of trust the category has spent twenty years burning. Here's the contract PureMac holds itself to, and you can verify every line of it in the source: +Mac 清理工具会请求 macOS 授予的最高权限 — 完全磁盘访问权限（Full Disk Access）— 然后删除你的文件。这要求一种信任，而该品类二十年来一直在消耗这种信任。以下是 PureMac 对自身恪守的契约，你可以在源码中逐行验证： -- **Trash, never `rm`.** Everything PureMac removes goes to the Trash via `FileManager.trashItem`. If it was wrong, you drag it back. Nothing is shredded or unlinked. -- **No telemetry, ever.** No analytics, no crash reporting, no "anonymous usage stats," no network calls to us. The app doesn't know you exist. -- **No fake urgency.** No dramatized "47 GB of junk detected!" badge, no red alarm counters, no "your Mac is at risk." We show you neutral facts and let you decide. -- **No overpromising.** We don't claim to "reclaim purgeable space," "boost RAM," or "speed up your Mac" - things no app can reliably do. See the purgeable-space note below. -- **You review before anything is removed.** Nothing is auto-deleted. Every item shows its real path with Reveal-in-Finder, and high-risk system paths are hard-excluded in code. -- **Auditable.** It's MIT. The exact code that decides what gets removed is in [`PureMac/Services`](PureMac/Services) and [`PureMac/Logic/Scanning`](PureMac/Logic/Scanning). Read it. Fork it. Ship your own. +- **废纸篓，绝不 `rm`。** PureMac 移除的一切均通过 `FileManager.trashItem` 进入废纸篓。若误删，拖回来即可。不会粉碎或 unlink。 +- **永不遥测。** 无分析、无崩溃上报、无「匿名使用统计」、不向我们的服务器发起网络请求。应用不知道你的存在。 +- **不搞虚假紧迫感。** 不会 dramatize「检测到 47 GB 垃圾！」徽章、红色警报计数或「你的 Mac 处于风险中」。我们展示中性事实，由你决定。 +- **不过度承诺。** 我们不声称能「回收可清除空间」「提升 RAM」或「加速你的 Mac」— 这些没有应用能可靠做到。见下方可清除空间说明。 +- **删除前由你审阅。** 不会自动删除。每项显示真实路径并支持在 Finder 中显示（Reveal-in-Finder），高风险系统路径在代码中硬排除。 +- **可审计。** MIT 许可。决定删除内容的代码位于 [`PureMac/Services`](PureMac/Services) 与 [`PureMac/Logic/Scanning`](PureMac/Logic/Scanning)。阅读它。Fork 它。发布你自己的版本。 -If PureMac ever adds telemetry, a paywall on core features, or a fear-based scan, it will have become the thing it was built to replace. Hold us to this. +若 PureMac 日后增加遥测、对核心功能设付费墙或进行基于恐惧的扫描，它将成为它所要取代的那种东西。请监督我们恪守此承诺。 -## Why this exists +## 为何存在 -Apple sells base-model Macs with 256 GB SSDs that you can't upgrade. The Mac mini, the Air, every entry-level MacBook Pro - the drive is soldered down. The next storage tier costs more than a midrange Windows laptop. Once you've paid it, every gigabyte you've already bought matters. +Apple 销售基础款 Mac，配备 256 GB SSD 且无法升级。Mac mini、Air、每一款入门 MacBook Pro — 硬盘焊死。下一档存储价格比中端 Windows 笔记本还贵。一旦付费，你已购买的每一 GB 都弥足珍贵。 -Most Mac cleaners are subscription apps that hide their disk usage behind a paywall, ship telemetry by default, and trade on FUD ("47 GB of junk detected!"). PureMac is the opposite: +多数 Mac 清理工具是订阅应用，将磁盘占用藏在付费墙后，默认携带遥测，并靠 FUD（恐惧、不确定、怀疑）交易（「检测到 47 GB 垃圾！」）。PureMac 相反： -- **One-time install.** No subscription, no trial, no account. -- **No telemetry.** It never phones home. It doesn't even know you exist. -- **Open source under MIT.** Read the code, fork it, audit it. -- **Honest scans.** "Junk" means actually-junk: cache directories the OS itself would purge, orphaned files left by apps you've already deleted, broken installer receipts, that 4 GB Xcode DerivedData blob from 2023. -- **Real uninstalls.** Drag an app, see every preference plist, cache folder, container, launch agent and log file it dropped across your library, remove all of it at once. +- **一次安装。** 无订阅、无试用、无账户。 +- **无遥测。** 从不回传数据。甚至不知道你的存在。 +- **MIT 开源。** 阅读代码、Fork、审计。 +- **诚实扫描。** 「垃圾」指真正的垃圾：OS 本身会清除的缓存目录、你已删除应用遗留的孤儿文件、损坏的安装收据、2023 年那个 4 GB 的 Xcode DerivedData 块。 +- **真正卸载。** 拖入一个应用，查看它在你资料库中留下的每个偏好 plist、缓存文件夹、容器、启动代理与日志文件，一次性全部移除。 -## What it does +## 功能 -### App Uninstaller -Discovers everything in `/Applications` and `~/Applications`, then uses a 10-level matching engine (bundle ID, team identifier, entitlements, Spotlight metadata, container discovery, company-name heuristics, partial path matches) to find every file the app dropped on your disk. Three sensitivity tiers - Strict, Enhanced, Deep - let you choose how aggressive that match is. Apple system apps are excluded from the uninstall list automatically. You can also right-click any app in Finder and choose **Services → Uninstall with PureMac** to jump straight into its related-files scan. +### 应用卸载器 +发现 `/Applications` 与 `~/Applications` 中的一切，然后使用 10 级匹配引擎（bundle ID、团队标识符、entitlements、Spotlight 元数据、容器发现、公司名启发式、部分路径匹配）查找应用在磁盘上留下的每个文件。三种敏感度档位 — Strict、Enhanced、Deep — 让你选择匹配的激进程度。Apple 系统应用自动从卸载列表排除。你也可在 Finder 中右键任意应用，选择 **Services → Uninstall with PureMac** 直接进入相关文件扫描。 -### Orphan Finder -Walks `~/Library` and surfaces files left behind by apps that no longer exist on disk. The matcher compares against bundle identifiers and normalized names of every installed app, so a leftover `~/Library/Containers/com.foo.bar` from an app you deleted in 2022 shows up clearly. +### 孤儿文件查找器 +遍历 `~/Library` 并列出磁盘上已不存在应用遗留的文件。匹配器对照每个已安装应用的 bundle 标识符与规范化名称比对，因此你 2022 年删除某应用后遗留的 `~/Library/Containers/com.foo.bar` 会清晰显示。 -### System Cleaner -Smart Scan runs every category in parallel. Each category is its own deliberate scanner: +### 系统清理器 +智能扫描（Smart Scan）并行运行每个类别。每个类别均为独立、审慎的扫描器： -- **System Junk** - system caches, logs, temp files -- **User Cache** - dynamically discovered, no hardcoded app list -- **AI Apps** - Ollama and LM Studio logs, caches, opt-in history cleanup -- **Mail Files** - downloaded mail attachments -- **Trash Bins** - empties all bins, including external volumes -- **Large & Old Files** - >100 MB or older than 1 year (never auto-selected) -- **Xcode Junk** - DerivedData, Archives, simulator caches -- **Brew Cache** - respects custom `HOMEBREW_CACHE` -- **Node Cache** - npm, yarn classic, pnpm content-addressable store -- **Docker Cache** - images, containers, build cache +- **系统垃圾** — 系统缓存、日志、临时文件 +- **用户缓存** — 动态发现，无硬编码应用列表 +- **AI 应用** — Ollama 与 LM Studio 日志、缓存，可选历史清理 +- **邮件文件** — 已下载的邮件附件 +- **废纸篓** — 清空所有废纸篓，包括外置卷 +- **大文件与旧文件** — >100 MB 或超过 1 年（永不自动选中） +- **Xcode 垃圾** — DerivedData、Archives、模拟器缓存 +- **Brew 缓存** — 尊重自定义 `HOMEBREW_CACHE` +- **Node 缓存** — npm、yarn classic、pnpm 内容寻址存储 +- **Docker 缓存** — 镜像、容器、构建缓存 -> **On "purgeable space":** PureMac shows your APFS purgeable space in the storage breakdown for transparency, but it deliberately does **not** list it as junk to delete. Purgeable space is reserved and reclaimed by macOS itself - no third-party app can reliably free it, and even the Finder's purgeable figure is known to be inaccurate. Cleaners that claim to "reclaim purgeable space" are overpromising. We'd rather be honest than impressive. +> **关于「可清除空间」：** PureMac 在存储分解中显示你的 APFS 可清除空间（purgeable space）以保持透明，但刻意**不**将其列为待删垃圾。可清除空间由 macOS 自身保留与回收 — 第三方应用无法可靠释放，连 Finder 的可清除数字也已知不准确。声称能「回收可清除空间」的清理工具属于过度承诺。我们宁愿诚实，也不愿显得厉害。 -### Scheduled Cleaning -Optional. Configurable interval (hourly to monthly), with auto-clean threshold so background runs only fire when there's something meaningful to remove. +### 定时清理 +可选。可配置间隔（从每小时到每月），并设有自动清理阈值，因此后台任务仅在有值得移除的内容时才会触发。 -## Permissions +## 权限 -PureMac needs **Full Disk Access** to read the locations macOS hides from every app by default - Mail downloads, Safari data, the TCC database, protected app containers. Without it, the cleanup categories miss roughly 70% of what they could find and app uninstalls leave behind everything in `~/Library/Containers`. +PureMac 需要**完全磁盘访问（Full Disk Access）**权限，才能读取 macOS 默认对所有应用隐藏的目录——邮件下载、Safari 数据、TCC 数据库、受保护的应用容器。没有该权限时，清理类别大约只能发现其可能找到内容的 70%，应用卸载后也会将 `~/Library/Containers` 中的内容全部遗留。 -The first-launch onboarding walks you through granting it with an animated preview of the exact toggle you need to flip. If you skip it, the dashboard surfaces a single-click "Set up" pill. If a cleanup fails because of a permission issue, PureMac opens System Settings, reveals its bundle in Finder so you can drag it into the FDA list, polls the permission state every second, and auto-retries the failed batch the moment you grant access. You never have to re-select anything. +首次启动引导会通过动画预览，逐步引导你授予该权限，并展示你需要拨动的确切开关。如果跳过，仪表盘会显示一键式「Set up」药丸按钮。如果因权限问题导致清理失败，PureMac 会打开系统设置，在 Finder 中显示其 bundle，以便你将其拖入 FDA 列表，每秒轮询权限状态，并在你授予访问权限的瞬间自动重试失败的批次。你无需重新选择任何内容。 -What PureMac does *not* do: -- It does not collect telemetry, crash reports, or usage analytics. -- It does not require a network connection to operate. -- It does not move data anywhere except the Trash. +PureMac *不会*做的事： +- 不收集遥测数据、崩溃报告或使用分析。 +- 运行不需要网络连接。 +- 除废纸篓外，不会将数据移动到任何其他地方。 -## Troubleshooting +## 故障排除 -### Launchpad / Dock shows a stale or dull PureMac icon +### Launchpad / Dock 显示陈旧或发暗的 PureMac 图标 -macOS aggressively caches app icons in LaunchServices. After a Homebrew **reinstall or upgrade** the Dock and Launchpad can keep showing the old cached icon. PureMac's cask now runs `lsregister -f` on install to refresh it automatically, but if a stale icon persists, reset the cache manually: +macOS 会在 LaunchServices 中积极缓存应用图标。Homebrew **重新安装或升级**后，Dock 和 Launchpad 可能仍显示旧的缓存图标。PureMac 的 cask 现在在安装时会运行 `lsregister -f` 以自动刷新，但如果陈旧图标仍然存在，请手动重置缓存： ```bash # Clear the icon caches and rebuild the LaunchServices database @@ -162,23 +168,23 @@ sudo find /private/var/folders/ \( -name com.apple.dock.iconcache -or -name com. killall Dock; killall Finder ``` -Give it a minute to re-seed, then open PureMac once. If it still sticks, a restart (or Safe Mode boot) forces a full rebuild. +给它一分钟重新播种，然后打开一次 PureMac。如果仍然卡住，重启（或安全模式启动）会强制完整重建。 -## Screenshots +## 截图 -| Onboarding | App Uninstaller | +| 引导 | 应用卸载器 | |---|---| |  |  | -| System Junk | Xcode Junk | +| 系统垃圾 | Xcode 垃圾 | |---|---| |  |  | -| User Cache | +| 用户缓存 | |---| |  | -## Architecture +## 架构 ``` PureMac/ @@ -194,48 +200,48 @@ PureMac/ Settings/ - Native Form-based settings ``` -Key components: -- **AppPathFinder** - 10-level heuristic matching engine for discovering app-related files -- **Locations** - 120+ macOS filesystem search paths -- **Conditions** - 25 per-app matching rules for edge cases (Xcode, Chrome, VS Code, etc.) -- **PermissionCoordinator** - Single source of truth for FDA prompts, polling, and post-grant retries -- **FullDiskAccessManager** - TCC probe + registration; broad probe paths (Mail, Safari, Messages, AddressBook, Calendars) so macOS catalogs the bundle reliably -- **CleaningEngine** - Symlink-resistant deletion with an allow-list, NSAppleScript-based admin escalation for root-owned items, NUL-separated path staging for xargs +关键组件： +- **AppPathFinder** - 10 级启发式匹配引擎，用于发现与应用相关的文件 +- **Locations** - 120+ 个 macOS 文件系统搜索路径 +- **Conditions** - 25 条按应用划分的匹配规则，用于处理边缘情况（Xcode、Chrome、VS Code 等） +- **PermissionCoordinator** - FDA 提示、轮询以及授权后重试的单一事实来源 +- **FullDiskAccessManager** - TCC 探测 + 注册；广泛的探测路径（Mail、Safari、Messages、AddressBook、Calendars），以便 macOS 可靠地编目 bundle +- **CleaningEngine** - 抗符号链接删除，带允许列表；对 root 拥有的项目通过基于 NSAppleScript 的管理员提权；为 xargs 使用 NUL 分隔的路径暂存 -## Security +## 安全 -- Symlink attack prevention: paths are resolved before validation, re-resolved immediately before unlink to close TOCTOU windows. -- Allow-list cleaning: a path that doesn't sit inside an explicit safe-root is refused, even for the user-level pass. -- Admin escalation is gated by a *narrower* allow-list (app bundles, package receipts, launch plists) than the normal cleaner — root-owned items can only be removed inside those roots. -- System app protection: Apple's bundles cannot be uninstalled, regardless of selection. -- All destructive operations require explicit confirmation by default. The toggle that disables that confirmation is buried in Settings. +- 符号链接攻击防护：路径在验证前解析，在 unlink 前立即重新解析，以关闭 TOCTOU 窗口。 +- 允许列表清理：不在显式安全根目录内的路径会被拒绝，即使用户级清理也不例外。 +- 管理员提权由*更窄*的允许列表（应用 bundle、package receipts、launch plists）把关，比普通清理器更严格——root 拥有的项目只能在这些根目录内移除。 +- 系统应用保护：无论是否选中，Apple 的 bundle 都无法卸载。 +- 所有破坏性操作默认需要明确确认。禁用该确认的开关深藏在设置中。 -If you find a vulnerability, please open a private security advisory rather than a public issue. +如发现漏洞，请提交私有安全公告，而非公开 issue。 -## Contributing +## 贡献 -Pull requests welcome. See [CONTRIBUTING.md](CONTRIBUTING.md). +欢迎 Pull request。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。 -Especially welcome: -- Per-category size and date filter presets -- Wider XCTest coverage for `AppState` and the scan engine -- Translations beyond the current set (en, ar, es, ja, pt-BR, zh-Hans, zh-Hant) -- App icon design +特别欢迎： +- 按类别划分的体积与日期筛选预设 +- 为 `AppState` 和扫描引擎提供更广泛的 XCTest 覆盖 +- 除当前语言集（en、ar、es、ja、pt-BR、zh-Hans、zh-Hant）之外的翻译 +- 应用图标设计 -## Acknowledgments +## 致谢 -- **[@nguyenhuy158](https://github.com/nguyenhuy158)** - Search and filter feature ([#18](https://github.com/momenbasel/PureMac/issues/18), [#29](https://github.com/momenbasel/PureMac/pull/29)) -- **[@edufalcao](https://github.com/edufalcao)** - Cleaning safety guards and confirmation dialogs ([#30](https://github.com/momenbasel/PureMac/pull/30)) -- **[@zeck00](https://github.com/zeck00)** - UI overhaul ([#31](https://github.com/momenbasel/PureMac/pull/31)), app uninstaller with system app protection ([#32](https://github.com/momenbasel/PureMac/pull/32)), onboarding experience ([#33](https://github.com/momenbasel/PureMac/pull/33)) -- **[@0x-man](https://github.com/0x-man)** - Symlink security vulnerability report ([#25](https://github.com/momenbasel/PureMac/issues/25)) -- **[@ansidev](https://github.com/ansidev)** - Checkbox interaction bug report ([#34](https://github.com/momenbasel/PureMac/issues/34)) -- **[@fengcheng01](https://github.com/fengcheng01)** - App uninstaller feature request ([#28](https://github.com/momenbasel/PureMac/issues/28)) -- **[@scholzfuni](https://github.com/scholzfuni)** - Modularization proposal ([#23](https://github.com/momenbasel/PureMac/issues/23)) -- **[@Zonharo](https://github.com/Zonharo)** - In-app auto-update request ([#94](https://github.com/momenbasel/PureMac/issues/94)) +- **[@nguyenhuy158](https://github.com/nguyenhuy158)** - 搜索与筛选功能 ([#18](https://github.com/momenbasel/PureMac/issues/18), [#29](https://github.com/momenbasel/PureMac/pull/29)) +- **[@edufalcao](https://github.com/edufalcao)** - 清理安全保护与确认对话框 ([#30](https://github.com/momenbasel/PureMac/pull/30)) +- **[@zeck00](https://github.com/zeck00)** - UI 大改版 ([#31](https://github.com/momenbasel/PureMac/pull/31)), 带系统应用保护的应用卸载器 ([#32](https://github.com/momenbasel/PureMac/pull/32)), 引导体验 ([#33](https://github.com/momenbasel/PureMac/pull/33)) +- **[@0x-man](https://github.com/0x-man)** - 符号链接安全漏洞报告 ([#25](https://github.com/momenbasel/PureMac/issues/25)) +- **[@ansidev](https://github.com/ansidev)** - 复选框交互缺陷报告 ([#34](https://github.com/momenbasel/PureMac/issues/34)) +- **[@fengcheng01](https://github.com/fengcheng01)** - 应用卸载器功能请求 ([#28](https://github.com/momenbasel/PureMac/issues/28)) +- **[@scholzfuni](https://github.com/scholzfuni)** - 模块化方案 ([#23](https://github.com/momenbasel/PureMac/issues/23)) +- **[@Zonharo](https://github.com/Zonharo)** - 应用内自动更新请求 ([#94](https://github.com/momenbasel/PureMac/issues/94)) -## Star History +## Star 历史 -If PureMac saved you some disk space, a star helps other people find it. +如果 PureMac 帮你腾出了磁盘空间，点个 star 能帮助其他人发现它。