功能文档

概览

Mole 有 Mac App 和 CLI 两种使用方式，覆盖相近的清理类别，也遵循同样保守的安全原则与保护列表，但能力范围并不完全相同。CLI 免费开源，采用 GPL-3.0 许可证。Mac App 是原生 SwiftUI 应用，一次购买 $19，包含持续更新，无订阅；通过图形界面完成日常清理和管理，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 删除。

软件 · 火星

「软件」把应用更新、启动项管理和卸载清理放在一起。「更新」视图会检查 Sparkle、Electron、Homebrew Cask / Formula、GitHub Releases、Mac App Store 应用，支持的更新可在 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。

更新尽量在 App 内完成：Sparkle 和 Homebrew Cask 都在 Mole 里直接装；Mac App Store 走 CommerceKit，授权或超时失败时再回退到 App Store；其他 App 会被打开，交给它们自己的更新器接手。

卸载 /Applications/*.app 里由系统管理员拥有的 App 时，本次运行期间只需一次管理员授权，之后不再重复要密码。「启动」视图里，能匹配到稳定 launchd 服务的登录项和已通过校验的 LaunchAgents / LaunchDaemons 由 Mole 直接切换；macOS 后台任务管理里无法由 Mole 直接管理的项目，则跳转到对应的系统设置页面。

Mole 还为 Adobe Genuine Service 提供官方卸载入口，能验证本机 Adobe 卸载器时直接打开，否则提供 Adobe 的操作说明，之后再检查服务状态，打开卸载器本身不代表已经卸载完成。TeamViewer 和 Bitdefender、Intego、Kaspersky、Norton、Trend Micro 等杀毒软件也会以同样的方式打开各自开发者提供的卸载器。

优化 · 水星

默认的维护任务点一下就会执行。不需要管理员权限的任务直接运行，需要管理员权限的任务会合并到一次授权里。

优化会先尝试修复输入法切换、Spotlight、通知中心和通用剪贴板。深度任务包括：重建快速预览缓存；压缩 SQLite 数据库；清理窗口状态、隔离事件和通知历史；修复损坏的偏好设置、共享文件列表和孤立的 Spotlight 规则；检查登录项；把程序已丢失的 Launch Agent 移到废纸篓；执行系统例行维护。

Mole 会跳过当前不适合执行的任务，DNS 或网络栈重置不属于默认维护任务。

「优化」的每项任务各自判断有没有必要跑，内存压力正常时不清内存，邮件和信息在运行时不压缩它们的数据库；被跳过项在结果面板里给出原因，方便查看哪些任务实际执行了。点击系统维护完成下面那行摘要会打开优化详情，执行了哪些任务、跳过了哪些、为什么跳过都列在里面。

分析 · 木星

用树状图展示磁盘空间，逐层打开文件夹即可查看里面各项的大小。较密集或大小相近的项目会合并显示，让图表保持清晰。

无法获取大小的条目，如权限受限目录与 TCC 保护容器，会显示重试选项，而不是悄悄丢掉。根级保护目录如 /、/Users 与 /Applications 不可删除。扫描结果会缓存下来，再次打开先显示上次的结果，超过 6 小时会在后台重新测量。

在树状图上点击文件夹即可打开，上方的路径栏可以跳回任意一级。左侧列表和代表文件或文件夹的色块都保留条目操作：打开或在访达中显示，右键移到废纸篓会像访达一样直接移走，之后可以从废纸篓放回，只有废纸篓里的项目因会永久删除才先确认；摘要块只用于概览。树状图上每个色块的面积按字节比例分配，所以最大的项目占最大的方块。

右键菜单还可以复制文件或文件夹路径，方便粘贴到访达或支持消息中，不会移除该项目。

图上方的多选可以从不同文件夹挑选文件和文件夹，逐层打开或返回时都会保留选择，最后一起移到废纸篓。鼠标移到文件夹上会显示名称，超过 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；菜单里还有为什么在运行？、在访达中显示、复制进程名称、复制 PID，以及终止（正常退出请求）和强制退出，受保护的系统进程不提供终止和强制退出。电池卡片里最耗电的那一行也能直接点开，跳到对应进程的解释面板。

菜单栏面板

开启菜单栏显示后，不用打开主窗口也能查看实时指标。菜单栏可以显示「图标」「运行数据」或「图标与数据」，图标里的小动物动画快慢随系统负载变化。小动物可选阿鼹、阿猫、阿汪、阿贵、阿龙、阿飞、阿马、阿兔、阿蛙、阿鸡、阿鸭、阿獭、阿豚、阿龟、阿鱼、阿怪、阿撑、阿力。点击后展开的面板会显示健康度、芯片、内存、macOS 版本、运行时间、硬件状态、CPU 占用最高的五个进程和「累计维护」统计，记录清理、卸载和优化的累计结果，支持的 Mac 还可以调节风扇。

面板底部是常用工具：摄像头或麦克风被占用时会有隐私指示灯；保持常亮可选 1、2、4、8、12 小时或不限时；清洁屏幕会把屏幕变成纯色，方便擦拭屏幕和键盘，还可选配清洁屏幕输入保护，用 macOS 的「辅助功能」权限拦下输入；检测到可弹出的外接磁盘或磁盘镜像时，这里也会出现弹出按钮。可自定义的全局快捷键随处唤出 Mole，打开「隐藏程序坞图标」后，后台只在菜单栏运行，整体在设置 › 菜单栏中配置。

按应用关闭隐私提醒。通知里出现应用名时，将鼠标移到 macOS 通知上，选择不再提醒此 App。之后可在设置 › 菜单栏 › 提醒 › 已关闭提醒的 App恢复。纯摄像头提醒不会显示应用名，因为 macOS 不提供占用摄像头的应用身份，所以 Mole 不会给这类通知显示按应用关闭操作。

菜单栏显示内容可选 图标（小动物动画）、运行数据（最多三个可配置指标）或 图标与数据，默认显示两个指标，「第三项状态数据」可以再加一个。每个指标各挑一项：CPU 占用、内存占用、内存压力、交换空间、GPU 占用、磁盘已用空间、芯片温度、电池电量、功耗、风扇转速、配件电量，不能重复。显示实时网速是独立开关，在这些指标旁边显示上传和下载速度。点击这对上传和下载速度会打开按 App 列出的网络清单，可查看实时速度，或过去 1、5、10、30 分钟、1 天、7 天或 30 天各 App 的流量，同时显示整台 Mac 的趋势，最多列出 12 个 App。Mole 在菜单栏里时，点状态页或菜单栏面板网络卡片上的下载、上传速度，也会打开这个清单。Mole 菜单和菜单栏右键菜单中的网络与测速也能打开它。只有显示这对速度时才会记录，每分钟读取一次，记录仅保存在这台 Mac 上，保留 30 天，重启后仍在，Mole 没有运行的时段不会记录。清单顶部的「测速」标签点开就开始测速，用的是 macOS 自带的 networkQuality，连接苹果的服务器，显示下载、上传、延迟和满载延迟，Mole 不经过自己的服务器。小动物角色只是外观差异，不影响指标采样。数据排列方式默认 分栏，也可以改成紧凑两行的 堆叠，「翻转方向」让小动物从朝左改为朝右。

菜单栏支持暂停小动物动画，保留当前角色，原生工具菜单提供保持常亮、清洁屏幕、受支持 Mac 的风扇控制、WiFi 低延迟和隐藏桌面，还可设置打开主窗口、切换风扇降温和隐藏桌面的快捷键。网络卡片也有 WiFi 低延迟入口，开启后临时停用 AWDL 与隔空投送，关闭、睡眠或退出 Mole 时恢复原状态，不承诺提高下载速度。隐藏桌面在 Mole 菜单和菜单栏右键菜单里也有，和系统设置 › 桌面与程序坞里的显示项目是同一个设置，文件和磁盘都还在原处，默认快捷键是 ⌃⌥⌘D。

诊断

点窗口左上角的 Mole logo，选运行诊断。Mole 生成只读的精简报告，覆盖 Mac 型号、macOS 版本、权限、近期操作、显示器、外接卷、网络、安全状态和运行环境。点复制报告，然后把内容贴到发给支持的消息里。

诊断检测六种状况：完全磁盘访问权限缺失、内存压力偏高、磁盘接近满载、电池健康度偏低、建议重启、操作日志不可写。每种状况链接到对应的 帮助页面 解决步骤。

设置

设置分为三个分页。通用里包含重启生效的界面语言、清理选项、不清理的项目、许可证激活与设备管理、接收测试版更新，以及完全磁盘访问权限的快捷入口。清理选项包括缓存删除方式，可选「永久删除」或「移到废纸篓」，默认永久删除；另有「显示 AI 工具清理与维护入口」和快速卸载模式。工具里有保持常亮、清洁屏幕、两者的快捷键和需要 macOS 辅助功能权限的清洁屏幕辅助功能权限，以及支持设备上的电池充电保护与风扇控制。电池充电保护在 Mole 运行时把内置电池保持在 75% 到 80%，需一次管理员授权，「降温后自动结束风扇加速」决定降温和强冷是否在 Mac 冷却后把风扇交回系统。菜单栏里有登录时自动启动、隐藏程序坞图标、图标与小动物形象、可见指标和网络速度、菜单栏面板快捷键，以及摄像头麦克风提醒等通知。许可证也可随时用 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。如果命令静默失败，检查系统设置中是否已授予完全磁盘访问权限。

反馈问题见帮助页面的 反馈问题 部分。