功能文件

概覽

Mole 有 Mac App 和 CLI 兩種使用方式，涵蓋相近的清理類別，也遵循同樣保守的安全原則與保護清單，但能力範圍並不完全相同。CLI 免費開源，採用 GPL-3.0 授權。Mac App 是原生 SwiftUI 應用，一次購買 $19，包含永久更新，無訂閱；它用原生方式執行 Mac 工作流程，CLI 額外提供幾個終端專屬指令。

Mac App

安裝

從首頁下載 DMG，或透過 Homebrew 安裝：brew install --cask mole-app。

清理 (Earth)

掃描 10 個類別：App 快取、系統快取與日誌、開發工具（Xcode、npm、pip、Gradle）、AI 工具（ChatGPT、Claude、Codex、Copilot、Cursor、Antigravity）、瀏覽器（Chrome、Edge、Arc、Safari、Firefox）、雲端儲存用戶端、設計工具（Adobe、Figma、Sketch）、通訊工具（Slack、Discord、微信、Zoom）和雜項暫存檔。垃圾桶單獨列在末尾。

審查列表按刪除影響排序：可再生快取在前，使用者可見狀態在後，垃圾桶始終最末。硬連結感知意味著跨工具共享的檔案（uv、pnpm）不會重複計算。預設永久刪除快取，讓釋放的空間和標題裡的數字一致。設定裡一個開關可以把所有操作改為移到垃圾桶。

預設需要檢視：重建成本較高的套件快取（npm、yarn、pnpm、bun、CocoaPods、Gradle、Maven），以及無需下載相依套件即可重建的專案產物（build、dist、target、.build、.next、DerivedData、__pycache__、coverage）。Mac App 不會列出 node_modules、Pods、venv 等下載相依套件目錄，因為重新產生需要網路，也可能無法還原鎖定檔對應的狀態。需要檢視的項目預設不選取；想保留可復原的餘地，可在設定 → 維護 → 快取刪除方式中選擇「移到垃圾桶」。

軟體 (Mars)

Software 把 App 更新、啟動項管理和移除清理放在一起。Updates 視圖會檢查 Sparkle、Homebrew Cask / Formula、Mac App Store App，支援的更新可在 App 內安裝；macOS 要求跳轉時會明確開啟 App Store。

Startup 視圖會列出 Login Items、Launch Agents、Launch Daemons 和背景項。支援的條目可以直接停用，也可以顯示檔案位置；Apple 管理的條目會引導到系統設定。

移除時選擇要移除的 App，Mole 會在十五個以上的 Library 子目錄裡查找殘留，包括 Application Support、Caches、Preferences、Logs、Launch Agents、Launch Daemons、Login Items、Containers、Group Containers、Saved Application State 和 Input Methods。Dock 條目會自動清理，模糊或弱匹配的殘留會保留在列表中但預設不勾選，方便先審查。

更新盡量在 App 內完成：Sparkle 和 Homebrew Cask 都在 Mole 裡直接安裝；Mac App Store 走 CommerceKit，授權或逾時失敗時再回退到 App Store；其他 App 會被開啟，交給它們自己的更新器接手。Cmd 點擊可以把多個 App 加進同一批移除，單項失敗的會保留在列表裡方便重試。

