功能文件

概覽

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

Mac App

安裝

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

更新後，標題列會顯示 查看更新內容，開啟或關閉提示後就會消失，這裡會顯示目前執行版本及之前四個版本的更新說明，最後可以開啟全部發佈紀錄，Mole 選單中的 更新內容 隨時可以再次開啟。

清理 · 地球

清理清單先顯示 App 快取，合併了瀏覽器、雲端儲存用戶端快取與 App 日誌，開發工具、AI 工具、通訊和設計工具另有分組，之後是移除殘留、在下載項目和桌面裡放了兩週以上的安裝檔和系統資料，系統資料包括本機 Time Machine 快照、系統快取與日誌、舊 macOS 安裝程式和過期背景圖片下載，最後是垃圾桶。「手動管理」列出備份、iCloud 本機檔案、虛擬機與模型，由你單獨處理，不計入清理容量。

清理前可以逐項確認，系統資料是 macOS 的儲存分類，不是一個資料夾，也不是要清到某個數值，Mole 測量的檔案大小不會與系統設定裡的數字完全一致。硬連結共用的檔案不會重複計算，快取預設永久刪除，也可以在設定中改為移到垃圾桶，本機快照清理會移除這些本機還原點，不影響外接磁碟上的備份，系統統一日誌清理則需要單獨確認，執行後無法復原。

預設標為「需確認」：重建成本較高的套件快取如 npm、yarn、pnpm、bun、CocoaPods 與 Gradle，以及無需下載相依套件即可重建的專案產物，包括 build、dist、target、.build、.next、DerivedData、__pycache__ 與 coverage。Mac App 不會列出 Pods、venv 等下載相依套件目錄，因為重新產生需要網路，也可能無法還原鎖定檔對應的狀態。專案裡的 node_modules 是例外，專案 90 天沒有變更、鎖定檔能重新安裝時才會列出，刪除時一律移到垃圾桶。標為「需確認」的項目預設不選取；可在設定中選擇清理時移到垃圾桶。

可在「手動管理」中單獨回收支援的 Parallels 虛擬磁碟內部閒置空間，使用的是 Parallels 自己的工具，需要先正常關閉虛擬機，執行中或暫停的虛擬機不能使用。查看估算並單獨確認後，它會保留虛擬機及其中的檔案，不隨批次清理執行，開始後應等待完成，不要中斷。

AI 清理與維護 · 月亮

這台 Mac 上有 AI 工具的資料時，清理頁右上角遠處會出現一輪月亮，點進去是 AI 清理與維護。入口只在偵測到資料時出現，偵測只看幾個固定資料夾在不在，不走訪磁碟，不需要的話在設定 › 一般 › 清理裡關掉「顯示 AI 工具清理與維護入口」。進到頁面不會自動掃描，點「掃描 AI 資料」才開始，掃到內容會直接打開結果。

結果依刪了會不會後悔分成三段。快取和舊版本預設勾選，包括 Claude Code、Codex、Cursor Agent、Grok、GitHub Copilot 這些命令列被取代的舊版本，Cursor 桌面版自己留著的 cursor-agent 舊版本也在內，以及 Claude、Codex、Cursor、Grok 的快取。工作階段與 worktree 預設不勾，包括超過保留期的 Codex、Claude Code、OpenCode 和 Devin 工作階段，保留期每個工具各自設定，可選 15、30、90、120 天或暫不清理，預設暫不清理，這時這一行會顯示保留了多少工作階段、共多大，選單裡每個選項也標出會列出幾筆、多大；同樣超過保留期且專案資料夾已經不在的 Claude Code 工作階段、Codex 已刪除工作階段留下的圖片，以及 git 能證明沒有獨有變更或未被分支保留的提交的 worktree 也在其列，變更已合併到主分支的 worktree 也包括在內。閒置工具與維護預設不勾，包括 30 天沒用、也沒在執行的 AI 命令列工具連同它的工作階段和設定一起移除、超過 200 MB 的 SQLite 資料庫壓縮，以及已移除工具留下的設定資料夾。舊版本、快取、工作階段和 worktree 展開後可以逐項取消。

