Skip to content

README.zh-Hans.md

Latest commit

 

History

History
160 lines (128 loc) · 6.25 KB

README.zh-Hans.md

File metadata and controls

160 lines (128 loc) · 6.25 KB

PureMac

English | العربية | Español | 日本語 | 简体中文 | 繁體中文

PureMac

免费、开源的 macOS 应用管理器与系统清理工具。
彻底卸载应用。查找孤立文件。清理系统垃圾。
无订阅。无遥测。无数据收集。

最新版本 构建状态 macOS 13.0+ Swift 5.9 MIT 许可证 Stars 下载量

安装 - 功能 - 截图 - 贡献

安装

Homebrew（推荐）

brew update
brew install --cask puremac

直接下载

从 Releases 下载最新的 .dmg，打开后将 PureMac 拖到 /Applications 目录。

已使用 Apple Developer ID 签名并公证 — 安装时不会出现 Gatekeeper 警告。

从源码构建

brew install xcodegen
git clone https://github.com/momenbasel/PureMac.git
cd PureMac
xcodegen generate
xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release -derivedDataPath build build
open build/Build/Products/Release/PureMac.app

功能

应用卸载器

  • 从 /Applications 和 ~/Applications 发现所有已安装应用
  • 基于启发式的文件发现引擎,采用10 级匹配(Bundle ID、公司名称、entitlements、团队标识符、Spotlight 元数据、容器发现)
  • 3 种灵敏度:严格(安全)、增强(平衡)、深度(彻底)
  • 展示所有相关文件:缓存、偏好设置、容器、日志、支持文件、启动代理
  • 系统应用保护 — 排除 27 个 Apple 应用,避免误删
  • 主从视图:左侧为应用列表,右侧为发现的文件

孤立文件查找

  • 检测 ~/Library 中已卸载应用残留的文件
  • 将 Library 内容与所有已安装应用的标识符进行比对
  • 一键清理孤立文件

系统清理

  • 智能扫描 — 一键扫描所有类别
  • 系统垃圾 — 系统缓存、日志和临时文件
  • 用户缓存 — 动态发现所有应用缓存(无需硬编码应用列表)
  • AI 应用 — Ollama 和 LM Studio 日志、缓存，以及可选的本地历史记录清理
  • 邮件附件 — 已下载的邮件附件
  • 废纸篓 — 清空所有废纸篓
  • 大文件与旧文件 — 超过 100 MB 或超过 1 年的文件
  • 可清除空间 — 检测 APFS 可清除磁盘空间
  • Xcode 垃圾 — DerivedData、Archives、模拟器缓存
  • Brew 缓存 — Homebrew 下载缓存(可识别自定义 HOMEBREW_CACHE)
  • 定时清理 — 按可配置的间隔自动扫描

原生 macOS 体验

  • 使用 SwiftUI 和原生 macOS 组件构建
  • NavigationSplitView、Toggle、ProgressView、Form、GroupBox、Table
  • 自动遵循系统浅色/深色模式
  • 无自定义渐变、发光或 Web 应用样式
  • 首次启动引导,支持完整磁盘访问设置

安全性

  • 所有破坏性操作前都有确认对话框
  • 防御符号链接攻击 — 删除前解析并验证路径
  • 系统应用保护 — Apple 应用无法被卸载
  • 大文件与旧文件永远不会被自动选中
  • AI 提示和对话历史记录会显示供用户检查，但永远不会自动选中
  • 通过 os.log 进行结构化日志记录(可在“控制台”应用中查看)

截图

引导 应用卸载器
引导 应用卸载器
系统垃圾 Xcode 垃圾
系统垃圾 Xcode 垃圾
用户缓存
用户缓存

架构

PureMac/
  Logic/Scanning/     - 启发式扫描引擎、位置数据库、条件
  Logic/Utilities/    - 结构化日志
  Models/             - 数据模型、类型化错误
  Services/           - 扫描引擎、清理引擎、调度器
  ViewModels/         - 集中式应用状态
  Views/              - 原生 SwiftUI 视图
    Apps/             - 应用卸载器视图
    Cleaning/         - 智能扫描与分类视图
    Orphans/          - 孤立文件查找
    Settings/         - 基于原生 Form 的设置
    Components/       - 共享组件

核心组件:

  • AppPathFinder — 用于发现应用相关文件的 10 级启发式匹配引擎
  • Locations — 120+ 个 macOS 文件系统搜索路径
  • Conditions — 25 条针对特殊情况的应用级匹配规则(Xcode、Chrome、VS Code 等)
  • AppInfoFetcher — 使用 Spotlight 元数据,并以 Info.plist 作为回退的应用发现
  • Logger — 基于 Apple os.log 的统一日志

贡献

欢迎贡献。请参阅 CONTRIBUTING.md 了解指南。

特别欢迎的贡献方向:

  • 分类视图中的大小/日期过滤器预设
  • AppState 与扫描引擎的 XCTest 覆盖
  • 本地化(其他语言)
  • 应用图标设计

许可证

MIT 许可证。详情请参阅 LICENSE。