功能文件

概覽

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)

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

「啟動項目」視圖會列出 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 時，同一次執行期間只需授權一次管理員，之後不再重複要密碼。「啟動項目」視圖裡，能匹配到穩定 launchd 服務的登入項目和已通過校驗的 LaunchAgents / LaunchDaemons 由 Mole 直接切換；macOS 背景工作管理裡沒有清晰句柄的條目，則跳轉到對應的系統設定頁面。

最佳化 (Mercury)

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

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

安全門控會跳過不合適的工作，每項工作只在確有需要時才執行，DNS 或網路堆疊重置不屬於預設維護集合。

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

分析 (Jupiter)

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

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

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

狀態 (Sun)

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

下方處理程序列表每秒更新。五欄（名稱、PID、CPU、Power、記憶體）都支援點一下排序，再點一次切換升降序。點一下某一列會打開它的說明面板。在某一列按右鍵可以選擇 Pin / 取消釘選（釘選的處理程序在重新整理和重新啟動 App 後都保持在最上方，方便持續盯住某個 App）、Terminate（先發 TERM，必要時回退到 KILL）、複製可執行檔路徑。Battery 卡片裡的 Top Drain 列可以直接點開，跳到對應處理程序的解釋面板。

選單列 HUD

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

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

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

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

診斷

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

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

設定

設定有三個分頁。通用：介面語言（重啟後生效）、登入時啟動、隱藏 Dock 圖示、授權啟用與裝置管理，以及完全取用磁碟的快捷入口。工具：快取刪除方式和保護清單。電池養護在支援的 Mac 上運行時把內建電池維持在 75% 到 80%，減緩老化，需一次管理員授權。選單列：開啟選單列監視器、在小動物和指標間切換、選擇顯示指標、設定支援裝置上的風扇行為，並為「喚出 Mole / 防止睡眠 / 擦螢幕」錄製快速鍵。授權啟用也可隨時用 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 預設的最佳化清單不同。支援 --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 內建診斷功能，可檢測常見問題。點視窗左上角的 Mole logo，選 執行診斷 即可開啟。各項檢測的詳細說明見 說明頁面。

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

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