24 小時內用過的工作階段不會列出，所以 Codex 和 Claude Code 開著時也能用。執行中的工具正開啟著的資料會列出並標明正在使用，不能勾選，刪除前每一列還會再核對一次。檔案移到垃圾桶，Codex 工作階段先複製一份到垃圾桶再呼叫 Codex 自己的刪除指令，Codex 為它產生的圖片也一起移到垃圾桶，Homebrew 安裝的工具透過 brew 移除，資料庫壓縮在原處進行。記憶、計畫和技能檔案不在任何一列裡，本機模型裡只列一個月沒用的 Ollama 模型，用 Ollama 自己的 ollama rm 刪除。

軟體 · 火星

軟體把 App 更新、啟動項目管理和移除清理放在一起。「更新」分頁會檢查 Sparkle、Electron、Homebrew Cask / Formula、GitHub Releases、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 自己使用的設定、聊天記錄等資料會隨 App 一起勾選，瀏覽器個人檔案、與其他 App 共用的資料，以及歸屬不明或關聯較弱的殘留則保留在列表中，預設不勾選，方便先確認，取消勾選某個分類就能保留它，供重新安裝後使用。與 App 由同一開發者簽署的音訊外掛和驅動程式會列出供確認，App 在 /Users/Shared 下的資料夾也會列出，成千上萬個自動產生名稱的殘留會作為一個資料夾移到垃圾桶。Cmd 點擊可以把多個 App 加進同一批移除，單項失敗的會保留在列表裡方便重試。App 列的右鍵選單選只清理資料則只移除資料、保留 App。命令列工具也在這個列表裡，包括你自己用 Homebrew 安裝的 Formula 和 AI 命令列工具，Formula 透過 Homebrew 移除，只有它用到的相依套件會一起移除。

更新盡量在 App 內完成：Sparkle 和 Homebrew Cask 都在 Mole 裡直接安裝；Mac App Store 走 CommerceKit，授權或逾時失敗時再回退到 App Store；其他 App 會被開啟，交給它們自己的更新器接手。

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

為 Adobe Genuine Service 提供官方移除入口，能驗證本機 Adobe 移除程式時直接開啟，否則提供 Adobe 的操作說明，之後再檢查服務狀態，開啟移除程式本身不代表已經移除完成。TeamViewer 和 Bitdefender、Intego、Kaspersky、Norton、Trend Micro 等防毒軟體，也會以相同方式開啟各自開發者提供的移除程式。

最佳化 · 水星

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

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

Mole 會略過目前不適合執行的工作，DNS 或網路堆疊重設不屬於預設維護工作。

最佳化的每項工作各自判斷有沒有必要跑，記憶體壓力正常時不清記憶體，郵件和訊息在執行時不壓縮它們的資料庫；被跳過項在結果面板裡給出原因，方便查看哪些工作實際執行了。按一下系統維護完成下方那行摘要會打開最佳化詳情，執行了哪些工作、略過了哪些、為什麼略過都列在裡面。

分析 · 木星

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

無法取得大小的條目，如權限受限目錄與 TCC 保護容器，會顯示重試選項而非靜默丟棄。受保護的導覽根目錄（/、/Users、/Applications）不能移到垃圾桶。掃描結果會快取，再次開啟時顯示上次結果，超過 6 小時會在背景重新測量。

在樹狀圖上點一下資料夾即可開啟，上方的路徑列可以跳回任意一層。左側列表和代表檔案或資料夾的色塊都保留項目操作：打開或在 Finder 中顯示，右鍵移到垃圾桶會像 Finder 一樣直接移入，不跳確認，之後可以從垃圾桶放回，只有已在垃圾桶裡的項目因為會永久刪除才先確認；摘要區塊只用於概覽。樹狀圖上每個色塊的面積按位元組比例分配，所以最大的項目永遠佔最大的方塊。

右鍵選單還可以複製檔案或資料夾路徑，方便貼到 Finder 或支援訊息中，不會移除該項目。

