Mole鼴

1. 下載並試用

點選 下載試用，把 Mole 拖入 Applications 後開啟。每個工具可免費使用 2 次。

2. 購買授權

在首頁點選購買按鈕，會進入 Dodo Payments 的安全結帳頁面。

1. 填寫 Contact Information：姓名、常用信箱和電話。授權金鑰會寄到這個信箱。付款前請仔細檢查信箱拼寫，不建議使用 @duck.com 等轉寄或隱私信箱；Dodo Payments 的授權郵件可能無法送達這類地址。
2. 填寫 Billing Address：國家、城市、地區、郵遞區號。
3. 點選 Continue to Payment。
4. 選擇付款方式：信用卡、Apple Pay、Google Pay、微信或 Cash App。
5. 確認付款。授權金鑰通常幾秒內就會寄到信箱。

3. 啟用 Mole

1. 開啟 Dodo Payments 的郵件，複製授權金鑰。
2. 開啟 Mole，按 Cmd + Shift + L，或在 macOS 選單列的 Mole 選單裡選擇 License...。
3. 貼上金鑰並點選 Activate。Mole 會自動去掉誤帶的空格和換行。
4. 看到 All tools unlocked 後，五個工具就都可以使用了。

4. 換到新 Mac

每份授權最多支援 2 台 Mac 同時使用。需要換裝置時，在舊機器上開啟 Mole，按 Cmd + Shift + L，點選 Deactivate this device。之後用同一個金鑰在新機器上啟用。

5. 退款和發票

如果 Mole 不適合你，請在購買後 14 天內帶上 Payment ID 或購買信箱聯繫 [email protected]。完整規則見 退款政策。

請在郵件裡簡單寫一句 Mole 最不好用的地方，幫我更快處理和改進產品。

Dodo Payments 會在購買後自動產生收據。如需帶公司名或稅號的正式發票，請在購買後 30 天內寄信說明。

6. 設定與快速鍵

按 Cmd + , 開啟設定。設定有三個分頁。

通用是基礎項：

• 語言 設定介面語言，重啟後生效。
• 登入時啟動 讓 Mole 在你登入時自動開啟。
• 隱藏 Dock 圖示 讓 Mole 純選單列執行，不在 Dock 出現。
• 授權 顯示啟用狀態，點管理可啟用、停用、切換裝置，或在裝置數已滿時處理回收。
• 完全磁碟存取 顯示權限是否已授予，並提供跳轉系統設定的快捷入口。

維護掌管清理行為：

• 快取刪除方式 決定快取如何處理：永久真正釋放空間，廢紙簍誤點後仍可復原。
• 保護清單 開啟白名單管理，被保護的項目以後掃描會跳過。
• Optimize Dock 重新整理 決定 Optimize 預設執行時是否帶上重啟 Dock。

選單列掌管選單列 HUD 和常用工具：

• 選單列監視器 可在 macOS 選單列顯示指標讀數、精簡圖示或隨系統負載運動的小動物。
• 可見指標 從 CPU、記憶體、溫度、磁碟、網路裡選擇小動物兩列內容。
• 快速鍵 在這裡給「選單列開關 / Keep Screen On / Clean Screen」分別錄製熱鍵，預設都未設定。
• Clean Screen 輸入鎖 靠 macOS Accessibility 在 Clean Screen 期間屏蔽輸入。
• 隱私指示通知 在相機或麥克風被佔用時通知你。

快速鍵：

• Cmd + , 開啟設定
• Cmd + Shift + L 開啟授權面板
• Esc 關閉任意彈層（設定、授權、診斷、審查面板）

7. 日常使用建議

前面幾節講的是裝機和操作步驟。這一節是設定選用建議，把 Mole 調成貼近自己的使用節奏。

選單列快速鍵

三個可選的全域熱鍵在「設定 → 選單列」裡錄製：「選單列開關」「Keep Screen On」「Clean Screen」。預設都沒有綁定，沒錄之前不會觸發。點擊輸入框，按下組合鍵，按 Enter 儲存即可；Mole 會替換掉這個動作之前的綁定。

常用選法：⌘⇧O 綁「選單列開關」，隨時瞥一眼 CPU、記憶體；功能鍵或 ⌥⇧K 綁「Keep Screen On」，簡報、下載、長時間任務時切常亮；⌃⌥C 綁「Clean Screen」，擦螢幕和鍵盤前一鍵變成純色，配合輸入鎖更安心。

最佳化頻率

Optimize 偵測到 VPN、藍牙鍵鼠、藍牙音訊、外接音訊或外接顯示器正在使用時，會自動避開相關工作。被跳過的項會在結果列表裡給出原因，方便複核。Dock 重啟另有 7 天冷卻期，跑過後會在面板裡告訴你「上次執行於 X 天前」。

建議節奏：記憶體壓力持續偏高、或應用程式開啟變慢時跑一次，不要日常多次。兩次 Optimize 之間，Doctor 是更輕量的健康檢查入口。

快取清理方式

「永久刪除」（預設）立刻釋放空間，掃描結果不能恢復；「放入垃圾桶」把所有項送到 macOS 垃圾桶，萬一某項快取比預期重要，可以從垃圾桶拖回原位置。

頭幾次清理或遇到不熟悉的分類時，垃圾桶模式是更穩的兜底。開啟 文件 → 清理 查看每類快取哪些是自動勾選清理、哪些是需要審查再決定。

8. 先執行診斷

選單列點 Help → 執行診斷…，Mole 會產生一份精簡報告，包含 Mac 狀態、權限、近期操作、執行環境。點 複製報告 用來貼到對話，或點 提交 GitHub Issue 直接開啟預填好內容的 Bug 回報表。

