# Mole 小白使用指南

> 不懂技术也能用的 Mac 清理工具教程

## 第一步：打开终端

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

**方法一：快捷键（推荐）**

1. 按 `Command (⌘)` + `空格键`
2. 在搜索框输入 `终端` 或 `Terminal`
3. 按回车

**方法二：应用程序**

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

> 小提示：别担心，接下来的操作都很简单

---

## 第二步：安装 Mole

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

1. **复制安装命令**
   选中下面这行，按 `Command (⌘)` + `C` 复制：

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

2. **粘贴到终端**
   - 按 `Command (⌘)` + `V` 粘贴
   - 或者右键选择粘贴

3. **开始安装**
   - 按回车
   - 等几秒，自动安装
   - 看到安装成功提示就好了

**方法二：通过 Homebrew 安装**

如果你装了 Homebrew，用这个：

```bash
brew install tw93/tap/mole
```

> 什么是 Homebrew？Mac 软件管理工具。不知道的话用方法一。
>
> **注意：** 只选一种方法装，别两种都用，会冲突。
>
> 安装时可能要验证管理员权限，Touch ID 或输密码都行，输密码时不显示字符是正常的

---

## 第三步：开始使用

1. **启动 Mole**
   在终端输入并回车：

   ```bash
   mo
   ```

   找不到命令的话，试试 `mole`，功能一样。

2. **界面操作**
   - `↑` `↓` 方向键选菜单
   - `空格键` 选中/取消
   - `回车键` 确认
   - `q` 键退出

---

## 第四步：常见操作

### 重要提示

**首次使用建议：**

1. **预览模式：** 先跑 `mo clean --dry-run` 看看会删什么，不会真删
2. **白名单保护：** 用 `mo clean --whitelist` 保护重要缓存
3. **谨慎使用：** Mac 很重要的话，等 Mole 更成熟再用

### 清理垃圾文件

**预览模式（第一次用建议先试）：**

```bash
mo clean --dry-run
```

只显示会删什么，不会真删。先看看再决定。

**白名单管理：**

```bash
mo clean --whitelist
```

选哪些缓存不删，比如开发工具的大型缓存。

**正式清理：**

```bash
mo clean
```

清理系统缓存、日志、临时文件等，释放空间。Mole 只删可重新生成的文件，放心用。

### 卸载应用

```bash
mo uninstall
```

这个功能：

- 显示所有已装应用
- 方向键选，空格标记，可多选
- 回车确认删除
- **连残留文件一起删**

### 查看帮助

```bash
mo --help
```

查看所有命令。

### 磁盘空间分析 🆕

```bash
mo analyze
```

看哪些文件和文件夹占空间大，快速找到并清理。

**操作：**

- `↑` `↓`：选择
- `回车`：进入文件夹/预览文件
- `←`：返回上级
- `Delete`：删除
- `q`：退出

> 需要权限时先试 Touch ID，不支持再输密码。

**提示：**

- 文件夹按大小排序
- 文本文件直接预览，其他用默认应用打开
- 超过 15 项自动分页

---

## 第五步：注意事项

### 使用建议

**推荐：** 定期清理，每月一次或磁盘快满时

**避免：** 频繁清理，或在运行重要程序时清理

### 安全保障

Mole 只删缓存和日志，不碰这些：

- 应用配置
- 应用数据
- 系统文件
- IDE 数据
- 数据库

---

## 常见问题

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

Mac 终端安全设计，直接输完按回车就行。

### 安装失败怎么办？

1. 检查网络
2. 重新跑安装命令
3. 还不行去 [GitHub Issues](https://github.com/tw93/mole/issues) 问

### 清理相关

**清理后能恢复吗？** 不用恢复。Mole 只删缓存和日志，应用会自动重新生成。注意：应用卸载后无法恢复。

**多久清理一次？** 每月一次，或磁盘快满时。

### 如何更新和卸载 Mole？

**更新：** `mo update`，Homebrew 装的会自动 `brew update && brew upgrade mole`

**卸载：** `mo remove`，自动识别安装方式，清理所有文件

### Mole 支持 Touch ID 吗？

Mole 用 `sudo` 请求权限，默认输密码。如果你给 `sudo` 启用了 Touch ID，可以直接按指纹，失败再输密码。

### 如何让命令行支持 Touch ID？

1. 打开配置：`sudo nano /etc/pam.d/sudo`
2. 在顶部注释下加：

   ```txt
   auth       sufficient     pam_tid.so
   ```

3. 保存退出：`Ctrl+O` 回车，`Ctrl+X`。以后 `sudo` 会先提示 Touch ID。

---

## 需要帮助？

- [GitHub 主页](https://github.com/tw93/mole)
- [提交问题](https://github.com/tw93/mole/issues)
- [完整文档](./README.md)

有用的话分享给朋友吧~