圖上方的多選可以從不同資料夾挑選檔案和資料夾，逐層開啟或返回時都會保留選取項目，最後一起移到垃圾桶。將游標移到資料夾上會顯示名稱，超過 5,000 個已知資料夾還會用一句話說明裡面裝了什麼、移除會有什麼影響，側邊列表中最大的幾項會標出所屬 App。最大檔案會把一年內沒有被開啟、寫入或搬移的檔案標為一年未用。如果卷宗使用的空間比一到三十天前的某次掃描增加了至少 1 GB，會有一行顯示增加了多少，並依歸屬列出垃圾桶、iPhone 和 iPad 備份、Xcode、AI 工具及已安裝 App 各占多少，點選每一列會開啟對應位置。

狀態 · 太陽

狀態面板顯示健康評分、CPU、GPU、記憶體、電池、磁碟、網路和風扇，沒有電池的 Mac 用溫度卡片取代電池，沒有風扇的 Mac 用溫度卡片取代風扇。趨勢圖顯示近期變化，支援的 Mac 會顯示自動、降溫、強冷三種風扇控制，關機、重新啟動或更新後會恢復先前開啟的降溫或強冷，主動結束 Mole 則不會恢復。面板上的每個標籤都能開啟相關讀數卡片，CPU 和 GPU 溫度標籤會列出各個感測器的名稱與讀數，電池、電源供應器和儲存裝置感測器各有自己的卡片，記憶體、磁碟、電池和晶片名稱也都能點開對應卡片，選單列面板中的同類標籤會開啟相同卡片。點一下網路卡片右上角的連線標籤可查看本機 IPv4、公網 IP 及其位置和電信業者、系統代理，使用代理伺服器或 VPN 時還會顯示 ChatGPT 看到的對外 IP 和國家，連著 Wi-Fi 時顯示訊號強弱，以及連線的標準、頻段和協商速率。

下方程序列表每秒更新，涵蓋名稱、PID、CPU、耗電量與記憶體五欄，均支援點一下排序，再點一次切換升降序。點一下某一列會打開它的說明面板；在某一列按右鍵可釘選或取消釘選，釘選的程序在重新整理和重新啟動 App 後都保持在最上方，方便持續查看同一個 App；選單裡還有為什麼在執行？、在 Finder 中顯示、拷貝程序名稱、拷貝 PID，以及結束（正常結束請求）和強制結束，受保護的系統程序不提供結束和強制結束。電池卡片裡耗電最多的程序可以直接點開，跳到對應程序的說明面板。

選單列面板

開啟選單列顯示後，不用打開主視窗也能查看即時指標。顯示內容可選「圖示」、「即時資訊」或「圖示與資訊」，圖示是小動物動畫，快慢隨系統負載變化。小動物可選阿鼴、阿貓、阿汪、阿貴、阿龍、阿飛、阿馬、阿兔、阿蛙、阿雞、阿鴨、阿獺、阿豚、阿龜、阿魚、阿怪、阿撐、阿力。點一下即可展開面板，查看健康評分、晶片、記憶體、macOS、開機時間、硬體狀態、CPU 使用率最高的五個程序，以及「累計維護」記錄的清理、移除和最佳化統計，支援的 Mac 還可以調整風扇。

面板底部是常用工具：相機或麥克風被佔用時會有隱私指示燈；防止睡眠可選 1、2、4、8、12 小時或不限時；清潔螢幕會把螢幕變成純色，方便擦拭螢幕和鍵盤，還可選配輸入鎖，用 macOS 的「輔助使用」權限攔下輸入；偵測到可退出的外接磁碟或磁碟映像時，這裡也會出現退出按鈕。可自訂的全域快速鍵隨處喚出 Mole，打開「隱藏 Dock 圖示」後，在背景時只留在選單列，整體在設定 › 選單列中設定。

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

