正在加载插件详情…
🐹 开源 Mac 和 PC 清理工具。让你的电脑保持干净、轻快,运行如新。提供快速命令行,还有原生 Mac 和 Windows 应用。
数据截至 2026/11/18 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。
dsh plugin --profile web add dsh-mole🐹 开源 Mac 和 PC 清理工具。让你的电脑保持干净、轻快,运行如新。提供快速命令行,还有原生 Mac 和 Windows 应用。
本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
macOS · Windows · Linux
Mole
深度清理、卸载、优化、分析磁盘、监控你的 Mac。免费开源命令行,外加一款 Mac 应用。
English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français · Polski · Українська · Русский
💡 本仓库是免费开源命令行(mo)。想要原生应用?Mole for Mac 需单独下载,提供删除前确认的清理、800+ 应用实测残留、维护、磁盘下钻、实时状态,以及受支持 Mac 上的风扇控制。Windows 上的原生应用是 Mole for Windows。brew install mole 只安装命令行。
功能
- 一体化命令行工具箱:把 CleanMyMac、AppCleaner、DaisyDisk、iStat Menus 那类工作流合进一条终端命令
- 深度清理:清掉缓存、日志、残留和孤立的应用数据,腾出磁盘空间
- 智能卸载器:卸载应用时一并清掉 LaunchAgents、偏好设置和残留
- 磁盘分析器:用交互式 TUI 可视化磁盘占用,找大文件,逐层浏览目录
- 系统维护:刷新 DNS、重建 QuickLook/图标缓存、优化系统数据库
- 实时监控:实时显示 CPU、内存、磁盘 I/O、网络流量和进程状态
快速开始
Mole 需要 macOS 12 或更高版本,Intel 和 Apple Silicon Mac 都支持。如果你的 macOS 版本已不受 Homebrew 支持,改用脚本安装。
通过 Homebrew 安装
brew install mole
或用脚本
bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
用 AI 智能体安装
对你的智能体说:
读 https://raw.githubusercontent.com/tw93/Mole/main/llms.txt,帮我安装 Mole
也可以自己装技能。装上之后,Claude Code、Codex、Cursor 等智能体在删除任何东西之前,都会先用 --dry-run 展示每一项清理内容;卸载应用和管理员操作则留给你自己处理。用 npx skills update -g -y 更新。
bash
npx skills add tw93/Mole -a claude-code codex cursor -g -y
作为宿主插件安装:在 Claude Code 里执行 /plugin marketplace add tw93/Mole,再执行 /plugin install mole@mole;在 Codex 里执行 codex plugin marketplace add tw93/Mole,再执行 codex plugin add mole@mole;在 DeepSeek Harness 里执行 dsh plugin --profile <name> add dsh-mole。
运行 bash mo # Interactive menu mo clean # Deep cleanup + already-uninstalled app leftovers mo uninstall # Remove installed apps + their leftovers mo optimize # Refresh caches & services mo analyze # Visual disk explorer (or 'mo analyse') mo status # Live system health dashboard mo purge # Clean project build artifacts mo installer # Find and remove installer files mo slim # Remove Intel code from universal apps
mo touchid # Configure Touch ID for sudo
mo completion # Set up shell tab completion
mo update # Update Mole
mo update --nightly # Update to latest unreleased main build, script install only
mo remove # Remove Mole from system
mo --help # Show help
mo --version # Show installed version
安全预览 bash mo clean --dry-run mo uninstall --dry-run mo optimize --dry-run mo purge --dry-run mo installer --dry-run mo slim --dry-run mo history mo history --json
mo clean --dry-run --debug # Preview + detailed logs
mo optimize --whitelist # Manage protected optimization rules
mo clean --whitelist # Manage protected caches
mo purge --paths # Configure project scan directories
mo analyze /Volumes # Analyze external drives only
mo analyze /private/tmp # Review user-owned temporary directories
其他安装方式
要安装指定版本,传入 releases 页面上的任意 tag,带不带开头的 V 都行。想跟踪开发分支,就传 main: bash
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- 1.51.0
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- main
main 安装的是默认分支上尚未发布的代码,所以难免有粗糙之处。latest 仍可作为 main 的旧别名使用;名字虽如此,它并不会安装最新的稳定版。
脚本默认安装到 /usr/local/bin,可能要求输入管理员密码。如果希望以后运行 mo update 时不再输密码,就装到用户自己的目录: bash
mkdir -p "$HOME/.local/bin"
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- --prefix "$HOME/.local/bin"
export PATH="$HOME/.local/bin:$PATH"
把同样的 PATH 导出语句加到 ~/.zshrc 或你的 shell 配置档里,新开的终端才会生效。Mole 更新的是你调用安装时的那份安装,所以会一直用这个目录。改动系统所属文件的命令仍可能要求管理员权限。
Nix
在 macOS 上,Nix 用户可以从 main 安装 flake,其中包含尚未发布的改动: bash nix profile install github:tw93/mole/main#mole nix profile upgrade mole nix profile remove mole
想用声明式安装,就把 github:tw93/mole/main 加为 flake input,并使用它的 packages.${system}.mole 包。通过 Nix 更新或移除 Mole;mo update 和 mo remove 不会改动 Nix 管理的安装。
在 Windows 上(Windows 命令行) powershell iwr -useb https://raw.githubusercontent.com/tw93/Mole/windows/quick-install.ps1 | iex
在 Linux 上(Linux 命令行) bash
curl -fsSL https://raw.githubusercontent.com/tw93/Mole/linux/install.sh | bash
Mole 只通过 Homebrew、本仓库和 mole.fit 分发。molemac.com、moleapp.net 和 molefit.com 都不是 Mole,mole.bluecatbot.com 上的 Windows 应用是另一个社区项目。
安全
Mole 会删除文件,所以它会校验路径、保护共享位置和系统所属位置,并在操作需要确认时征求你的同意。当 Mole 无法证明某个项目可以安全改动时,它会跳过或拒绝。
- clean、uninstall、purge、installer、slim 和 remove 会删除文件,所以先用 --dry-run 检查,需要时再加上 --debug
- 不要用 sudo 运行 Mole;它只在需要时请求管理员权限
- mo uninstall、mo analyze 和 mo slim 在确认后默认把删除项放进废纸篓;clean、purge 和 installer 则永久删除。mo uninstall --permanent 跳过废纸篓
- 清理活动记录在 ~/Library/Logs/mole/operations.log;用 mo history 查看,或用 MO_NO_OPLOG=1 关闭记录
- 用 mo clean --whitelist 保护缓存,或用 mo optimize --whitelist 保护维护项
- 如果读不到白名单文件,clean、purge 和 optimize 会停止运行,而不是在没有白名单的情况下继续
报告指引、安全边界和当前限制见 SECURITY.md 和 SECURITY_AUDIT.md。
配置
Mole 无需配置即可运行。下面这些环境变量用来适配慢速磁盘、卡顿的网络或云端挂载;只有 Mole 报告某一步超时,才需要调大对应超时。
- MOLE_TIMEOUT_QUICK_DETECT_SEC(2):探测命令是否可用
- MOLE_TIMEOUT_SHORT_QUERY_SEC(3):轻量查询,例如 df 和 tmutil status
- MOLE_TIMEOUT_MEDIUM_PROBE_SEC(5):遍历目录树或访问网络的探测
- MOLE_TIMEOUT_PKG_LIST_SEC(10):包管理器列表,例如 brew list
- MOLE_TIMEOUT_PKG_CLEANUP_SEC(20):遍历磁盘的缓存清理
- MOLE_TIMEOUT_DISK_VERIFY_SEC(30):文件系统校验与修复
- MOLE_TIMEOUT_HINT_SCAN_SEC(15):无边界用户目录扫描
- MOLE_CLOUD_OFFICE_SECTION_BUDGET_SEC(300):云端与 Office 清理环节的总预算
括号里的数字是默认值,单位秒。例如,磁盘慢时给扫描多留点时间: bash
MOLE_TIMEOUT_HINT_SCAN_SEC=60 MOLE_TIMEOUT_MEDIUM_PROBE_SEC=15 mo clean
功能详解
下面的示例经过精简。可用项目、大小和跳过原因取决于你的 Mac。
清理
mo clean 检查已知安全的缓存、日志、临时文件、开发者产物,以及已卸载应用留下的残留。默认清空 ~/.Trash;想保留它,就在 mo clean --whitelist 里选中 Trash,这个菜单同样用来保护你想保留的缓存。/Volumes/*/.Trashes 这类卷回收站不会随之清空。选择结果保存在 ~/.config/mole/whitelist。添加自定义路径前,先打开菜单按 Enter 保存选择,再每行追加一个路径。已有文件会替换可选默认值;内置的安全保护仍然生效。
text
$ mo clean
Clean Your Mac
⚙ Apple Silicon | Free space: 219.0GB
➤ User essentials
✓ User app cache · 18 items, 2.4GB ✓ User app logs · 7 items, 12.8MB ✓ Trash · emptied, 9 items
➤ App caches
✓ App Store cache · 8 items, 248.5MB
➤ Browsers
✓ Safari cache · 24 items, 642.1MB ✓ Chrome cache · 31 items, 1.2GB
➤ Developer tools
✓ npm cache · cleaned ◎ pnpm cache · skipped (pnpm busy)
Cleanup complete
Removed: 4.5GB · 97 items Free space: 223.5GB (+4.5GB)
卸载
mo uninstall 卸载已安装的应用,同时清掉 Mole 能关联到该应用的相关文件。若另一份已安装副本仍在使用共享数据,则保留这些数据。应用已经删掉了,就用 mo clean 查找残留。
个人数据(包括设置和插件)默认保留。在移除预览中按 D 可选择要保留的数据路径。mo uninstall --with-data 启动时已选中这些数据,但浏览器配置档和 App Group 容器除外;预览会单独列出它们,按 D 仍可保留任意路径。移除完成后,shell、Hook 或 MCP 配置中的引用只按文件和行号列出;Mole 不会改动这些配置。
text
$ mo uninstall
Select Apps to Remove 1/3 selected
➤ ● Photoshop 2024 4.20GB | 2mo ago
○ IntelliJ IDEA 2.80GB | 3d ago
○ Premiere Pro 3.40GB | 2w ago
Files to be removed:
✓ Photoshop 2024, 4.20GB
✓ /Applications/Adobe Photoshop 2024/Adobe Photoshop 2024.app
Personal data kept:
~/Library/Application Support/Adobe/Adobe Photoshop 2024
~/Library/Preferences/com.adobe.Photoshop.plist
D choose personal data
Uninstall complete
Removed 1 app, freed 4.20GB: Photoshop 2024
Optimize
mo optimize 针对受支持的 Finder、网络、数据库和 macOS 服务执行有边界的维护。没必要、当前不安全或不可用的任务会被跳过,并给出原因。用 mo optimize --whitelist 排除任务或路径模式,例如长期挂载在 /Volumes/mail 的磁盘映像,不应出现在可卸载候选中。
text
$ mo optimize
Optimize
⚙ System 18/32 GB RAM | 616/926 GB Disk | Uptime 6d
PERFORMANCE DIAGNOSIS
✓ No sustained high-CPU bottleneck detected
➤ Finder Cache Refresh
✓ QuickLook thumbnails refreshed
✓ Icon services cache rebuilt
➤ Network Cache Refresh
✓ DNS cache refreshed
➤ Database Optimization
◎ Close these apps before database optimization: Safari
➤ Disk Health
✓ Disk verify skipped
Optimization Complete
Applied 2 optimizations
13 unchanged | 3 skipped | 1 unavailable
Analyze
mo analyze 打开终端磁盘浏览器。它支持方向键和 Vim 导航、过滤、多选、Finder 预览,以及确认后移到废纸篓。默认概览会跳过外接磁盘;用 mo analyze /Volumes 或具体挂载路径查看它们。用 mo analyze /private/tmp 查看用户拥有的临时文件,但不会把它们变成自动清理目标。逐文件扫描时,共享全部块的 APFS 克隆只计一次;快速文件夹估算仍可能重复计算共享块。
以 + 结尾的大小,表示部分扫描测得的字节数;unknown 表示无法测量大小。因超时等临时故障而中断的结果,不会覆盖完整的缓存测量值,稍后刷新可以补回缺失数据。macOS 不允许终端读取的文件夹会一直保持部分状态,直到访问权限发生变化。终端列表只保留最大的 30 项,所以无法读取的条目可能落在列表之外;总数仍能说明扫描是部分完成的。目录 JSON 输出包含所有已扫描的条目。
mo analyze --json /path 会在结果和每个条目上带上 scan_status:complete、partial 或 unavailable。数值大小是实测字节数;unavailable 下的零并不表示目录为空。部分扫描仍会正常退出,所以自动化脚本应检查 scan_status。完整性只在 Mole 现有的扫描排除范围内成立,并不承诺文件系统快照是原子的。
text
$ mo analyze
Analyze Disk (302.1GB free)
Select a location to explore:
▶ 1. ████████████████████████ 47.9% | Home 75.4GB
2. ███████████ 22.0% | User Library 34.6GB
3. ███████ 14.2% | Applications 22.4GB
4. █████ 10.7% | System Library 16.9GB
5. ███ 5.2% | Old Downloads (90d+) 8.2GB >3mo
Status
mo status 是只读仪表盘,展示硬件、系统压力、磁盘活动、网络流量、电源和进程。
当 IPv4 默认路由走隧道时,网络图表使用该接口的速率,避免在物理承载上重复计算同一份流量。JSON 保留每个接口的速率,包括承载路由的隧道;空闲的非默认隧道保持隐藏。
text
$ mo status
Mole Status Health ● 92 MacBook Pro · M4 Pro · 32GB · macOS 26
⚙ CPU ▦ Memory
Total ████████████░░░░░░░ 45.2% Used ███████████░░░░░░░ 58.4%
Load 0.82 / 1.05 / 1.23 (8 cores) Total 18.7 / 32.0 GB
Core 1 ███████████████░░░░ 78.3% Free ████████░░░░░░░░░░ 41.6%
Core 2 ████████████░░░░░░░ 62.1% Avail 13.3 GB
▤ Disk ⚡ Power
Used █████████████░░░░░░ 67.2% Level ██████████████████ 100%
Free 156.3 GB Status Charged
Read ▮▯▯▯▯ 2.1 MB/s Health Normal · 423 cycles Write ▮▮▮▯▯ 18.3 MB/s Temp 58°C · 1200 RPM
⇅ Network ▶ Processes
Down ▁▁█▂▁▁▁▁▁▁▁▁▇▆▅▂ 0.54 MB/s Zombies 3 · Chrome (4242) ×3 Up ▄▄▄▃▃▃▄▆▆▇█▁▁▁▁▁ 0.02 MB/s Code ▮▮▮▮▯ 42.1% Proxy HTTP · 192.168.1.100 Chrome ▮▮▮▯▯ 28.3% 健康评分综合 CPU、内存、磁盘容量、SMART 状态、I/O、温度、电池状态和运行时长,用颜色区分区间。按 k 切换猫,按 c 循环切换显示的 CPU 核心数,按 q 退出;显示偏好会保存。
JSON、NDJSON 与进程告警
- mo analyze --json ~/Documents 以 JSON 返回一次性磁盘报告
- mo status --json 以 JSON 返回一次性状态快照
- mo status | jq '.health_score' 输出被管道接管时自动切换为 JSON
- mo status --watch --interval 2s 从常驻采集器流式输出按行分隔的 JSON
- mo history --json 以 JSON 返回清理活动。会话包含 run_id(不透明字符串,未记录身份时为空)和 attribution:run 表示已识别运行,command 表示按旧版命令分组,ambiguous 表示旧版标记无法区分中断与重叠运行。已记录的操作仍然可用;ambiguous 计数无法可靠归属到单次运行。ended_at 为空表示未记录结束标记
- mo uninstall --list 以 JSON 返回已安装应用,包含 name、bundle_id、source、uninstall_name、path 和 size text
$ mo analyze --json ~/Documents
{
"path": "/Users/you/Documents",
"overview": false,
"entries": [
{ "name": "Library", "path": "...", "size": 80939438080, "is_dir": true }
],
"large_files": [
{ "name": "backup.zip", "path": "...", "size": 8796093022 }
],
"total_size": 168393441280,
"total_files": 42187
}
$ mo status --json
{
"host": "MacBook-Pro",
"health_score": 92,
"cpu": { "usage": 45.2, "logical_cpu": 8 },
"memory": { "total": 34359738368, "used": 20078972109, "used_percent": 58.4 },
"disks": [],
"process_collected_at": "2026-08-29T12:30:00Z",
"process_stale": false,
"zombie_count": 3,
"zombie_parents": [
{ "pid": 4242, "name": "Google Chrome for Testing", "count": 3 }
],
"zombie_parents_complete": true,
"uptime": "3d 12h 45m"
}
僵尸进程诊断只读,不影响健康评分,也不终止进程。Mole 尚未成功采集进程样本时,process_collected_at、process_stale、zombie_count 和 zombie_parents_complete 会省略,zombie_parents 为 null。后续的快速/监视快照复用最近一次成功样本及其原始 process_collected_at,并把 process_stale 设为 true;实时进程样本则设为 false。计数为 0 表示 Mole 未测到僵尸进程。父进程摘要最多包含三个已知属主;zombie_parents_complete: false 表示归属信息不可用、不完整或被截断。
某个采集器失败时,mo status --json 仍会打印已采集的指标,在 stderr 报告失败,并以成功状态退出,与 --watch 继续流式输出的行为一致。CPU、内存、磁盘、进程指标全都不可用,或 JSON 输出失败时,退出码为 1。
状态还支持只读告警,针对持续高于 CPU 阈值的进程。用 --proc-cpu-threshold、--proc-cpu-window 或 --proc-cpu-alerts=false 调整或关闭。
Purge
mo purge 查找可重建的项目产物,比如 node_modules、target、.build、build 和 dist。它按项目分组,只永久删除你确认的条目。最近 7 天有文件活动的产物,或 Mole 无法核实活动的产物,默认不选中。Mole 优先用 fd,没有就用 find,并保护包含部署密钥文件、嵌套 Git 仓库或 Git 跟踪文件的目录。非交互运行需要 mo purge --yes;先用 mo purge --dry-run 查看候选。
用 Page Up/Down 或 h/l 翻页,用 [/] 在项目间跳转,用 X 跳过项目并前进。/ 搜索项目路径和产物名,n 查找下一个匹配项且不改动选择,Enter 打开最终路径复核。报告的占用空间是估算值;未测量的产物和不完整的扫描会明确标出。
Purge 示例输出 text
$ mo purge
Purge Project Artifacts
Select Artifacts to Purge
6.00GB, 2 selected
➤ ● ┌ ~/Projects/website 3.80GB | node_modules | 28d
○ └ ~/Projects/website 186MB | dist | <1d
● ┌ ~/Projects/rust-app 2.20GB | target | 2mo
○ └ ~/Projects/rust-app 22MB | dist | <7d
Purge complete
Estimated space freed: 6.00GB | Items: 2 | Free: 223.5GB
自定义扫描路径
运行 mo purge --paths 配置扫描目录,或直接编辑 ~/.config/mole/purge_paths: shell ~/Documents/MyProjects ~/Work/ClientA ~/Work/ClientB
配置了自定义路径后,Mole 只扫描这些目录。否则用默认路径,比如 ~/Projects、~/GitHub、~/dev,以及受支持的智能体工作树容器。发现过程不会保存不完整的结果。产物扫描会深入到每个配置根目录下六层;项目更深就加一个更近的根目录。Purge 删除工作树内部的可重建产物,绝不删除工作树本身。
Installer
mo installer 会在下载、桌面、Homebrew 缓存、iCloud、邮件、Telegram 等支持的位置查找 DMG、PKG、MPKG、ISO、XIP 和安装包 ZIP 文件,并在删除前显示每一项的大小和来源。查找过程有累计时间上限:只要某次扫描或元数据探测失败或超时,Mole 就丢弃列表并退出,不选中任何文件。损坏和无法读取的 ZIP 归档会被跳过;扫描根目录支持符号链接,但不跟随根目录之下的符号链接;选中的文件在删除边界处会再次核对其已确认的身份。
安装包清理示例输出 text
$ mo installer
Select Installers to Remove, 3.83GB, 5 selected
➤ ● Photoshop_2024.dmg 1.20GB | Downloads
● IntelliJ_IDEA.dmg 850.6MB | Downloads
● Illustrator_Setup.pkg 920.4MB | Downloads
● PyCharm_Pro.dmg 640.5MB | Homebrew
● Acrobat_Reader.dmg 220.4MB | Downloads
○ AppCode_Legacy.zip 410.6MB | Downloads
Installers cleaned
Removed 5 installers, freed 3.83GB
Slim
mo slim 会移除通用应用在 Apple Silicon Mac 上携带的 Intel 代码。它列出你拥有的、使用 Developer ID 签名的应用,并显示每个应用 Intel 代码的大小,只改动你选中的应用。每个应用都在副本上瘦身,只处理主可执行文件和自带签名的嵌套代码;副本只有在保留 Apple Silicon 代码并通过代码签名和 Gatekeeper 检查后,才会替换原应用,原应用则移入废纸篓。App Store 应用、Apple 应用、设为使用 Rosetta 打开的应用、属于其他用户的应用以及正在运行的应用都不动。它不需要开发者工具,应用更新后 Intel 代码会回来。
快速启动器
Raycast 和 Alfred 设置
安装五个启动器,分别对应 Clean、Uninstall、Optimize、Analyze 和 Status: bash
curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh | bash
脚本会添加 Raycast 命令;如果存在 Alfred 偏好设置,还会添加对应的 Alfred 工作流,关键词为 clean、uninstall、optimize、analyze 和 status。
Raycast 需要手动设置一步:
1. 打开 Raycast Settings > Extensions > Script Commands。
2. 把 ~/Library/Application Support/Raycast/script-commands 添加为脚本目录。
3. 在 Raycast 中运行 Reload Script Directories。
启动器会自动识别 Terminal、iTerm2、Alacritty、kitty、WezTerm、Ghostty、Hyper、WindTerm 和 Warp。设置 MO_LAUNCHER_APP=<name> 可选择其中一个;你也可以直接在 Kaku 中运行 Mole。
社区
感谢每一位帮助构建 Mole 的人。去关注他们吧。❤️
这些是真实用户反馈,他们在 𝕏 上分享了 Mole。
看 PAPAYA 電腦教室 出的 Mole 教程视频。
支持
- 购买 Mole for Mac 是支持 Mole 开发最直接的方式
- 如果 Mole 帮到了你,给它点个 star,分享出去,或者提 issue、PR
- 我养了两只猫,汤圆和可乐。如果 Mole 让你的日子轻松了一点,欢迎请它们吃罐头 🥩
这些可爱的人已经请过了 🐱
许可证
Mole 以 GPL-3.0 开源,详见 LICENSE。你分享的任何修改版本都必须沿用同一许可证。如果你 fork 了 Mole,请另起一个名字,并注明 Mole 是上游来源。Mole for Mac 是独立的闭源应用,而 Mole 会长期做下去。