沒有完全磁碟取用權限

Mole 需要完全磁碟取用權限才能掃描 ~/Library 和系統目錄裡的快取。開啟 系統設定 → 隱私權與安全性 → 完全磁碟取用，把 Mole 打開，然後重新啟動 App。Mole 只會從這些位置讀取，永遠不會上傳檔案內容。

記憶體壓力偏高

當使用中記憶體加上壓縮記憶體擠占快取時，macOS 會報告記憶體壓力偏高。建議關掉不再使用的 App（特別是開了很多分頁的瀏覽器和大型 Electron 工具）。Mole 的 Status 頁面按 CPU、記憶體列出前幾名處理程序，方便定位元兇。

磁碟快滿了

當啟動磁碟使用率超過 90% 後，macOS 會開始 swap，速度明顯下滑。開啟 Clean 頁面回收快取、日誌和垃圾桶。如果是個別大目錄，可以用 Analyze 頁面按目錄視覺化用量，快速找出占空間的大戶。

電池健康度偏低

當電池最大容量低於 80%，或充電循環次數超過 1000 次時，Mole 會給出這個提示。電池老化沒有軟體解法：可以在 系統設定 → 電池 → 電池健康 裡核對具體數值；如果續航已經明顯撐不住，建議預約 Apple 維修更換。Mole 的 Status 頁面也會持續顯示這個讀數。

Mole 的操作日誌寫不進去

Mole 會把每次操作記錄到 ~/Library/Logs/mole/operations.log。如果磁碟滿了或該目錄不可寫入，日誌寫入會靜默失敗。先騰出一些空間，然後結束再開啟 Mole，下次診斷報告裡這項就會恢復正常。

近期操作失敗

失敗通常是清理或移除批次處理裡某個路徑被 macOS 保護、被其他 App 占用，或者 Mole 處理前已經消失了。開啟對應分類（Clean、Uninstall、Optimize），在詳情面板裡查看每個失敗項的原因。

9. 回報問題

送出之前，先看看 已有 issue，也許有人遇到過同樣的情況。

Mac App 的 Bug 或當機

先執行診斷（上面第 8 節）。點診斷面板裡的 提交 GitHub Issue，會帶著系統報告直接跳到 Bug 回報表。也可以手動複製報告再貼到表單裡。

Mac App 功能建議

開啟 建議表，說清楚想解決什麼問題，而不只是想要什麼功能。

CLI 的 Bug 或建議

Mole CLI 是獨立的開源專案。CLI 問題請在 CLI issue tracker 提交，附上 macOS 版本和 mo version 輸出。

授權、付款、退款或含隱私資訊的問題

寄信到 [email protected]，附上購買信箱、Payment ID 和大致付款時間。

概覽

Mole 有兩種使用方式，清理範圍、安全規則和保護列表保持一致。CLI 免費開源，MIT 授權。Mac App 是原生 SwiftUI 應用，早鳥價 $9 到 2026 年 6 月 15 日，6 月 16 日起為 $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、node_modules、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)

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

工作包括：重建 Quick Look、在安全條件下重建 Spotlight、字型快取和 Launch Services 垃圾回收；壓縮 SQLite 資料庫；清理 saved state、隔離事件和通知歷程；修復損壞的偏好設定、Launch Agent 和共享檔案列表；可選重新整理 Dock 狀態；審查登入項；執行 periodic maintenance。

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

偵測到 VPN 活躍、藍牙 HID 或音訊、外接顯示器或音訊裝置時，Optimize 也會主動跳過會更動裝置狀態的工作；被跳過項在結果面板裡給出原因，方便複核執行清單。Dock 重啟另有 7 天冷卻期，並顯示距離上次執行的天數，避免在連續兩次執行裡反覆重啟 Dock。

分析 (Jupiter)

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

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

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

狀態 (Sun)

九個指標區放在一個 bento 儀表板裡：健康評分、CPU、記憶體、GPU、磁碟 I/O、網路吞吐、電池、溫度/風扇和執行時間。每項指標附帶 60 秒迷你圖，支援的 Mac 會顯示 Auto、Cool、Quiet 三種風扇控制。

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

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

選單列 HUD

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

彈層底部是常用工具：相機或麥克風被佔用時會有隱私指示燈，Keep Screen On 可選時長，Clean Screen 會把螢幕變成純色，方便擦螢幕和鍵盤（可選 Accessibility 輸入鎖），還有一鍵退出外接磁碟區；右鍵快捷選單可開啟任意工具，全域快捷鍵隨處喚出 Mole，隱藏 Dock 圖示後即成純選單列 App，整體在 Settings → Menu Bar 中設定。

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

診斷

選單列 Help → 執行診斷…。Mole 產生精簡報告，涵蓋 Mac 型號、macOS 版本、權限、近期操作、顯示器、外接磁碟區、網路、安全狀態和執行環境。點 複製報告 貼到對話，或點 提交 GitHub Issue 直接開啟預填好內容的 Bug 回報表。

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

設定

Settings 有三個分頁。通用：介面語言（重啟後生效）、登入時啟動、隱藏 Dock 圖示、授權啟用與裝置管理，以及完全磁碟存取的快捷入口。維護：快取刪除方式、保護清單，以及 Optimize 是否重新整理 Dock。選單列：開啟選單列監視器、在小動物和指標間切換、選擇顯示指標、設定支援裝置上的風扇行為，並為「選單列開關 / 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。如果指令靜默失敗，檢查系統設定中是否已授予完全磁碟取用權限。

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