momenbasel--puremac/docs

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

PureMac

免費、開源的 macOS 應用程式管理與系統清理工具。
徹底解除安裝應用程式。尋找孤立檔案。清理系統垃圾。
無訂閱。無遙測。無資料收集。

安裝 - 功能 - 螢幕截圖 - 貢獻

---

安裝

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、Team Identifier、Spotlight 中繼資料、容器探索)
• 3 種靈敏度:Strict(安全)、Enhanced(平衡)、Deep(徹底)
• 顯示所有相關檔案:快取、偏好設定、容器、記錄、支援檔案、啟動代理
• 系統應用程式保護 — 排除 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
• 自動沿用系統淺色/深色模式
• 不使用自訂漸層、光暈或網頁風格樣式
• 首次啟動時提供完整磁碟存取權的設定流程

安全性

• 所有破壞性操作前皆會顯示確認對話框
• 符號連結攻擊防護 — 刪除前先解析並驗證路徑
• 系統應用程式保護 — Apple 應用程式無法被解除安裝
• 大型與舊檔案永遠不會被自動勾選
• AI 提示與對話歷史記錄會顯示供使用者檢視，但永遠不會自動勾選
• 透過 os.log 進行結構化記錄(可在「主控台」App 中檢視)

螢幕截圖

引導	應用程式解除安裝

系統垃圾	Xcode 垃圾

使用者快取

架構

PureMac/
  Logic/Scanning/     - 啟發式掃描引擎、位置資料庫、條件
  Logic/Utilities/    - 結構化記錄
  Models/             - 資料模型、型別化錯誤
  Services/           - 掃描引擎、清理引擎、排程器
  ViewModels/         - 集中式應用程式狀態
  Views/              - 原生 SwiftUI 視圖
    Apps/             - 應用程式解除安裝視圖
    Cleaning/         - 智慧掃描與分類視圖
    Orphans/          - 孤立檔案搜尋
    Settings/         - 以原生 Form 為基礎的設定
    Components/       - 共用元件

核心元件:

• AppPathFinder — 用於發現應用程式相關檔案的 10 層啟發式比對引擎
• Locations — 120 組以上的 macOS 檔案系統搜尋路徑
• Conditions — 針對特殊情況(Xcode、Chrome、VS Code 等)的 25 條應用程式比對規則
• AppInfoFetcher — 以 Spotlight 中繼資料搭配 Info.plist 作為後備的應用程式發現
• Logger — 以 Apple os.log 為基礎的整合式記錄

貢獻

歡迎參與貢獻。請參閱 CONTRIBUTING.md 了解指引。

特別歡迎協助的方向:

• 分類視圖中的大小/日期篩選預設值
• AppState 與掃描引擎的 XCTest 覆蓋率
• 本地化(其他語言)
• 應用程式圖示設計

授權

MIT 授權。詳情請參閱 LICENSE。