Mole/GUIDE.md

Mole Mac 清理工具 - 小白使用指南

一个完全不懂技术的 Mac 用户也能轻松使用的清理工具教程

第一步：打开终端

终端是 Mac 自带的一个工具，用来输入命令操作电脑。

方法一：快捷键（推荐）

1. 按下键盘上的 Command (⌘) + 空格键
2. 在弹出的搜索框中输入 终端 或 Terminal
3. 按回车键，会打开一个黑色或白色的窗口

方法二：应用程序

1. 打开"访达"（Finder）
2. 点击左侧的"应用程序"
3. 找到"实用工具"文件夹
4. 双击"终端"图标

💡 小提示：这个窗口看起来可能有点专业，但别担心，接下来的操作都很简单！

---

第二步：安装 Mole

方法一：一键安装（推荐）

1. 复制安装命令 用鼠标选中下面这一行，然后按 Command (⌘) + C 复制：

   curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
   

2. 粘贴到终端

   • 在终端窗口中，按 Command (⌘) + V 粘贴
   • 或者右键点击终端窗口，选择"粘贴"

3. 开始安装

   • 按下 回车键
   • 等待几秒钟，会自动安装完成
   • 看到类似"安装成功"的提示就完成了

方法二：通过 Homebrew 安装

如果你的电脑已经安装了 Homebrew，可以使用这个命令：

brew install tw93/tap/mole

💡 什么是 Homebrew？一个 Mac 软件管理工具。如果你不知道这是什么，请使用方法一。

⚠️ 重要： 只选择一种方法安装！不要同时用两种方法，会产生冲突。

⚠️ 注意：第一次安装可能会要求你输入 Mac 的登录密码（输入时不会显示任何字符，这是正常的）

---

第三步：开始使用

1. 启动 Mole 在终端中输入以下命令并按回车：

   mole
   

2. 了解界面操作

   • 用键盘的 ↑ ↓ 方向键 选择菜单项
   • 按 空格键 选中或取消选中
   • 按 回车键 确认执行
   • 按 q 键退出当前界面

---

第四步：常见操作

清理垃圾文件

安全预览模式（推荐第一次使用）：

mole clean --dry-run

这个命令只会显示哪些文件会被清理，不会真的删除。你可以先看看效果再决定。

管理白名单（保护重要缓存）：

mole clean --whitelist

交互式选择哪些缓存不要删除，比如开发工具的大型缓存（Homebrew、Gradle 等）。

正式清理：

mole clean

会清理系统缓存、日志、临时文件等，释放磁盘空间。Mole 很安全，只删除可重新生成的文件。

卸载应用（彻底删除）

mole uninstall

这个功能会：

• 显示你电脑上所有已安装的应用
• 用方向键选择要卸载的应用
• 按空格键标记（可以多选）
• 按回车确认删除
• 会连同应用的残留文件一起删除

查看帮助

mole --help

可以查看所有可用的命令和说明。

磁盘空间分析 🆕

mole analyze

交互式查看哪些文件和文件夹最占空间，帮助你快速找到并清理大文件。

基本操作：

• ↑ ↓：上下选择
• 回车：进入文件夹 / 打开文件预览
• ←：返回上级
• Delete：删除（需确认）
• q：退出

小提示：

• 文件夹会按大小排序，一目了然
• 文本文件可以直接预览，其他文件用系统默认应用打开
• 超过 15 项会自动分页，继续按方向键滚动查看

---

第五步：注意事项

使用建议

推荐：

• 第一次使用先 --dry-run 预览
• 定期清理（每月一次或磁盘快满时）
• 有大型缓存可用 --whitelist 保护

避免：

• 频繁清理（一周一次就够了）
• 运行重要程序时清理

安全保障

Mole 只删除可重新生成的缓存和日志，不会删除：

• 应用配置文件（.plist）- 你的设置会保留
• 应用数据（Application Support）- 重要文档不受影响
• 系统关键文件、IDE 数据、数据库等

白名单保护： 可以保护特定缓存不被删除

mole clean --whitelist  # 交互式选择要保护的缓存

---

常见问题

为什么输入密码时看不到字符？

这是 Mac 终端的安全设计，密码不会显示，直接输入后按回车就行。

安装失败怎么办？

1. 检查网络连接是否正常
2. 尝试重新运行安装命令
3. 如果还不行，可以去 GitHub Issues 寻求帮助

清理后能恢复吗？

不需要恢复！Mole 只删除缓存和日志，应用会自动重新生成，不影响使用。

注意： 应用卸载后无法恢复（但配置文件会保留）

多久清理一次比较好？

• 磁盘空间充足：1-2 个月一次
• 磁盘快满了：立即清理
• 日常使用：看个人习惯

如何更新 Mole？

如果是一键安装的：

mole update

如果是 Homebrew 安装的：

brew upgrade mole

---

需要更多帮助？

• GitHub 项目主页
• 提交问题反馈
• 完整使用文档

祝你使用愉快！如果觉得有用，欢迎分享给朋友 ✨