功能文件

概覽

Mole 有 Mac App 和 CLI 兩種使用方式，涵蓋相近的清理類別，也遵循同樣保守的安全原則與保護清單，但能力範圍並不完全相同。CLI 免費開源，採用 GPL-3.0 授權。Mac App 是原生 SwiftUI 應用，一次購買 $19，包含持續更新，無訂閱；Mac 上的操作都由原生介面完成，CLI 則多了幾個只在終端機裡用的指令。

Mac App

安裝

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

清理（地球）

掃描 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 等下載相依套件目錄，因為重新產生需要網路，也可能無法還原鎖定檔對應的狀態。需要檢視的項目預設不選取；想保留可復原的餘地，可在設定 › 工具 › 快取刪除方式中選擇「移到垃圾桶」。

軟體（火星）

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

最佳化（水星）

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

最佳化會先嘗試修復輸入法切換、Spotlight、通知中心和通用剪貼板。深度工作包括：重建 Quick Look；壓縮 SQLite 資料庫；清理 saved state、隔離事件和通知歷程；修復損壞的偏好設定、共享檔案列表和孤立 Spotlight 規則；審查登入項目；把程式已遺失的 Launch Agent 移到垃圾桶；執行 periodic maintenance。

Mole 會略過目前不適合執行的工作，每項工作只在確有需要時才執行，DNS 或網路堆疊重置不屬於預設維護工作。

最佳化的每項工作各自判斷有沒有必要跑，記憶體壓力正常時不清記憶體，郵件和訊息在執行時不壓縮它們的資料庫；被跳過項在結果面板裡給出原因，方便查看哪些工作實際執行了。

分析（木星）

用樹狀圖顯示磁碟空間，逐層開啟檔案夾即可查看各項目的大小。較密集或大小相近的項目會合併顯示，讓圖表保持清晰。

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

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

狀態（太陽）

狀態面板顯示健康評分、CPU、記憶體、GPU、磁碟 I/O、網路、電池或溫度，以及依硬體切換的風扇或溫度卡片。趨勢圖顯示近期變化，支援的 Mac 會顯示自動、降溫、強冷三種風扇控制。

下方處理程序列表每秒更新。五欄（名稱、PID、CPU、耗電量、記憶體）都支援點一下排序，再點一次切換升降序。點一下某一列會打開它的說明面板。在某一列按右鍵可以選擇釘選或取消釘選（釘選的處理程序在重新整理和重新啟動 App 後都保持在最上方，方便持續查看同一個 App）、結束程序（先嘗試正常結束，沒有回應時再強制結束）、複製可執行檔路徑。電池卡片裡耗電最多的程序可以直接點開，跳到對應處理程序的解釋面板。

選單列面板

開啟選單列顯示後，不用打開主視窗也能查看即時指標。你可以選擇數字、精簡圖示或小動物動畫，動畫快慢隨系統負載變化。點一下即可展開面板，查看硬體狀態、高負載程序和累計清理統計，支援的 Mac 還可以調整風扇。

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

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

顯示模式可在「小動物動畫」和「雙列指標」之間切換。兩列指標各挑一項：CPU、記憶體、壓力、交換空間、GPU、磁碟、溫度、電池、功耗、風扇、配件電量，兩列不能挑同一項。網路速度是獨立開關，在這兩列旁邊另佔一欄。小動物角色只是外觀差異，不影響指標取樣。

診斷

點視窗左上角的 Mole logo，選 執行診斷。Mole 產生唯讀的精簡報告，涵蓋 Mac 型號、macOS 版本、權限、近期操作、顯示器、外接磁碟區、網路、安全狀態和執行環境。點 複製報告，再把內容貼到寄給支援的訊息裡。

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

設定

設定有三個分頁。通用：介面語言（重啟後生效）、登入時啟動、僅選單列模式、授權啟用與裝置管理，以及完整磁碟取用權限的快捷入口。工具：快取移除和保護項目（你在清理審查裡選「永不清理此項」加進來的目錄）。電池養護在支援的 Mac 上運行時把內建電池維持在 75% 到 80%，減緩老化，需一次管理員授權。選單列：開啟選單列圖示、在小動物和指標間切換、選擇顯示指標、設定支援裝置上的風扇行為，並為「喚出 Mole / 防止睡眠 / 清潔螢幕」設定快速鍵。授權啟用也可隨時用 Cmd + Shift + L 開啟。

CLI

安裝

透過 Homebrew 安裝：brew install mole。執行 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

終端機內的互動式樹狀圖。方向鍵或 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。如果指令靜默失敗，檢查系統設定中是否已授予完全取用磁碟權限。

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