Mole 教學：免費 Mac 清理工具，安裝、磁碟分析與常用命令
Mac 空間快滿時，我會先找出到底是哪些資料夾變大，再決定要清快取、移除軟體，還是整理下載過的 AI 模型。
Mole 把這些工作集中在終端機裡，輸入 mo 就能用方向鍵操作，涵蓋磁碟分析、清理、解除安裝、系統維護與即時監控。
對已經使用 Homebrew、Codex 或本地模型的 Mac 使用者，Mole 很適合當作日常維護工具，它能協助回收空間、找出資源占用，但清掉檔案並不代表 CPU 會自動變快。先知道瓶頸在哪裡，才不會刪了一堆快取，最後只是讓軟體重新下載相同資料。
Mole 免費嗎，終端機版和 DMG App 差在哪裡
目前的 Mole GitHub 專案 是免費開源 CLI，採 GPL-3.0 授權。
Mole for Mac 繁體中文官網 提供的是另外一款付費原生圖形介面 App。免費開源的說法應對應 CLI，不能套用到所有同名版本。
CLI 適合用鍵盤操作、希望檢查原始碼，或要把結果交給其他程式處理的人，原生 App 則提供視覺化磁碟樹狀圖、App 管理、選單列狀態等操作介面，對不想開終端機的人更直覺，官方目前標示 App 為一次購買、終身更新，一份授權可用於兩台 Mac，實際價格和條款以購買頁為準。本文以下以免費 CLI 為主。
安裝 Mole，先確認 Homebrew 能使用
按下 Command 加空白鍵，搜尋「終端機」。如果已安裝 Homebrew，先檢查版本，再安裝 Mole。
brew --version
brew install mole
mo --version
mo還沒裝 Homebrew，可以到 Homebrew 官網取得安裝命令。安裝完成後，照終端機顯示的 Next steps 設定環境，再重新開啟終端機。Apple Silicon 和 Intel 的安裝位置可能不同，直接照自己電腦輸出的步驟最穩。
輸入管理員密碼時，終端機通常不會顯示字元或星號，輸入完按 Enter 即可。Mole 只有在操作需要較高權限時才會提出要求，不必把每一條命令都加上 sudo。
第一次使用，我會從 Analyze 開始
先執行磁碟分析，沿著最大的資料夾往下查看。比起直接啟動清理，這一步更容易理解自己的硬碟用在哪裡。
mo analyze也可以指定範圍，縮小到下載資料夾或外接磁碟。外接磁碟不包含在預設總覽裡，要另外指定。
mo analyze ~/Downloads
mo analyze /Volumes使用方向鍵瀏覽，需要判斷內容時在 Finder 開啟對應位置。Analyze 內的移除操作會在確認後將所選項目移到垃圾桶，這和部分清理命令的刪除行為不同。要立即回收實際空間，還要考慮垃圾桶是否已清空。操作快捷鍵以畫面下方提示為準。
AI 模型快取很大，但它不一定是垃圾
本地 AI 工作流常會保存多個模型版本、量化格式與下載快取，依照 Hugging Face 官方快取說明，Hub 檔案快取預設位於 ~/.cache/huggingface/hub，設定過 HF_HOME 或 HF_HUB_CACHE 時則可能在別處。可以先用 Mole 查看預設快取的上層資料夾。
mo analyze ~/.cache/huggingface模型檔值得保留與否，取決於近期是否還會使用，以及重新下載的成本。你可以先列出每個模型的用途，保留常用版本，再逐一移除已淘汰的模型。不同快取版本可能共用檔案，適合搭配模型下載工具自身的管理功能，避免只刪掉某個片段後留下不完整模型。
如果你正在比較 llama.cpp、MLX 與 Ollama 的本地推理方式，要特別留意不同工具可能各自保存權重。整理時先確認模型屬於哪個工具，才知道之後要從哪裡重新取得。
做 ComfyUI 本地影音工作流 時也一樣，模型、輸入素材和生成成果應分開管理。尚未交付的成品有保留價值，不能只因為容量大就把整個輸出目錄視為可刪快取。
Clean 清快取，先看 dry-run 結果
準備清理時，先預覽會處理哪些路徑。需要保留的快取可以加入保護清單，再執行清理。
mo clean --dry-run
mo clean --whitelist確認預覽內容後，以下命令會實際進行清理。
mo clean清理範圍包括符合規則的快取、日誌、暫存與已移除 App 的殘留。清理後部分軟體第一次開啟可能要重建快取或重新下載資料，這是規劃清理時間時需要考慮的成本。Mole 的保護規則可以減少誤操作，但仍要自己確認預覽清單是否包含工作需要的資料。
瀏覽器也要分清楚快取和設定。Chrome 擴充功能的存放位置和一般網頁快取用途不同，不要自行把整個 Chrome 使用者資料夾都當成垃圾刪除。
需要追查剛才做了什麼，可以查看操作紀錄。
mo history
mo history --jsonUninstall 移除 App，也檢查相關殘留
不用的軟體可以交給 Uninstall，一起檢查能明確對應到該 App 的相關檔案。先做預覽，確認選取的是正確程式與版本。
mo uninstall --dry-run確定要解除安裝後，再執行下方命令並選取 App。
mo uninstall如果 App 本體早已刪除，改用 mo clean 檢查殘留比較合適。同一套軟體的不同版本可能共用資料，所以「完整移除」不能理解成所有相似名稱的資料夾都應一起消失，仍在使用的共用資料需要保留。
Optimize 與 Status，分別處理維護和觀察
遇到縮圖、搜尋或系統服務異常，可以先預覽 Optimize 的維護項目。它會依系統狀況略過不適用的工作，不能把它當成每台 Mac 都會得到相同效果的加速按鈕。
mo optimize --dry-run確認項目後才執行實際維護，需要排除的工作可用保護設定管理。
mo optimize --whitelist
mo optimize只想了解目前 CPU、記憶體、磁碟、網路與電力狀態時，用唯讀的 Status 儀表板即可。按 q 可以離開。
mo status對跑本地模型的人來說，可以在載入模型前後觀察記憶體壓力，再在生成內容時看 CPU 和磁碟活動。如果空間回收了，運算仍然慢，就應繼續檢查模型大小、同時執行的工作與記憶體，而不是反覆清理相同快取。
開發者可以用 Purge 整理專案產物
許多舊專案占空間，是因為 node_modules、target、build 或 dist 長期保留。Purge 會以專案為單位整理候選項目，先設定要掃描的資料夾，再做預覽。
mo purge --paths
mo purge --dry-run看清楚清單後，實際清理使用以下命令。
mo purgePurge 會永久刪除你確認的項目。原則上這些產物能重新建立，但自己的專案可能把手工修改內容或唯一成品放進 build 或 dist，所以仍需先核對。清掉依賴後，下一次開發也要重新安裝，應保留套件清單與 lockfile。
下載資料夾裡的舊安裝包則交給 Installer。先確認是否還需要離線重裝，再決定移除。
mo installer --dry-run以下會進入安裝包的實際移除流程。
mo installerMole 常用命令速查
| 工作 | 起手命令 | 使用重點 |
|---|---|---|
| 查看空間 | mo analyze | 先瀏覽，移除需確認 |
| 查看狀態 | mo status | 唯讀監控 |
| 清理快取 | mo clean –dry-run | 先預覽，再執行 clean |
| 移除 App | mo uninstall –dry-run | 先確認程式與殘留 |
| 系統維護 | mo optimize –dry-run | 先確認維護項目 |
| 專案產物 | mo purge –dry-run | 正式執行可能永久刪除 |
| 舊安裝包 | mo installer –dry-run | 先確認是否仍需保存 |
整合 Raycast，減少每天開終端機的步驟
Mole 官方提供快速啟動器腳本，可以加入 Clean、Uninstall、Optimize、Analyze 與 Status。以下命令請逐行操作，先下載官方腳本，用 less 閱讀內容，按 q 離開閱讀畫面，確認後才執行最後一行。
curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh -o setup-mole-launchers.sh
less setup-mole-launchers.sh
bash setup-mole-launchers.sh- 開啟 Raycast Settings，進入 Extensions 的 Script Commands
- 新增腳本目錄
~/Library/Application Support/Raycast/script-commands - 執行 Reload Script Directories 重新載入
- 在 Raycast 搜尋 analyze 或 status，開啟相應功能
清理指令仍然會啟動 Mole 本身的操作流程。快速啟動器的價值在於少打字，並不代表能略過對清理範圍的判斷。官方腳本在找到 Alfred 設定時，也會建立對應 workflow。
讓 Codex 協助讀取磁碟報告
Mole 已有 JSON 輸出，適合把資料交給 Codex 整理。可以請 Codex 解釋哪些資料夾占空間，以及哪些是模型、快取、安裝包或專案產物，再由自己決定下一步。
mo analyze --json ~/Documents
mo status --json
mo history --json可以這樣下提示詞。以下是整理報告的範例，並不會自動開始刪除。
請使用 Mole 的唯讀分析與 JSON 輸出，整理我指定資料夾的空間占用。按模型檔、專案依賴、生成成果與安裝包分類，列出路徑、容量與可能用途。請保留正在使用的模型和唯一成品，先提供清理建議，等我指定項目後再執行刪除。
JSON 報告可能包含使用者名稱與專案路徑。把它交給雲端服務時，就和 Mole 本身在本機掃描是兩個不同的資料處理步驟，可以先限制分析範圍。
更新、移除與常見錯誤
用 Homebrew 安裝的版本，更新時指定 Mole 即可。
brew update
brew upgrade mole不再需要這個工具時，用原本的套件管理方式解除安裝。
brew uninstall mole如果用官方安裝腳本安裝，則使用 mo update 更新與 mo remove 移除工具本身。不要把 mo uninstall 和 mo remove 混在一起，前者是管理其他 App，後者是移除 Mole。
遇到 Bundled status binary not found，先確認版本與命令位置。如果原本是 Homebrew 安裝，可用以下方式重新安裝套件，恢復遺失的執行檔。
command -v mo
mo --version
brew reinstall mole原本使用官方腳本安裝時，依錯誤訊息執行 mo update，或重新執行官方安裝流程。若電腦同時裝了兩個版本，先整理命令搜尋路徑，避免更新了一份，實際卻執行另一份。
FAQ
Mole 可以完全免費使用嗎
CLI 版可以，GitHub 專案採 GPL-3.0 開源授權。原生 Mole for Mac App 是另外的付費產品，兩者的授權和介面不同。
Mole 清理後一定會讓 Mac 變快嗎
不一定。它可以協助回收空間與處理部分維護工作，效能是否改善仍取決於磁碟剩餘空間、記憶體壓力、背景程序和實際工作負載。
Mole 有 Windows 版嗎
主要產品針對 macOS，官方 GitHub 目前另有實驗性的 windows 分支。不要把 Mac 的 Homebrew 命令與清理規則直接套到 Windows，也不要假設兩邊功能完全相同。
Analyze 和 Clean 都會刪除檔案嗎
Analyze 主要供瀏覽分析，選取移除後會確認並移到垃圾桶。Clean 會按清理規則實際刪除資料，第一次操作先使用 dry-run 預覽。
我會怎麼把 Mole 放進日常工作
第一次先跑 Analyze 和 Status，弄清楚容量與資源占用。空間不足時再預覽 Clean，需要移除 App 時用 Uninstall，舊專案交給 Purge。這樣比較容易把每次清理和實際問題對上，也能保留常用模型與工作成果。
我很喜歡 Mole 把路徑、大小與操作結果攤開的方式。對經常下載模型、建立測試專案與輸出影音素材的人，能知道硬碟裡放了什麼，比每次容量不足才四處翻資料夾方便得多。
近期留言