移除根目錄 /Applications/*.app 的 root 所有 bundle 時，同一次執行期間只需授權一次管理員，之後不再重複要密碼。Startup 視圖裡，能匹配到穩定 launchd 服務的登入項和已通過校驗的 LaunchAgents / LaunchDaemons 由 Mole 直接切換；macOS 背景工作管理裡沒有清晰句柄的條目，則跳轉到對應的系統設定頁面。

最佳化 (Mercury)

預設維護工作，一鍵執行。非管理員工作靜默執行，需要管理員權限的工作會合併到一次授權裡。

Optimize 會先執行一段看得見的「修小毛病」流程，重啟 Dock、輸入法切換、iCloud Drive 同步、隔空投送、聚焦、通知中心等能自行恢復的系統服務。深度工作包括：重建 Quick Look、字型快取和 Launch Services 垃圾回收；壓縮 SQLite 資料庫；清理 saved state、隔離事件和通知歷程；修復損壞的偏好設定、Launch Agent、共享檔案列表和孤立 Spotlight 規則；審查登入項；執行 periodic maintenance。

安全門控會跳過不合適的工作：瀏覽器開啟時跳過字型快取重建；DNS 或網路堆疊重置不屬於預設維護集合。

偵測到 VPN 活躍、藍牙 HID 或音訊、外接顯示器或音訊裝置時，Optimize 也會主動跳過會更動裝置狀態的工作；被跳過項在結果面板裡給出原因，方便複核執行清單。

分析 (Jupiter)

整顆磁碟的 Treemap 視覺化。逐層下鑽任意目錄，查看每個層級的大小；密集或相近大小的項目會合併成摘要區塊，避免地圖變成滿滿一片碎片。

無法取得大小的條目（權限受限目錄、TCC 保護容器）會顯示重試選項，而非靜默丟棄。根級保護目錄（/、/Users、/Applications）不可刪除。掃描結果快取 24 小時，方便之後快速回查。

Treemap 上單擊某個目錄就能下鑽進去，上方的 Breadcrumb 可以跳回任意一級。左側列表和真實 Treemap 色塊都保留項目操作：打開或在 Finder 中顯示，右鍵「移到垃圾桶」並確認；摘要區塊只用於概覽。Treemap 上每個色塊的面積按位元組比例分配，所以佔空間最大的那幾個永遠在視覺上最顯眼。

狀態 (Sun)

一個 bento 儀表板集中展示健康評分、CPU、記憶體、GPU、磁碟 I/O、網路、電池或溫度，以及依硬體切換的風扇或溫度卡片。每項指標附帶 60 秒迷你圖，支援的 Mac 會顯示自動、降溫、強冷三種風扇控制。

下方處理程序列表每秒更新。點擊欄頭（名稱、CPU、記憶體）排序。點擊某行將它釘選，重新整理時保持可見，方便持續監控特定處理程序。

五欄（名稱、PID、CPU、Power、記憶體）都支援點擊排序，再點一次切換升降序。右鍵某行可以選擇 Pin / 取消釘選（跨重新整理、跨重啟都保留）、Terminate（先發 TERM，必要時回退到 KILL）、複製可執行檔路徑。Battery 卡片裡的 Top Drain 列可以直接點開，跳到對應處理程序的解釋面板。

選單列 HUD

常駐 macOS 選單列的可選監視器。可以選擇即時指標、精簡圖示，或隨系統負載變化的小動物運動。彈層顯示硬體卡片、支援裝置上的風扇控制、高負載處理程序和 Clean Watch 摘要。

彈層底部是常用工具：相機或麥克風被佔用時會有隱私指示燈，Keep Screen On 可選時長，Clean Screen 會把螢幕變成純色，方便擦螢幕和鍵盤（可選輔助使用輸入鎖）；偵測到可退出的外接磁碟或磁碟映像時，這裡也會出現 Eject 按鈕。全域快捷鍵隨處喚出 Mole，隱藏 Dock 圖示後即成純選單列 App，整體在設定 → 選單列中設定。

按 App 關閉隱私提醒。通知裡出現 App 名稱時，將游標移到 macOS 通知上，選擇「不再提醒此 App」。之後可在「設定 → 選單列 → 通知 → 不再提醒的 App」恢復。純相機提醒不會顯示 App 名稱，因為 macOS 不提供使用相機的 App 身分，所以 Mole 不會給這類通知顯示按 App 關閉操作。

顯示模式可在「小動物動畫」和「雙列指標」之間切換。兩列指標可以分別從 CPU、記憶體、溫度、磁碟、網路裡挑選一項獨立顯示。小動物角色只是外觀差異，不影響指標取樣。

診斷

選單列 Help → 執行診斷…。Mole 產生只讀的精簡報告，涵蓋 Mac 型號、macOS 版本、權限、近期操作、顯示器、外接磁碟區、網路、安全狀態和執行環境。點 複製報告 可以貼到對話；點 複製終端機指令 可以產生完整支援包並私下寄信排查。

診斷會檢測五種狀況：完全磁碟取用權限缺失、記憶體壓力偏高、磁碟使用超過 90%、操作日誌不可寫入、近期操作失敗。每種狀況連結到對應的 說明頁面 解決步驟。

設定

設定有三個分頁。通用：介面語言（重啟後生效）、登入時啟動、隱藏 Dock 圖示、授權啟用與裝置管理，以及完全磁碟存取的快捷入口。維護：快取刪除方式和保護清單。電池養護在支援的 Mac 上運行時把內建電池維持在 75% 到 80%，減緩老化，需一次管理員授權。選單列：開啟選單列監視器、在小動物和指標間切換、選擇顯示指標、設定支援裝置上的風扇行為，並為「選單列開關 / Keep Screen On / Clean Screen」錄製快速鍵。授權啟用也可隨時用 Cmd + Shift + L 開啟。

CLI

安裝

透過 Homebrew：brew install mole。透過腳本：curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash。執行 mo 開啟互動式選單，或直接使用子指令。

共享指令（Mac App 也有）

mo clean

和 Mac App 相同的 10 類深度清理。支援 --dry-run 預覽、--debug 詳細日誌、--whitelist 管理受保護快取。自動跳過執行中 App 的快取。

mo uninstall

互動式 App 選擇 + 殘留偵測。顯示 App 大小、bundle ID 和最後使用日期。查找和 Mac App 相同的十五類以上殘留目錄。支援 --dry-run。

mo optimize

執行 CLI 維護工作，需要管理員權限的工作會提示輸入密碼。它的具體工作集合可能和 Mac App 預設 Optimize 列表不同。支援 --whitelist 排除特定工作。

mo analyze

終端內互動式 Treemap。方向鍵或 Vim 鍵位（h/j/k/l）導覽。可直接從地圖刪除檔案。支援 --json 輸出和自訂路徑，如 mo analyze /Volumes 分析外接磁碟。

mo status

即時系統儀表板：CPU、GPU、記憶體、磁碟 I/O、網路、電池、溫度、運行時間、健康評分和前幾名處理程序，附帶 60 秒迷你圖。支援 --json 輸出，方便串接到其他工具。

CLI 獨有指令

mo purge

查找專案目錄裡的舊建置產物：node_modules、target、.build、build、dist、venv。掃描可設定的路徑（預設：~/Projects、~/GitHub、~/dev）。7 天內的專案標記為 "Recent"，預設不選取。支援 --dry-run 和 --paths 設定掃描目錄。

mo installer

發現下載項目、桌面、Homebrew 快取、iCloud 和郵件附件中的 .dmg、.pkg、.zip 安裝檔。按來源標註每個檔案。支援 --dry-run。

mo touchid

為 sudo 指令啟用 Touch ID。mo touchid enable 開啟，mo touchid disable 關閉。支援 --dry-run。

工具指令

mo completion

設定 Bash 和 Zsh 的 Tab 自動補齊。自動偵測當前 Shell 並更新對應設定檔。

mo update

自動更新到最新穩定版。--nightly 更新到 main 分支最新未發佈建置（僅腳本安裝）。--force 重新安裝當前版本。

mo remove

從系統移除 Mole CLI，包括設定檔和 Shell 整合。支援 --dry-run。

安全

CLI 和 Mac App 共享相同的安全原則：

路徑保護。內建拒絕清單涵蓋系統關鍵目錄、使用者目錄核心結構，以及已知快取位置之外的任何路徑。符號連結在操作前會被解析和驗證。

處理程序感知。執行中 App 的快取在清理時被跳過。瀏覽器開啟時不會清理其快取。

授權門控。Mac App 中每個破壞性工具（清理、移除、最佳化、從分析頁面刪除）可免費使用 2 次，之後需要有效授權。掃描始終免費。

白名單。CLI（~/.config/mole/whitelist）和 Mac App 都支援保護特定快取或最佳化工作，使其在未來執行中被跳過。

操作日誌。每次刪除都記錄在 ~/Library/Logs/mole/operations.log。Mac App 的診斷面板會檢查日誌健康狀態並回報近期失敗。

先預覽。CLI 在每個破壞性指令上支援 --dry-run。Mac App 在任何操作前顯示完整檔案列表和位元組數。

疑難排解

Mac App 內建診斷功能，可檢測常見問題。從選單列 Help → 執行診斷… 開啟。各項檢測的詳細說明見 說明頁面。

CLI 在任何指令後加 --debug 可查看詳細日誌。操作日誌位於 ~/Library/Logs/mole/operations.log。如果指令靜默失敗，檢查系統設定中是否已授予完全磁碟取用權限。

回報問題見說明頁面的 回報問題 部分。