選單列顯示內容可選 圖示（小動物動畫）、即時資訊（最多三個可設定指標）或 圖示與資訊，預設顯示兩個指標，「第三項狀態資訊」可以再加一個。每個指標各挑一項：CPU 使用率、記憶體使用率、記憶體壓力、交換空間、GPU 使用率、磁碟已用空間、晶片溫度、電池電量、耗電功率、充電功率、風扇轉速、配件電量，不能重複。顯示即時網路速度是獨立開關，在這些指標旁邊顯示上傳和下載速度。點一下這組上傳和下載速度會開啟各 App 的網路清單，可查看即時速度，或過去 1、5、10、30 分鐘、1 天、7 天或 30 天各 App 的流量，同時顯示整台 Mac 的趨勢，最多列出 12 個 App。Mole 在選單列裡時，點狀態頁或選單列面板網路卡片上的下載、上傳速度，也會開啟這個清單。Mole 選單和選單列右鍵選單中的網路與測速也能開啟它。只有顯示這組速度時才會記錄，每分鐘讀取一次，紀錄僅儲存在這台 Mac 上，保留 30 天，重新啟動後仍在，Mole 沒有執行的時段不會記錄。清單頂部的「測速」標籤點開就開始測速，使用 macOS 內建的 networkQuality，連線到 Apple 的伺服器，顯示下載、上傳、延遲和滿載延遲，Mole 不經過自己的伺服器。小動物角色只是外觀差異，不影響指標取樣。資訊排列方式預設 分欄，也可以改成緊湊兩行的 堆疊，「翻轉方向」讓小動物從朝左改為朝右。

可以暫停小動物動畫，保留目前角色，原生工具選單提供防止睡眠、清潔螢幕、支援的 Mac 的風扇控制、WiFi 低延遲和隱藏桌面，還可設定開啟主視窗、切換風扇降溫和隱藏桌面的快速鍵。網路卡片也有 WiFi 低延遲入口，開啟後暫時停用 AWDL 與 AirDrop，關閉、睡眠或退出 Mole 時恢復原狀態，不承諾提高下載速度。隱藏桌面在 Mole 選單和選單列右鍵選單裡也有，和系統設定 › 桌面與Dock裡的顯示項目是同一個設定，檔案和磁碟都還在原處，預設快速鍵是 ⌃⌥⌘H。

診斷

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

診斷會檢測六種狀況：完全取用磁碟權限缺失、記憶體壓力偏高、磁碟接近滿載、電池健康度偏低、建議重新開機、操作日誌不可寫入。每種狀況連結到對應的 說明頁面 解決步驟。

設定

設定分為三個分頁。一般包含重新啟動後生效的介面語言、清理選項、不清理的項目、授權啟用與裝置管理、接收測試版更新，以及完整磁碟取用權限的快捷入口。清理選項包含快取刪除方式，可選永久刪除或移到垃圾桶，預設永久刪除；另有「顯示 AI 工具清理與維護入口」和快速移除模式。工具包含防止睡眠、清潔螢幕、兩者的快速鍵和需要 macOS 輔助使用權限的清潔螢幕輔助使用權限，以及支援裝置上的電池充電保護與風扇控制。電池充電保護在 Mole 執行時把內建電池維持在 75% 到 80%，需一次管理員授權，「降溫後自動結束風扇加速」決定降溫和強冷是否在 Mac 冷卻後交回系統。選單列包含登入時自動啟動、隱藏 Dock 圖示、圖示與小動物角色、顯示指標與網路速度、選單列面板快速鍵，以及相機與麥克風提醒等通知。授權也可隨時用 Cmd + Shift + L 開啟。

終端機選項

少數只有部分人需要的選項不放進設定，在終端機裡執行指令，再結束並重新打開 Mole 就會生效。溫度想用華氏顯示，執行 defaults write com.tw93.MoleApp temperatureUnitPreference -string fahrenheit，想換回攝氏，執行 defaults delete com.tw93.MoleApp temperatureUnitPreference。改的只是顯示的數字，風扇曲線和高溫提醒仍依同樣的讀數運作。行星旁的詩句想改用無襯線字體，執行 defaults write com.tw93.MoleApp poemFontPreference -string system，想換回襯線字體，執行 defaults delete com.tw93.MoleApp poemFontPreference。

CLI

安裝

透過 Homebrew 安裝：brew install mole。執行 mo 開啟互動式選單，或直接使用子指令。

共享指令 · Mac App 同步提供

mo clean

清理快取與暫存檔案。支援 --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。如果指令靜默失敗，檢查系統設定中是否已授予完全取用磁碟權限。

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